MCP — プログラムインターフェース

REST に加えて、GetMyBot には MCP（Model Context Protocol）インターフェースがあります。これは、エンドポイントを手動で叩くのではなく、ツールを呼び出すAIエージェントやアシスタント向けに設計されています。REST は引き続き主要インターフェースであり、MCP はエージェント型シナリオにおける便利な代替手段です。以下に記載するツール・リソース・プロンプトの名前は、サーバーが公開しているものと一致しています。

アドレスと認証

MCP はエンドポイント /mcp（トランスポート: Streamable HTTP、メソッド: POST）で利用できます。認証には REST と同じ個人トークンを使用します: ヘッダー Authorization: Bearer mbp_…。トークンを別途作成する必要はありません — 1つの PAT が REST と MCP の両方で機能します。各ツールは対応する REST エンドポイントと同じスコープを必要とし、スコープ * のトークンはフルアクセスを持ちます。スコープが不足している場合、呼び出しは拒否されます（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 を完全にカバーしています。以下にツールと必要なスコープを示します。名前は 動詞_名詞（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 経由でも利用できます。チャネルとテンプレートは、共通スコープ bots:read / bots:write で制御されます — 専用のチャネルスコープはありません。

  • 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_channel ではなく connect_bot で接続します — 後者が扱うのは wa と vk のみです。テンプレートのカテゴリ: MARKETING / UTILITY / AUTHENTICATION。create_wa_template はドラフトをただちに Meta の審査に送ります。ステータスは 非同期に 変化するため、list_wa_templates で読み直してください（必要に応じて sync_wa_templates でカタログを更新）。

テンプレートのメディアヘッダー（画像/動画/ドキュメント）のアップロードは、MCP 経由では まだ対応していません — ウェブ UI または 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 コンテキストにはプレミアム確認と 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 — コンパクトなリファレンス: スコープ付きのツール一覧と規約（ベースアドレス、ページネーション、エラーフォーマット、制限）。
  • 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 をご利用ください。
  • MCP に対応したAIアシスタントやエージェントに GetMyBot を接続する場合は /mcp をご利用ください。

どちらのインターフェースも同一のトークンで動作し、同じ所有者権限に従います。必要なツールが見つからない場合は、対応する REST エンドポイントが常にインタラクティブリファレンスに掲載されています。

次のステップ