# 設定 — Unreal Engine · AI Game Developer Wiki

Unreal MCP を設定します - AI Game Developer ウィンドウ、MCP Tools の表示、プロジェクト設定ファイル、.env、およびすべての UNREAL_MCP_* 環境変数について説明します。

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

このページでは、現在 Unreal MCP が持つすべての設定と、その変更場所を一覧にしています。ほとんどの人は接続モードと AI エージェントのセットアップだけを触ればよく、残りはチューニング、自動化、CI 向けです。

## 設定の保存場所

Unreal MCP にはエディタ接続用の Project Settings ページはありません。すべては（Tools メニューの）**AI Game Developer** ウィンドウにあり、プロジェクトごとに次の場所へ保存されます。

```text
<YourProject>/Saved/Config/UnrealMcp/ai-game-developer-config.json
```

`Saved/` はどの Unreal プロジェクトテンプレートでもバージョン管理の対象外なので、このファイル内のトークンが既定でリポジトリに入ることはありません。

設定は次の順序で読み込まれ、優先度が高いものから適用されます。

1. プロセスの環境変数（たとえば `unreal-mcp-cli open` やシェルで設定されたもの）。
2. プロジェクトルートの `.env` ファイル。
3. 上記の設定ファイル。
4. 組み込みのデフォルト値。

環境変数や `.env` から取得された値はそのセッションにおいてファイルの値を上書きしますが、ファイルへ書き戻されることはありません。

## AI Game Developer ウィンドウ

| セクション | できること |
| --- | --- |
| ヘッダー | **Log Level**（Trace、Debug、Info、Warning、Error、Exception、None）を選択し、**Open log file** でプロジェクトのログフォルダを開き、プラグインの **Version** を確認 |
| 接続 | **Custom / Cloud** を切り替え。Cloud モードでは **Authorize**、**Cancel**、**Revoke**。Custom モードでは **Server URL** を設定。**Connect / Disconnect / Stop**。Unreal、MCP サーバー、接続中の AI エージェントのステータスと IPC ブリッジのポートを確認 |
| MCP サーバー（Custom モード） | ローカルの `gamedev-mcp-server` を **Start / Stop** し、**Transport**（http または stdio）と **Authorization** モード（none、token、oauth）を選択し、**New** でトークンを生成 |
| AI エージェント | エージェントを選択し、その MCP エントリを **Configure**、**Reconfigure**、**Remove**。**Tutorial** や **Download / Docs** を開く。**Generate skill files**。プロジェクトキーの **Regenerate key** |
| 拡張機能 | インストール済みおよび利用可能な拡張機能を確認し、**Refresh catalog**、**Install** または **Update**、拡張機能の有効化／無効化をリアルタイムで行い、**Compile (Live Coding)** |
| フッター | **Help / Talk**（Discord）、**Bug Report**（GitHub）、**GitHub Star**、**Restart bridge** |

