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 |
書 | リンクを解除 |
アナリティクスプロバイダー
Section titled “アナリティクスプロバイダー”読み取り: mcp:analytics_providers:read · 書き込み: mcp:analytics_providers:write · 最小ロール: admin
| ツール | スコープ | 説明 |
|---|---|---|
list_analytics_providers |
読 | 組織アナリティクスプロバイダー設定の一覧(公開IDのみ) |
get_analytics_provider |
読 | 1件の組織アナリティクスプロバイダーを取得 |
create_analytics_provider |
書 | 再利用可能なプロバイダーを作成(google_analytics、mixpanel、posthog、amplitude、google_tag_manager、meta_pixel) |
update_analytics_provider |
書 | 名前、config、is_active を更新 |
delete_analytics_provider |
書 | プロバイダーを削除(ストリームリンクも連鎖削除) |
list_stream_analytics_providers |
読 | ストリームにリンクされたプロバイダー一覧 |
link_stream_analytics_provider |
書 | 組織プロバイダーをストリームに接続 |
update_stream_analytics_provider |
書 | ストリームリンクを更新(is_active、config_override) |
unlink_stream_analytics_provider |
書 | ストリームリンクを解除(組織プロバイダーは残る) |
設定には公開の測定ID / プロジェクトトークンのみ — シークレットAPIキーは不可。手順はアナリティクスプロバイダーを参照。
読み取り: mcp:gallery:read · 書き込み: mcp:gallery:write · 最小ロール: editor
| ツール | スコープ | 説明 |
|---|---|---|
list_gallery_media |
読み取り | ページ分けされた組織ギャラリーとストレージ使用量;任意の source フィルタ(upload、generated) |
delete_gallery_media |
書き込み | idでギャラリー項目を削除;サムネイル、ロゴ、ゲームアセット、賞品画像として使用中なら 409 |
削除前にメディア一覧とストレージを確認してください。ダッシュボードの手順はギャラリーを参照。
読み取り: mcp:vouchers:read · 書き込み: mcp:vouchers:write · 最小ロール: viewer(読み取り)/ editor(書き込み)
| ツール | スコープ | 説明 |
|---|---|---|
list_voucher_sets |
読み取り | コード統計とリンク済みゲーム付きでバウチャーセット一覧 |
get_voucher_set |
読み取り | 1セットを取得;任意で include_vouchers |
create_voucher_set |
書き込み | 空のバウチャーセットを作成 |
add_vouchers_to_set |
書き込み | コードを一括追加(大文字化;重複はスキップ;1回最大5,000) |
update_org_voucher_status |
書き込み | コードを available または claimed に設定 |
delete_org_voucher |
書き込み | available の単一コードを削除(claimed/usedは削除不可) |
delete_voucher_set |
書き込み | セットとそのコードをカスケード削除 |
セット作成とコード投入後、prize_type: voucher_set と voucher_set_id で set_game_prizes にリンクします。バウチャーシステムを参照。
スコープ: mcp:reports:read · 最小ロール: analyst
| ツール | 説明 |
|---|---|
get_org_analytics_summary |
ダッシュボード向けの軽量集計(日次プレイ、合計、トップゲーム);最大90日 |
get_org_report |
詳細レポートJSON(Reports APIと同じ形状、CSVなし);最大365日;表形式は最大100行 |
get_org_report は report、start_date、end_date(YYYY-MM-DD)、任意の game_id / stream_id を受け付けます。レポート種別: overview、games、streams、prizes、sessions、highscores、streamScoreboard、ctaLeads。
スコープ: mcp:ai · 最小ロール: editor
| ツール | 説明 |
|---|---|
extract_brand |
WebサイトURLからブランドアイデンティティを抽出 |
generate_funnel |
ブランドURLまたはブリーフからファネル段階を提案 |
generate_image |
Geminiで単一ゲームアセットを生成。任意で透明PNG。組織ギャラリーに保存 |
generate_images |
最大8枚を並列生成;複数アセットのテンプレートではこちらを優先 |
アート生成ではテンプレートアセットの width、height、transparent、prompt_wrapper を渡します。generate_images では各項目の asset_key をテンプレートの asset.name にし、返されたURLをフラットキーで update_game に渡します。プロンプト画像が8を超える場合はプレースホルダーで作成してからバッチ生成してください。
スコープ: 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 | テンプレート、ゲーム/ストリーム、バウチャーの読み取り |
| analyst | レポートツール |
| editor | ゲーム/ストリーム書き込み、ギャラリー、バウチャー書き込み、AI、セッション発行 |
| admin | すべてのコネクションおよびアナリティクスプロバイダーツール |
APIキーはMCP経由でも組織のメンバーシップモデルでロールチェックされます。キーのリソース許可リストも適用されます。
同じ機能はアプリ内のアシスタントでも利用できます(サインインユーザーとして認証。APIキーではありません)。