# MCPツールリファレンス

すべてのMCPツールは組織スコープのケイパビリティに対応します。デフォルト拒否です。APIキーに一致する[MCPスコープ](/ja/api/mcp/#mcpスコープ)が必要で、呼び出し元は最小組織ロールを満たす必要があります。

## テンプレート

**スコープ:** `mcp:templates:read` · **最小ロール:** viewer

| ツール | 説明 |
| --- | --- |
| `list_templates` | 承認済みゲームテンプレートをアセットスキーマ（`name`、サイズ、`transparent`、`promptWrapper`）と `baseGameConfig` 付きで一覧 |
| `get_template` | idで1件取得（コントロールとconfig接続ヒント付き） |

`list_templates` の任意入力: `category`（大文字小文字を無視した部分一致）

## ゲームと賞品

**読み取り:** `mcp:games:read` · **書き込み:** `mcp:games:write` · **最小ロール:** viewer（読）/ editor（書）

| ツール | スコープ | 説明 |
| --- | --- | --- |
| `list_games` | 読 | 組織のゲーム一覧。任意で `status` フィルタ |
| `get_game` | 読 | フラットな `config` と有効な賞品を含む詳細 |
| `list_game_prizes` | 読 | ゲームの有効な賞品一覧 |
| `create_game` | 書 | テンプレートから下書きゲームを作成。フラット `config` + 任意の賞品 |
| `update_game` | 書 | フィールド更新。`config` は浅いマージ |
| `set_game_status` | 書 | `draft` / `published` / `archived` を設定 |
| `set_game_prizes` | 書 | 賞品テーブルを同期（`id` なしで作成、配列にない賞品は削除、空配列ですべて削除） |

賞品の確率は `min_score` ティアごとに**合計ちょうど100%**である必要があります。

## ストリーム

**読み取り:** `mcp:streams:read` · **書き込み:** `mcp:streams:write` · **最小ロール:** viewer（読）/ editor（書）

| ツール | スコープ | 説明 |
| --- | --- | --- |
| `list_streams` | 読 | 組織のストリーム一覧 |
| `get_stream` | 読 | ストリーム取得。任意で `include_games` / `include_connections` |
| `create_stream` | 書 | キャンペーンジャーニー（ストリーム）を作成 |
| `update_stream` | 書 | ストリームフィールドを更新 |

## コネクション

**読み取り:** `mcp:connections:read` · **書き込み:** `mcp:connections:write` · **最小ロール:** admin

| ツール | スコープ | 説明 |
| --- | --- | --- |
| `list_connections` | 読 | 組織インテグレーション一覧（生の認証情報なし） |
| `get_connection` | 読 | `has_credentials` / `credential_keys` のみの詳細 |
| `create_connection` | 書 | インテグレーション作成（例: Braze、Zapier） |
| `update_connection` | 書 | 名前・説明・対応する認証情報を更新 |
| `delete_connection` | 書 | 組織コネクションを削除 |
| `list_stream_connections` | 読 | ストリームにリンクされたインテグレーション一覧 |
| `link_stream_connection` | 書 | コネクションをストリームに接続 |
| `update_stream_connection` | 書 | ストリーム–コネクションリンクを更新 |
| `unlink_stream_connection` | 書 | リンクを解除 |

:::note
`voucher_webhook` はMCP経由ではサポートされません。読み取りレスポンスにプロバイダシークレットは含まれません。
:::

## AI

**スコープ:** `mcp:ai` · **最小ロール:** editor

| ツール | 説明 |
| --- | --- |
| `extract_brand` | WebサイトURLからブランドアイデンティティを抽出 |
| `generate_funnel` | ブランドURLまたはブリーフからファネル段階を提案 |
| `generate_image` | Geminiでゲームアセットを生成。任意で透明PNG。組織ストレージに保存 |

アート生成ではテンプレートアセットの `width`、`height`、`transparent`、`prompt_wrapper` を渡し、返された `url` をアセットのフラットキー名で `update_game` に渡します。

## セッション

**スコープ:** `mcp:sessions:write` · **最小ロール:** editor

| ツール | 説明 |
| --- | --- |
| `create_play_session` | `game_id` または `stream_id` のワンタイムプレイセッショントークンを発行（RESTのcreate-sessionと同じ） |

任意入力: `external_ref`、`metadata`、`expires_in_minutes`（最大7日）

ライフサイクルとプレイヤーURLは[セッショントークン](/ja/api/session-tokens/)を参照してください。

## ロール要件のまとめ

| 最小ロール | ツール |
| --- | --- |
| **viewer** | テンプレートおよびゲーム/ストリームの読み取り |
| **editor** | ゲーム/ストリーム書き込み、AI、セッション発行 |
| **admin** | すべてのコネクションツール |

APIキーはMCP経由でも組織のメンバーシップモデルでロールチェックされます。キーのリソース許可リストも適用されます。