WhatsApp Business API by Wassenger

面向官方 WhatsApp Business API 的 WhatsApp MCP 服务

这是一个托管的 Model Context Protocol 服务，让 Claude、Cursor、VS Code、OpenAI API 和任何其他 MCP 客户端都能通过官方 WhatsApp Business API 使用 WhatsApp：发送和读取消息、使用已获批准的模板回复、开展营销活动、管理联系人并使用共享团队收件箱。

该服务由 Wassenger 运营。无需安装任何内容： 只需将客户端指向 https://api.wassenger.com/mcp，并在 Authorization 标头中发送 Wassenger API 密钥。 Claude 和 ChatGPT 网页版没有可填写标头的字段，因此需要将密钥放在地址中。

Remote URL:  https://api.wassenger.com/mcp
Transport:   Streamable HTTP
Auth:        Authorization: Bearer <WASSENGER_API_KEY>
             or https://api.wassenger.com/mcp?key=<WASSENGER_API_KEY> for clients without headers

Business API 还是个人账号？

WhatsApp MCP 服务有两种，各自解决不同的问题。

	本服务（Wassenger）	个人账号服务，例如 lharries/whatsapp-mcp
连接方式	官方 WhatsApp Business API（Meta Cloud API）	将个人账号关联为 WhatsApp Web 设备
设置	托管服务。添加 URL 和 API 密钥	在本地运行 Go bridge 和 Python 服务，然后扫描 QR 码
超出 24 小时窗口的消息	可以，需使用已获批准的模板	不支持模板
多人共用一个号码	共享收件箱、聊天分配、部门、标签	单个用户
营销活动和批量发送	支持，由发送队列控制发送节奏	不支持
消息存储位置	你的 Wassenger 账号	你电脑上的 SQLite 数据库
WhatsApp 的条款	使用 Meta 为企业提供的 API	WhatsApp 的服务条款不允许使用非官方客户端，因此号码可能会受限
费用	Wassenger 订阅费用；模板消息由 Meta 直接计费	免费且开源

如果你只想让 Claude 读取和搜索自己的个人聊天记录，个人账号服务更简单。如果你的企业通过 WhatsApp 与客户沟通，请使用 Business API。

快速开始

1. 创建 Wassenger 账号并关联你的 WhatsApp Business 号码。
2. 从 app.wassenger.com/apikeys 复制 API 密钥。
3. 使用以下任一配置将服务添加到客户端。
4. 询问：“我连接了哪些 WhatsApp 号码？”，检查是否正常运行。

连接客户端

Claude（网页版和桌面应用）

打开 Customize → Connectors，点击 +，选择 Add custom connector，为其命名，然后粘贴包含密钥的地址：

https://api.wassenger.com/mcp?key=YOUR_WASSENGER_API_KEY

点击 Add。在聊天中打开 + 菜单，选择 Connectors 并将其开启。Team 和 Enterprise 套餐只有所有者可以添加自定义连接器，所有使用该连接器的人共用同一个密钥。

ChatGPT（网页版）

在 OpenAI 启用了开发者模式的套餐中，ChatGPT 可以从网页版访问自定义 MCP 服务；工作区管理员还必须先启用此功能。前往 Apps → Create，粘贴相同的地址，选择 No authentication，点击 Scan tools，然后点击 Create。选择 OAuth 会失败，因为此服务不会发布 OAuth 元数据。

Claude Code

claude mcp add --transport http wassenger https://api.wassenger.com/mcp \
  --header "Authorization: Bearer YOUR_WASSENGER_API_KEY"

仅运行本地服务的客户端

有些客户端只会启动本地进程，例如通过 claude_desktop_config.json 配置的 Claude Desktop。请使用此代码库中的 npm bridge（mcp-wassenger）：它会连接到托管服务，并在 Authorization 标头中发送你的密钥。

{
  "mcpServers": {
    "wassenger": {
      "command": "npx",
      "args": ["-y", "mcp-wassenger", "YOUR_WASSENGER_API_KEY"]
    }
  }
}

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "wassenger": {
      "url": "https://api.wassenger.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_WASSENGER_API_KEY" }
    }
  }
}

VS Code

.vscode/mcp.json。VS Code 会在首次使用时询问密钥，并将其安全存储：

{
  "inputs": [
    { "type": "promptString", "id": "wassenger-key", "description": "Wassenger API key", "password": true }
  ],
  "servers": {
    "wassenger": {
      "type": "http",
      "url": "https://api.wassenger.com/mcp",
      "headers": { "Authorization": "Bearer ${input:wassenger-key}" }
    }
  }
}

OpenAI API（Responses API 和 Agents SDK）

import OpenAI from 'openai'

const openai = new OpenAI()

