unreal-engine / uefn

UE 5.8とUEFNのUnreal MCPでAIエージェントがEditorを操作する仕組み

Unreal MCPのEditor操作、Toolset Registry、クライアント側の統制を整理し、ローカルLLMの利用者報告から実行・検証・停止の判断基準をまとめます。

起票日: 2026-08-21
更新日: 2026-09-08
対象: Unreal Engine 5.8 / UEFN 42.00（2026年8月20日確認） / ローカルLLMの利用者報告は2026年9月8日確認

概要

Unreal Engine 5.8では、AIエージェントをUnreal Editorへ接続するExperimentalのUnreal MCP Pluginが追加されました。2026年8月20日には同じ仕組みがUnreal Editor for Fortnite（UEFN）へ広がり、Codex、Claude Code、CursorなどからVerse、Creative Device、Verse Scene Graph、Play Sessionを操作できるようになりました。

これは、AIがコードを提案するだけでなく、Editorの状態を読み、オブジェクトを変更し、テスト結果を確認する開発フローをEpicが公式に扱い始めたことを意味します。一方、Editorへ接続するサーバーにどのような認証があり、Toolsetがどこまで権限境界になるかは分けて確認する必要があります。

この記事では、2026年8月21日時点のEpic、OpenAI、Unityの公式資料を基に、Unreal MCPの接続構造、UE 5.8とUEFNの違い、安全に使うための判断基準を整理します。

2026年9月8日にローカルLLMの利用者報告を追加し、ProgrammaticToolsetの説明を見直しました。既存の公式資料に基づく節は各情報日を維持しており、今回すべての機能を再検証したものではありません。

結論

Tool Callの形式、許可範囲内の実行、実データによる検証、停止は別々の評価項目です。ローカルLLMの報告も、これらをHarness側で強制する必要性を補強しています。
Unreal MCPは、MCP互換のAIエージェントがUnreal Editorを読み取り、変更するための公式Pluginです。
EpicはCodex、Claude Code、Cursorを接続例として挙げ、特定ベンダーのモデルやクライアントへ限定していません。
UE 5.8ではActor、Asset、Blueprint、Level、Material、Mesh、テストなど、広いEditor機能をToolとして公開できます。
UEFNではVerse、Creative Device、Verse Scene Graph、UMG、Play Sessionを対象とする専用Toolsetが提供されています。
CodexやClaude Codeを導入しただけでEditorへ自動接続されるわけではなく、Plugin、Toolset、MCP Server、クライアント設定の有効化が必要です。
Unreal MCP Serverは標準ではlocalhostへ限定されますが、クライアントを識別する認証層を持ちません。
Toolset Registryはエージェントへ公開する操作面を限定できますが、ユーザーやクライアントを認可する仕組みとは異なります。
UE 5.8のUnreal MCPはExperimentalであり、UEFN版にも座標変換やEditor停止に関する既知問題があります。
UnityとEpicの違いはEditor操作の可否ではなく、Unityが認可されたGatewayやCLIを強調し、EpicがEditor内MCPとToolsetによる拡張を強調している点です。

UE 5.8からUEFNへ広がった経緯

EpicのUE 5.8公式発表とUEFN向け発表を並べると、次の順序になります。

日付	出来事
2026年6月23日	UE 5.8を公開し、ExperimentalのUnreal MCP PluginをUnreal Editorへ追加
2026年8月20日	Fortnite 42.00でUnreal MCPをUEFNへ導入
UE6へ向けて	UEとUEFNの開発ストリームを統合しながら、UEFN対応機能を追加する方針を表明

UE 5.8は、Epicの現在の計画では最後の主要なUE5リリースです。EpicはUE5の修正を継続しながらUE6の開発を進めており、Unreal MCPについてもUEとUEFNで同じToolset Registryを利用する方向を示しています。

ただし、UE 5.8の全ToolsetがUEFNで利用できるわけではありません。2026年8月20日時点のUEFNには専用Toolsetが提供され、対応範囲は段階的に拡張される予定です。

エージェントがEditorでできること

Unreal MCPはEditorプロセス内へMCP Serverを組み込み、Editor機能を型付きToolとして外部クライアントへ公開します。エージェントはファイルだけでなく、Editorが保持する選択状態、Actor、Asset、Scene、実行結果へアクセスします。

UE 5.8

Unreal MCP公式ドキュメントでは、次のような操作が例示されています。

Actorの確認、生成、Transform変更
Lightingの設定
Asset、Level、Material、Meshの作成または編集
Blueprintを含むEditorシステムの操作
Slate Widgetの調査
Automation Testの実行と結果確認
PythonまたはC++による独自Toolsetの追加

