# Unreal MCP — AI Game Developer Wiki

Unreal MCPはClaude、Cursor、CopilotなどのAIエージェントをUnreal Editorに接続します。プラグイン、ブリッジ、CLI、アプリの関係を解説します。

このページは英語から機械翻訳されています。[英語の原文を読む](https://ai-game.dev/docs/wiki/unreal)。

Unreal MCPはAI Game DeveloperのUnreal Engineプラグインです。Claude Code、Cursor、GitHub Copilot、Codex、GeminiなどのAIエージェントがUnreal Editor内で作業できるようにします。アクター、コンポーネント、アセット、レベルの照会と変更、Blueprintの作成とコンパイル、C++の編集とコンパイル、エディタPythonの実行、エージェントが確認できるスクリーンショットの取得などが可能です。やりたいことを自然言語で伝えると、エージェントがModel Context Protocol（MCP）を通じてエディタのツールを呼び出します。

このwikiでは、プラグインのインストール方法、AIクライアントの接続方法、Unreal EditorでAIから有用な結果を得る方法を説明します。プラグインは**ベータ**版で、現在のリリースは0.26.2です。

## 構成要素の関係

Unreal MCPのセットアップは4つの部分から成ります。これらを理解しておくと、セットアップとトラブルシューティングがずっと楽になります。

- **Unreal MCPプラグイン**（`UnrealMCP`）。プロジェクトの`Plugins/`フォルダにインストールするC++エディタプラグインです。AIツールを登録し、エディタに**AI Game Developer**ウィンドウを追加します。
- **ブリッジ**（`unreal-mcp-bridge`）。UnrealのエディタはC++で動作するため、.NET製のMCPホストはエディタの隣で小さなヘルパープロセスとして実行されます。プラグインが自動的に起動し、ローカルのトークンで保護された接続を介して通信します。パッケージ版にはブリッジが同梱されているため、.NETをインストールする必要はありません。
- **MCPサーバー**。デフォルトでは、ブリッジは[ai-game.dev](https://ai-game.dev)でホストされているサーバーに接続します（**Cloud**モード）。代わりに、共有のローカルサーバー`gamedev-mcp-server`を自分のマシンで実行することもできます（**Custom**モード）。
- **AIクライアント**。任意のMCPクライアントが同じサーバーに接続し、それを介してエディタに到達します。

セットアップに役立つツールが2つあります：

- **AI Game Dev**（デスクトップアプリ）は、Unrealプロジェクトにプラグインをインストールし、エディタを開くこともできます。Node.jsは不要です。詳しくは[アプリのwiki](https://ai-game.dev/ja/docs/wiki/app)をご覧ください。
- \*\*`unreal-mcp-cli`\*\*は、npmで配布されているクロスプラットフォームのコマンドラインツールです。プラグインのインストールと更新、サインイン、MCPクライアント設定の書き込み、エディタの起動、ターミナルやCIからのツール実行を行います。

## AIエージェントにできること

このプラグインには7ファミリー・27個のツールが含まれています。エディタのデータのほとんどは、操作ごとに1つのツールを使うのではなく、エディタ全体で共通のクエリ言語である**RQL**を通じて扱われます：

- **RQL**（`rql-query`、`rql-mutate`、`rql-schema`）：アクター、コンポーネント、アセット、レベル、DataTable、Gameplayタグ、Project Settings、Blueprintグラフ、Widget Blueprint、Level Sequenceの検索と変更。
- **Blueprints**：Blueprintの作成、編集、コンパイル。エージェントが修正できる構造化されたエラーリスト付きです。
- **C++ソース**：プロジェクトのC++の読み取り、雛形生成、編集、コンパイル（Live CodingまたはUnreal Build Tool）。
- **Python**：`unreal`エディタAPIをフルに使ってPythonを実行。
- **スクリーンショット**：ビューポート、ゲームビュー、カメラ、アクター単体のキャプチャ。
- **コンソール**および**ツール一覧**のヘルパー。

6つのオプション拡張により、Control Rig、Enhanced Input、Gameplay Ability System、LandscapeとWater、Niagara、PCGのサポートが追加されます。任意のUnrealプラグインから独自のツールを登録することもできます。

## Wikiページ

| ページ | 内容 |
| --- | --- |
| [インストール](https://ai-game.dev/ja/docs/wiki/unreal/installation) | 必要な環境と、現在存在するすべてのインストール方法：アプリ、CLI、手動インストール |
| [はじめに](https://ai-game.dev/ja/docs/wiki/unreal/getting-started) | 初回の接続、最初のプロンプト、すべてが動作しているかの確認 |
| [AIクライアントの接続](https://ai-game.dev/ja/docs/wiki/unreal/connecting-ai-clients) | CloudモードとCustomモード、デバイスコードによるサインイン、プロジェクトキー、エージェントごとの`setup-mcp` |
| [設定](https://ai-game.dev/ja/docs/wiki/unreal/configuration) | AI Game Developerウィンドウ、MCP Toolsウィンドウ、設定ファイル、`UNREAL_MCP_*`変数 |
| [ツール](https://ai-game.dev/ja/docs/wiki/unreal/tools) | すべての組み込みツールと、何を頼めばよいか |
| [拡張](https://ai-game.dev/ja/docs/wiki/unreal/extensions) | 6つのオプション拡張とそのインストール方法 |
| [カスタムツール](https://ai-game.dev/ja/docs/wiki/unreal/custom-tools) | C++から独自のツール、プロンプト、リソースを追加（ゲーム内（ランタイム）ツールを含む） |
| [CLIリファレンス](https://ai-game.dev/ja/docs/wiki/unreal/cli) | `unreal-mcp-cli`のすべてのコマンドとフラグ |
| [トラブルシューティング](https://ai-game.dev/ja/docs/wiki/unreal/troubleshooting) | 接続、ブリッジ、ビルド、ツールの問題の解決策 |
| [FAQ](https://ai-game.dev/ja/docs/wiki/unreal/faq) | よくある質問への簡潔な回答 |

## 次に読むもの

- 初めての方は[インストール](https://ai-game.dev/ja/docs/wiki/unreal/installation)から始め、次に[はじめに](https://ai-game.dev/ja/docs/wiki/unreal/getting-started)へ進んでください。
- 手短に知りたい方は、[Unreal Engineインストールページ](https://ai-game.dev/ja/engines/unreal)と[クイックスタート](https://ai-game.dev/ja/docs/quickstart)に要点がまとまっています。
- ツールの詳細をお探しですか？[Unreal ツールカタログ](https://ai-game.dev/docs/tools/unreal)と[Unreal ベストプラクティス](https://ai-game.dev/docs/best-practices/unreal)をご覧ください。
- 別のエンジンも併用していますか？[Unity wiki](https://ai-game.dev/ja/docs/wiki/unity)と[Godot wiki](https://ai-game.dev/ja/docs/wiki/godot)をご覧ください。3つのプラグインはすべて同じサーバー、アカウント、AI クライアントを共有しています。

- [**インストール** AI Game Devアプリまたはunreal-mcp-cliを使って、Unreal Engine 5.5以降向けのUnreal MCPプラグインをインストールします。要件、更新、削除、Fabでの提供状況について説明します。](https://ai-game.dev/ja/docs/wiki/unreal/installation)
- [**はじめに** 初めてUnreal MCPに接続し、ai-game.devにサインインして、AIクライアントを設定し、Unreal Editorで最初のAIプロンプトを実行します。](https://ai-game.dev/ja/docs/wiki/unreal/getting-started)
- [**AIクライアントの接続** Claude Code、Cursor、Copilot、Codex、Gemini などの MCP クライアントを、ai-game.dev のクラウドエンドポイントまたはローカルサーバー経由で Unreal MCP に接続します。](https://ai-game.dev/ja/docs/wiki/unreal/connecting-ai-clients)
- [**設定** Unreal MCP を設定します - AI Game Developer ウィンドウ、MCP Tools の表示、プロジェクト設定ファイル、.env、およびすべての UNREAL\_MCP\_\* 環境変数について説明します。](https://ai-game.dev/ja/docs/wiki/unreal/configuration)
- [**ツール** Unreal MCP の組み込みツール27個（RQL、Blueprint、C++ ソース、Python、スクリーンショット、コンソール）と、Unreal Editor での AI 向けプロンプト例を紹介します。](https://ai-game.dev/ja/docs/wiki/unreal/tools)
- [**拡張機能** Control Rig、Enhanced Input、GAS、Landscape/Water、Niagara、PCG に対応する任意の Unreal MCP 拡張機能。それぞれの追加内容とインストール方法を解説します。](https://ai-game.dev/ja/docs/wiki/unreal/extensions)
- [**カスタムツール** 任意のC++プラグインから独自のAIツール、RQLモジュール、プロンプト、リソースをUnreal MCPに追加し、実行中のゲームでゲームプレイツールを公開できます。](https://ai-game.dev/ja/docs/wiki/unreal/custom-tools)
- [**CLI リファレンス** unreal-mcp-cli の完全なコマンドリファレンス - Unreal MCP プラグインのインストール、サインイン、AI エージェントの設定、エディタの起動、ツールと Python の実行。](https://ai-game.dev/ja/docs/wiki/unreal/cli)
- [**トラブルシューティング** よくあるUnreal MCPの問題を解決 - プラグインが読み込まれない、ブリッジが見つからない、接続が止まる、AIエージェントにUnrealツールがない、古いビルド、ツールエラー。](https://ai-game.dev/ja/docs/wiki/unreal/troubleshooting)
- [**FAQ** Unreal MCP に関するよくある質問への回答 - 対応エンジンバージョン、AI クライアント、Blueprint のみのプロジェクト、Fab、オフライン利用、コスト、パッケージ済みゲーム。](https://ai-game.dev/ja/docs/wiki/unreal/faq)

---

Source (HTML): https://ai-game.dev/ja/docs/wiki/unreal

Machine-translated (ja) from the English page: https://ai-game.dev/docs/wiki/unreal