AIクライアントの接続
Claude Code、Cursor、Copilot、Codex、Gemini などの MCP クライアントを、ai-game.dev のクラウドエンドポイントまたはローカルサーバー経由で Unreal MCP に接続します。
このページでは、AI クライアントがどのように Unreal Editor に到達するか、サインインの仕組み、そしてサポートされている各エージェント向けの MCP 設定の書き方を説明します。最短の方法だけを知りたい場合は、エディタの AI agent セクションにある Configure ボタン（はじめに を参照）がすべてを行ってくれます。
Cloud か Custom: 接続モードを選ぶ
AI Game Developer ウィンドウの Connection セクションには Custom / Cloud スイッチがあります。同じ設定は UNREAL_MCP_CONNECTION_MODE です（設定 を参照）。
| Cloud（デフォルト） | Custom | |
|---|---|---|
| サーバー | ai-game.dev のホスト型エンドポイント | 自分で実行する gamedev-mcp-server（通常は localhost） |
| サインイン | ai-game.dev アカウントによるデバイスコードフロー | 任意: なし、共有トークン、または OAuth |
| ローカルで動作するもの | エディタとそのブリッジ | エディタ、そのブリッジ、ローカルサーバー |
| 適した用途 | ほとんどのユーザー、複数マシンでの利用、ファイアウォールをまたぐ作業 | 完全ローカル構成、オフライン作業、CI |
Cloud モード
Cloud モードでは、ブリッジが ai-game.dev に接続し、AI クライアントも同じエンドポイント https://ai-game.dev/mcp に接続します。サーバーはクライアントのツール呼び出しをエディタにルーティングします。エンドポイント自体については MCP エンドポイントのページ を参照してください。
デバイスコードフローでサインインする
サインインはマシンごとに 1 回だけです。次のいずれの方法でもよく、アプリ、他のエンジンプラグイン、CLI と共通の認証情報ストア（~/.ai-game-dev/credentials.json）を共有します:
- エディタ内: Cloud を選択し、Authorize をクリックして認証ページを開き、ウィンドウに表示されたユーザーコードを入力して承認します。
- ターミナル内:
unreal-mcp-cli login。 - AI Game Dev アプリ内: 通常どおりサインインします。
警告: エディタの Revoke は、このプロジェクトだけでなくマシン全体をサインアウトさせます。認証情報を共有するすべての AI Game Dev ツール（エンジンプラグイン、CLI、デスクトップアプリ）がサインアウトされるため、エディタは最初に確認を求めます。
アカウント、デバイス、トークンの仕組みについては 認証ページ で説明しています。
プロジェクト固定 URL
アカウントに複数のエディタが接続されている場合、https://ai-game.dev/mcp という URL をそのまま使うクライアントは誤ったエディタに到達する可能性があります。そのため、プラグインと unreal-mcp-cli setup-mcp はデフォルトで プロジェクト固定 の URL を書き込みます:
https://ai-game.dev/mcp/p/<pin>固定はプロジェクトフォルダから導出されるため、クライアントは常にこのプロジェクトのエディタにルーティングされます。代わりに固定なしの URL を書き込むには setup-mcp --no-pin を使用します。
プロジェクトキー
マシンがサインイン済みの場合、Cloud の設定には プロジェクトキー、つまりこのプロジェクトに紐づく Authorization: Bearer agd_pk_… ヘッダーも含まれます。これがあれば、エージェント側で別途サインインする必要はありません。キーは有効期限がなく、失効させることもでき、~/.ai-game-dev/project-keys.json にキャッシュされるため、プロジェクトのすべてのエージェントが再利用します。
setup-mcp --oauthは代わりに URL のみの設定を書き込み、エージェントが自身で OAuth サインインを実行します。setup-mcp --regenerate-key、またはエディタの AI agent セクションにある Regenerate key ボタンは、新しいキーを作成し、設定済みのエージェントを新しいキーで書き換え、古いキーを失効させます。- 明示的な
--tokenはどちらよりも優先されます。
マシンがサインインしていない場合、設定は URL のみとなり、エージェントが自身でサインインします。
Custom モード: ローカルサーバー
Custom モードでは、ブリッジは自分が管理するサーバー、通常はマシン上で動作する共有の gamedev-mcp-server に接続します。各プロジェクトにはプロジェクトパスから導出された 20000〜29999 の範囲の固定ローカルポートが割り当てられるため、設定なしでエディタと CLI の間で一致します。
エディタから起動するには:
- Connection セクションを Custom に切り替えます。
- MCP server カードで http トランスポートを選択し、Start をクリックします。固定されたサーバーリリースが見つからない場合はエディタがダウンロードして起動し、エディタの終了時に停止します。Start ボタンは Custom モードかつ http トランスポートの場合にのみ動作します。
- Authorization モードを選択します: none（ローカル、匿名）、token（共有シークレット。New で生成し、Reveal を押し続けると表示されます）、または oauth。
代わりにターミナルから起動するには、unreal-mcp-cli open ./YourProject --start-server --connection-mode Custom を使うか、unreal-mcp-cli configure で UNREAL_MCP_START_SERVER=true を設定します。
注意: ローカルサーバーをエディタに向けてもウィンドウに Cloud と表示される場合、ブリッジは ai-game.dev に接続しており、ローカルサーバーは「No connected clients」と応答します。Custom モードを明示的に設定してください。unreal-mcp-cli open に --host を渡すと Custom が自動的に選択されます。
setup-mcp でクライアント設定を書き込む
unreal-mcp-cli setup-mcp <agent> は、1 つのエージェント用の MCP 設定エントリを書き込みます。プロジェクトに保存された接続設定を読み取るため、まずエディタでプロジェクトを一度開いておく必要があります（または --url を渡します）。
# Claude Code: writes .mcp.json in the project
unreal-mcp-cli setup-mcp claude-code --path ./YourProject
# Cursor, with the local server over stdio instead of http
unreal-mcp-cli setup-mcp cursor --path ./YourProject --transport stdio
# Print the snippet without writing anything
unreal-mcp-cli setup-mcp vscode-copilot --path ./YourProject --dry-run
# List every agent and its config path
unreal-mcp-cli setup-mcp --list--transport stdio を指定すると、CLI は固定バージョンの gamedev-mcp-server リリースを <project>/Intermediate/UnrealMCP/server/ にダウンロードし、エージェントがそのサーバーを自分で起動します。
対応エージェント
| エージェント | setup-mcp の ID | 設定ファイル |
|---|---|---|
| Claude Code | claude-code | .mcp.json（プロジェクト） |
| Claude Desktop | claude-desktop | claude_desktop_config.json（ユーザー） |
| Cursor | cursor | .cursor/mcp.json（プロジェクト） |
| Visual Studio Code (Copilot) | vscode-copilot | .vscode/mcp.json（プロジェクト） |
| Visual Studio (Copilot) | vs-copilot | .vs/mcp.json（プロジェクト） |
| Rider (Junie) | rider-junie | .junie/mcp/mcp.json（プロジェクト） |
| GitHub Copilot CLI | github-copilot-cli | ~/.copilot/mcp-config.json（ユーザー） |
| Gemini | gemini | .gemini/settings.json（プロジェクト） |
| Antigravity | antigravity | ~/.gemini/ 配下の mcp_config.json（ユーザー） |
| Cline | cline | VS Code のグローバルストレージにある cline_mcp_settings.json（ユーザー） |
| Open Code | open-code | opencode.json（プロジェクト） |
| Codex | codex | .codex/config.toml（プロジェクト） |
| Kilo Code | kilo-code | .kilocode/mcp.json（プロジェクト） |
| その他の MCP クライアント | custom | mcp.json（プロジェクト） |
エディタの AI agent ドロップダウンでも同様のワンクリック設定が可能で、エントリを削除する Remove、Tutorial と Download / Docs のリンク、スキルをサポートするエージェント向けの Generate skill files も用意されています。
Claude Code と Unreal Engine
Claude Code は、起動したフォルダの .mcp.json を読み込みます。したがって Unreal で Claude Code を使う場合は次のとおりです。
unreal-mcp-cli setup-mcp claude-code --path ./YourProjectを実行します（またはエディタで Claude Code を選択して Configure を実行します）。- プロジェクトフォルダから Claude Code を起動します。
- 「現在のレベルのアクターを一覧表示して」と依頼し、Unreal のツールが利用可能であることを確認します。
任意で、unreal-mcp-cli setup-skills --path ./YourProject を実行すると、Claude Code 用のスキル（.claude/skills/unreal-mcp/SKILL.md）が書き込まれ、このプロジェクトの MCP サーバーをどう操作するかを Claude に伝えます。
その他のクライアント
上記に挙げていないものを含む多くのクライアント向けの既成の設定スニペットは、MCP endpoint ページにあります。エコシステムの概要では、サーバー、プラグイン、アプリがどのように連携するかを説明しています。