Editor操作はMCP Server自体へ固定実装されているのではなく、Toolset Registryへ登録されたToolsetから供給されます。そのため、プロジェクトやPlugin固有の操作も追加できます。

UEFN

UEFN MCP公式ドキュメントとFortnite 42.00リリースノートでは、UEFN固有の範囲として次が示されています。

Verseファイルの読み取り、編集、コンパイル
Verse Scene Graph EntityとComponentの作成、変更、一覧取得
Creative Deviceの検索、配置、@editableプロパティの編集
UMGを使ったUIの構築
Play Sessionの開始、停止、状態確認
実行中SessionへのVerse変更反映とClient Logの確認

エージェントが作成したVerseファイル、Device、Entityは、Editor上で開き直し、Details PanelやOutlinerから人が編集できる実体として残ります。

MCP ServerとToolset Registryの構造

UE 5.8の標準的な接続は次の構造です。

Codex / Claude Code / Cursor
  → localhostのStreamable HTTP
  → Unreal MCP Server（Editorプロセス内）
  → Toolset Registry
  → 有効化されたToolsetとTool
  → Actor・Asset・Scene・Testなど

Unreal MCP Pluginは通信とTool呼び出しを担当し、実際の操作はToolsetが提供します。Toolset Registryは起動時にPythonまたはC++で定義されたToolsetを収集し、MCP Serverが各Toolを外部クライアントへ公開します。

UE 5.8ではAll Toolsets Pluginを有効にすると標準Toolsetをまとめて読み込めます。一方、必要なToolsetだけを個別に有効化することもできます。関数をMCPへ公開するには、Pythonでは専用Decorator、C++ではAICallableの指定が必要です。

標準設定のTool Searchでは、全ToolのSchemaを最初から送らず、次の三つのMeta Toolを使って必要なToolsetを実行時に探索します。

list_toolsets
describe_toolset
call_tool

これはContext量を抑える仕組みであり、クライアントの認証機能ではありません。

CodexやClaude CodeはそのままEditorを編集できるか

Editor側とクライアント側の準備が完了すれば、編集できます。ただし、エージェントをインストールしただけでは接続されません。

UE 5.8では、少なくとも次の設定が必要です。

Unreal MCP Pluginを有効にする。
All Toolsetsまたは必要な個別Toolsetを有効にする。
Editor内のMCP Serverを起動する。
CodexやClaude Codeへhttp://127.0.0.1:8000/mcpなどの接続先を登録する。
クライアント側でMCP Toolの実行を許可する。

UEFNでは、Python Editor ScriptingとUEFN MCP ToolsetsもProject Settingsで有効にします。

Epicは「任意のMCP互換エージェント」を接続対象としており、Codex、Claude Code、Cursorを具体例として挙げています。UnityのAuthorized Agentic Accessのように、接続するエージェント、モデル、MCPクライアントをEpicのallowlistで判定する構成は、現在の公式資料では示されていません。

一方、これはMCP Serverをインターネットへ公開するという意味ではありません。UE 5.8のServerは標準でlocalhostへbindし、非loopbackのOriginを拒否します。ただし認証層はないため、同じPC上でEndpointへ接続できるプロセスを、Server側でクライアントごとに識別して許可する構成ではありません。

Toolsetはどこまで権限境界になるか

Toolsetは、エージェントへ公開するCapabilityをコードと設定で限定するために利用できます。

不要なToolset Pluginを有効にしない
Toolset全体を有効または無効にする
Tool名に対するallowまたはblock filterを設定する
AIへ公開しない関数をToolの対象外にする
読み取り専用Toolsetと変更Toolsetを分ける

Toolset RegistryのAPIには、Toolsetの有効化と、Tool名に対するallow・block filterが用意されています。このため、権限をプロンプトだけに頼らず、呼び出せる操作そのものを減らす設計は可能です。

ただし、Toolsetは接続クライアントを認証しません。ProgrammaticToolset.execute_tool_scriptを無制限のPython実行と同一視しません。利用者報告では、importを制限し、Unreal Python、ファイル、ネットワークへの直接アクセスを許可しないと説明されています。これは報告上の条件であり、セキュリティ監査の結果ではありません。導入版の実装とexecute_toolから到達する各Toolを確認します。呼び出しをまとめても、内部操作の変更権限は狭くなりません。

EpicのClaude Code向け公式Pluginも、Unreal MCPへの接続を任意コード実行と同等の強い権限として扱い、事前のSource Control保存と差分確認を推奨しています。

