任何 MCP 客戶端中的 WhatsApp:Gemini CLI、VS Code、Cursor、Devin Desktop(Windsurf)等
任何支援以 OAuth 透過 Streamable HTTP 連接遠端伺服器的 MCP 客戶端,都可以用於 WhatsApp Business 號碼:加入伺服器的 URL,在瀏覽器登入一次,WhatsApp 工具便會出現。兩者的分別只在設定。Cursor 和 Zed 使用 url,Gemini CLI 使用 httpUrl,Antigravity 使用 serverUrl,而 VS Code 和 Cline 需要把傳輸方式設為 HTTP。
easyCoexistence 運行一個遠端 MCP 伺服器 https://easycoexistence.com/api/mcp,採 OAuth 登入,並為您透過 Coexistence 連接的 WhatsApp Business 號碼提供超過 30 個工具:健康狀況、訊息、訊息範本、路由及自動化,任何支援 Streamable HTTP 的客戶端均可使用。
Gemini CLI 的設定鍵:Streamable HTTP 伺服器應使用 httpUrl;此處的 url 表示 SSE 端點。
Antigravity 用於遠端伺服器的鍵;url 亦可運作,但不支援 httpUrl 與舊版 SSE 傳輸。
Gemini CLI 已由 Antigravity CLI 取代,適用於免費層級及 Google One 用戶。
Cline 中遠端伺服器應設定的類型;若省略,Cline 預設使用舊版 SSE 傳輸。
Windsurf 的新名稱;其常見問題表明,改變的只是名稱與品牌形象。
easyCoexistence 的 MCP 伺服器以無狀態模式運行 Streamable HTTP,且不開啟 SSE 串流。
客戶端連接遠端 WhatsApp MCP 伺服器需要什麼?
需要三項,而目前大部分客戶端都具備。第一是 Streamable HTTP,即客戶端向單一 URL 發送 POST 的 MCP 傳輸方式;此處伺服器以無狀態模式運行,不開啟 SSE 串流,因此設為 SSE 的客戶端會失敗。第二是 OAuth 探索:首次呼叫時,伺服器回覆 401 並附上其元數據的位置,客戶端透過動態客戶端註冊完成自我註冊並開啟您的瀏覽器,登入過程採用 PKCE。第三是執行客戶端的電腦上需有瀏覽器。
設定中不需要任何標頭、API 金鑰或權杖。伺服器接受協定版本 2025-06-18、2025-03-26 及 2024-11-05;若客戶端只支援在本機啟動的本地伺服器,便無法連接。
每個客戶端使用哪種設定?
以下各項均已於 2026 年 11 月 11 日對照該客戶端自身的說明文件核實。各客戶端的模式相同:一個名稱加上 URL https://easycoexistence.com/api/mcp,但存放 URL 的鍵名及項目所在位置各有不同,而且在部分客戶端中,鍵名寫錯會靜默失敗。每個項目只需名稱與 URL,不需標頭或權杖:
各設定檔看起來是怎樣的?
以下是將伺服器存放於檔案中的客戶端項目,依其說明文件所示。把適合您客戶端的項目貼到上方所列的檔案中,並與既有伺服器合併,然後重新載入客戶端,並完成其開啟的登入。若客戶端亦提供指令或表單,則該途徑會自動寫入相同的項目:
// Cursor: ~/.cursor/mcp.json
{ "mcpServers": { "easycoexistence": { "url": "https://easycoexistence.com/api/mcp" } } }
// VS Code with Copilot: ~/.copilot/mcp-config.json
{ "mcpServers": { "easycoexistence": { "type": "http", "url": "https://easycoexistence.com/api/mcp" } } }
// Gemini CLI: ~/.gemini/settings.json
{ "mcpServers": { "easycoexistence": { "httpUrl": "https://easycoexistence.com/api/mcp" } } }
// Antigravity: ~/.gemini/config/mcp_config.json
{ "mcpServers": { "easycoexistence": { "serverUrl": "https://easycoexistence.com/api/mcp" } } }
// Zed: settings.json
{ "context_servers": { "easycoexistence": { "url": "https://easycoexistence.com/api/mcp" } } }
// Cline: cline_mcp_settings.json
{ "mcpServers": { "easycoexistence": { "type": "streamableHttp", "url": "https://easycoexistence.com/api/mcp" } } }如何在 VS Code 中加入?
選取 Copilot 後,執行 Chat: Open Customizations,選擇 MCP Servers,並於 User 群組中選取 Add Server (+);或從命令面板執行 MCP: Add Server,以同一引導流程操作。選擇 HTTP (HTTP or Server-Sent Events),貼上 URL,並輸入 easycoexistence 作為伺服器 ID,然後選擇 Global 與 Copilot Global,以便在該電腦的各個工作區共用個人設定。當 VS Code 提示時完成授權。
Microsoft 的參考資料指出,較舊的 .vscode/mcp.json 檔案(其中的 servers 鍵)屬已棄用的編輯器管理格式,並建議新設定改用 Copilot 檔案。工作區根目錄的 .mcp.json 可與團隊成員共用伺服器;由於項目不含任何機密,可安全提交至版本控制。
如何在 Gemini CLI 與 Antigravity 中加入?
在 Gemini CLI 中,執行 gemini mcp add --transport http easycoexistence https://easycoexistence.com/api/mcp -s user。若不加 -s user,伺服器會儲存於專案內的 .gemini/settings.json。然後執行 /mcp auth easycoexistence 以登入;權杖過期時,同一指令可重新登入。Google 指出,Gemini CLI 已於 2026 年 6 月 18 日由 Antigravity CLI 取代,適用於免費層級及 Google One 用戶。
在 Antigravity 中,若要套用於所有專案,請把含 serverUrl 的項目放入 ~/.gemini/config/mcp_config.json;若只用於單一工作區,則放入 .agents/mcp_config.json。在 CLI 中,/mcp 會開啟 MCP Manager 並顯示各伺服器的狀態;在 IDE 中,於代理面板選取 …,然後依序選擇 MCP Servers、Manage MCP Servers 及 View raw config。由於此伺服器支援動態客戶端註冊,無須提供客戶端 ID。
如何在 Zed、Cline 與 Devin 中加入?
在 Zed 中,開啟 Settings > AI > MCP Servers,按 Add Server,然後選擇 Add Remote Server;若項目中沒有 Authorization 標頭,Zed 會執行標準的 MCP OAuth 流程。在 Cline 中,開啟 MCP Servers 圖示,再進入 Remote Servers 分頁,輸入名稱與 URL,選擇 Streamable HTTP,然後按 Add Server;在 Cline CLI 中,執行 cline mcp add easycoexistence 並附上 URL 與 --transport http,然後按精靈中的 Authorize OAuth 操作。
Devin Desktop(即 Windsurf 的新名稱)在 Agents 視窗的 Customize > MCPs 下管理伺服器,並儲存於 ~/.config/devin/mcp_config.json 或專案的 .devin 資料夾中;當已儲存的憑證過期時,伺服器會顯示 Needs authentication,按 Authenticate 即可重新登入。在 Devin CLI 中,執行 devin mcp add easycoexistence 並附上 URL 與 -s user,因預設範圍為本機,然後執行 devin mcp login easycoexistence。
各客戶端的共通之處是什麼?
URL 之後的一切。每個客戶端都登入同一個 easyCoexistence 帳戶,透過 list_numbers 看到相同的號碼,並獲得相同的超過 30 個工具。Meta 的規則同樣適用:自由格式訊息只能發送給過去 24 小時內曾向您發訊息的人,訊息範本只能透過 API 發送,而 Coexistence 號碼每秒最多發送 20 則訊息。所有客戶端中,發送類工具都需要有效的方案,讀取類工具則照常運作。
不同之處在於客戶端自身對工具呼叫的控制,例如 Cursor 預設會在使用 MCP 工具前要求批准。伺服器在客戶端連接時發送其工具清單,且不會通知變更,因此在您的帳戶新增功能後,請重新載入或重新連接客戶端。
設定方法
- Connect your numberSign up at easycoexistence.com and connect the number through Meta's Embedded Signup; the WhatsApp Business app keeps working on the phone.
- Add the serverUse your client's command or form, or paste its entry into the right file, with https://easycoexistence.com/api/mcp as the URL.
- Reload and sign inReload the client, then approve the browser sign-in it opens with your easyCoexistence account.
- Try a requestAsk "Which WhatsApp numbers do I have, and are they healthy?" and check that the client calls list_numbers.
常見錯誤
- 在 Gemini CLI 的 settings.json 中寫入 url。該檔案中的 url 代表 SSE 端點,而本伺服器不開啟該端點;請改用 httpUrl,或執行 gemini mcp add --transport http。
- 在 Cline 項目中省略 type。Cline 會改用舊版 SSE 傳輸,連接即告失敗,因此請將 type 設為 streamableHttp。
- 在 Gemini CLI 或 Devin CLI 中加入伺服器時未指定範圍,結果在另一資料夾找不到。Gemini 預設為專案範圍,Devin 預設為本機範圍;請加上 -s user。
- 在無介面伺服器或 SSH 工作階段中登入。Gemini CLI 的說明文件指出,其 OAuth 流程需要本機瀏覽器及 localhost 回呼,因此請在自己的電腦上完成登入。
應用程式留在您的手機上,每個號碼全天候 24/7 受監察並設有警報。每個已連接號碼每月 US$ 9 起,號碼越多越便宜,最低降至 US$ 0.75;首 3 天免費試用。
常見問題
是否有可安裝的本地版本?
沒有。伺服器僅為遠端運行,因此沒有需要安裝的套件、npx 指令或需要持續運行的程序。關閉客戶端不會影響已連接的號碼。
能否改用標頭中的 API 金鑰,而不登入?
不能。MCP 伺服器只接受 easyCoexistence 自身登入所發出的 OAuth 權杖。由 create_api_key 產生的 ec_live_ 金鑰屬於 Partner API,即供軟件為其客戶連接號碼而使用的 REST API,並不能開啟 MCP 伺服器。
登入可維持多久?
存取權杖有效期為 1 小時,客戶端會透過更新權杖自動續期;每次續期都會發出新的更新權杖,而更新權杖在 60 天未使用後會過期。超過此時段後,客戶端會要求您重新登入。
多個客戶端能否同時使用同一帳戶?
可以。每個客戶端各自登入,因此 Cursor、VS Code 與終端機代理可同時在同一組號碼上運作,移除其中一個不會影響其他客戶端的連接。
繼續閱讀
準備開始嗎?
幾分鐘內設定 WhatsApp Coexistence,而非幾個月。應用程式在手機上仍可繼續運作。
開始免費試用驗證日期