wazionapps

WAzion MCP Server

将 AI 助手连接到 WAzion —— 这是一个 WhatsApp Business 平台，提供 AI 副驾驶、自动化工作流、大规模营销、CRM 等功能。此 MCP 服务提供 240+ 种工具，让任何兼容 MCP 的客户端都能通过自然语言管理 WhatsApp Business 运营。

---

快速开始

方法 1：直接使用 HTTP（推荐——无需安装）

WAzion 的 MCP 端点支持 Streamable HTTP 传输，因此大多数客户端无需安装任何内容即可直接连接。

Claude Code：

claude mcp add --transport http wazion https://www.wazion.com/api/mcp/ \
  --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "wazion": {
      "type": "url",
      "url": "https://www.wazion.com/api/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

方法 2：npm 包（适用于仅支持 stdio 的客户端）

如果你的客户端仅支持 stdio 传输，可使用 npm 包作为桥接：

npx -y @wazion/mcp-server

需要设置 WAZION_API_KEY 环境变量。

---

按客户端设置

Claude Code

claude mcp add --transport http wazion https://www.wazion.com/api/mcp/ \
  --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "wazion": {
      "type": "url",
      "url": "https://www.wazion.com/api/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

ChatGPT

在 ChatGPT 设置中，转到 连接器，添加新的 Streamable HTTP 连接：

• URL： https://www.wazion.com/api/mcp/
• 身份验证： 使用你的 API 密钥作为 Bearer 令牌

Cursor

在项目根目录中创建或编辑 .cursor/mcp.json：

{
  "mcpServers": {
    "wazion": {
      "type": "url",
      "url": "https://www.wazion.com/api/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Windsurf / VS Code

添加到你的 settings.json：

{
  "mcp.servers": {
    "wazion": {
      "type": "url",
      "url": "https://www.wazion.com/api/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

任意仅支持 stdio 的客户端

对于仅支持 stdio 传输（不支持 HTTP）的客户端，请使用 npm 包：

WAZION_API_KEY=your_key npx -y @wazion/mcp-server

或者添加到客户端的配置中：

{
  "mcpServers": {
    "wazion": {
      "command": "npx",
      "args": ["-y", "@wazion/mcp-server"],
      "env": {
        "WAZION_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

---

可用工具

WAzion 提供 244 个工具，分为 24 个类别。以下是主要类别：

类别	工具数量	描述
大规模营销	39	WhatsApp 批量营销活动、联系人列表、发送配置、退订管理和活动统计
WhatsApp 操作	27	会话状态、消息日志、发送消息、工作流执行和连接管理
插件	18	产品问答、网页聊天、文档问答——安装、配置和监控插件
自动化	16	WhatsApp 自动化工作流——创建触发器、条件、AI 回复和定时消息
统计	15	对话指标、响应时间、Agent 表现和使用情况分析
常规设置	13	语言、时区、日期格式、Shopify 集成和业务偏好设置
客户	13	客户信息、备注、标签、搜索、提醒和对话历史
AI 提示词	12	系统提示词、自定义指令、AI 模型设置和回复行为
存储	12	在云存储中上传、列出、删除和管理文件
Agent	11	创建、编辑和管理具有角色和权限的支持 Agent
对话	9	搜索、查看和分析客户对话
活动	8	每日和每周摘要、趋势和运营指标
AI 分析	7	情感分析、对话摘要和 AI 驱动的洞察
高级	6	Webhook、自定义函数（函数调用）和 CRM 端点
智能跟进	6	AI 驱动的购买意向检测和自动跟进消息
任务	6	客户任务和提醒，支持分配负责人和设置截止日期
集成	5	Shopify 连接、外部服务和第三方平台
通知	5	系统通知管理和偏好设置
日历	4	与客户关联的事件和预约安排
知识库	3	上传和管理用于 AI 驱动回答的文档
账户	3	账户详情、账单和订阅信息
推荐	3	推荐计划——生成链接并跟踪佣金
产品	2	产品搜索和查询统计
支持	1	联系 WAzion 支持团队

---

获取 API 密钥

1. 在 wazion.com 注册
2. 扫描二维码以连接你的 WhatsApp 号码
3. 前往设置 > 开发者并复制你的 API 密钥

你的 API 密钥与用于控制面板的令牌相同。它可唯一标识你的商店及其配置。

---

环境变量

变量	必需	描述
WAZION_API_KEY	是	你的 WAzion API 密钥（位于“设置” > “开发者”）
WAZION_API_URL	否	自定义端点 URL（默认值：https://www.wazion.com/api/mcp/）。用于可自托管实例。

---

示例

连接后，你可以向 AI 助手提出如下请求：

发送消息：

“向 +34612345678 发送一条 WhatsApp 消息，内容为：你的订单已发货！”

查看对话：

“显示我今天最近的对话”

创建自动化：

“创建一个工作流，在客户于营业时间外发送消息时自动使用 AI 回复”

启动活动：

“向我的 VIP 列表启动大规模营销活动，发送消息：本周末专享 20% 折扣！”

分析表现：

“总结本周的活动情况——消息、响应时间和情感倾向”

---

确认

会修改数据的操作（删除工作流、移除 Agent、清空列表等）采用两步确认流程：

1. 第一次调用会返回一条警告，说明将执行的操作
2. 第二次调用时传入 confirm: true，即可执行该操作

这样可以避免意外执行破坏性操作。你的 AI 客户端会自动处理此流程。

---

自托管

WAzion 可在你自己的基础设施上自托管。如果你运行的是自托管实例，请设置 WAZION_API_URL 环境变量，使其指向你的服务：

WAZION_API_URL=https://your-instance.example.com/api/mcp/

所有工具在自托管安装中均以相同方式运行。

---

故障排除

“Unauthorized”或 401 错误

• 确认 API 密钥正确（在控制面板的 Settings > Developer 中查看）
• 确保 Authorization: Bearer 标头格式正确
• 检查账户是否处于活动状态

连接超时

• 确保你的网络可以访问 https://www.wazion.com
• 如果使用代理，请相应配置 HTTP 客户端
• 对于 stdio 传输，请检查是否已安装 Node.js >= 18

未显示工具

• 确认 MCP 服务已连接（检查客户端的 MCP 状态）
• 添加配置后，重启 AI 客户端
• 确认 API 密钥未被轮换

WhatsApp 消息发送失败

• 检查 WhatsApp 会话是否已连接（如有需要，请扫描 QR 码）
• 确认账户中有足够的额度
• 确保电话号码包含国家代码（例如，+34612345678）

---

链接

• WAzion 网站
• API 文档
• 开发者集成指南
• GitHub 问题

---

许可证

MIT - 详情请参阅 LICENSE。