したがって、Toolset Registryは「Capabilityを公開する境界」にはなりますが、それだけを完全なSecurity Sandboxとはみなしません。

クライアント側にも操作制限がある

EditorがToolを公開していても、AIエージェント側で実行前の承認やTool Filterを追加できます。

Codexは公式MCPドキュメントで、MCP Serverごとに次の設定を提供しています。

enabled_toolsによるallow list
disabled_toolsによるdeny list
すべて確認するprompt
書き込みToolだけ確認するwrites
ToolごとのApproval Mode

Epic側のToolsetを必要最小限にし、クライアント側でもToolと承認方法を絞ることで、二重に操作範囲を限定できます。Claude Codeなど別のクライアントを使う場合も、そのクライアントのTool承認設定を確認し、承認を省略する設定と強いEditor操作を組み合わせないようにします。

UE 5.8とUEFNの違い

観点	UE 5.8	UEFN 42.00
MCPの位置	Unreal Editor内	UEFN Editor内
主な対象	Actor、Asset、Blueprint、Level、Material、Mesh、Testなど	Verse、Creative Device、Verse Scene Graph、UMG、Session
Toolset	All Toolsetsまたは個別Plugin	UEFN向け専用Toolset
Play Loop	Editor操作とAutomation Test	Play-in-Client Sessionの開始、更新、ログ確認
対応状況	多数の標準Toolsetを提供	UE 5.8の全Toolsetには未対応
Fileの制限	Toolsetごとの実装に依存	Verse File操作をCreator Project内へ限定するSandboxを提供

UEFNで「Scene Graphを操作できる」という場合、2026年8月20日時点では主にVerse Scene Graph EntityとComponentを指します。UE 5.8側のActorやAssetを扱う全ToolsetがUEFNへそのまま移植された、という意味ではありません。

Experimental段階の制約

UE 5.8のリリースノートは、Unreal MCPをExperimentalとしています。公式ドキュメントも、未完成または未対応の機能があり、APIとデータ形式が変更される可能性を明記しています。

UEFN MCPには、次の既知問題があります。

Python Toolsetが使うXYZと、UEFNのLeft-Up-Forward座標系の変換で誤りが増える場合がある
MCP Toolの呼び出しによってEditorがhitchまたはhangする場合がある
UE 5.8の全Toolsetを利用できない

また、UE 5.8のMCP Serverには認証層がないため、localhostの外へ公開する用途には適しません。Experimental段階では、重要な本番Projectへ最初から広い書き込み権限を与えるのではなく、再現可能な小さい操作から評価します。

Unityとの違い

UnityとEpicの両方が、AIエージェントにEditorの状態を読ませ、変更し、Play ModeやTestで結果を確認させる方向へ進んでいます。「UnityはEditorを操作させず、Epicだけが操作させる」という分け方ではありません。

主な違いは接続経路と統制方法です。

Unity	Unreal Engine 5.8・UEFN
Authorized Agentic Accessとして、Unityが認めるGatewayやクライアントを要求	任意のMCP互換クライアントを接続対象として説明
Unity CLI、Pipeline package、公式MCP、AI Gatewayを提供	Editor内MCP ServerとToolset Registryを提供
CLIとToken-gated APIをEditor操作の境界として強調	ToolsetとPluginをCapability公開の境界として強調
公式経路からEditorやPlayer内でC#を実行可能	ToolsetによってEditor APIやPython実行へ到達可能

Unity側の規約と公式経路は、UnityのAIエージェント規約とUnity CLIの現在地で整理しています。

ローカルLLMによるEditor操作の実測例

2026年9月8日確認。Jrt0013による9月7日の報告は、Kimi Code、Windows上のUE5.8、64GBメモリのM1 Maxを使った検証です。EpicのBenchmarkではなく利用者の実験です。llama.cpp上のQwen3-30B-A3B-Instruct-2507 Q8_0は、指定されたカメラ修正を約33秒で適用・検証したと報告されています。一方、自律判断では書き込みを省略して検証値を捏造し、Qwen3-Coder-30B-A3Bは読み取り要求を越えて別カメラを変更しました。

Schemaの説明を整理した後の小さな課題は12秒・2モデルターン・1 MCP Callで完了し、別のScriptは復元を含む8回の内部操作を実行しました。課題が異なるため、33秒から12秒への統制された速度改善とは扱いません。

設計上の示唆は、変更の提案と実行権限を分離することです。Profileは引数の誤りを減らせても、強制力のある境界にはなりません。事前条件と機械的な事後検証を持つ限定的な操作を優先し、自然言語の成功報告をScene変更の証拠として扱わないようにします。

