MCP — 程序接口

除 REST 外，GetMyBot 还提供 MCP（Model Context Protocol）接口——专为 AI 智能体和助手设计，它们通过调用工具而非手动请求端点来完成操作。REST 仍是主要接口；MCP 是智能体场景下更便捷的替代方案。以下工具、资源和提示词的名称与服务器发布的完全一致。

地址与授权

MCP 通过端点 /mcp 提供（传输方式：Streamable HTTP，方法 POST）。授权方式与 REST 相同——使用同一个个人令牌：请求头 Authorization: Bearer mbp_…。无需单独创建令牌——一个 PAT 同时适用于 REST 和 MCP。每个工具所需的 scope 与对应的 REST 端点相同；scope 为 * 的令牌拥有完整访问权限。scope 不足时调用会被拒绝（fail-closed），与 REST 行为一致。

连接到 Claude Code / Cursor

将 GetMyBot 添加为远程 MCP 服务器。配置示例（mcpServers）——替换为你的域名和令牌：

{
  "mcpServers": {
    "mybot": {
      "url": "https://your-domain/mcp",
      "headers": {
        "Authorization": "Bearer mbp_YOUR_TOKEN"
      }
    }
  }
}

Claude Code：将此配置块放入项目的 .mcp.json，或使用命令 claude mcp add 添加服务器。Cursor：将同一配置块添加到 MCP 设置中（Settings → MCP → Add server）。连接后，客户端会自动获取工具、资源和提示词列表。

按域划分的工具

服务器发布了 100 个工具——完整覆盖 PAT 可访问的 REST 接口。以下列出工具及所需 scope，命名格式为 动词_名词（snake_case）。

机器人（bots）

  • list_bots — bots:read
  • get_bot — bots:read
  • validate_bot_token — bots:write
  • connect_bot — bots:write
  • update_bot — bots:write
  • delete_bot — bots:write
  • sync_bot — bots:write
  • change_bot_token — bots:write
  • transfer_bot — bots:write
  • get_bot_settings — settings:read
  • update_bot_settings — settings:write

渠道与 WhatsApp 模板（bots）

多渠道支持（Telegram + WhatsApp + VK）同样可通过 MCP 使用。渠道和模板受 共享 scope bots:read / bots:write 控制——没有单独的渠道 scope。

  • list_channels — bots:read — 列出机器人的渠道（platform tg/wa/vk、external_id、name、enabled、callback_url）。
  • connect_channel — bots:write — 连接 WhatsApp 或 VK 渠道（platform + 凭据）。
  • delete_channel — bots:write — 断开渠道。
  • list_wa_templates — bots:read — 渠道的 WhatsApp 模板目录（name、language、status、category、body）。
  • sync_wa_templates — bots:write — 从 Meta 重新同步模板目录。
  • create_wa_template — bots:write — 创建 WhatsApp 模板并提交给 Meta 审核。
  • update_wa_template — bots:write — 编辑模板（APPROVED/REJECTED/PAUSED 状态）。
  • delete_wa_template — bots:write — 删除模板。

Telegram 渠道通过 connect_bot 连接，而不是 connect_channel——后者只处理 wa 和 vk。模板类别：MARKETING / UTILITY / AUTHENTICATION。create_wa_template 会立即将草稿提交给 Meta 审核；状态会 异步 变化——请通过 list_wa_templates 重新读取（必要时用 sync_wa_templates 刷新目录）。

通过 MCP 上传模板的媒体头部（图片/视频/文档）尚不支持 ——请使用 Web 界面或 REST POST /api/bots/{botID}/channels/{channelID}/templates/media。

反应（reactions）

  • list_reactions — reactions:read
  • get_reaction — reactions:read
  • create_reaction — reactions:write
  • update_reaction — reactions:write
  • delete_reaction — reactions:write
  • import_reactions — reactions:write
  • test_formula — reactions:write
  • reorder_reaction — reactions:write
  • get_reaction_links — reactions:read
  • list_reaction_folders — reactions:read
  • create_reaction_folder — reactions:write
  • update_reaction_folder — reactions:write
  • delete_reaction_folder — reactions:write
  • add_reaction_to_folder — reactions:write
  • remove_reaction_from_folder — reactions:write
  • add_reactions_to_folder — reactions:write

