UEFN MCP

UEFN MCP は、Claude Code、Cursor、MCP Inspector などの MCP 互換 AI エージェントがローカル HTTP 接続経由でエディタを制御できるように、Unreal Editor for Fortnite プロセス内に MCP サーバーを埋め込みます。

UEFN 専用の以下の機能を公開します。 

• Verse シーン グラフ エンティティの作成と修正

• Verse ファイルの読み書き

• クリエイティブの仕掛けの配置とそのプロパティの編集

• 再生セッションの開始、停止、および検査

MCP とは何ですか？

UEFN MCP は、UEFN エディタ プロセス内にモデル コンテキスト プロトコル (MCP) サーバーを埋め込みます。 MCP 互換の AI エージェントは、ローカル HTTP を介して MCP に接続し、ツールセットにグループ化された型付きツールを介してエディタを制御します。 これによって、エディタが、エージェントが Verse の読み込み、シーン グラフの編集、クリエイティブの仕掛けの配置と構成、プレイ セッションの実行といった操作を行えるようになります。 

デベロッパーがエージェント (Claude Code など) を実行中のエディタに向けて設定すれば、自然言語で質問を開始したり指示を与えたりできます。 たとえば、次のような場合です。

• どのような仕掛けを配置できますか？

• ラウンド開始時にログを追加し、コンパイルします。

• テストできるようにセッションを開始してください。

このような質問や指示によって、エージェントは利用可能なツールセットを発見し、ツールを呼び出し、報告します。 

UEFN MCP の必須要件

UEFN MCP を続行する前に、プロジェクトで以下の設定を行う必要があります。

1. プロジェクトでPython エディタ スクリプティングを有効にします。

2. MCP の自動起動を構成します。

3. クライアント構成ファイルを生成します。

4. フォートナイト UEFN インストール ディレクトリから AI エージェントを起動します。

Python と UEFN MCP を有効にする

プロジェクト設定で、[Python Editor Scripting (Python エディタ スクリプティング)]と [UEFN MCP Toolsets (UEFN MCP ツールセット)]のチェックボックスをオンにします。

MCP 自動起動の構成

MCP の自動起動を構成する方法：

• [Edit (編集)] > [Editor Preferences (エディタの環境設定)] を開きます。

• [General (一般)] グループで、[Model Context Protocol (モデル コンテキスト プロトコル)] を選択します。

これにより、[Auto Start Server (サーバーを自動起動)] 設定が表示されます。この設定を有効にすると、エディタを起動するたびに MCP サーバーが自動的に起動し、MCP サーバーが http://127.0.0.1:8000/mcp にバインドされます。 

このパネルでは、これらのデフォルトが別のローカル サービスと競合する環境向けのリスニング ポート (デフォルト 8000) と URL パス (デフォルト /mcp) も公開しています。 ServerInfo.name で通知されるサーバー名は、常に unreal-mcp となります。

オンデマンドでサーバーを開始したい場合は、[Auto Start Server (サーバーを自動起動)] をオフのままにして、エディタ コンソールに ModelContextProtocol.StartServer と入力します。

このコマンドは、オプションのポート (ModelContextProtocol.StartServer:8000) も受け入れます。

クライアント構成を作成する

各 AI エージェントは、特定のファイル形式で、プロジェクト ツリー内の特定の場所にあるサーバー リストを期待します。 UEFN がインストールされている場所を知る必要があります。 

すばやくアクセスするため、ランチャーのインストール先を確認して、そのフォルダの場所を直接開くことができます。

UEFN インストール ファイルが保存されている場所 (プロジェクトのファイルではない) を確認したら、.mcp.json ファイルを作成します。

mcp.json ファイルを作成する方法： 

1. UEFN プロジェクトのルート フォルダで右クリックし、テキスト ドキュメントを新規作成します。 名前を .mcp.txt とします。  

   

2. テキスト ドキュメントを開きます。