const response = await openai.responses.create({
  model: 'gpt-6.1-sol',
  input: 'Summarize the unread WhatsApp chats from today',
  tools: [{
    type: 'mcp',
    server_label: 'wassenger',
    server_url: 'https://api.wassenger.com/mcp',
    headers: { Authorization: `Bearer ${process.env.WASSENGER_API_KEY}` },
    require_approval: 'always'
  }]
})

其他客户端

使用支持 Streamable HTTP 的远程 URL 和 Authorization 标头。如果客户端没有用于填写标头的字段，请使用 ?key= 地址；如果客户端只能运行本地服务，请使用 npm 桥接程序：npx -y mcp-wassenger YOUR_WASSENGER_API_KEY。

可以询问什么

• “显示今天的未读聊天，并为每个聊天拟一条回复。”
• “将所有提到 ‘invoice’ 的聊天分配给账单部门。”
• “向 +1 555 555 0100 发送 order_shipped 模板，并附上跟踪号码 1Z999。”
• “本周哪些客户询问了价格却没有得到回复？”
• “使用 spring_offer 模板，为标记为 ‘VIP’ 的联系人创建营销活动。”
• “将 Acme 的交易移至 ‘Proposal sent’，并添加一条包含今天通话摘要的备注。”
• “导入前检查这 20 个号码是否注册了 WhatsApp。”
• “本周我们开启、解决了多少个聊天，又留下了多少个待处理聊天？”

工具

工具超过 50 个，按用途分组：

类别	工具用途
消息	发送文本、媒体、位置、联系人信息和定时消息；回复、回应和转发
模板	列出、创建和删除模板；在 24 小时窗口之外发送已批准的模板
聊天	按状态、标签、Agent、日期或未读状态搜索和筛选聊天；查看消息历史记录；导出聊天；查看聊天统计数据
联系人和标签	创建、搜索、更新和导入联系人；创建和应用标签
团队收件箱	管理 Agent 和部门；将聊天交给队友或部门，解决或重新开启聊天，添加内部备注，将聊天标记为已读或未读
营销活动	创建、启动和停止营销活动并管理收件人；监控发送队列
销售管道	创建管道和阶段，跟踪交易，为交易添加备注和任务
WhatsApp Flows	列出流程、发送流程并读取其回复
文件	从 URL 上传文件，搜索已发送和已接收的文件，下载媒体
号码和设备	列出已连接的号码及其状态；检查电话号码是否注册了 WhatsApp

群组、频道和状态更新仅适用于通过 QR 码连接的号码，因为官方 Business API 不提供这些功能。

安全

• 只要客户端有用于填写标头的字段，就应使用 Authorization 标头。地址中的密钥（?key=）会出现在访问日志、代理日志、错误报告和浏览器历史记录中，因此应视为已泄露：对于网页版 Claude 和 ChatGPT，请创建一个仅用于这些服务的密钥；如果地址泄露，请撤销该密钥。
• 使用此服务的 Agent 可以读取客户消息，并以你的名义发送消息。请将不可信的消息内容视为不可信输入：对于发送或删除内容的工具，请保持审批开启，如上面的 OpenAI 示例所示。
• 可随时在 app.wassenger.com/apikeys 撤销密钥。

常见问题

有没有可与 Claude 配合使用的 WhatsApp MCP 服务？ 有。它基于官方 WhatsApp Business API，可在网页版和桌面应用版 Claude 中作为自定义连接器使用，也可在 Claude Code 和任何 MCP 客户端中使用。只需提供一个 URL 和一个 API 密钥即可完成设置。

如何将 WhatsApp 连接到 Claude 或 ChatGPT，作为 AI Agent 使用？ 先将你的号码连接到 Wassenger，然后添加此服务：在 Claude 中将其设为自定义连接器，在 ChatGPT 的开发者模式中将其设为应用，或者按照上述配置，将其设为基于 OpenAI API 构建的 Agent 中的 MCP 工具。随后，Agent 就可以读取聊天内容、回复、发送模板消息，并将对话转交给团队成员。

我需要一直开着手机或电脑吗？ 不需要。使用 Business API 的号码运行在 Meta 的云端，MCP 服务也托管在云端。

它能给过去 24 小时内没有发过消息的客户发送消息吗？ 可以，但必须使用经 Meta 批准的模板。只有在客户上次发消息后的 24 小时内，才允许发送自由格式消息；这是适用于所有服务提供商的 WhatsApp 规则。

它免费吗？ 托管服务包含在你的 Wassenger 账户中，此仓库中的 npm 桥接程序则基于 MIT 许可证开源。你需要拥有一个已连接号码的 Wassenger 账户：请参阅定价。模板消息费用由 Meta 直接收取。

链接

• Wassenger · 定价 · API 文档
• 将 WhatsApp 连接到 Claude：分步指南
• 模型上下文协议

许可证

MIT