# AIクライアントの接続 — Unreal Engine · AI Game Developer Wiki

Claude Code、Cursor、Copilot、Codex、Gemini などの MCP クライアントを、ai-game.dev のクラウドエンドポイントまたはローカルサーバー経由で Unreal MCP に接続します。

このページは英語から機械翻訳されています。[英語の原文を読む](https://ai-game.dev/docs/wiki/unreal/connecting-ai-clients)。

このページでは、AI クライアントがどのように Unreal Editor に到達するか、サインインの仕組み、そしてサポートされている各エージェント向けの MCP 設定の書き方を説明します。最短の方法だけを知りたい場合は、エディタの **AI agent** セクションにある **Configure** ボタン（[はじめに](https://ai-game.dev/ja/docs/wiki/unreal/getting-started#ai-client) を参照）がすべてを行ってくれます。

## Cloud か Custom: 接続モードを選ぶ

AI Game Developer ウィンドウの **Connection** セクションには **Custom / Cloud** スイッチがあります。同じ設定は `UNREAL_MCP_CONNECTION_MODE` です（[設定](https://ai-game.dev/ja/docs/wiki/unreal/configuration) を参照）。

|  | 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 エンドポイントのページ](https://ai-game.dev/ja/mcp-endpoint-info) を参照してください。

### デバイスコードフローでサインインする

サインインはマシンごとに 1 回だけです。次のいずれの方法でもよく、アプリ、他のエンジンプラグイン、CLI と共通の認証情報ストア（`~/.ai-game-dev/credentials.json`）を共有します:

- エディタ内: **Cloud** を選択し、**Authorize** をクリックして認証ページを開き、ウィンドウに表示されたユーザーコードを入力して承認します。
- ターミナル内: `unreal-mcp-cli login`。
- AI Game Dev アプリ内: 通常どおりサインインします。

**警告:** エディタの **Revoke** は、このプロジェクトだけでなくマシン全体をサインアウトさせます。認証情報を共有するすべての AI Game Dev ツール（エンジンプラグイン、CLI、デスクトップアプリ）がサインアウトされるため、エディタは最初に確認を求めます。

アカウント、デバイス、トークンの仕組みについては [認証ページ](https://ai-game.dev/docs/auth) で説明しています。

### プロジェクト固定 URL

アカウントに複数のエディタが接続されている場合、`https://ai-game.dev/mcp` という URL をそのまま使うクライアントは誤ったエディタに到達する可能性があります。そのため、プラグインと `unreal-mcp-cli setup-mcp` はデフォルトで **プロジェクト固定** の URL を書き込みます:

```text
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 の間で一致します。

エディタから起動するには:

1. Connection セクションを **Custom** に切り替えます。
2. **MCP server** カードで **http** トランスポートを選択し、**Start** をクリックします。固定されたサーバーリリースが見つからない場合はエディタがダウンロードして起動し、エディタの終了時に停止します。Start ボタンは Custom モードかつ http トランスポートの場合にのみ動作します。
3. **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` を渡します）。

```bash
# 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 を使う場合は次のとおりです。

1. `unreal-mcp-cli setup-mcp claude-code --path ./YourProject` を実行します（またはエディタで Claude Code を選択して **Configure** を実行します）。
2. プロジェクトフォルダから Claude Code を起動します。
3. 「現在のレベルのアクターを一覧表示して」と依頼し、Unreal のツールが利用可能であることを確認します。

任意で、`unreal-mcp-cli setup-skills --path ./YourProject` を実行すると、Claude Code 用のスキル（`.claude/skills/unreal-mcp/SKILL.md`）が書き込まれ、このプロジェクトの MCP サーバーをどう操作するかを Claude に伝えます。

## その他のクライアント

上記に挙げていないものを含む多くのクライアント向けの既成の設定スニペットは、[MCP endpoint ページ](https://ai-game.dev/ja/mcp-endpoint-info)にあります。[エコシステムの概要](https://ai-game.dev/ja/docs/ecosystem)では、サーバー、プラグイン、アプリがどのように連携するかを説明しています。

---

Source (HTML): https://ai-game.dev/ja/docs/wiki/unreal/connecting-ai-clients

Machine-translated (ja) from the English page: https://ai-game.dev/docs/wiki/unreal/connecting-ai-clients