AIクライアントの接続 — Unity

このページでは、AIクライアントがUnity Editorに到達する仕組み、使用するエンドポイントとサインイン、およびサポートされる各エージェントをAI Game Developerウィンドウ、unity-mcp-cli、または手動で設定する方法を説明します。

2つの接続方法

AIクライアントがUnityと直接通信することはありません。どちらもMCPサーバーに接続し、サーバーがSignalR接続を介してツール呼び出しをEditorにルーティングします。

	クラウド（デフォルト）	カスタム（ローカル）
サーバー	ホストされたエンドポイント `https://ai-game.dev/mcp`	プラグインがダウンロードして起動する `gamedev-mcp-server`
Editor接続	プラグインがai-game.devに接続	プラグインが `http://localhost:<port>` に接続
クライアントエンドポイント	`https://ai-game.dev/mcp/p/<pin>`（ピン留め）または `https://ai-game.dev/mcp`	`http://localhost:<port>`、またはstdio経由のサーバーバイナリ
サインイン	ai-game.devアカウント（OAuthデバイスフロー）	なし、ai-game.dev OAuth、または共有トークン
オフライン動作	不可	可（`none`または`token`認可の場合）

モードはAI Game DeveloperウィンドウのConnectionスイッチ（Custom / Cloud）で選択します。Configurationではローカルサーバーの設定について説明しています。

ピン留めURL

ベースエンドポイントhttps://ai-game.dev/mcpは、フォールバックとして接続済みのEditorの1つにルーティングされます。開いているプロジェクトが1つだけなら問題ありませんが、複数ある場合は曖昧になります。

ピン留めURL https://ai-game.dev/mcp/p/<pin>は、常に1つのプロジェクトのEditorにルーティングされます。ピンはプロジェクトのIDから生成されます。ウィンドウのConfigureボタンとunity-mcp-cli setup-mcpはデフォルトでピン留めURLを書き込み、setup-mcp --no-pinは代わりにベースURLを書き込みます。stdioトランスポートの場合、ピンはproject=<pin>引数として渡されます。

Editor、CLI、デスクトップアプリは、~/.ai-game-dev/credentials.jsonに保存されたマシン全体で共有される1つのサインインを共有します。いずれかで一度サインインしてください:

ウィンドウで: クラウドモードにしてからAuthorize、ブラウザでコードを承認します。
ターミナルで: unity-mcp-cli login。
AI Game Devアプリで: Sign in。

トークンはバックグラウンドで更新されます。ウィンドウのRevokeは、マシン上のすべてのAI Game Devツール（すべてのエンジンプラグイン、CLI、デスクトップアプリ）からサインアウトし、サーバー上のトークンを取り消します。

AIクライアント自体の認証方法は、書き込まれた設定によって異なります:

プロジェクトキー（サインイン時のCloud HTTPのデフォルト）。 設定にはAuthorization: Bearer agd_pk_…が含まれます。これは有効期限がなく、このプロジェクトにのみ紐付けられた取り消し可能なキーです。キーは~/.ai-game-dev/project-keys.jsonに保存されます。ウィンドウのRegenerate key、またはsetup-mcp --regenerate-keyで置き換えられ、古いキーは取り消されます。
OAuth（URLのみ）。 ファイルに認証情報は含まれず、クライアントは初回接続時にブラウザのサインインを開きます。サインインしていない場合、またはsetup-mcp --oauthを指定した場合にこの形式になります。
パーソナルアクセストークン。 CIやブラウザログインができないクライアント向けに、ai-game.devアカウントでトークンを作成し（Authentication参照）、setup-mcp --token <token>で渡します。

プロジェクトキーとトークンはパスワードと同様に扱ってください。.mcp.jsonなどのファイルはプロジェクトフォルダ内にあるため、コミットする前に.gitignoreを確認してください。アカウント側の説明はAuthenticationにあります。

サポートされるAIエージェント

ウィンドウのAI agentドロップダウンにこれらの設定項目が一覧表示されます。Configureは表示されたファイルを書き込み、Removeはエントリを再び削除します。

