---
type: reference
title: MCP ツールリファレンス
summary: すべての Caputchin MCP ツール、その役割、そしてそのトークンが持たなければならない権限を、領域ごとにまとめます。
---

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

## ここでの権限の仕組み

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

| 値 | 意味 |
|---|---|
| **アカウント** | アカウント上の有効なトークンならどれでも。トークンとシートを発行するツールは、加えてアカウントのマスター資格情報（ダッシュボードのセッション、または [Personal Access Token](/docs/account-management/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 サーバーを使う](/docs/automation/mcp)：どちらのトランスポートでもエージェントをつなぐ。
- [権限とスコープ](/docs/troops/permissions)：上の表が使う read / create / edit / manage モデル。
- [インタラクティブ API リファレンス](/docs/api-reference)：各ツールの背後の操作の正確なスキーマ。