給 AI 助手一個真正的 WhatsApp 號碼。
MCP 伺服器讓 Claude、ChatGPT 或 Cursor 直接使用 WhatsApp:列出您的號碼、檢查連接狀態、傳送訊息及訊息範本,並將 Webhook 指向您自己的系統。我們的伺服器在 Meta 官方的 Cloud API 上運作,因此客戶一直聯絡的號碼絕不會面臨風險。
{
"mcpServers": {
"easycoexistence": {
"url": "https://easycoexistence.com/api/mcp"
}
}
}連接器實際連接到哪裡
一部透過 OAuth 存取的遠端伺服器,為一個仍在 WhatsApp Business 應用程式中正常使用的號碼呼叫 Meta 有文件說明的 Cloud API。任何地方都不會保留工作階段,您的電腦上也不會執行任何程式。
- 1您的助手Claude、ChatGPT、Cursor 或 Claude Code,透過 MCP 連接
- 2easycoexistence.com/api/mcp遠端運作,透過 OAuth 授權。無需在任何地方貼上金鑰
- 3Meta Cloud API有文件說明的 Graph 端點,使用該帳戶自己的存取權杖
- 4企業號碼透過 Coexistence 連接,手機上的應用程式照常運作
大多數 WhatsApp 自動化走的是另一條路:以已連結裝置身分登入,然後操控 WhatsApp Web 工作階段。這違反 WhatsApp 的條款,而 Meta 是根據流量的特徵而非傳送流量的程式碼來偵測它,所以「防封號」承諾描述的是供應商無法控制的事情。這裡沒有任何功能使用這種機制。
如何安裝
一個遠端端點,帳戶內的每個號碼都使用同一個。無需安裝套件,也無需產生金鑰:每個用戶端在第一次呼叫工具時透過 OAuth 登入。
- 開啟設定,前往連接器。
- 選擇加入自訂連接器,貼上下方的端點。
- 儲存後,請 Claude 列出您的號碼。第一次會開啟登入頁面。
https://easycoexistence.com/api/mcp- 開啟設定,前往連接器,再前往進階,然後開啟開發人員模式。
- 使用下方的端點加入一個連接器。
- 開始一個對話,請它列出您的號碼,以觸發登入。
https://easycoexistence.com/api/mcp- 在任何終端機中執行下方的指令。
- 在 Claude Code 中執行 /mcp 並完成驗證。
- 此後,每個工作階段都可以使用這些工具。
claude mcp add --transport http easycoexistence --scope user https://easycoexistence.com/api/mcp- 開啟設定,找到 MCP 部分。
- 使用下方的設定加入一部伺服器。
- 重新載入,然後請 Cursor 列出您的號碼。
{
"mcpServers": {
"easycoexistence": {
"url": "https://easycoexistence.com/api/mcp"
}
}
}連接號碼是另一個一次性步驟,需要使用瀏覽器,因為 Meta 的登記流程使用自己的彈出視窗及 QR 碼掃描。如果您希望由助手把連結交給您,get_connect_link 會傳回這個連結。
由工具強制執行的規則,讓助手不必吃虧才學會
當收件人在過去 24 小時內曾傳訊息給該號碼,send_message 才能使用。這些回覆是免費的。超出這段時間,只有使用已批核範本的 send_template 能夠送達,工具說明中寫明了這一點,因此助手無需提醒就會選擇正確的工具。
在 Coexistence 號碼上,手機應用程式無法傳送範本。任何預定、交易類或窗口之外的訊息都必須透過 API 傳送,這也是很多人連接號碼的主要原因之一。
推廣訊息由 Meta 向 WhatsApp Business 帳戶上的付款方式收費,該付款方式在 WhatsApp Manager 中設定。費用從不經過我們,我們也無法透過 API 加入信用卡。
必須使用 HTTPS,並且在收到帶有 hub.mode=subscribe 及您的 hub.verify_token 的 GET 請求時,端點必須原樣傳回 hub.challenge。我們在呼叫前進行驗證,因此錯誤的 URL 會立即失敗,而不是看起來已經連接。
16 項 WhatsApp 工具,以及每項工具的實際用途
一個連接器即可為帳戶內的每個號碼提供這些工具,同時也提供其他頻道的工具。list_numbers 排在第一位,因為其他每項 WhatsApp 工具都要從它取得 connection_id。
list_numbers已連接的號碼,包括狀態、品質評級及訊息傳送級別。其他一切操作的起點。get_number_healthMeta 的即時快照,加上近期的監察時間線:Webhook 事件及輪詢檢查合併在一起。get_api_credentialsGraph API 基本 URL、WABA id、phone number id,以及該帳戶自己的存取權杖(如有)。
send_message自由文字,且只能在 24 小時客戶服務窗口內傳送。窗口內的回覆免費。send_template向尚未先傳訊息的人開始對話的方式。list_templates帳戶內的訊息範本及其審核狀態。create_template提交給 Meta 審核。UTILITY、MARKETING 或 AUTHENTICATION,附有 {{1}} 形式的變數,需要提供範例值。get_template_status按範本名稱傳回 APPROVED、PENDING 或 REJECTED。
set_webhook_destination將來自 Meta 的傳入訊息及手機應用程式回傳直接轉送到您的系統。傳入 null 即可重設。get_connect_link傳回控制台連結及連接新號碼的步驟,因為登記流程需要瀏覽器。get_docs完整的產品文件(Markdown 格式),讓助手依據我們的文件回答,而不是猜測。
get_partner_setupPartner API 的設定進度:計費、API 金鑰、事件 URL,以及下一步。create_api_key簽發 Partner API 金鑰,並只顯示一次。未經您確認,不會取代現有的金鑰。revoke_api_key經您確認後撤銷 Partner API 金鑰。此後,所有使用該金鑰的請求都會失敗。set_partner_events_url設定連接狀態事件的傳送位置,並傳回簽署密鑰,該密鑰只顯示一次。create_connect_link為您的其中一位客戶建立託管的連接連結,有效時間 1 小時。該號碼計入您的帳戶收費。
付款中斷時仍可使用的功能
會對外部產生操作的工具會受到限制,get_api_credentials 也一樣,因為它會交出用於傳送的存取權杖。讀取健康狀況和狀態的功能刻意保持開放。
list_numbersget_number_healthget_template_statuslist_templatesget_connect_linkget_docsget_partner_setupcreate_api_keyrevoke_api_keyset_partner_events_url
send_messagesend_templatecreate_templateset_webhook_destinationget_api_credentialscreate_connect_link
如果一個帳戶看不到自己為何被封鎖,或無法檢查號碼是否正常,那麼除了提交支援請求之外別無出路。連接狀態監察本身亦依賴這兩項讀取功能。
如果您為其他企業提供服務,這一對工具最重要
get_connect_link 傳回客戶用來接駁自己號碼的連結,set_webhook_destination 則在號碼連接的那一刻將其指向您的系統。兩者結合,AI 代理就能由頭到尾完成客戶登記,無需任何人開啟控制台。
一個帳戶可以容納您需要的任何數量的號碼,每個號碼獨立計費,list_numbers 會傳回所有號碼及其 connection_id,供其他每項工具使用。
讀取、傳送、範本、接線、文件及 Partner API 工具,全部列於下方。
Coexistence 號碼的固定傳送流量由 Meta 設定,無論由我們或您都不能提高。
客戶回覆後可維持工作階段開啟的時間。超出這段時間後,只能傳送已獲批核的範本。
伺服器位於遠端,因此您的裝置不會執行任何程式,也不會在任何地方保留工作階段。
常見問題
我的客戶號碼會因為使用這項服務而被封鎖嗎?
不會。這是 Meta 的官方 Cloud API,透過 Meta 自己的 Coexistence 功能存取。人們所說的封鎖風險,來自以已連結裝置身分登入的非官方閘道,這是完全不同的機制。
連接器支援哪些助手?
任何透過 HTTP 搭配 OAuth 使用 MCP 的助手都可以:現時包括 Claude、ChatGPT、Cursor、Claude Code 及 Codex。這是一個遠端端點,因此您的裝置不會執行任何程式。
我的對話會經過你們的伺服器嗎?
預設不會。傳入訊息會由 Meta 直接轉送至您指定的 Webhook,而我們不儲存對話內容。我們只保留運作及監察連接所需的帳戶、號碼狀態及憑證,不會保留其他資料。
我可以為多個客戶使用一個連接器嗎?
可以。一個帳戶可以存放您需要的任意數量號碼,每個號碼按獨立連接計費,而連接器會列出全部號碼。您可以將它用於自己服務的企業,沒有相關限制。
準備開始嗎?
幾分鐘內設定 WhatsApp Coexistence,而非幾個月。應用程式在手機上仍可繼續運作。
開始免費試用免費 3 天。試用結束前不會收取任何費用。