エージェント	書き込まれる設定ファイル	CLI id
Claude Code	`.mcp.json`（プロジェクトルート）	`claude-code`
Claude Desktop	Claudeのアプリデータフォルダ内の`claude_desktop_config.json`	`claude-desktop`
Cursor	`.cursor/mcp.json`	`cursor`
Visual Studio Code（Copilot）	`.vscode/mcp.json`	`vscode-copilot`
Visual Studio（Copilot）	`.vs/mcp.json`	`vs-copilot`
Rider（Junie）	`.junie/mcp/mcp.json`	`rider-junie`
GitHub Copilot CLI	`~/.copilot/mcp-config.json`	`github-copilot-cli`
Gemini	`.gemini/settings.json`	`gemini`
Antigravity	`~/.gemini/config/mcp_config.json` と `~/.gemini/antigravity/mcp_config.json`	`antigravity`
Cline	VS Codeのグローバルストレージ内の`cline_mcp_settings.json`	`cline`
Open Code	`opencode.json`	`open-code`
Codex	`.codex/config.toml`	`codex`
Kilo Code	`.kilocode/mcp.json`	ウィンドウのみ
Zoo Code	`.roo/mcp.json`	ウィンドウのみ
Unity AI	`UserSettings/mcp.json`	`unity-ai`
その他 - カスタム	コピー用のJSONを表示	`custom`

相対パスはUnityプロジェクト内を指します。サーバーエントリ名は常にai-game-developerです。unity-mcp-cli setup-mcp --listを実行すると、お使いのCLIバージョンがサポートするidを確認できます。

unity-mcp-cli で設定する

setup-mcp は、Unity を開かずに、ウィンドウの Configure ボタンと同じ出力を書き込みます:

unity-mcp-cli setup-mcp claude-code ./MyUnityProject
unity-mcp-cli setup-mcp cursor ./MyUnityProject --transport stdio
unity-mcp-cli setup-mcp claude-code ./MyUnityProject --no-pin

デフォルトのトランスポートは http です。--transport stdio を指定すると、代わりにローカルサーバーバイナリを起動する設定になります。すべてのフラグは CLI リファレンスにあります。

手動で設定する

HTTP をサポートする MCP クライアントならどれでも、ホストされたエンドポイントを利用できます。Claude Code の例:

claude mcp add --transport http ai-game-developer https://ai-game.dev/mcp

汎用的な mcpServers JSON 設定:

{
  "mcpServers": {
    "ai-game-developer": {
      "url": "https://ai-game.dev/mcp"
    }
  }
}

1つのプロジェクトを対象にするには、URL をプロジェクトの固定 URL（ウィンドウの手動設定手順に表示されます）に置き換えてください。MCP エンドポイントのページには、VS Code の servers 形式や PAT ヘッダーなど、すべてのクライアント向けのスニペットがあります。

HTTP 経由のローカルサーバー

Custom モードで HTTP トランスポートを使う場合、クライアントをローカルサーバーに向けます。ポートはウィンドウの Server URL に記載されているものです。ウィンドウに表示されるお使いのエージェント向けの手動設定手順には、プロジェクトの固定を含む正確な URL が含まれています:

{
  "mcpServers": {
    "ai-game-developer": {
      "url": "http://localhost:<port>"
    }
  }
}

stdio 経由のローカルサーバー

stdio トランスポートでは、クライアントがサーバーバイナリ自体を起動します。Windows の場合:

claude mcp add ai-game-developer "<project>/Library/mcp-server/win-x64/gamedev-mcp-server.exe" port=<port> plugin-timeout=10000 client-transport=stdio

他のプラットフォームでは osx-arm64、osx-x64、linux-x64、linux-arm64、win-x86、win-arm64 を使用します（Windows 以外では .exe を付けません）。<project> はプロジェクトのフルパスに、<port> はウィンドウに表示されるポートに置き換えてください。stdio サーバーを同時に使用できるエージェントは1つだけであり、エージェントがプロセスを所有するため、ウィンドウの Start/Stop ボタンは無効になります。クライアントが HTTP をサポートしていない場合を除き、HTTP を推奨します。

設定後

AI クライアントを再起動するか、その MCP サーバーに再接続して、新しい設定を読み込ませてください。その後、はじめにに従って接続を確認します。クライアントにツールが表示されない場合は、トラブルシューティングを参照してください。

2つの接続方法#

ピン留めURL#

サインイン#

サポートされるAIエージェント#

unity-mcp-cli で設定する#

手動で設定する#

HTTP 経由のローカルサーバー#

stdio 経由のローカルサーバー#

設定後#