Playgama MCP - Publish & Manage HTML5 Games

Playgama Developer Console MCP Server

AI エージェント（Codex、Claude Code、Cursor、VS Code）から直接、Playgama でHTML5ゲームを公開・管理できます。詳しいガイドはPlaygama wikiをご覧ください。

サーバーはPlaygamaがホストしています。インストールや実行は不要で、トークンをコピーする必要もありません。以下のエンドポイントをクライアントに設定し、開いたブラウザーでコンソールにサインインして、接続を許可してください。

利用できる機能

• 数分で公開 — エージェントに依頼するだけで、一般公開されたプレイ可能なリンクが返されます。
• オーディエンスを獲得 — ゲームはPlaygamaネットワークから最初のプレイヤーを獲得でき、公開当日にはPlaygama DSPからさらにプレイヤーを獲得できます（ベータ版）。エージェントはstart_sandbox_trafficを使ってキャンペーンを開始できます。まずゲームを共有すれば、ブーストは無料です。
• 収益化を開始 — ゲームがセッション数のしきい値を超えると、Playgama Adを通じてリワード広告、インタースティシャル広告、バナー広告が有効になります（申請制）。
• テレメトリーをもとにゲームを改善 — エージェントはゲームに計測機能を組み込み、事前に集計されたイベント、トレンド、セッションの概要を確認し、そのデータを使って進行やパフォーマンスの問題を見つけられます。プレイ時間、リテンション、収益のレポートはデベロッパーダッシュボードで引き続き確認でき、支払いは100 USDから開始されます。

エンドポイント	https://developer.playgama.com/api/mcp
トランスポート	Streamable HTTP
認証	OAuth 2.1 — クライアントがエンドポイントから自動検出します
接続済みエージェント	developer.playgama.com/mcpで確認・取り消しできます

サインアップを完了したPlaygamaデベロッパーアカウントが必要です。接続されたエージェントがアクセスできるのは、ご自身の組織のゲームだけです。エージェントはサーバーを使い続けている間は接続状態を維持します。同じページで接続を取り消すと、次回の呼び出しから拒否されます。

サンドボックスを含め、すべてのゲームにPlaygama Bridge SDKの組み込みが必要です。 まだ組み込まれていない場合は、初回アップロードの前にエージェントが組み込みます。get_bridge_sdk_docsでドキュメントを参照でき、ゲームチェックリストには必須の手順が順番に記載されています。SDKが検出されなかったビルドは公開されません。また、サンドボックスで使用できるのはPlaygama Bridge 2.2.0以降のみです。

お問い合わせ：[email protected]

接続

以下の各クライアントは、初回接続時にブラウザーを開きます。未サインインの場合はコンソールにサインインし、アカウントとエージェントを確認して、接続を許可してください。

Codex

codex mcp add 'playgama-developer-console' --url 'https://developer.playgama.com/api/mcp'

Claude Code

claude mcp add --transport 'http' 'playgama-developer-console' 'https://developer.playgama.com/api/mcp'

次に、Claude Codeで/mcpを実行し、サインインするサーバーを選択してください。

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "playgama-developer-console": {
      "type": "http",
      "url": "https://developer.playgama.com/api/mcp"
    }
  }
}

VS Code

.vscode/mcp.json：

{
  "servers": {
    "playgama-developer-console": {
      "type": "http",
      "url": "https://developer.playgama.com/api/mcp"
    }
  }
}

Claude Desktopとclaude.ai

「設定」→「コネクタ」→「カスタムコネクタを追加」の順に選択し、エンドポイントhttps://developer.playgama.com/api/mcpを指定してください。

OAuth導入前の設定にあるトークン

設定でpgm_mcp_トークンを含むAuthorizationヘッダーをまだ送信している場合、当面は引き続き動作します。ヘッダーを削除し、上記の手順で再接続してください。

ツール

正式な一覧は、サーバーがtools/listに返す内容です。バージョン1.8.0時点では次のとおりです。

