MCP ツールリファレンス

これらは MCP サーバーが、ローカルとホスト型の両方の形で公開するツールです。各々が単一の管理 API 操作をプロキシするので、ツールに必要な権限は、その操作に必要な権限です。エージェントのトークンがそれを持たなければなりません。カタログと説明はサーバー自身から来ます。ツールの背後の操作の正確なリクエストとレスポンスのスキーマは、インタラクティブ API リファレンスを参照してください。

ここでの権限の仕組み

ツールは、その背後のトークンが、根底の操作を行うことを許されている場合だけ走ります。権限列は次の値を使い、それらはチームの権限とスコープモデルに対応します：

値	意味
アカウント	アカウント上の有効なトークンならどれでも。トークンとシートを発行するツールは、加えてアカウントのマスター資格情報（ダッシュボードのセッション、または Personal Access Token）を要します。チームトークンはトークンやシートを発行できません。
読み取り	`read` 権限。サイトにスコープづけされたツールは、サイトキーがトークンのスコープ内にあることも要します。
作成	チームへの `create` 権限（その中にサイトキーを作る）。
編集	ツールが対象とするサイトキーにスコープづけされた `edit` 権限。
管理	`manage` 権限：チーム管理（メンバー、トークン、チーム全体の設定）。

いくつかのツールはプランの階層も要し、説明に記されています。ホワイトラベルは Apex、ゲームの言語とスキンのカスタマイズは Alpha 以上、監査ログは Apex です。

アカウントとヘルス

ツール	役割	権限
`caputchin_ping`	ヘルスチェック。トークンが有効なとき、解決されたアカウント id を返します。	アカウント
`caputchin_get_account`	認証されたアカウント（id、メール、プラン）。	アカウント
`caputchin_me_billing`	請求の概要（プラン、ステータス、期間）。	アカウント
`caputchin_get_seats`	アカウントのシート使用状況（使用済み、合計、内訳）。	アカウント

トークンとシート

ツール	役割	権限
`caputchin_list_tokens`	アカウントのトークンを一覧。シークレットは決して返しません。	アカウント
`caputchin_create_token`	トークンを発行（`type` は troop か account）。値は一度返されます。	アカウント（マスター）
`caputchin_rotate_token`	トークンのシークレットをローテーション。新しい値は一度返されます。	アカウント（マスター）
`caputchin_revoke_token`	トークンを失効。即時に有効。	アカウント（マスター）
`caputchin_invite_seat_user`	ユーザーをチームに招待（シート対応）。新規ならシートを消費。	アカウント（マスター）
`caputchin_remove_seat_user`	アカウント内のすべてのチームからユーザーを削除。	アカウント（マスター）
`caputchin_mint_seat_pat`	チームトークンを 1 回の呼び出しで発行・紐づけ。値は一度返されます。	アカウント（マスター）
`caputchin_attach_seat_pat`	既存のチームトークンを別のチームに紐づけ。	アカウント（マスター）
`caputchin_revoke_seat_pat`	チームトークンをアカウント全体で失効。	アカウント（マスター）

チーム

ツール	役割	権限
`caputchin_list_troops`	アカウントのチームを一覧。	アカウント
`caputchin_get_troop`	id で 1 つのチーム。	読み取り
`caputchin_create_troop`	共有チームを作成。	アカウント
`caputchin_rename_troop`	チームを改名。	管理
`caputchin_delete_troop`	チームを削除。まだサイトキーを所有していれば拒否。	管理
`caputchin_list_troop_members`	チームのメンバーを、その権限とスコープとともに。	読み取り
`caputchin_add_troop_member`	権限とスコープを付けてメールでユーザーを追加。シートを消費し得ます。	管理
`caputchin_update_troop_member`	メンバーの権限かスコープを変更。	管理
`caputchin_remove_troop_member`	メンバーを削除。最後のものなら彼らのシートを解放。	管理
`caputchin_list_troop_pats`	チームに紐づくチームトークン。	読み取り
`caputchin_attach_troop_pat`	権限とスコープを付けてチームトークンを紐づけ。シートを消費。	管理
`caputchin_update_troop_pat`	紐づいたトークンの権限かスコープを変更。	管理
`caputchin_detach_troop_pat`	チームトークンの紐づけを解く。そのシートを解放。	管理
`caputchin_get_troop_security`	チームのセキュリティ設定（force-game の天井）。	読み取り
`caputchin_update_troop_security`	チームの force-game の天井を設定。	管理

サイトキー

ツール	役割	権限
`caputchin_list_sites`	アカウントのチームにわたるすべてのサイトキー。	読み取り
`caputchin_get_site`	id で 1 つのサイトキー。	読み取り
`caputchin_create_site`	サイトキーを作成（チーム内、または Personal）。一度きりのシークレットを返します。	作成
`caputchin_update_site`	キーの名前か無効フラグを更新。	編集
`caputchin_delete_site`	キーを削除。セッションと設定にカスケード。元に戻せません。	編集
`caputchin_rotate_site_secret`	シークレットをローテーション。古いものは即停止。新しいものは一度返されます。	編集
`caputchin_get_site_cap_config`	キーの proof-of-work 設定。	読み取り
`caputchin_update_site_cap_config`	proof-of-work 設定を更新。	編集
`caputchin_get_site_security`	キーのセキュリティ設定（require-game ゲート）。	読み取り
`caputchin_update_site_security`	キーごとの require-game ゲートを切り替え。	編集
`caputchin_list_site_sessions`	キーの最近の検証セッション。	読み取り

ホスト型認証

