任意 MCP 客户端中的 WhatsApp:Gemini CLI、VS Code、Cursor、Devin Desktop(Windsurf)等
任何支持基于 Streamable HTTP 远程服务器并采用 OAuth 的 MCP 客户端,都可以接入 WhatsApp Business 号码:添加服务器的 URL,在浏览器中登录一次,WhatsApp 工具即会出现。不同之处仅在于配置。Cursor 和 Zed 使用 url 字段,Gemini CLI 使用 httpUrl,Antigravity 使用 serverUrl,VS Code 和 Cline 需要将 transport 设为 HTTP。
easyCoexistence 运行一个远程 MCP 服务器 https://easycoexistence.com/api/mcp,提供 OAuth 登录和 30 多个工具,服务于您通过 Coexistence 连接的 WhatsApp Business 号码:连接健康状况、消息、模板、路由和自动化,适用于任何支持 Streamable HTTP 的客户端。
Gemini CLI 中用于 Streamable HTTP 服务器的设置键;这里的 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 是 MCP 传输方式,客户端向单一 URL 发送 POST 请求;此处的服务器以无状态模式运行,不开启 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,将服务器 ID 填为 easycoexistence,然后选择 Global 和 Copilot Global,以便在该机器的所有工作区中共享个人设置。VS Code 提示时,完成授权。
微软的参考文档称,旧的 .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,因为默认作用域为 local,然后运行 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 端点,而本服务器不开启 SSE;请使用 httpUrl,或运行 gemini mcp add --transport http。
- 在 Cline 条目中省略 type。Cline 随后会使用旧版 SSE 传输,连接失败,因此请将 type 设为 streamableHttp。
- 在 Gemini CLI 或 Devin CLI 中添加服务器时未指定作用域,结果在另一个文件夹中找不到它。Gemini 默认为项目作用域,Devin 默认为 local;请传入 -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,而不是几个月。应用会继续在手机上运行。
开始免费试用验证时间