ツール	機能	種類
ゲーム
list_applications	組織のゲームを新しい順に一覧表示します	読み取り専用
create_application	新しいゲームを下書きとして作成します	書き込み
get_application	ゲームの保存済みフォーム、アーカイブ、メディアを読み込みます	読み取り専用
update_application_form	フォームのフィールドを保存します。省略したフィールドの値はそのまま維持されます	書き込み
get_game_categories	update_application_form の category に指定できるカテゴリを優先順に読み込み、コアメカニクスに基づく選び方を確認します	読み取り専用
get_submission_state	ゲームを今すぐ審査に提出できるか、できない場合はその理由を確認します	読み取り専用
list_moderation_comments	ゲームに関する審査でのやり取りを読み込みます	読み取り専用
get_launch_steps	ゲームの公開までの手順（アーカイブ、Bridge SDK、カバー、フォーム、サンドボックス、共有、トラフィック）を順に読み込み、現在の手順と各手順を進めるツールを確認します	読み取り専用
ビルド
start_archive_upload	zip のアップロードを開始し、1 時間有効なアップロード URL を返します	書き込み
confirm_archive_upload	アップロードしたアーカイブをフォームに追加し、解凍を開始します	書き込み
get_archive_status	解凍の進行状況とビルドチェックを読み込みます	読み取り専用
カバー
start_cover_upload	正方形、縦長、横長のいずれかのスロットにカバーのアップロードを開始します	書き込み
confirm_cover_upload	画像をチェックし、指定のスロットに設定します	書き込み
アプリ内購入
list_in_app_products	チェックサム付きでアプリ内カタログを読み込みます	読み取り専用
replace_in_app_products	カタログ全体を置き換えます。省略した商品は削除されます	書き込み
リーダーボード
list_leaderboards	ゲームのリーダーボードを一覧表示します	読み取り専用
create_leaderboard	リーダーボードを追加します	書き込み
update_leaderboard	リーダーボードの名前、種類、スコア順を変更します	書き込み
テスト
get_archive_qa_tool_link	アップロード済みのビルドを Playgama QA Tool で開きます	読み取り専用
get_local_game_qa_tool_link	localhost から配信されるゲームを QA Tool で開きます	読み取り専用
ドキュメント
get_bridge_sdk_docs	Playgama Bridge SDK の最新ウィキ全体、または指定したページを読み込みます	読み取り専用
get_game_checklist	最新のゲームチェックリストを読み込みます。アップロード前にゲームとそのアーカイブが満たすべき要件を確認できます	読み取り専用
ゲームのテレメトリー
get_game_telemetry_guide	ゲームへの計測機能の組み込みとテレメトリーの解釈に関する、エージェント専用の手順を読み込みます	読み取り専用
get_game_telemetry_analytics	1 つのゲームについて、概要とページ分割されたイベント一覧を読み込みます	読み取り専用
get_game_telemetry_event_analytics	1 つのイベントについて、パフォーマンスフィールドを含む、事前集計されたフィールドと範囲を限定した値の概要を読み込みます	読み取り専用
get_game_telemetry_timeseries	30 分単位または日単位のイベント量とサンプリング到達率の傾向をページ分割して読み込みます	読み取り専用
get_game_telemetry_session_facts	シーケンスに関する質問に答えるため、フィルター済みの仮名化されたプロダクトイベントデータを読み込みます	読み取り専用
紹介
get_referral_program	組織の招待、参加資格、紹介トラフィックのボーナスを読み込みます	読み取り専用
apply_referral_code	組織が初めてサンドボックスに公開する前に、開発者から提供された招待コードを適用します	書き込み
サンドボックス
get_sandbox_state	サンドボックスで公開中の内容と、公開が受け付けられるかどうかを読み込みます	読み取り専用
get_publications	サンドボックスとカタログの各公開先について、最新の公開結果を読み込みます	読み取り専用
get_sandbox_share	公開中のサンドボックス用に、すぐに投稿できる内容と共有リンクを読み込みます	読み取り専用
publish_sandbox	審査なしで、リンクを知っている人なら誰でもプレイできるようにビルドを公開します	書き込み
get_sandbox_traffic	サンドボックスにトラフィックを誘導できるか、提供するパッケージ、これまでの実施回数を読み込みます	読み取り専用
start_sandbox_traffic	ゲームのカバーを使って DSP キャンペーンを開始します。紹介ボーナスには bonusId を、別枠の共有ボーナスには公開投稿のリンクを 1～2 件使用します	書き込み
カタログ
send_playgama_catalog_update	開発者が明示的に承認した場合、Playgama カタログで公開済みのゲームの更新を、審査なしでそのゲームの全プレイヤーに送信します	書き込み
すべての書き込みツールには destructiveHint: true が注釈として付いています。確認を求める際にこのヒントをどう使うかは、クライアントが決定します。

