---
title: "如何用 MCP 把 WhatsApp 连接到 Claude、ChatGPT 和 Cursor"
description: "配置 WhatsApp MCP 服务器，让 Claude、ChatGPT、Cursor 或 Claude Code 搜索聊天、总结对话、设置提醒：云端地址或本地 npx，分步教程。"
canonical: "https://kaptionai.com/blog/zh/whatsapp-lianjie-claude-chatgpt-mcp/"
lang: "zh"
---

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

> 配置 WhatsApp MCP 服务器，让 Claude、ChatGPT、Cursor 或 Claude Code 搜索聊天、总结对话、设置提醒：云端地址或本地 npx，分步教程。

Canonical: https://kaptionai.com/blog/zh/whatsapp-lianjie-claude-chatgpt-mcp/

AI 助手很擅长读完长长的对话、找出你要的那个细节，再帮你起草回复。而很多这样的对话，都在 WhatsApp 里。模型上下文协议（MCP）是连接两者的标准方式：MCP 服务器提供一组工具，任何兼容 MCP 的 AI 应用都可以在你提出请求时调用它们。

本文介绍如何借助 Kaption 的 MCP 服务器，把 WhatsApp 连接到 Claude、ChatGPT、Cursor、Claude Code 和其他 MCP 客户端。内容包括两种连接方式、连接后 AI 能做和不能做什么，以及如何关闭连接。

*2026 年 9 月更新*

## 工作原理

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 扩展](/zh/) 的 WhatsApp Web，或打开 [Kaption 桌面应用](/zh/desktop/)。确认你已登录 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 配置文件中。

```json
{
  "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](https://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 页面](/zh/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 套餐。扩展中会显示你的套餐包含哪些功能。