给 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 的接入流程使用自己的弹出窗口和二维码扫描。如果您希望由助手把链接交给您,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 则在号码连接的那一刻将其指向您的系统。两者结合,智能体就能从头到尾完成客户接入,无需任何人打开控制台。
一个账户可以容纳您需要的任意数量的号码,每个号码单独计费,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 天。试用结束前不会收取任何费用。