設定 — Unreal Engine · AI Game Developer Wiki

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

設定の保存場所

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

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

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

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

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

環境変数や .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、拡張機能は 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 を追加します:

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

Unreal のプロジェクトテンプレートには .gitignore が含まれていないため、このコマンドは必要に応じて作成します。そのままにしておくには --no-gitignore を渡してください。すべてのフラグは CLI リファレンスにあります。

警告: .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" と表示されます。

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

設定の保存場所#

AI Game Developer ウィンドウ#

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

その他のウィンドウ#

環境変数#

CLI で .env を書き出す#

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

ポート#