安装必备软件

按照README要求安装Go、Python 3.6+、UV包管理器。如果使用Windows，还需按照指南安装MSYS2和C编译器

Windows用户特别注意CGO启用问题，这是常见失败点

安装Anthropic Claude Desktop或Cursor

选择并安装一个支持MCP的AI助手客户端，这是使用该项目的最终界面

Claude Desktop是官方推荐，Cursor是代码编辑器内置AI助手

克隆项目仓库

使用git clone命令将whatsapp-mcp项目下载到本地

确保网络通畅，仓库地址为：https://github.com/lharries/whatsapp-mcp

进入桥接目录并运行

导航到whatsapp-bridge目录，运行Go应用程序。首次运行会生成二维码

确保在正确的目录下执行命令，Windows用户需要设置CGO_ENABLED=1

扫码认证WhatsApp

使用手机WhatsApp扫描终端显示的二维码，完成设备链接

确保手机和电脑在同一网络，二维码有时效性，需尽快扫描

等待初始同步

认证成功后，桥接服务会自动开始同步历史消息到本地SQLite数据库

首次同步可能需要几分钟，取决于消息数量，请耐心等待

创建MCP配置文件

根据README中的JSON模板，创建claudedesktop-config.json或mcp.json配置文件，填入正确的路径

注意{{PATH}}需要替换为实际的项目路径，路径中的反斜杠可能需要转义

放置配置文件到正确目录

将配置文件放到Claude Desktop或Cursor的配置目录中

不同操作系统的配置目录路径不同，请仔细核对README中的路径

重启AI客户端

完全关闭并重新打开Claude Desktop或Cursor，使配置生效

确保之前的进程完全退出，有时需要强制结束任务管理器中的进程

检查集成是否成功

在Claude Desktop中查看是否出现WhatsApp集成，或在Cursor中测试MCP连接

如果没出现，检查桥接服务和MCP服务器是否都在运行，查看终端是否有错误日志

尝试基础搜索

在AI助手界面尝试使用searchcontacts工具搜索联系人，验证数据读取功能

从最简单的查询开始，如搜索一个你知道的常用联系人姓名

测试消息读取

使用listmessages或listchats工具查看最近的聊天记录

如果看不到消息，可能是初始同步未完成，等待几分钟再试

发送文本消息

使用sendmessage工具向一个联系人发送测试消息，验证发送功能

首次发送建议选择一个熟悉的联系人，并说明是测试消息

尝试媒体功能

如果有FFmpeg，尝试使用sendaudiomessage发送语音消息；或使用sendfile发送图片

音频文件需要.ogg格式，或依赖FFmpeg转换。可以先从发送小图片开始

探索其他工具

逐一尝试getchat、getmessagecontext、downloadmedia等其他MCP工具

每个工具都有特定参数，参考项目描述了解各工具用途