如何通过 MCP 将 WATI 连接到 Cursor

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → WATI、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

WATI + Cursor

用你的 AI 管理 WATI 的 WhatsApp Business 收件箱：列出已审核的模板，查找、添加和更新联系人，读取联系人的聊天记录，把会话分配给团队成员，并发送模板消息。会话消息、互动消息和群发在安装时处于关闭状态。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

WATI_API_ENDPOINT, WATI_ACCESS_TOKEN

步骤 1 — 获取凭证

设置大约需要 2 分钟。你需要一个 Growth 或更高套餐的 WATI 工作区，以及它的 API Endpoint 和 Access Token。

1. 登录 WATI，在菜单中打开 API Docs（较新的工作区为 Connector → API）。
2. 按 WATI 显示的原样把 API Endpoint 复制到 WATI_API_ENDPOINT，例如 https://live-mt-server.wati.io/123456，末尾不要加 /api/v1。最后的数字是你的工作区（租户）ID。
3. 把 Access Token 复制到 WATI_ACCESS_TOKEN，不要带上 Bearer 一词：WATI 显示为 Bearer eyJ...，只粘贴从 eyJ 开始的部分。
4. 安装连接器并运行 wati_list_message_templates：它会列出你的 WhatsApp 模板，并确认地址和令牌是匹配的。

仅支持 API v1：连接器使用 WATI 的 API v1。较新的 API v3 不接受 API Docs 页面上的令牌，因此它的附加功能（会话标签和状态、渠道、营销活动、额度）不在本连接器范围内。令牌只发送到你的 API Endpoint，账号密码修改后令牌会失效。

可读取的内容：你的消息模板，包括类别、状态（APPROVED、PENDING、REJECTED）、语言、页眉、带占位符的正文、页脚和按钮；你的联系人，包括 WhatsApp 号码、姓名、订阅授权、群发许可、自定义属性和团队，可按姓名、属性或创建日期筛选；以及与某位联系人的聊天记录，最新的在前，包含送达状态、客服和工单事件。

号码：WhatsApp 号码使用带国家代码的国际格式，不加 + 和空格，例如 8613800138000。工具需要联系人时，也可以传入 WATI 联系人 ID。如果你的工作区有多个 WhatsApp 号码，AI 可以选择使用哪个企业号码。

模板与 24 小时窗口：在客户最后一条消息 24 小时之后，WhatsApp 只允许发送已审核的模板，并且只有状态为 APPROVED 的模板才能发送。在窗口内，可以发送自由文本和回复按钮。Meta 按会话对模板消息收费。

每次修改前都会询问：wati_send_template_message 向一个号码发送一个模板，客户会立即收到；wati_add_contact 添加带姓名和自定义属性的联系人；wati_update_contact_attributes 设置订单状态、线索阶段等属性，未指定的属性保持不变。每次执行前，AI 都会展示号码、模板和取值或具体改动，等你同意后再执行。wati_assign_operator 按邮箱把聊天转给团队成员，或交回机器人，只改动共享收件箱。

安装时关闭：wati_send_session_message（在开放的 24 小时会话中发送自由文本）、wati_send_interactive_buttons（最多带三个回复按钮的消息）和 wati_send_template_broadcast（每次调用把一个模板发给最多 1,000 个号码，每位收件人都会收到消息并产生费用）。它们会直接触达客户，因此需要管理员有意识地开启，即便开启后，AI 也会在每次发送前与你确认。

限制：联系人和消息约为每 10 秒 10 次请求，模板发送根据套餐为每 10 秒 30 到 100 次。出现 429 时，等几秒再试。

常见错误：401 表示令牌错误、已过期，或仍以 Bearer 开头。403 表示令牌或你的套餐不允许此调用。404 通常表示 API Endpoint 填错了。WATI 对部分失败也会返回 HTTP 200 和 result false，例如号码无效或模板未通过审核：连接器会把它们转换为带有 WATI 原文的错误。从未与你聊过天的联系人没有聊天记录（Can't find Conversation）。发送成功表示 WATI 已接受消息，并不代表已经送达。

该连接器不使用 API v3，不创建或删除模板，不安排营销活动或 CSV 群发，不发送媒体、文件、列表或 CTA 消息，不搭建聊天机器人或客户分群，不设置 Webhook，不处理 WhatsApp Pay，也不轮换令牌。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Cursor 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目：

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 Cursor。
3. 打开 Cursor → Settings → MCP，确认 anythingmcp 已列出并处于已连接状态。
4. 开始对话，智能体现在可以调用 WATI 的工具。

可用工具

示例提示

• “找到联系人陈静，给我看她最近和我们的 WhatsApp 消息。”
• “我们已审核的模板里，哪些适合发货通知？它们需要填哪些值？”
• “用 order_shipped 模板给 8613800138000 发消息，姓名填 张伟，订单号填 4512。发送前把全部内容给我看。”
• “把 8613912345678 的 lead_stage 设为 qualified，并把聊天分配给 [email protected]。”
• “列出今天新建、城市为上海的联系人。”

FAQ

Cursor 免费套餐支持自定义 MCP 服务器吗？ 支持，Hobby、Pro 和 Business 套餐均可使用 MCP。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT