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 結構描述。對於正確產生反應（觸發器、條件、對話、動作）、場景和集合最為實用。
• 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 端點一律可在互動式參考手冊中找到。

後續步驟

• AI 代理人技能 — 適用於 Claude Code 及其他代理人的 GetMyBot 預建封裝。
• 授權與權杖 — 建立 MCP 用的 PAT。
• API 快速入門 — REST 替代方案。
• 互動式參考手冊 — 完整 REST 端點。