実務で導入するときの判断基準

Unreal MCPを導入する場合は、次の順序で操作範囲を広げます。

Source Controlへ現在の状態を保存し、復旧点を作る。
All Toolsetsではなく、最初は読み取り中心の必要なToolsetだけを有効にする。
Codexなどのクライアント側でTool Allow ListとApproval Modeを設定する。
Actor選択やAsset一覧などの読み取り操作で接続を確認する。
一つのActor生成やTransform変更など、取り消せる変更を試す。
保存されたAsset、Editor Log、Test結果を人が確認する。
必要性を確認してから、Blueprint編集や任意Python実行など強いToolを追加する。

次はPromptだけでなくHarness側で強制します。

読み取り要求では、Scriptからの間接呼び出しを含めて変更Toolを拒否する。
変更前に対象の識別情報と元の状態を記録し、対象・引数・許可範囲を検証する。
実行後に実際の状態を読み直し、期待結果と照合する。その検証が通った場合だけ成功と判定する。
呼び出し回数、期限、終了状態をコードで管理し、完了・取消・失敗後の追加呼び出しを拒否する。
一括処理では途中失敗と復元の方法を定義し、復元結果も別途確認する。1 MCP Callであることは処理全体の原子性を保証しない。

長時間の自律実行では、次も決めておきます。

操作してよいLevel、Folder、Asset種別
削除、移動、上書きに確認を要求する条件
一回の依頼で変更できるAsset数
Editor停止時のTimeoutと再試行回数
TestまたはPlay Sessionでの完了条件
変更差分と生成物のReview方法

Toolsetを細かく設計することは有効ですが、Toolの実装が内部で何へ到達するかも確認します。狭い名前のToolでも、任意Scriptや汎用Object更新を内部で許可すれば、実際の影響範囲は広くなります。

gamescom 2026で強調された検証Layer

gamescom dev 2026では、JetBrains Riderを使ったUnreal EngineのAgent開発として、Architecture、C++ Scaffolding、Crash調査、Actor配置、Automated TestをAgentへ接続するDemoが行われました。Rider 2026.2は、Unreal向けのコード作成、Live Debugging、Test作成Skillに加え、Coverage、Profiler、Refactoring、Code Quality HookをAgentへ公開しています。

同じ会議のShipping Games in the First Era of Coding Agentsでは、Agentの最初のDraftが速くても、重複Logic、原因を隠す修正、後から発生する同期ずれによってReview負荷が増えると整理されました。

この二つを合わせると、EditorやIDEへToolを追加するだけでは十分ではありません。Unreal MCPのToolset、Client承認、Source Controlに加え、Agentが先へ進む前にBuild、Test、Static Analysis、Diff条件を満たす検証Layerを設けます。gamescom 2026の他のAI事例との比較は、gamescom 2026で見えたゲームAIの現在地で整理しています。

現時点の判断

ローカルモデルは範囲を限定したEditor操作の検証候補ですが、Tool Callの形式だけで自律実行の信頼性は判断できません。実行・検証・停止を独立して評価します。

Unreal MCPは、AIをEditor外のコード生成補助から、Editorの状態を観測し、実体を変更し、結果を検証するエージェントへ広げる明確な実例です。UEFNへの導入によって、この構成がC++中心のUE開発だけでなく、VerseとCreative Deviceを使うFortnite制作にも展開されました。

一方、現在のUnreal MCPは、接続クライアントをServer側で認証する製品ではありません。安全性は、localhost限定、公開するToolset、Tool内部の実装、CodexやClaude Code側の承認、Source ControlとReviewを組み合わせて確保します。

Epicの方向性は「MCPに何でも任せる」ことよりも、Editor機能を型付きToolへ分け、必要なCapabilityをエージェントへ公開できる基盤を作ることにあります。実務では、Toolset Registryを権限設計の一部として使いながら、認証、承認、復旧を別の層で補います。

注意点

既存の公式資料に基づく節は各情報日を維持しています。9月7日の利用者報告は2026年9月8日に確認しましたが、本記事による追試ではなく、他のハードウェア、クライアント、UEFNでの性能を示すものでもありません。
UE 5.8のUnreal MCPはExperimentalであり、API、Toolset、Client設定は変更される可能性があります。
UEFNの対応範囲と既知問題はFortniteの更新に伴って変わるため、導入時は最新のRelease Notesを確認してください。
localhost限定は、同じPC上のすべてのプロセスを信頼できることを保証しません。
Codex、Claude Codeなどの承認方法はクライアントごとに異なります。Editor側とクライアント側の両方を確認してください。