iDos Games SDK

iDos Games MCP

クロスプラットフォームゲーム（Web、Android、iOS、PC）向けのバックエンド兼パブリッシングプラットフォームである iDos Games の公式 Model Context Protocol サーバーです。web3 に対応しています。Claude、 ChatGPT、Cursor、VS Code、Codex、その他の MCP クライアントに接続すると、AI アシスタントがゲームの構築、設定、リリースを行えます。

サーバーは 2 種類あり、それぞれ役割が異なります。

	iDos Games (com.idosgames/platform)	iDos Games SDK (com.idosgames/sdk)
対象	稼働中のゲームのデータ、およびゲームモジュールと SDK スキル	プロジェクト内のゲームコード：オフラインで使えるモジュールとスキル
実行場所	ホスト型：https://site.idosgames.com/api/v2/mcp	ローカル：npx -y @idosgames/mcp
トランスポート	ストリーミング可能な HTTP	stdio
サインイン	OAuth 2.1。対象のゲームと権限を選択します（モジュールとスキルはサインインなしで利用できます）	なし（公開、読み取り専用）
ブラウザーのみのクライアント（claude.ai、ChatGPT）での利用	はい	いいえ。ローカルプロセスを起動できるクライアントが必要です

どちらも、同じゲームモジュールのカタログ、プロジェクトのひな形、SDK スキルを提供するため、ブラウザーのみのクライアント （claude.ai、ChatGPT）はホスト型サーバーからそれらを取得できます。ゲームのライブ設定、生成されたアセット、タスクボード、ビルドは iDos Games サーバーを経由します。SDK サーバーはサインイン不要で、オフラインで動作します。

iDos Games（ホステッド）

アシスタントでできること：

• ゲームを検索して、各ゲームで許可されている操作を確認できます（list_my_titles）。
• 新しいゲームを作成できます（専用の権限であるcreate_title）。ダッシュボードと同じ方法で、プランの枠を使用して、基本システム、ゲームモジュール、すぐに使えるスタータービルド、サンドボックス（DEV）コピーを取得します。新しいゲームはすぐにアシスタントのアクセス対象に加わるため、続けて設定やリリースを行えます。
• ゲーム設定をセクションごとに読み取り、更新できます。仮想通貨、アイテム、ストア、ルートボックス、クエスト、期間限定イベントや協力プレイイベント、シーズン、リーダーボード、クラフト、報酬、プレミアム、チュートリアル、A/Bテスト、ローカライズ、チャット、マルチプレイヤー、プッシュ通知、広告などに対応します（get_<section> / save_<section>）。各セクションは個別に保存されるため、ほかの設定には影響しません。
• Web3：EVMネットワークとSolana上での、ゲーム内通貨のオンチェーントークン化、アイテムのNFT化、報酬プールを通じたプレイヤーの入出金、トークン保有者限定のプレイとウォレットログイン、ネットワーク、コントラクトアドレス、ガスのポリシーに対応します（get_blockchain / save_blockchain、save_currencyでの暗号資産通貨、save_itemでのNFTアイテム）。トークンのローンチと保有者のステーキングは、idosgames.com上で行います。
• タイトルデータとローカライズキー：ゲームで共有するキーと値のデータ、およびテキストキーを扱えます。
• サーバーロジック：CloudCodeを公開し、シークレット名を一覧表示できます（値は返されません）。
• AIでアセットを生成：画像、音声、サウンド、音楽、短い動画、3Dモデル、テキストを生成できます。生成にはアカウントのクレジットを使用するため、実行前にlist_ai_tiersとestimate_media_costで確認できます。
• タスクボード：プロジェクト、列、カード、担当者、コメントを扱えます。
• ビルドをリリース：完成したWebビルドをアップロードしてテスト用リンクを取得し、プレイヤー向けに公開できます。
• ゲームモジュールとSDKスキル（読み取り専用、ゲーム不要）：プロジェクトのスキャフォールド（get_host_scaffold）、ストア、クエスト、インベントリ、リーダーボード、マルチプレイヤーなどのすぐに使えるゲームやシステム（list_modules、search_modules、get_module）、正確なSDKパッケージバージョン（get_manifest）、SDKの手順を解説するスキル（list_skills、get_skill）を利用できます。
• ビデオスタジオのカタログ（読み取り専用、ゲーム不要）：短い動画のフォーマットと、動画で使えるすべての要素（list_video_formats、get_video_format）、すぐに使えるキャラクター、シーン、音楽のライブラリ（search_assets）、完成した動画のサンプル（list_video_templates）を利用できます。
• ビデオスタジオ用の動画を作成（クレジットを使用）：plan_videoは、スタジオのAIディレクターによってアイデアを完成した動画に仕上げます。generate_assetはキャラクター、シーン、小道具、音楽を作成し、適切な場所に配置します。応答には動画パッケージ（{ spec, assets }）と、アプリのエディターで開くリンクが含まれます。MP4はプレイヤーのデバイス上で作成されます。publish_assetは、アセットを公式コンテンツとしてアプリのワークショップに追加します。