通过 import_reactions 导入时会创建反应，但跳过媒体文件：MCP 上下文中不包含 premium 验证和 Telegram 文件接收器。如果 SamBot 包中包含图片、视频或文档，请使用功能完整的 REST 导入（POST /api/bots/{botID}/reactions/import），它支持媒体迁移。

群发（broadcasts）

  • start_broadcast — broadcasts:write（可选 paid，可选按标签分段）
  • get_broadcast — broadcasts:write
  • pause_broadcast — broadcasts:write
  • resume_broadcast — broadcasts:write
  • cancel_broadcast — broadcasts:write

标签（labels）

  • list_labels — labels:read
  • create_label — labels:write
  • delete_label — labels:write
  • set_label_favorite — labels:write

集合与记录（collections）

  • list_collections — collections:read
  • create_collection — collections:write
  • update_collection — collections:write
  • delete_collection — collections:write
  • list_records — collections:read
  • create_record — collections:write
  • update_record — collections:write
  • delete_record — collections:write

场景（flows）

  • list_flows — flows:read
  • get_flow — flows:read
  • create_flow — flows:write
  • update_flow — flows:write
  • delete_flow — flows:write

集成、连接与凭据（integrations）

  • list_integrations — integrations:read
  • get_integration_sheets — integrations:read
  • get_integration_status — integrations:read
  • create_integration — integrations:write
  • update_integration — integrations:write
  • delete_integration — integrations:write
  • rotate_integration_token — integrations:write
  • list_connections — integrations:read
  • create_connection — integrations:write
  • test_connection — integrations:write
  • update_connection — integrations:write
  • delete_connection — integrations:write
  • list_credentials — integrations:read
  • create_credential — integrations:write
  • update_credential — integrations:write
  • delete_credential — integrations:write

媒体（media）

  • upload_media — media:write
  • get_media — media:write

模板（templates）

  • list_templates — templates:read
  • delete_template — templates:write
  • create_template_from_bot — templates:write
  • apply_template — templates:write

订阅者、聊天与对话——只读（subscribers）

  • list_subscribers — subscribers:read（offset/limit 分页，支持按标签筛选）
  • list_chats — subscribers:read
  • list_dialogs — subscribers:read
  • read_dialog — subscribers:read
  • send_dialog_message — subscribers:write
  • send_dialog_reaction — subscribers:write
  • transcribe_dialog_message — subscribers:write

统计与分析（stats）

  • get_stats — stats:read
  • get_stats_summary — stats:read
  • get_stats_recent — stats:read
  • get_stats_log — stats:read
  • get_reaction_health — stats:read
  • get_analytics — stats:read
  • get_analytics_chats — stats:read
  • get_funnel — stats:read

账单——只读（billing）

  • get_balance — billing:read
  • list_tariffs — billing:read
  • get_transactions — billing:read

发送消息

  • send_message — broadcasts:write — 以机器人名义发送消息；余额消耗根据令牌所有者自动计算。

资源

除工具外，服务器还提供资源——可读取这些资源以了解数据结构：

  • mybot://openapi.yaml — 完整的 OpenAPI 规范（与 /openapi.yaml 返回的相同）。
  • mybot://reference — 精简参考手册：工具列表及其 scope、约定（基础地址、分页、错误格式、限制）。
  • mybot://schemas/reaction、mybot://schemas/trigger、mybot://schemas/action、mybot://schemas/flow、mybot://schemas/collection — 配置的 JSON Schema。正确生成反应（触发器、条件、聊天、动作）、场景和集合时最为实用。
  • mybot://bots — 你的机器人动态列表（无需调用工具即可快速获取上下文）。

提示词

内置场景（MCP 客户端的斜杠命令）：

  • setup_autoresponder — 创建自动回复机器人（参数：机器人、主题/问题集）。
  • segment_broadcast — 按标签分段群发（参数：机器人、标签、反应/文本）。
  • diagnose_reaction — 排查反应未触发的原因（读取反应、reaction-health 和顺序）。
  • import_from_sambot — 执行 SamBot 包导入并验证结果。
  • weekly_report — 生成机器人指定时间段的统计/分析摘要。

何时选择 MCP，何时选择 REST

  • 构建集成、同步、脚本或自定义面板——使用 REST。
  • 将 GetMyBot 接入支持 MCP 的 AI 助手或智能体——使用 /mcp。

两种接口使用同一令牌，遵循相同的所有者权限规则。如果找不到对应的工具，交互式参考文档 中始终提供相应的 REST 端点。

下一步