コンテンツにスキップ

MCPツールリファレンス

すべてのMCPツールは組織スコープのケイパビリティに対応します。デフォルト拒否です。APIキーに一致する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 書 リンクを解除

読み取り: 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はセッショントークンを参照してください。

最小ロール ツール
viewer テンプレート、ゲーム/ストリーム、バウチャーの読み取り
analyst レポートツール
editor ゲーム/ストリーム書き込み、ギャラリー、バウチャー書き込み、AI、セッション発行
admin すべてのコネクションおよびアナリティクスプロバイダーツール

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

同じ機能はアプリ内のアシスタントでも利用できます(サインインユーザーとして認証。APIキーではありません)。