如何用 MCP 把 WhatsApp 连接到 Claude、ChatGPT 和 Cursor

工作原理

Kaption 的 MCP 服务器由三部分组成：

1. 你的 AI 应用（Claude、ChatGPT、Cursor 或其他 MCP 客户端）判断需要 WhatsApp 信息，于是调用一个工具，例如“搜索 Maria 发来的关于发票的消息”。
2. 连接。 在云端模式下，请求会经过 Kaption 位于 mcp.kaptionai.com 的中继，中继会验证你已登录并转发请求。中继无法读取你的消息。在本地模式下，请求始终留在你的电脑上。
3. 你电脑上的 Kaption。 WhatsApp Web 中的 Kaption 扩展或 Kaption 桌面应用，会在你的 WhatsApp 上执行请求，只把结果发回去。

由于最后一步在你自己的电脑上运行，所以只有 Kaption 打开时连接才能工作：也就是在 Chrome 或 Edge 中打开装有扩展的 WhatsApp Web，或者打开桌面应用。

方式一：云端连接（Claude、ChatGPT、Cursor）

适用于任何可以添加远程 MCP 服务器（通常称为“自定义连接器”）并支持 OAuth 登录的 AI 应用。

第 1 步：在电脑上打开 Kaption。 在 Chrome 或 Edge 中打开装有 Kaption 扩展 的 WhatsApp Web，或打开 Kaption 桌面应用。确认你已登录 Kaption。

第 2 步：开启连接。 在扩展中打开 AI 助手（MCP），选择 云端桥接 并点击 启用。在桌面应用中，到“设置”里打开 云端 MCP。在你完成这一步之前，连接一直处于关闭状态。

第 3 步：把服务器添加到你的 AI 应用。 使用以下地址添加远程 MCP 服务器或自定义连接器：

https://mcp.kaptionai.com/mcp

第 4 步：登录。 你的 AI 应用会打开 Kaption 的登录页面。输入你的手机号码，再填写 Kaption 通过 WhatsApp 发给你的 6 位验证码。然后选择 AI 应用保持连接的时长：

• 使用期间保持连接（推荐）：连续 90 天未使用后自动断开。
• 1 年。
• 直到我手动断开。

就这么简单。向你的 AI 应用问一个关于聊天的问题，它就会调用 WhatsApp 工具。

方式二：本地连接（Claude Code、Claude Desktop、Cursor、VS Code）

如果你希望连接只留在自己的电脑上，可以运行 Kaption 的本地 MCP 服务器。它通过 localhost 与扩展通信，需要 Node.js 18 或更高版本。

首先，在 Kaption 扩展的设置中开启 MCP 桥接（或在桌面应用的“设置”中开启 本地 MCP），并保持 WhatsApp Web 打开。

Claude Code： 运行一条命令即可。

claude mcp add whatsapp -- npx -y @kaptionai/mcp-extension@latest

Claude Desktop、Cursor、Windsurf、VS Code 及其他客户端： 把以下内容添加到应用的 MCP 配置文件中。

{
  "mcpServers": {
    "whatsapp": {
      "command": "npx",
      "args": ["-y", "@kaptionai/mcp-extension@latest"]
    }
  }
}

本地服务器可以同时连接多个 WhatsApp 号码，多个 AI 应用也可以共用同一个连接。

你的 AI 助手能做什么

云端服务器的工具按作用对象分组如下：

• 搜索和读取： 搜索消息和聊天，查找联系人和群组，导出联系人，下载聊天中的媒体文件，查看聊天统计。
• 总结： 总结一段对话。摘要仅你自己可见。
• 整理： 归档、置顶、静音聊天，标记为已读或未读；保存草稿；管理列表和提醒。在 WhatsApp Business 账号上还能管理标签和备注。
• 定时发送： 给单个联系人安排一条定时消息，最多 800 个字符，Kaption 会在你设定的时间发送。

它做不到的事

• 立即发送消息。 没有“立即发送”工具。AI 可以为你保存一份草稿，或在你要求时给单个联系人安排定时消息。
• 查看已锁定的聊天。 你在 WhatsApp 中锁定的聊天始终是隐藏的。
• 在 Kaption 关闭时工作。 如果装有扩展的 WhatsApp Web 或桌面应用没有打开，工具会返回错误，提示你先打开它。
• 群发或发送未经请求的消息。 Kaption 的条款禁止把 MCP 访问用于这类用途，并且会限制访问频率。

好用的提问示例

• “总结一下销售群今天聊了什么。”
• “找出 Maria 上周发给我的地址。”
• “从周五到现在，哪些聊天我还没回复？”
• “明天 9 点提醒我跟进 Carlos。”
• “起草一条回复给 João，确认周四下午 3 点。”

尽量说明具体的聊天或联系人。“搜索我的 WhatsApp”也能用，但“在我和房东的聊天里找押金金额”会更快、更可靠。

隐私与安全

• 默认关闭，随时可撤销。 连接需要你亲自开启，也可以在 Kaption 中关闭，或在 AI 应用中移除该连接器。
• 中继无法读取你的消息。 它只在你的 AI 应用和你电脑上的 Kaption 之间转发请求和结果。源代码公开在 github.com/Kaption-AI/mcp-extension-remote，每次部署都经过签名，并记录在一份公开的哈希链日志中。
• 单一权限范围的 OAuth。 登录使用带 PKCE 的 OAuth 2.1，只有一个权限范围，访问令牌一小时后过期。
• 存储了什么。 提醒和定时消息存储在 Kaption Cloud 中，以便准时触发。你的消息不会被存储。

请注意，你的 AI 应用读取的任何内容，之后都会由该 AI 服务商按照其自身条款处理。只连接那些你本来就放心交给它聊天内容的 AI 应用。

故障排查

提示“Extension not connected”（扩展未连接）。 在 Chrome 或 Edge 中打开装有 Kaption 的 WhatsApp Web（或打开桌面应用），并确认“云端桥接”或“云端 MCP”开关已打开。

AI 应用找不到工具。 检查你添加的地址是否与 https://mcp.kaptionai.com/mcp 完全一致（包括末尾的 /mcp），并确认登录已完成。

本地服务器无法启动。 运行 node --version，确认版本为 18 或更高，然后检查扩展中的“MCP 桥接”是否已开启。

以上内容的概览，请看 Kaption MCP 页面。

常见问题

哪些 AI 应用支持 WhatsApp MCP 服务器？

云端连接支持 Claude、ChatGPT、Cursor，以及任何支持 OAuth 远程服务器的 MCP 客户端。本地服务器支持 Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、Zed，以及其他可运行本地 MCP 服务器的客户端。

Claude 或 ChatGPT 能替我发送 WhatsApp 消息吗？

不能立即发送。在你要求时，它们可以保存草稿，或给单个联系人安排定时消息。不会有任何消息被立即发出。

有官方的 WhatsApp MCP 服务器吗？

WhatsApp 没有发布官方的 MCP 服务器。Kaption 的服务器通过你自己电脑上的 WhatsApp Web 工作。Kaption 与 WhatsApp 或 Meta 没有任何关联。

支持 WhatsApp Business 吗？

支持。WhatsApp Business 账号还能使用标签和备注工具。

如何断开 AI 应用？

在 Kaption 中关闭连接，或在你的 AI 应用中移除该连接器。如果你选择的是“使用期间保持连接”，连续 90 天未使用后连接也会自动结束。

需要付费吗？

MCP 访问权限取决于你的 Kaption 套餐。扩展中会显示你的套餐包含哪些功能。