接続の詳細は [Connecting AI clients](https://ai-game.dev/ja/docs/wiki/unreal/connecting-ai-clients)、拡張機能は [Extensions](https://ai-game.dev/ja/docs/wiki/unreal/extensions) を参照してください。

## MCP Tools ウィンドウ：ツールごとの表示設定

**Tools** から **MCP Tools** を開きます。ウィンドウには登録済みのすべてのツールがタイトル、ファミリー、説明とともに表示され、ツールごとの **Visible** チェックボックスと、「27 / 27 tools visible」のようなサマリーが表示されます。

- **Visible** は、そのツールを `tools/list` で AI エージェントに一覧表示するかどうかを決めます。不要なツールを非表示にすると、エージェントのツールリストが短くなり、トークンを節約できます。
- これはアクセス制御では**ありません**。非表示のツールも、クライアントが名前で呼び出せば実行されます。また `unreal-tool-list` は非表示のツールも（hidden とマークして）表示するため、エージェントはそれらを見つけられます。
- この選択は `hiddenTools` として保存され、エディタの再起動や拡張機能のリロード後も維持されます。

ツールをまったく提供しないようにするには、後述の `UNREAL_MCP_TOOLS` ホワイトリストを使用します。

## その他のウィンドウ

Tools メニューには **MCP Prompts** と **MCP Resources** ウィンドウもあります。現在のリリースでは空状態のメッセージが表示されますが、プラグインや拡張機能が登録したプロンプトとリソースは AI クライアントから引き続き利用できます。**Serialization Check** ウィンドウは、選択したアクターやオブジェクトを JSON にシリアライズして、ツールから見える内容を確認できるようにします。

## 環境変数

プラグインは次の `UNREAL_MCP_*` 変数をプロセスの環境変数またはプロジェクトの `.env` ファイルから読み込みます。

| 変数 | 用途 |
| --- | --- |
| `UNREAL_MCP_CONNECTION_MODE` | `Cloud`（デフォルト）または `Custom` |
| `UNREAL_MCP_HOST` | Custom モードでのサーバー URL。例：`http://localhost:<port>` |
| `UNREAL_MCP_CLOUD_URL` | クラウドのベース URL。デフォルトは ai-game.dev |
| `UNREAL_MCP_TOKEN` | 認証トークン。シークレットなのでコミットしないでください |
| `UNREAL_MCP_AUTH_OPTION` | Custom モードの認証：`none`、`token`、`oauth`（古い値 `required` は `token` として読み込まれます） |
| `UNREAL_MCP_KEEP_CONNECTED` | 起動時に接続を自動的に復元（デフォルトは true） |
| `UNREAL_MCP_TOOLS` | 提供するツールのホワイトリスト。空の場合はフィルタなし |
| `UNREAL_MCP_START_SERVER` | `true`：エディタがローカルサーバーを自身で起動し（Custom モード、http のみ）、終了時に停止します |
| `UNREAL_MCP_TRANSPORT` | `http` または `stdio` |
| `UNREAL_MCP_LOG_LEVEL` | ログの詳細度 |
| `UNREAL_MCP_TOOL_TIMEOUT` | 1 回のツール呼び出しの最大時間（ミリ秒）。デフォルトは `300000`（5 分） |
| `UNREAL_MCP_BRIDGE_PATH` | ブリッジバイナリへのパス。同梱のものより優先される開発者向けの上書き設定 |
| `UNREAL_MCP_SERVER_PATH` | ローカルの `gamedev-mcp-server` へのパス。`unreal-mcp-cli` が読み取り、サーバーのダウンロードをスキップします |

**ヒント:** 長い `python-execute` スクリプトや大きなアセットのインポートがタイムアウトする場合は、`UNREAL_MCP_TOOL_TIMEOUT` を上げてください。エディターが開始する前にタイムアウトしたツール呼び出しはスキップされ、後から実行されることはありません。

## CLI で .env を書き出す

`unreal-mcp-cli configure` はこれらの値を `<project>/.env` に書き込み、プロジェクトの `.gitignore` に `.env` を追加します:

```bash
unreal-mcp-cli configure --path ./YourProject --mode Custom --host http://localhost:23456 --start-server
```

Unreal のプロジェクトテンプレートには `.gitignore` が含まれていないため、このコマンドは必要に応じて作成します。そのままにしておくには `--no-gitignore` を渡してください。すべてのフラグは [CLI リファレンス](https://ai-game.dev/ja/docs/wiki/unreal/cli#configure) にあります。

**警告:** `.env` は絶対にコミットしないでください。`UNREAL_MCP_TOKEN` が含まれている可能性があります。

## ディスク上の認証情報とキー

| ファイル | 内容 |
| --- | --- |
| `~/.ai-game-dev/credentials.json` | マシン全体の ai-game.dev サインイン。アプリ、プラグイン、CLI で共有されます |
| `~/.ai-game-dev/project-keys.json` | Cloud MCP 設定で使用されるキャッシュされたプロジェクトキー |
| `<project>/Saved/Config/UnrealMcp/ai-game-developer-config.json` | プラグインのプロジェクトごとの設定 |
| `<project>/.env` | 任意のオーバーライド。コミットされません |

## ポート

- ローカル MCP サーバーは、プロジェクトパスから計算される 20000～29999 の固定のプロジェクト別ポートを使用します。CLI も同じ数値を計算するため、設定は不要です。
- プラグインとそのブリッジは 30000～39999 のループバックポートで通信します（衝突時は次の空きポート）。ウィンドウでは "IPC bridge port" と表示されます。

これらのポートをネットワークに公開する必要はありません。どちらもローカルです。

---

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

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