【用途】 Gambot MCP 把官方 WhatsApp Business（Cloud）API 封装为面向 AI 智能体的 Model Context Protocol（MCP）服务器和 REST API，让 Claude、Cursor、Codex、Gemini CLI、VS Code/Copilot、Windsurf 等 AI 客户端可以发送 WhatsApp 消息和模板，并管理 CRM、线索与营销活动。官方资料说明，Gambot 是 Meta 授权的 Business Solution Provider（BSP），使用官方 API，而非 WhatsApp Web 自动化，因此不需要二维码、关联个人会话或无头浏览器，支持真实商业账号、已批准模板和 Meta 支持的投递。
【主要能力】
- 发送 WhatsApp 消息与已批准模板；提供发送消息、发送模板、接收 webhook、投递状态的可运行示例（Node/TypeScript、Python、Next.js、Laravel/PHP）。
- CRM 相关管理：联系人、线索、案例、任务、报价、发票、订单和营销活动。
- 机器人（bots）与自动化：会话机器人通常由共享 sourceFlowId 的一组 botomations 组成，按顺序包括主机器人（menu / ai / combined 三种形态）、激活器（activator）和人工介入取消（human_intervention_cancel）。
- 智能体行为支持：结构化错误包含 error_code、reason、can_recover、recommended_action、required_tool、relevant_contact、template_required 等字段；内置 24 小时客服窗口和模板指引；提供统一入口工具 gambot_setup_whatsapp_integration。
- 工具标注：读取类工具标记为只读/幂等；delete_*、disable_user、issue_invoice 标记为破坏性；所有工具均为 openWorld。
- 账号创建：无需 API key，智能体可自行创建 Gambot 账号；唯一人工步骤是在浏览器中完成 Meta WhatsApp 连接。
【使用方式】 本地运行：npx -y gambot-mcp（无需克隆或构建，MCP 客户端按需通过 npx 运行）。托管服务器：https://gambot-mcp.azurewebsites.net/mcp（Streamable HTTP，OAuth 2.0 或令牌）。不需要令牌即可开始：未设置 GAMBOT_TOKEN 时，服务器以引导模式运行并创建账号。已有账号可使用 Gambot Token（gmbt_…，位于 Settings → General）作为 GAMBOT_TOKEN（本地）或 Authorization: Bearer gmbt_…（托管/REST）。官方提示令牌是机密，切勿粘贴到聊天中，也不要放入源码管理。可用环境变量 GAMBOT_API_BASE 覆盖基础 URL（默认 https://api.gambot.co.il/api/v1）。
【适用场景】 适合需要将官方 WhatsApp 商务能力接入 AI 智能体的开发者与团队，例如：向客户发送订单发货通知；用模板向带标签的联系人批量发促销；查询当日消息量与待回复数量；汇总客服对话；定时营销活动；构建线索机器人（当广告带来线索时发送带按钮的欢迎模板，并在人工介入时停止）。
【限制与说明】 官方资料未提供具体收费、价格或平台可用性信息，暂未提供。MCP 是对 Gambot 公共 REST API 的 AI 接口，与 REST API 使用相同业务逻辑，并非独立后端。AI/combined 类型的 Gambot AI 机器人需在 Bot Builder 应用中构建，因为需要 Gambot AI 配置。遇到 CONVERSATION_WINDOW_CLOSED / TEMPLATE_REQUIRED 需改用模板发送；MISSING_TEMPLATE_VARIABLES 需先获取模板变量；CONTACT_NOT_FOUND 需先查询联系人，不应猜测收件人；遇到速率限制应退避，批量发送应使用营销活动。已列出支持的客户端及对应设置指南（Cursor、Claude、ChatGPT、Gemini）。
