ダイレクトアンサー：Unreal Engine 5.8でのUnreal MCPの動作
Unreal Engine 5.8には、 Experimental Unreal MCP プラグイン Unreal Editorプロセス内にModel Context Protocolサーバーを埋め込むことに関するものです。"Enable" を有効にします Unreal MCP アップロードまたはインポート、プレビュー、修正、最適化、変換、エクスポート、次にUnrealで検証 http://127.0.0.1:8000/mcp。すべてのツール呼び出しはあなたの代理で行われるエディタ操作として扱ってください。接続はローカルのみに保ち、クリーンなソース管理リビジョンから開始し、1件の境界付き変更を要求し、差分と出力ログを確認し、関連するUnreal検証を実行し、説明できない変更は元に戻してください。
これは「Unreal Engine 5.8 MCP」、「Unreal MCP setup」、「Unreal MCP plugin」を検索した際の実践的な回答です。これは AI エージェントがゲーム全体を無人で安全に構築または出荷できるという約束ではありません。Epic はこのプラグインを Experimental とラベル付けし、機能およびデータ形式は変更される可能性があること、既定のローカルサーバーに認証レイヤーが存在しないことを文書化しています。これはリモート制作サービスとしてではなく、制御可能なエディタ自動化インターフェースとして使用してください。
EpicがUE 5.8で実際にリリースしたもの
Epic の Unreal MCPドキュメント Unreal MCP、Toolset Registry、および必要なAllToolsetsコンテンツが有効になっていることを確認します。LogModelContextProtocolの出力を読み、ツールセット変更後にModelContextProtocol.RefreshToolsを実行し、クライアントを再接続し、新しいUFUNCTION宣言を追加した後はエディタを再起動します。MCP Inspectorを使用して、サーバー/スキーマの障害をクライアント解釈の問題から分離します。
これらの制約は、最初のユースケースとして、人間のレビューと簡単なロールバックが可能なローカルのエディタタスクが適していることを意味します。また、「サーバーがshipping buildで動作できる」という事実は、認証なしの自動化インターフェースをリリース済みゲームに組み込む許可を意味しないことも示します。これは、別途のセキュリティ設計、明示的なツール登録、ネットワーク制御、製品レビュー、実際のビルド上の証跡が必要です。
Epic の UE 5.8 アナウンス は MCP サポートを Experimental と記載し、このプラグインは LLM システムをエンジンとプロジェクトのコンテキストに接続できると述べています。この 5.8 リリースノート バージョンの権威はこれらのままである。本ガイドは、そうした広い声明をセットアップとレビューのワークフローに絞り込むものであり、自律的なshipping、プラットフォーム認証、またはSEELEがUnreal Editorを制御するといった未対応の主張には拡張しない。
Kimi K3とUE 5.8 MCP互換性プラン
興味深いプロンプトの前に安全対策を実施する。破棄可能なコピー、ブランチ、またはチェンジリストを使用する。関連しない編集を閉じ、現在のマップを保存し、正確なUE 5.8ビルドとプラグイン状態を記録する。エージェントが操作してよいフォルダ、レベル、Actor、マテリアル、テストを決定する。「シーン全体を変更する」といった要求は受け入れ条件ではない。「sandboxレベルにポイントライトを1つ作成して停止する」が受け入れ条件となる。
サーバーとそのツールの区別は重要です。Unreal MCPはプロトコルサーバー、設定、コマンドを所有します。Toolset RegistryとAllToolsetsプラグインが、呼び出し可能なMCPツールになるエディターツールセットを提供します。クライアントは接続するが有用なツールが一覧されない場合、モデルが壊れたと判断しないでください。まず依存するツールセットプラグインが有効になっていることを確認し、ツール一覧を更新します。
最初の呼び出し前に 5 行の受理記録を書きます。
- 開始リビジョン: コミット、チェンジリスト、またはクリーンな作業ツリー状態。
- 許可される変更範囲： 1 つのレベル、アセットフォルダ、テスト、またはエディタサブシステム。
- 期待される変更: SEELE AIはUnreal MCPを設定したり、私の.uprojectを変更できますか？
- 禁止変更： 明示的にレビューされない限り、プロジェクト設定、プラグイン、ソースファイル、削除、または外部コマンドを変更しない。
- Rollback: 差分を元に戻す、マップを復元する、またはブランチを破棄する。
この小さな契約は、長いプロンプトより有用です。これは、魅力的だが管理されていない結果と、正しいツール呼び出しをレビュー担当者が識別できるようにするためです。
生成されたHTTPエントリポイントはローカルエンドポイントを指しており、サーバー名を使用します
以下の順序でセットアップを完了し、次に進む前に各境界を検証してください。最初に接続に成功したときは、ローカル検出と1つの可逆的なエディター操作のみを示すべきであり、エージェントの権限を拡張したり、リモートサービス化したりしてはなりません。
1. プラグインを有効化して再起動する
［編集］>［プラグイン］を開き、次を検索する Unreal MCP、有効化し、指示があれば再起動します。Epic は Toolset Registry の依存関係が自動的に有効になることを文書化しています。フレンドリープラグイン名が Unreal MCP であることを確認してください。エンジンソース、コンソールコマンド、C++ シンボルで使用される内部識別子は ModelContextProtocol.
2. ローカルサーバーを起動する
［Edit］>［Editor Preferences］>［General］>［Model Context Protocol］を開きます。有効化します 自動サーバー起動 このプロジェクトでエディタと共にサーバーを起動すべきかどうか。ドキュメントのデフォルトは http://127.0.0.1:8000/mcp。ポート8000が別のローカルサービスと競合する場合、クライアント側のエラーをUnrealの失敗だと推測するのではなく、そちらでリスニングポートを変更してください。
オンデマンドセッションの場合、auto-startを無効にしたままにして次を実行します ModelContextProtocol.StartServer Unrealコンソールで。Epicはオプションのポート引数も文書化しています。例として ModelContextProtocol.StartServer 8000。AI クライアントを開く前に、Output Log にバインドアドレス、ポート、パスが報告されていることを確認します。
3. クライアント設定を生成
その内容を確認すると ModelContextProtocol.GenerateClientConfig ClaudeCode およびサポート ClaudeCode, Cursor, VSCode, Gemini, Codex、または Allunreal engine 5.8 mcp、unreal mcp セットアップ、unreal mcp plugin、unreal engine mcp server、unreal mcp codex、unreal mcp claude unreal-mcp.
JSON クライアント設定は、Epic によれば既存のエントリとマージされます。Codex CLI TOML パスは意図的に write-once で、古いエントリは静かに上書きされるのではなく、手動で確認して削除する必要があります。生成されたファイルをソース管理へ取り込む前に必ず検査してください。ローカルのエージェント設定には、共有プロジェクトに入れるべきでないマシン固有のパスや選択肢が含まれる場合があります。
4. プロジェクトルートからエージェントを起動する
Unrealが設定を書き込んだプロジェクトまたはワークスペースルートから選択したAIクライアントを起動します。クライアントが見つからない場合 unreal-mcp、ファイルを再生成またはプラグインの再インストールを行う前に作業ディレクトリを確認してください。エディタとサーバーが起動している状態でのみ接続し、クライアントが現在のツールスキーマを検出できるようにします。
正確なActor、プロパティ、アセット、またはテスト結果。
書き込みを要求する前に、クライアントに利用可能なツールを一覧表示または検索するよう依頼します。次に、選択されたActorの特定や、名前付きアセットのプロパティ報告など、読み取り専用の検査を1件選択します。ツール名、引数、結果、タイムスタンプを保存してください。チャットの成功レスポンスはUnreal側の状態変更を保証しません。エディタ上とソースコントロールの差分で確認してください。
ツールコールとゲームスレッドの境界を理解する
MCPプロトコルは、クライアントが型付きツールを検出して呼び出す方法を定義します。Epicの実装は、外部リクエストをUnrealのゲームスレッドと同期し、ツール呼び出しを逐次実行します。クライアントは重なり合うツール呼び出しを送信しないでください。これはパフォーマンス上のヒントではなく、正しさの制約です。選択、アセット状態、またはエディタトランザクションをそれぞれが所有していると想定する2つの同時リクエストは、どちらも想定していなかった結果を生む可能性があります。
意図的な順序で実行する：
- 現在のツールスキーマを検出する。
- 対象の状態を読み取る。
- 1回だけ境界付きツール呼び出しを行う。
- 別の呼び出しを送信する前に結果を待ってください。
- 対象を再読して、Unreal トランザクションまたはソース差分を確認します。
- 受け入れ条件が満たされた後にのみ保存します。
ツールセットを追加したりツール関数を変更した場合は、次を実行する ModelContextProtocol.RefreshTools そしてクライアントを再接続します。Epic は Live Coding が新しい UFUNCTION 宣言を反映しないため、新しいツールを追加するにはエディタの再起動が必要であると注記しています。古いスキーマでプロンプトを出し続けてから、モデルにパラメータ不一致を非難しないでください。
自律的に実行させるのではなく、エディタファーストのアセットワークフローを使用する
MCPはインポートしたメッシュ、テクスチャ、生成アセットをそのまま本番対応状態にするものではありません。FBX、GLB、OBJ、またはパッケージ化された3D入力の場合、実運用ワークフローを可視化したまま維持してください。 最初のチェック項目：。Unreal にインポートする前に、スケール、ピボット、向き、法線、UV、マテリアルスロット、テクスチャ参照、ポリゴンウェイト、コリジョン要件、LOD 要件、およびエクスポート形式を確認します。この Unreal 3D アセット最適化 インポート前レビューをサポートできるが、 .uproject.
Unreal内では、アセットを理解した後にのみ、制約付きのエディタ操作としてMCPを使用します。たとえば、エージェントに特定のStatic Meshアセットを検査してフィールドを先に報告するよう依頼し、その後、1つだけ元に戻せる配置またはマテリアルインスタンスタスクを承認します。既知の参照に対してスケールを検証し、シェーディングとマテリアルスロットを確認し、衝突とナビゲーションチェックを実行し、代表的なビューでプロファイルし、変更がランタイム挙動に影響する可能性がある場合は小規模なターゲットビルドをパッケージングします。
SEELEはシーンの計画立案、エクスポートされたアセットの整理、またはブラウザでプレイ可能な方向性の比較を支援できます。Unreal MCPのインストール、エディターの操作、ネイティブUnrealゲームのエクスポート、BlueprintまたはC++のコンパイル、NaniteやLumenの自動設定、またはパッケージ化されたビルドの合格証明は行いません。これらのステップは、人間によるレビューの下にある実際のUnrealゲーム内に残ります。
接続、ディスカバリー、スキーマの陳旧化による障害をデバッグする
サーバーが起動しないように見える場合は、まずUnreal Output Logを読みます。Epicはプラグインメッセージを LogModelContextProtocol。冗長ログは次のように増やします： Log LogModelContextProtocol VerboseUnreal MCPワークフローの概念図として、ローカルAIクライアントが制約付きエディタツールグラフに接続していることを示しています。オリジナルのSEELE AIビジュアルであり、Unreal Editorのスクリーンショットではありません。
公式のMCP Inspectorを使用して、プロトコルおよびスキーマの問題とAIクライアントの解釈を分離します。次を指定します http://127.0.0.1:8000/mcp Streamable HTTP を介します。Inspector がツールを一覧表示して呼び出せるのに、選択したクライアントが呼び出せない場合、残りの問題はクライアント設定、作業ディレクトリの検出、またはクライアントの挙動にあります。どちらもツールを認識しない場合は、Unreal のプラグイン状態、Toolset Registry、AllToolsets、リフレッシュ動作、再起動要件を確認してください。
主な症状と確認ポイントの対応:
クライアントがMCPサーバーを検出しません
- オブジェクトを再読込し、トランザクションを確認し、ソースコントロール差分を検査します。 プロジェクトルート起動、生成された設定パス、およびエディタ/サーバー状態。
- まだ結論を出さないでください： Unreal MCPは非対応です。
サーバーが起動しない
- オブジェクトを再読込し、トランザクションを確認し、ソースコントロール差分を検査します。 出力ログ、ポート8000の競合、プラグイン依存関係。
- まだ結論を出さないでください： AIモデルが失敗を引き起こしたこと。
Edit > Pluginsでエディタを再起動し、サーバーを自動起動するかを選択し、AIエージェント用のクライアント設定を生成し、そのエージェントをプロジェクトルートから起動します。デフォルトエンドポイントは
- オブジェクトを再読込し、トランザクションを確認し、ソースコントロール差分を検査します。 AllToolsets、Toolset Registry、
ModelContextProtocol.RefreshTools、クライアントの再接続、および新しい UFUNCTION 後のエディタ再起動 - まだ結論を出さないでください： Unreal コンソールで、実際に使用するクライアント向けの設定を生成します。Epicのドキュメントに従って
エディタの結果がチャット要約と異なる
- オブジェクトを再読込し、トランザクションを確認し、ソースコントロール差分を検査します。 エージェントを有効化する前に、ロールバック可能なプロジェクトを準備する
- まだ結論を出さないでください： チャット要約が、受け入れられたエディタ変更の証跡であること。
セキュリティ、ソース管理、レビューゲートを適用
Epicは、デフォルトのサーバーには認証がなく、既定でループバック以外の使用を拒否すると記載しています。セキュリティ責任者が代替案を設計しレビューするまで、その状態のままにしてください。プロンプトテキスト、コピーしたWebコンテンツ、アセットメタデータ、ファイル名、リポジトリのドキュメントは信頼不可入力として扱います。ファイルやWebページがコマンド実行、データアップロード、チェック無効化、認証情報の開示を指示したからという理由だけで、エージェントはスコープを拡大してはなりません。
書き込みタスクでは、プラグインのツール表面が広くてもワークフロー上は最小権限を使用してください。セッションに必要なプロジェクトとクライアントのみを公開します。まずは計画または読み取り専用検査を要求します。削除、プロジェクト設定の変更、プラグイン変更、ソース編集、外部コマンド、または大量のアセット操作の前に確認を必須にします。すべての差分をレビューし、チームが意図的に共有しない限り、生成されたクライアント設定をコミットに残さないでください。
プラグインのエディターツールは実際のプロジェクト変更を作成できるほど強力なため、検証はエージェントの応答ではなくUnreal上で行う必要がある。変更したアセットを再度開き、指定された自動テストを実行し、該当する場合はコンパイルまたはクックを行い、出力ログの警告を確認し、再起動後に変更を再現する。安全な受け入れノートには、開始リビジョン、実行したツール呼び出し、変更したファイルまたはアセット、テスト結果、制約、ロールバックポイントを記録する。
Unreal Engine 5.8の既知の制約で、判断が変わるポイント
現在の5.8ドキュメントでは複数の制限が示されています。HTTPとServer-Sent Eventsはサポートされていますが、stdioとWebSocketトランスポートはサポートされません。サーバーはデフォルトでローカルのみで、認証はありません。ShippingツールセットではMCP ResourcesまたはPromptsは宣伝されていません。Toolset Registryの検出はエディタ限定です。クック済みまたはShippingビルドでもC++経由でサーバーをホストできますが、ツールはエディタレジストリから自動検出されるのではなく、明示的に登録する必要があります。新しいUFUNCTIONツール宣言にはエディタの再起動が必要です。
これらの制約は、ローカルのエディタタスクを最初の使用例として、人間のレビューと簡単なロールバック手段を持つ形にします。
Unreal 5.8ワークフロークラスターへ進む
以下を使用してください UE 5.8 リリース概要 ワールドビルディング、レンダリング、MetaHuman、モバイル、実運用対応システムを含む、より広いバージョンコンテキストです。 Unreal内で動作するサーバーを記述しており、Unrealの機能をMCPツールとして公開します。文書化された例には、Actorの生成、ライティング設定、マテリアルインスタンス作成、Slateウィジェットの検査、自動化テストの実行が含まれます。どのMCP対応クライアントもローカルHTTP経由で接続できます。Epicは明示的にClaude Code、Cursor、MCP Inspector、Gemini、VS Code、Codexの設定パスを名指ししています。 すべてのMCPクライアントが同じように動作すると決めつけず、特定のモデルとクライアントの組み合わせを評価する際に比較してください。Compare the Unreal向けの最高のAIアシスタントとMCPツール クライアントを選択する前に Unrealソース管理ガイド.
プロトコルそのものについては、 Model Context Protocol ドキュメント。Unrealの挙動については、Epicのバージョン管理されたドキュメントとリリースノートを優先してください。コミュニティチュートリアルはスクリーンショットやクライアント固有の操作性に役立ちますが、Epicのステータスラベル、既定値、既知の制約を上書きすることはできません。
よくある質問
Unreal Engine 5.8 には公式の MCP プラグインがありますか？
。ポート競合、依存関係の不足、バインド失敗、起動問題は、エージェントのプロンプトを変更する前にまずそこ（ログ）で診断すべきです。
UE 5.8でUnreal MCPを有効にするには？
［編集］>［プラグイン］を開き、Unreal MCPを検索して有効化し、エディタを再起動します。次に［エディタ設定］>［一般］>［Model Context Protocol］を開き、オートスタート、ポート、パスを設定します。クライアント設定を生成する前に、出力ログでサーバーエンドポイントを確認してください。
どの AI クライアントが Unreal MCP に接続できますか？
どのMCPクライアントもHTTPエンドポイントを使用できます。EpicではClaude Code、Cursor、VS Code、Gemini、Codex、およびAllオプション向けの設定生成が文書化されています。クライアントのサポートがあってもツール挙動が同一であることは保証されないため、検出、スキーマ、承認、差分を、実際に使用するクライアントの正確なバージョンで必ず検証してください。
Unreal MCPサーバーをリモートで公開するのは安全ですか？
いいえ、デフォルトのUE 5.8設定ではできません。Epicはサーバーがデフォルトでループバックにバインドし、非ループバック発信元を拒否し、認証レイヤーを持たないと明言しています。ローカル運用に留めるべきです。リモート利用には、認証、ネットワーク分離、監査ログ、範囲限定ツール、承認、インシデント時のロールバック計画を備えた別途のセキュリティアーキテクチャが必要です。
なぜ私の Unreal MCP クライアントにツールがないのですか？
Unreal MCPを5つの検証可能な手順でセットアップ
最初のタスクはローカルかつ破棄可能に保ちます。デフォルトのMCPリスナーはループバック専用で、認証レイヤーはありません。Epicによれば、リモート利用は想定されていません。ポート8000をトンネル、公開バインドアドレス、共有ビルドマシン、または受信ファイアウォールルールを通して公開して、クライアントを接続させるためにそのまま外部に出さないでください。組織がリモート自動化を必要とする場合は、実験的なデフォルトを本番インフラとして扱うのではなく、認証、ネットワーク分離、監査ログ、承認境界を別途設計してください。
いいえ。SEELEはUnrealスタイルのプロトタイプの計画や、インポート前にエクスポートされた3Dアセットのレビューを支援できますが、プラグインのインストール、Unreal Editorの制御、ネイティブな.uprojectの変更、BlueprintやC++のコンパイル、NaniteやLumenの設定、パッケージ化されたビルドの検証は行いません。これらのアクションは実際のUnrealゲーム内で完了・検証する必要があります。