各ツールにはtitleとreadOnlyHint / destructiveHint / openWorldHintのアノテーションがあります。create_titleにはidempotentHint: falseも設定されており、呼び出しが成功するたびに新しいゲームが作成されます。

サインインの仕組み

ヘッダーもAPIキーも設定せず、通常のHTTP MCPサーバーとしてサーバーを追加します。initializeとtools/listにはサインインは不要です。最初のツール呼び出しは401を返し、クライアントによってiDos Gamesのサインインページが開きます。そこで、アシスタントに使用を許可するゲームと、各ゲームで許可する操作（設定の読み取り、設定の書き込み、アセットの生成、ビルドのアップロードなど）、新しいゲームの作成を許可するかどうかを選択します。その後、クライアントが呼び出しを再試行します。アクセス権はいつでもplatform.idosgames.comの接続済みアプリで取り消せます。

接続

Claude（claude.ai、Desktop、モバイル）：設定 → コネクター → カスタムコネクターを追加 → https://site.idosgames.com/api/v2/mcp。

Claude Code

claude mcp add --transport http idosgames https://site.idosgames.com/api/v2/mcp

ChatGPT：設定 → アプリとコネクター → 詳細設定 → 開発者モード → 作成、URL https://site.idosgames.com/api/v2/mcp、認証方式は OAuth です。

Codex CLI

codex mcp add idosgames --url https://site.idosgames.com/api/v2/mcp

Gemini CLI

gemini mcp add --transport http idosgames https://site.idosgames.com/api/v2/mcp

Cursor（.cursor/mcp.json）、Windsurf（~/.codeium/windsurf/mcp_config.json、キー serverUrl）、 VS Code（.vscode/mcp.json）：両方のサーバーを1つの設定にまとめるを参照してください。

iDos Games SDK（ローカル）

iDos Games の モジュール＆スキルレジストリをコーディングエージェントに提供します。

ツール	目的
list_modules	組み合わせ可能なゲームモジュールのカタログ（ゲームとシステム：ストア、クエスト、インベントリ、リーダーボードなど）
get_module	1つのモジュールの完全なソースコードとインストール手順
get_host_scaffold	新しいプロジェクトの基本となる土台（サインイン、ロビー、設定）
get_manifest	ランタイムの @idosgames/* パッケージと正確なバージョン
list_skills / get_skill	@idosgames/core、モジュールの契約、組み合わせ方に沿ったコーディング方法
search	必要な機能を備えた既製モジュールを検索
validate_asset / validate_video	ビデオスタジオのアセットまたはビデオパッケージを、スタジオ独自のコードで検証します。title_id を指定すると、アプリ内でビデオを開くリンクが表示されます

すべてのツールは読み取り専用で、コンテンツを返します。エージェントはファイルを自身のプロジェクトに書き込みます。レジストリは パッケージに同梱されているため、オフラインでも動作します。

claude mcp add idosgames-sdk -- npx -y @idosgames/mcp

npm： @idosgames/mcp。

両方のサーバーを1つの設定にまとめる

Cursor、.cursor/mcp.json：

{
  "mcpServers": {
    "idosgames": { "url": "https://site.idosgames.com/api/v2/mcp" },
    "idosgames-sdk": { "command": "npx", "args": ["-y", "@idosgames/mcp"] }
  }
}

VS Code、.vscode/mcp.json：

{
  "servers": {
    "idosgames": { "type": "http", "url": "https://site.idosgames.com/api/v2/mcp" },
    "idosgames-sdk": { "type": "stdio", "command": "npx", "args": ["-y", "@idosgames/mcp"] }
  }
}

Windsurf、~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "idosgames": { "serverUrl": "https://site.idosgames.com/api/v2/mcp" },
    "idosgames-sdk": { "command": "npx", "args": ["-y", "@idosgames/mcp"] }
  }
}

Claude Code、.mcp.json：

{
  "mcpServers": {
    "idosgames": { "type": "http", "url": "https://site.idosgames.com/api/v2/mcp" },
    "idosgames-sdk": { "command": "npx", "args": ["-y", "@idosgames/mcp"] }
  }
}

プロンプトの例

• 「Moon Farm という新しい放置系 RPG を作成して、通貨を3種類追加してください。」
• 「ゲームに設定されている仮想通貨とストアアイテムを表示してください。」
• 「マッチに3回勝つとゴールドを100獲得できるデイリークエストを追加してください。」
• 「炎の剣の512×512アイコンを生成して、アイテムカタログに追加してください。」
• 「ストアとデイリークエストを備えた新しい放置系 RPG プロジェクトを開始してください。」（SDK サーバー）
• 「ゲームをビルドして、テスト版としてアップロードしてください。」（両方のサーバー）
• 「ボード上で自分に割り当てられているタスクは何ですか？」

リンク

• ドキュメント：idosgames.com/mcp
• サポート：idosgames.com/mcp#support、[email protected]
• プライバシーポリシー：idosgames.com/privacy
• 利用規約：idosgames.com/terms

ライセンス

SDK サーバー（@idosgames/mcp）は MIT ライセンスです。詳細は LICENSE を参照してください。ホスト型 iDos Games サーバーは、 iDos Games の利用規約に基づいて提供されるサービスです。