WAzion MCP Server 用于把 AI 助手连接到 WAzion——一个具备 AI 副驾驶、自动化工作流、批量营销、CRM 等能力的 WhatsApp Business 平台。该 MCP 服务器暴露 240 多个工具，使任何兼容 MCP 的客户端都能通过自然语言管理 WhatsApp 商业运营，实现智能副驾驶、24/7 自动化和批量营销。本工具基于 MIT 许可证发布，具体许可细节见仓库中的 LICENSE 文件。
连接方式 该服务提供两种接入方式。方法一：直接 HTTP（推荐，无需安装）。WAzion 的 MCP 端点支持 Streamable HTTP 传输，因此大多数客户端可直接连接，无需安装任何内容。方法二：npm 包（适用于仅支持 stdio 的客户端）。如果客户端只支持 stdio 传输，可使用 npm 包作为桥接，需设置 WAZION_API_KEY 环境变量。
各客户端配置 Claude Desktop：添加到 claude_desktop_config.json。 ChatGPT：在设置中进入 Connectors，添加新的 Streamable HTTP 连接，URL 为 https://www.wazion.com/api/mcp/，身份验证使用 Bearer token 加 API 密钥。 Cursor：在项目根目录创建或编辑 .cursor/mcp.json。 Windsurf / VS Code：添加到 settings.json。 仅支持 stdio 的客户端：使用 npm 包，或在客户端配置中设置。
可用工具 WAzion 在 24 个类别中暴露 244 个工具，主要类别如上所述（资料未逐一列出具体工具名称）。
获取 API 密钥
- 在 wazion.com 注册；2. 扫描二维码连接你的 WhatsApp 号码；3. 前往 Settings > Developer 复制 API 密钥。该 API 密钥与仪表盘使用的令牌相同，它唯一标识你的店铺及其配置。
环境变量 需要设置 WAZION_API_KEY 环境变量。如果运行自托管实例，设置 WAZION_API_URL 环境变量指向你的服务器，所有工具在自托管安装中行为一致。
自然语言使用示例 连接后，你可以这样向 AI 助手发出指令：发送消息（“向 +34612345678 发送 WhatsApp 消息：您的订单已发货！”）；查看对话（“显示我今天的最近对话”）；创建自动化（“创建一个工作流，当客户在非工作时间发送消息时用 AI 自动回复”）；运行营销活动（“向我的 VIP 列表发起批量营销活动，消息为：本周末专属 20% 折扣！”）；分析表现（“给我一份本周活动总结——消息、响应时间和情绪”）。
数据修改的两步确认 修改数据的操作（删除工作流、移除代理、清空列表等）采用两步确认流程：第一次调用返回描述将要发生什么的警告；第二次调用带上 confirm: true 才执行操作。这可以防止意外的破坏性操作。你的 AI 客户端会自动处理这一流程。
故障排除 “Unauthorized”或 401 错误：验证 API 密钥正确（仪表盘的 Settings > Developer）；确保 Authorization: Bearer 头格式正确；检查账户处于活动状态。 连接超时：确保网络可访问 https://www.wazion.com；如处于代理后，相应配置 HTTP 客户端；对于 stdio 传输，检查是否安装了 Node.js >= 18。 工具未显示：确认 MCP 服务器已连接（检查客户端的 MCP 状态）；添加配置后重启 AI 客户端；验证 API 密钥未被轮换。 WhatsApp 消息未发送：检查 WhatsApp 会话已连接（如需请扫描二维码）；验证账户中有足够积分；确保电话号码包含国家代码（如 +34612345678）。
API 文档 开发者集成指南（Developer Integration Guide），具体内容暂未提供。