ツール	役割	権限
`caputchin_get_hosted_verification`	キーのホスト型認証設定。	読み取り
`caputchin_set_hosted_verification`	有効フラグと宛先を設定。	編集
`caputchin_test_hosted_verification`	設定済みの宛先に合成配信を発火。	編集

統計、配信、監査ログ

ツール	役割	権限
`caputchin_site_stats`	範囲にわたるサイトの検証統計。	読み取り
`caputchin_site_stats_dashboard`	サイト統計のダッシュボードのロールアップ。	読み取り
`caputchin_site_stats_activity`	サイト統計のアクティビティ系列。	読み取り
`caputchin_site_stats_durations`	サイト統計のタイミングのパーセンタイル。	読み取り
`caputchin_site_stats_rejections`	サイトの拒否カウント。	読み取り
`caputchin_troop_stats`	チーム統計の累計の合計。	読み取り
`caputchin_troop_stats_dashboard`	チーム統計のダッシュボードのロールアップ。	読み取り
`caputchin_troop_stats_activity`	チーム統計のアクティビティ系列。	読み取り
`caputchin_troop_stats_durations`	チーム統計のタイミングのパーセンタイル。	読み取り
`caputchin_troop_stats_rejections`	チームの拒否カウント。	読み取り
`caputchin_quick_stats_sites`	アカウント全体の、コンパクトなサイトごとの統計スナップショット。	読み取り
`caputchin_quick_stats_troops`	アカウント全体の、コンパクトなチームごとの統計スナップショット。	読み取り
`caputchin_site_delivery_dashboard`	サイトのホスト型認証の配信統計。Apex。	読み取り
`caputchin_troop_delivery_dashboard`	チームのホスト型認証の配信統計。Apex。	読み取り
`caputchin_account_audit_logs`	アカウントレベルの監査ログ。Apex。	アカウント
`caputchin_troop_audit_logs`	チームの監査ログ。Apex。	読み取り
`caputchin_site_audit_logs`	サイトキーの監査ログ。Apex。	読み取り

マーケットプレイスのゲーム

ツール	役割	権限
`caputchin_list_games`	マーケットプレイスのゲームを一覧。	アカウント
`caputchin_search_games`	テキストでマーケットプレイスのゲームを検索。	アカウント
`caputchin_get_game`	id で 1 つのマーケットプレイスのゲーム。	アカウント

ゲームのカスタマイズ

これらはスコープ（サイトキーかチーム）を対象とするので、サイトにスコープづけされた変更はそのキーへの edit を、チーム全体の変更は manage を要します。言語とスキンのカスタマイズは Alpha 以上 です。

ツール	役割	権限
`caputchin_list_customized_games`	スコープの登録済み（インストール済み）ゲーム。	読み取り
`caputchin_register_customized_game`	スコープにゲームを登録（インストール）。スナップショットを固定。	編集（サイト）または管理（チーム）
`caputchin_repin_customized_game`	登録済みのゲームを最新バージョンに再固定。	編集（サイト）または管理（チーム）
`caputchin_update_customized_game`	登録済みのゲームの設定を更新（自動更新）。	編集（サイト）または管理（チーム）
`caputchin_delete_customized_game`	スコープから登録済みのゲームをアンインストール。	編集（サイト）または管理（チーム）
`caputchin_list_game_presets`	スコープとゲームのカスタマイズプリセット。	読み取り
`caputchin_set_game_preset`	ゲームプリセットを作成または更新。Alpha+。	編集（サイト）または管理（チーム）
`caputchin_delete_game_preset`	ゲームプリセットを削除。Alpha+。	編集（サイト）または管理（チーム）
`caputchin_set_game_default`	ある軸の既定のゲームプリセットを設定。Alpha+。	編集（サイト）または管理（チーム）
`caputchin_get_custom_game_schema`	スコープのカスタムゲームのフィールドスキーマ。	読み取り
`caputchin_set_custom_game_schema`	カスタムゲームのフィールドスキーマを設定。Alpha+。	編集（サイト）または管理（チーム）
`caputchin_delete_custom_game_schema`	カスタムゲームのフィールドスキーマを削除。Alpha+。	編集（サイト）または管理（チーム）
`caputchin_upload_custom_game_run`	カスタムゲームのヘッドレス実行アーティファクトをアップロード。	編集（サイト）または管理（チーム）
`caputchin_get_custom_game_run`	カスタムゲームの保存済み実行アーティファクトの参照を取得。	読み取り
`caputchin_delete_custom_game_run`	カスタムゲームの実行アーティファクトを削除。	編集（サイト）または管理（チーム）

ホワイトラベル

ウィジェットシェルのホワイトラベルは Apex の機能です。ゲームのカスタマイズと同様、サイトにスコープづけされた変更は edit を、チーム全体のものは manage を要します。

ツール	役割	権限
`caputchin_list_white_label_presets`	スコープのホワイトラベルプリセット。	読み取り
`caputchin_set_white_label_preset`	ホワイトラベルプリセットを作成または更新。Apex。	編集（サイト）または管理（チーム）
`caputchin_delete_white_label_preset`	ホワイトラベルプリセットを削除。Apex。	編集（サイト）または管理（チーム）
`caputchin_set_white_label_default`	ある軸の既定のホワイトラベルプリセットを設定。Apex。	編集（サイト）または管理（チーム）

あわせて読む

MCP サーバーを使う：どちらのトランスポートでもエージェントをつなぐ。
権限とスコープ：上の表が使う read / create / edit / manage モデル。
インタラクティブ API リファレンス：各ツールの背後の操作の正確なスキーマ。

MCP ツールリファレンス

このページの内容