登录开始免费试用
Meta Tech Provider

给 AI 助手一个真正的 WhatsApp 号码。

MCP 服务器让 Claude、ChatGPT 或 Cursor 直接使用 WhatsApp:列出您的号码、检查连接状态、发送消息和消息模板,并将 Webhook 指向您自己的系统。我们的服务器运行在 Meta 官方的 Cloud API 上,因此客户一直联系的号码绝不会面临风险。

开始免费试用免费 3 天。试用结束前不会收取任何费用。
添加连接器
{
  "mcpServers": {
    "easycoexistence": {
      "url": "https://easycoexistence.com/api/mcp"
    }
  }
}
通过 OAuth 登录无需安装账户中的每个号码
默认不储存消息Business 应用 + Cloud API为 Claude 和 ChatGPT 提供 MCP2 分钟即可开始使用

连接器实际连接到哪里

一台通过 OAuth 访问的远程服务器,为一个仍在 WhatsApp Business 应用中正常使用的号码调用 Meta 有文档说明的 Cloud API。任何地方都不保留会话,您的电脑上也不运行任何程序。

  1. 1
    您的助手Claude、ChatGPT、Cursor 或 Claude Code,通过 MCP 连接
  2. 2
    easycoexistence.com/api/mcp远程运行,通过 OAuth 授权。无需在任何地方粘贴密钥
  3. 3
    Meta Cloud API有文档说明的 Graph 端点,使用该账户自己的访问令牌
  4. 4
    企业号码通过 Coexistence 连接,手机上的应用照常使用

大多数 WhatsApp 自动化走的是另一条路:以关联设备身份登录,然后操控 WhatsApp Web 会话。这违反 WhatsApp 的条款,而 Meta 是根据流量的特征而不是发送流量的代码来识别它的,所以“防封号”承诺描述的是供应商无法控制的事情。这里没有任何功能使用这种机制。

如何安装

一个远程端点,账户中的每个号码都使用同一个。无需安装软件包,也无需生成密钥:每个客户端在第一次调用工具时通过 OAuth 登录。

Claude设置 → 连接器 → 添加自定义连接器
  1. 打开设置,进入连接器。
  2. 选择添加自定义连接器,粘贴下方的端点。
  3. 保存后,让 Claude 列出您的号码。第一次会打开登录页面。
连接器 URL
https://easycoexistence.com/api/mcp
ChatGPT设置 → 连接器 → 高级 → 开发者模式
  1. 打开设置,进入连接器,再进入高级,然后开启开发者模式。
  2. 使用下方的端点添加一个连接器。
  3. 开始一个对话,让它列出您的号码,以触发登录。
连接器 URL
https://easycoexistence.com/api/mcp
Claude Code一条命令,每台电脑执行一次
  1. 在任意终端中运行下方的命令。
  2. 在 Claude Code 中运行 /mcp 并完成身份验证。
  3. 此后,每个会话都可以使用这些工具。
终端
claude mcp add --transport http easycoexistence --scope user https://easycoexistence.com/api/mcp
Cursor设置 → MCP,或 ~/.cursor/mcp.json
  1. 打开设置,找到 MCP 部分。
  2. 使用下方的配置添加一个服务器。
  3. 重新加载,然后让 Cursor 列出您的号码。
mcp.json
{
  "mcpServers": {
    "easycoexistence": {
      "url": "https://easycoexistence.com/api/mcp"
    }
  }
}

连接号码是单独的一次性步骤,需要使用浏览器,因为 Meta 的接入流程使用自己的弹出窗口和二维码扫描。如果您希望由助手把链接交给您,get_connect_link 会返回这个链接。

由工具强制执行的规则,让助手不必吃亏才学会

自由文本只能在 24 小时内发送

当收件人在过去 24 小时内给该号码发过消息时,send_message 才能使用。这些回复是免费的。超出这个时间,只有使用已批准模板的 send_template 能够送达,工具说明中写明了这一点,因此助手无需提醒就会选择正确的工具。

在 Coexistence 下,模板只能通过 API 发送

在 Coexistence 号码上,手机应用无法发送模板。任何定时、交易类或窗口之外的消息都必须通过 API 发送,这也是很多人连接号码的主要原因之一。

Meta 将营销消息费用计入您自己的账户

营销消息由 Meta 向 WhatsApp Business 账户上的付款方式收费,该付款方式在 WhatsApp Manager 中设置。费用从不经过我们,我们也无法通过 API 添加银行卡。