ローンチのワークフローでは、エージェントは get_launch_steps から開始し、各ステップの後に再度読み込みます。 データの読み取りのみを求めるリクエストは、ゲームの変更、公開、トラフィックキャンペーンを許可するものではありません。

ビルドのアップロード

1. get_game_checklist を読み、ゲームと zip が各項目に適合しているか確認します。不適合があれば、アップロード前に修正してください。
2. start_archive_upload は uploadUrl と headers を返します。
3. 指定されたヘッダーをそのまま使い、uploadUrl に zip を PUT します。例： curl -T game.zip -H "Content-Type: application/zip" "<uploadUrl>"。
4. confirm_archive_upload を呼び出し、state.status が CHECKING 以外になるまで get_archive_status をポーリングします。公開できるのは PASSED のビルドのみです。PROBLEM または NOT_CHECKED の場合は、state.message を一字一句そのまま開発者に伝え、ビルドを修正してください。publish_sandbox もモデレーションへの提出も、どちらもそのビルドを拒否します（SDK 統合ドキュメントは get_bridge_sdk_docs にあります）。サンドボックスでは、2.2.0 より古い Playgama Bridge を使ったビルド（BRIDGE_VERSION_OUTDATED）や、チェック時にバージョンを読み取れなかったビルド（BRIDGE_VERSION_UNKNOWN）も拒否されます。SDK を更新して、新しいアーカイブをアップロードしてください。processing が FAILED の場合は、修正した zip をアップロードしてください。
5. サンドボックスで公開するには、3 種類すべてのカバー画像と、入力済みのフォームも必要です。これらがない場合、publish_sandbox は拒否され、空のスロットは emptySlots に、未入力のフィールドは details に示されます。カバー画像をアップロードするか、update_application_form でフィールドに入力してから、再度公開してください。
6. publish_sandbox は PENDING を返します。通常は数分以内にビルドが作成され、公開されます。get_publications で PLAYGAMA_SANDBOX の公開状況を確認し、読み込みの間は retryAfterSeconds の秒数だけ待って、IN_PROGRESS 以外になるまで繰り返します。PUBLISHED になったら、公開結果から url を渡してください。FAILED は、ビルドが公開されなかったことを意味します。公開処理中に別の公開を試みると、409 で拒否されます。

カバー画像のアップロード方法はどれも同じで、1 回の呼び出しにつき 1 スロットです。PNG または JPEG 形式で、サイズは正確に 800×800（正方形）、1080×1920（縦長）、または 1920×1080（横長）である必要があります。サンドボックスでの公開にも、モデレーションへの提出にも、3 種類すべてが必要です。

カタログで公開中のゲームを更新する

Playgama カタログですでに公開されているゲームは、モデレーションなしで更新できます。初回の公開と、その他すべてのプラットフォームでの公開はモデレーションを経る必要があり、開発者がコンソールから提出します。

1. ビルドの archiveId と reviewType: AUTO を指定して get_submission_state を呼び出すと、更新が拒否されるかどうかと、その理由がわかります。
2. エージェントは開発者に、対象のゲームとビルド、そしてモデレーターによる事前確認なしに、カタログのすべてのプレイヤーが更新を受け取ることを伝えます。この更新への明示的な同意があった場合にのみ、先へ進みます。
3. send_playgama_catalog_update にはビルドと、プレイヤーにわかる変更内容を記した必須の updateNote を指定します。releaseId を含む PENDING が返されます。get_publications でその releaseId の PLAYGAMA 公開状況を確認し、IN_PROGRESS 以外になるまで待ちます。PUBLISHED は更新が公開されたことを意味し、FAILED はプレイヤーに以前のビルドが引き続き表示されることを意味します。

ゲームのテレメトリ

ゲームを完成させる前に、エージェントは get_game_telemetry_guide を読み、関連するプロダクトの進行イベントとパフォーマンスサンプルを追加します。テレメトリはあくまでガイダンスであり、アップロードや公開の条件ではありません。

