MCPツールリファレンス
すべてのMCPツールは組織スコープのケイパビリティに対応します。デフォルト拒否です。APIキーに一致するMCPスコープが必要で、呼び出し元は最小組織ロールを満たす必要があります。
テンプレート
Section titled “テンプレート”スコープ: mcp:templates:read · 最小ロール: viewer
| ツール | 説明 |
|---|---|
list_templates |
承認済みゲームテンプレートをアセットスキーマ（name、サイズ、transparent、promptWrapper）と baseGameConfig 付きで一覧 |
get_template |
idで1件取得（コントロールとconfig接続ヒント付き） |
list_templates の任意入力: category（大文字小文字を無視した部分一致）
ゲームと賞品
Section titled “ゲームと賞品”読み取り: 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 |
書 | ストリームフィールドを更新 |
コネクション
Section titled “コネクション”読み取り: 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 |
書 | リンクを解除 |
スコープ: 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はセッショントークンを参照してください。
ロール要件のまとめ
Section titled “ロール要件のまとめ”| 最小ロール | ツール |
|---|---|
| viewer | テンプレートおよびゲーム/ストリームの読み取り |
| editor | ゲーム/ストリーム書き込み、AI、セッション発行 |
| admin | すべてのコネクションツール |
APIキーはMCP経由でも組織のメンバーシップモデルでロールチェックされます。キーのリソース許可リストも適用されます。