Webhook 目标地址必须完成 Meta 的握手

必须使用 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 格式),让助手依据我们的文档回答,而不是猜测。
Partner API让您自己的客户直接在您的软件中连接号码
  • 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_numbers
  • get_number_health
  • get_template_status
  • list_templates
  • get_connect_link
  • get_docs
  • get_partner_setup
  • create_api_key
  • revoke_api_key
  • set_partner_events_url
受限
  • send_message
  • send_template
  • create_template
  • set_webhook_destination
  • get_api_credentials
  • create_connect_link

如果一个账户看不到自己为何被封锁,或无法检查号码是否正常,那么除了提交支持工单之外别无出路。连接状态监控本身也依赖这两项读取功能。

如果您为其他企业提供服务,这一对工具最重要

get_connect_link 返回客户用来接入自己号码的链接,set_webhook_destination 则在号码连接的那一刻将其指向您的系统。两者结合,智能体就能从头到尾完成客户接入,无需任何人打开控制台。

一个账户可以容纳您需要的任意数量的号码,每个号码单独计费,list_numbers 会返回所有号码及其 connection_id,供其他每个工具使用。

30+ tools

读取、发送、模板、配置、文档和 Partner API 工具,全部列在下方。

20 msg/s

Coexistence 号码的固定发送吞吐量由 Meta 设定。我们和您都无法提高。

24 hours

客户回复后会话保持开放的时长。超出时长后,只能发送获批准的模板。

0 installs

服务器在远端运行,因此您的设备无需运行任何程序,也不会在任何地方保留会话。

常见问题

客户的号码会因此被封禁吗?

不会。这是 Meta 的官方 Cloud API,通过 Meta 自有的 Coexistence 功能访问。人们所说的封禁风险来自非官方网关,它们以绑定设备登录,机制完全不同。

连接器支持哪些助手?

任何通过 HTTP 和 OAuth 支持 MCP 的助手都可以使用:Claude、ChatGPT、Cursor、Claude Code 和 Codex 目前均可。它是一个远程端点,因此您的设备无需运行任何程序。

我的对话会经过你们的服务器吗?

默认不会。传入消息会从 Meta 直接路由到您指定的 Webhook,我们不会存储对话内容。我们只保留运行和监控连接所需的账户、号码状态和凭据,不保存其他内容。

一个连接器可以用于多个客户吗?

可以。一个账户可以按需保存任意数量的号码,每个号码单独计为一个连接,连接器会列出所有号码。您可以将它用于所服务的企业,没有此项限制。

准备开始了吗?

几分钟即可设置 WhatsApp Coexistence,而不是几个月。应用会继续在手机上运行。

开始免费试用免费 3 天。试用结束前不会收取任何费用。

继续阅读

参考MCP 还是 Webhook:您真正需要哪一个MCP 是请求与响应:有人提出要求时,助手才会调用工具。Webhook 则相反,Meta 传送事件后,由您的系统决定如何处理。任何需要自动响应的流程,都不能只靠 MCP 构建。参考MCP 工具参考该连接器覆盖账户中的每个连接,共提供 30 多个工具。WhatsApp 先用 list_numbers,其工具使用它返回的 connection_id;其他渠道先用 list_social_accounts,其工具使用 account_id。付款逾期时有 6 个工具会受限:4 个会影响外部系统的 WhatsApp 工具、返回访问令牌的 get_api_credentials,以及 create_connect_link。其余工具仍可使用。指南WhatsApp Coexistence:同一号码使用应用和 APICoexistence 是 Meta 的官方模式,让 WhatsApp Business 应用和 Cloud API 同时使用同一号码。团队仍可通过手机回复,保留相同的对话和历史记录,同时由软件在同一号码上发送和接收消息。无需迁移,也无需更换号码。集成通过官方 Cloud API 将 WhatsApp 连接到 n8n将 Webhook 目标指向 n8n Webhook 节点后,发送到该号码的每条消息都会触发工作流。回复可通过 Cloud API 发送,也可通过我们的 MCP server 发送。n8n 的 MCP Client Tool 支持 OAuth2,因此能够连接。整个过程中,手机仍可正常使用。集成使用自定义连接器将 WhatsApp 连接到 Claude在 Claude 中添加 https://easycoexistence.com/api/mcp 作为自定义连接器,然后登录。之后,Claude 可以列出您的号码、检查连接状态、发送消息和模板,并将 Webhook 指向您自己的系统。所有操作都基于 Meta 的官方 Cloud API,而不是已连接设备会话。