3. 以下のテキストをコピーしてファイルに貼り付けます。 これはモデル固有の JSON であり、使用している特定の AI エージェントに合わせてフォーマットする必要があります。 以下の例は Claude の JSON です。

   Config

   mcp.json
   {
     "mcpServers": {
       "unreal-mcp": {
         "type": "http",
         "url": "http://127.0.0.1:8000/mcp"
       }
     }
   }
   

   Copy full snippet(9 lines long)

4. [All Files (全てのファイル)] として、末尾の拡張子を .json として .txt を置き換え、保存します。

   

AI エージェントの構成を作成したら、Codex CLI を使用する際に留意すべき点が 1 つあります。 使用される TOML 構成は一度しか書き込まれません。つまり、コマンドは既存のファイルを上書きしません。 このため、古い構成は手動で削除する必要があります。 Claude Code、Cursor、VS Code、および Gemini で使用される JSON 形式の構成の場合、これらは既存のエントリとマージされるため、コマンドを繰り返し実行しても安全です。 

AI エージェントを接続する

AI エージェントを UEFN に接続するには、.mcp.json 構成ファイルが生成されたプロジェクトまたはワークスペースのルートから、任意の AI エージェント CLI またはアプリケーションを起動します。 そのファイルの場所の構成ファイルを生成する際に、出力ログを参照できます。 

以下に示すのは、.mcp.json ファイルが作成されたフォルダから Claude を起動する例です。 

接続に問題がある場合、以下の手順を試してください：

• AI エージェント CLI またはアプリケーションが Unreal MCP を見つけられない場合、構成ファイルが配置されているプロジェクトまたはワークスペースのルートから起動されたことを確認します。

• デフォルトのポート (8000) が別のサービスで使用されている場合は、別のポートを試してください。 これは、サーバー ポート番号を使用してエディタの環境設定で設定できます。

• Python エディタ スクリプティングと UEFN MCP ツールセットの両方がプロジェクト設定で有効になっていることを確認します。

• サーバーを開始および停止するには、エディタを閉じてから開き直す必要があります。 迷ったときは、エディタを再起動してみてください。

Unreal MCP は他にどのような機能とインタラクトしますか？

ツールセットのプロンプトの提案

以下の表には、各機能のパフォーマンスを試すために使用できるプロンプトが含まれており、全てのツールセットが意図したとおりに動作していることを再確認することもできます。

最良の結果を得るためのヒント

• 具体的に指定しましょう。

  • プロンプトを作成する際は、オブジェクトに対して何かを行うようにエージェントに指示する際に、できるだけ具体的に指定することが重要です。 例えば、エージェントに「タイマーの仕掛け」を使用して何かを変更するよう依頼した場合、「追加したもの」と指定した場合よりも、より良い結果が得られます。

• 利用可能なツールを一覧表示するようエージェントに依頼しましょう。

  • そのための検出ツールがあり、間違った推測を減らすために利用できます。

• 複数ステップのリクエストについては計画を尋ねましょう。

  • エージェントにタスクを実行させる前に、提供された計画を確認します。 これにより、エージェントが意図したリクエストを誤って推測することを防ぎます。

• 変更をレビュー可能な状態に保ちましょう。

  • 範囲の小さい編集は、広範な変更よりも検証が簡単です。 変更は、範囲を広げるほど検証がますます困難になり、途中で何かを見落とす可能性があります。

既知の不具合

これは、現在調査中で今後のリリースで解決される可能性がある既知の不具合のリストです：

• LUF から XYZ 形式への座標系とトランスフォームの変換。

  • 現在、Python ツールセットは、Left-Up-Forward (LUF) 座標系ではなく XYZ 形式を使用しています。 XYZ から UEFN が使用する LUF への変換では、AI エージェントに変換をリクエストすれば上手く実行できる場合もありますが、空間演算に関してシステムの動作が異なるため、エラーの可能性が倍増します。

• エディタのヒッチ

  • MCP ツール呼び出しにより、エディタが停止したりハングしたりする可能性があります。 これは現在調査中であり、エディタでのツール呼び出しをより効率的にする方法を評価中です。