リリース後にトラフィックが集まったら、エージェントは get_game_telemetry_analytics から確認を始めます。関連するイベントまたはフィールドを1つだけ確認する場合は get_game_telemetry_event_analytics、イベント量やサンプリングの到達状況の経時変化を確認する場合は get_game_telemetry_timeseries、フィルターしたプロダクトイベントの順序を確認する場合は get_game_telemetry_session_facts を使用します。performance_sample の FPS、フレーム時間、スタッターの要約はイベント分析から取得します。時系列のポイントにはこれらのフィールド値は含まれません。また、反復的に発生する core_ping と performance_sample のイベントはセッションファクトから意図的に除外されているため、現在のビューではセッションごとの FPS を示すことはできません。ツールが返すのは動的に事前集計された JSON であり、生イベントやサーバーが生成した結論ではありません。エージェントはレスポンスのスキーマバージョン、期間、鮮度、サンプルサイズ、ページネーションを確認し、欠落または null のフィールドはゼロではなく取得不可として扱います。また、追加ページの内容によって現在の結論が変わる場合にのみ、次のページを取得します。

概要のイベント一覧はデフォルトでイベントタイプを50件表示し、最大100件まで指定できます。events_page.next_cursor は eventCursor として渡します。エージェントは事前にイベント一覧の全件を取得しません。パラメーターとレスポンスに関する詳細なガイダンスは、ツールリファレンスに記載されています。

サンドボックスのトラフィック

2種類の個別のトラフィックボーナスで、サンドボックスキャンペーンを開始できます。

• 紹介ボーナスは get_referral_program から取得し、bonusId として start_sandbox_traffic に渡します。SNSへの投稿は不要です。組織のメンバーであれば誰でも、返された invitation.url を共有できます。開発者から提供された招待のみを、招待先組織が初めてサンドボックスに公開する前に適用してください。招待が承認されると、招待されたスタジオに3ドル分のトラフィックが付与され、招待先の最初のサンドボックス公開時には、招待した側にも3ドル分のトラフィックが付与されます。これはキャンペーン予算であり、現金ではありません。
• シェアボーナスは、いずれかのプラットフォームでゲームについて投稿すると獲得できます。開発者が投稿を公開してそのリンクをエージェントに貼り付けると、エージェントは公開 HTTPS 投稿リンクを1～3件、postUrls として start_sandbox_traffic に渡します。リンクは1件で十分です。このボーナスを受け取れるのはゲームごとに1回で、組織ごとに利用期間全体で最大3ゲームまでです。共有を伴わない過去の無料公開では、このボーナスは消費されません。get_sandbox_share から投稿文と共有リンクを取得できます。有料トラフィックはコンソールで利用できます。MCP から購入することはできません。

制限事項

• ビルドアーカイブ：ZIPファイル1件あたり最大300 MB。
• カバー：ファイル1件あたり最大10 MB。
• サンドボックス：ゲームごとに、連続する1時間あたり15回まで公開できます。公開のたびにカウントされ、同じビルドの公開も含まれます。

サーバーが意図的に行わないこと

以下はコンソールで人間が行う操作です。

• ゲームを審査に提出すること。
• リーダーボード、またはフォームからアーカイブやカバーを削除すること。
• ゲームを最新リリースにロールバックすること。
• 支払い額を確認すること。
• スクリーンショット、動画、その他のアセットをアップロードすること。

MCP サーバーのその先へ

Playgama スタックのほかの要素が、このサーバーの先を引き継ぎます。

• Playgama Bridge SDK — アップロードするすべてのゲームで必須です（上記参照）。同じ統合によってゲームをさらに発展させることができ、複数のプラットフォームで同じゲームを公開する際に、広告、リーダーボード、決済、プラットフォーム SDK をひとつの API で利用できます。オープンソース、npm i @playgama/bridge。
• Playgama Ad — 軽量な単一の JS SDK を通じて、リワード広告、インタースティシャル広告、バナー広告でウェブゲームを収益化します。ゲームに特化した広告需要、Google Ad Manager MCM のサポート、レポート機能を備えています。利用は申請制です。
• Playgama Wrap — 同じゲームを独自ドメインのスタンドアロンサイトに変換し、ホスティング、プレイヤーアカウント、ゲーム内購入、PWA インストール、インデックス可能な SEO ページを提供します。早期アクセスです。
• Playgama DSP — 公開したばかりのゲームに最初のプレイヤーを呼び込みます。ベータ版です。

ライセンス

MIT