UE5 は 5.8 から MCP 機能が実験機能として搭載されました。Engine 自体に Plugin として組み込まれているため、外部ツール等をインストールする必要もなく有効化するだけで使えます。ですが実験機能段階ということもあり、なかなか思うように動かないことがあります。今回はそのいくつかの理由を解説します。MCP 機能自体の使い方に関しては以前の解説を参照してください。
日本語の問題
以前の記事でも説明したように、MCP 利用時は UE5 Editor の言語設定を英語に変更しておくことを強くお勧めします。日本語設定のままだと BP ノード名などが部分的に日本語で渡されており AI がだいぶ混乱してしまうようです。以下は Blueprint Editor 上で、PrintString ノードを追加する場合の実際の Tool call の内容を表したものです。(多少簡略化しています)
日本語の場合
- ノードを「 Development|PrintString 」で作成しようとしてエラー
- ノードを検索して正しい名前を探す
- 正しい名前は「デベロップメント|PrintString」だったことが判明
- 「デベロップメント|PrintString」でノードを作成して成功
4ターン消費
role: assistant
content: PrintStringノードをEventGraphに作成し、DoFireBallの`then`ピンに接続、文字列値を\"Fire\"に設定します。
tool_calls: ue5__call_tool
tool_name: create_node
toolset_name: editor_toolset.toolsets.blueprint.BlueprintTools
type_id: Development|PrintString
role: tool
name: ue5__call_tool
content: The node could not be created / Development|PrintString does not exist
role: assistant
tool_calls: ue5__call_tool
tool_name: find_node_types
toolset_name: editor_toolset.toolsets.blueprint.BlueprintTools
type_id_filter: PrintString
role: tool
name: ue5__call_tool
content: ～
role: assistant
name: ue5__call_tool
tool_name: find_node_types
toolset_name: editor_toolset.toolsets.blueprint.BlueprintTools
type_id_filter: PrintString
role: tool
name: ue5__call_tool
content: {"returnValue":["デベロップメント|PrintString","クラス|PCG出力要素設定|PrintStringを取得","クラス|PCG出力要素設定|SetPrintString"]}
role: assistant
content: 日本語のtype_idが必要なようです。「デベロップメント|PrintString」でノードを作成します。
tool_calls: ue5__call_tool
tool_name: create_node
toolset_name: editor_toolset.toolsets.blueprint.BlueprintTools
type_id: デベロップメント|PrintString
role: tool
name: ue5__call_tool
content: {"returnValue": {"refPath":"/Game/ThirdPerson/Blueprints/BP_ThirdPersonCharacter.BP_ThirdPersonCharacter:EventGraph.K2Node_CallFunction_3"}}
英語の場合
- ノードを「 Development|PrintString 」で作成。成功
1ターンで完了
role: assistant
content: PrintStringノードのtype_idを確認できました。次にPrintStringノードを作成し、DoFireBallの後に接続します。
tool_calls: ue5__call_tool
tool_name: create_node
toolset_name: editor_toolset.toolsets.blueprint.BlueprintTools
type_id: Development|PrintString
role: tool
name: ue5__call_tool
content: {"returnValue": {"refPath":"/Game/ThirdPerson/Blueprints/BP_ThirdPersonCharacter.BP_ThirdPersonCharacter:EventGraph.K2Node_CallFunction_4"}}
なぜ日本語設定なのに最初に「 Development|PrintString 」を使おうとするのかというと、LLM が参照している説明文 (tool の description) には英語のまま「Development|PrintString」と書かれている箇所があるからです。そのため初回の呼び出しに失敗し、何度か試行錯誤して正解を探すような挙動になってしまいます。動作効率も落ちますしその分時間もかかるので、最初に英語に設定しておくことをお勧めします。
スクリーンキャプチャ機能の問題
Editor の状態やビューポートの内容を把握するために、AI がスクリーンキャプチャ機能を自発的に使用する場合があります。最近のモデルは Vision 対応のものが殆どで、blender 用 mcp などでもキャプチャを使ってAI が実際の画面見ながら作業することができます。
ところが UE5 5.8 の MCP の場合はスクリーンキャプチャ命令は完全な地雷で、これが走るとコンテキストウィンドウを完全に使い果たしてツールがエラーで停止します。AI は自分からキャプチャを取りに行くことがあるので、スクリーンショット機能を使わないように最初に指示を追加しておくことをお勧めします。
本来 LLM の API は、content の配列として画像やリソース専用の型を必要とします。書式は使用する LLM の API によって異なりますが、以下は説明のために用意した content 配列の一例です。
"content" : [
{ "type": "text", "text": "～" },
{ "type": "image", "data": "<b64>～", "format": "jpeg" },
～
]
ところが Unreal Engine 5 の MCP の場合は、構造化されたデータを返す場合にデコードせずに json の文字列をそのまま text で返してしまいます。
例えば画像を返す場合でも以下のように text として埋め込まれます。
"content" : [
{ "type": "text", "text": "{\"returnValue\":{\"image\":{\"mimeType\":\"image/png\",\"data\":\"<b64>～\"}}}" },
]
ただのテキストなので、base64 エンコードされた巨大な文字列がそのまま文字トークンとして流し込まれます。キャプチャ画像の base64 文字列は数百 KB から M バイト単位になることもあるので、あっという間に Context Window の Token を使い果たしてしまうわけです。
画像として扱うためには、受け取った文字列を認識できる形に変換する必要があります。
おそらく Claude Code のような既製ツールの場合は、UE5 側の対応を待つか MCP の間に変換用のレイヤーを挟み込む必要があるかと思います。そのため対応が入るまでは、キャプチャツールを呼ばないように指示を追加しておくことをお勧めします。
2026/08/04 追記: 変換用のレイヤーツール作りました。Claude Code 等の既存クライアントでも UE5 MCP からキャプチャ画像を取得できます。「UE5 5.8 MCP Server から画面キャプチャを取得できるようにする」
私は自作の AI Agent Tool (ハーネス) を使用しているため、MCP の受け取り側で画像を変換するようにしてみました。この変換はうまくいき、UE5 でもビューポートのキャプチャを正しく画像として認識できるようになりました。画像なので Token 消費も常識的な範囲に収まるようになり、キャプチャツールが走ってしまったせいで Token を使い果たすこともなくなっています。
if getattr(content[0], 'type', None) == 'text':
text_data= getattr(src_content[0], 'text', '')
if len(text_data) >= 80*1024:
if ('"returnValue"' in text_data) and ('"image"' in text_data) and ('"image/' in text_data):
ue5_json= json.loads(text_data)
data= ue5_json.get('returnValue',{}).get('image',{})
cformat= data.get('mimeType','').replace('image/','')
return [ {'type': 'image', 'data': data.get('data'), 'format': cformat} ]
関連ページ
