インストール

このページでは、Unreal Engine向けのAI Game DeveloperプラグインであるUnreal MCPをプロジェクトにインストールする方法を説明します。いずれかのインストール方法を選んで手順に従い、その後ははじめにに進んでください。

要件#

プラグインはディスクリプタでエンジンの正確なバージョンを固定していないため、同じプラグインが新しいエンジンリリースでも読み込まれます。

注意： Blueprintのみのプロジェクトでは、プラグインをビルドする前にC++モジュールが必要です。Unreal Editorで任意のC++クラスを追加（Tools、New C++ Class）してC++プロジェクトに変換するか、unreal-mcp-cli create-projectで新しいC++プロジェクトを作成してください。

オプション1：AI Game Devデスクトップアプリ#

デスクトップアプリが最も簡単な方法です。インストール処理が組み込まれているため、Node.js、npm、ターミナルは不要です。

1. ダウンロードページからAI Game Devをインストールします。手順はアプリのインストールガイドで説明しています。
2. ai-game.devアカウントでサインインします。
3. Open folder…を選択し、Unrealプロジェクトのフォルダ（.uprojectファイルを含むフォルダ）を選びます。アプリはそれをUnrealプロジェクトとして認識します。またはCreate new projectで新規作成すると、プラグインが自動的にインストールされます。
4. サイドバーのInstall Packageをクリックします。アプリは最新リリースのUnreal MCPバージョンをインストールし、その前にダウンロードを検証します。インストール済みのプラグインの方がすでに新しい場合は、そのまま維持されます。
5. Open Editorをクリックすると、サインイン済みのセッションでUnreal Editorが起動するため、手動でトークンを設定しなくてもプラグインがai-game.dev経由で接続します。

アプリのCLIでは、同じ操作が/install-pluginと/openコマンドになります。アプリでは任意の拡張機能もインストールできます。詳細はプロジェクトとエンジンにあります。

オプション2：unreal-mcp-cli#

unreal-mcp-cliはnpmで公開されており、Windows、macOS、Linuxで動作します。リポジトリのクローンも、独自のビルド手順も不要です。

CLIをグローバルにインストールします：

npm install -g unreal-mcp-cli

または、インストールせずに任意のコマンドを一度だけ実行します：

npx unreal-mcp-cli@latest status

続いて、プラグインをインストールし、サインインしてエディタを起動します：

# 1. Install the UnrealMCP plugin into <project>/Plugins/UnrealMCP
unreal-mcp-cli install-plugin ./YourProject

# 2. Sign in to ai-game.dev once per machine (device-code flow in your browser)
unreal-mcp-cli login

# 3. Open the Unreal Editor for the project
unreal-mcp-cli open ./YourProject

これらのコマンドの動作：

• install-pluginはCLIのバージョンに対応するプラグインのソース（GitHubリリースのunreal-mcp-plugin-source-<version>.zip）をダウンロードし、展開する前に署名を確認します。改ざんされた、または署名のないダウンロードは拒否されます。各プラットフォーム向けのブリッジはそのパッケージに含まれています。
• loginは認証情報をマシン全体のストア（~/.ai-game-dev/credentials.json）に保存し、アプリや他のエンジン用CLIと共有します。
• openはプロジェクトのEngineAssociationから適切なエンジンを見つけ、ネイティブのエディタモジュールをコンパイルする必要がある場合は先にビルドし、既知のUnreal起動時プロンプト（「Missing Modules」など）が表示された場合は閉じます。

ヒント： プラグインをインストールまたは更新する前に、Unreal Editorを閉じてください。Unrealは、実行中のエディタが読み込んでいるプラグインを置き換えることはできません。

オプション3：ソースから手動でインストール#

手動インストールは、コントリビューターやプラグイン開発者向けの方法です。

1. Unreal-MCPリポジトリのUnrealMCP/フォルダを<YourProject>/Plugins/UnrealMCP/にコピーします。
2. ソースのチェックアウトにはブリッジが同梱されていません。unreal-mcp-cli bootstrap-local ./YourProjectでビルドするか（.NET 9 SDKが必要）、自分でビルドしたブリッジをUNREAL_MCP_BRIDGE_PATHで指定してください。
3. プロジェクトを開きます。初回起動時にUnrealがプラグインのモジュールをコンパイルします。

ライブ開発では、unreal-mcp-cli install-plugin --junctionを使うと、プラグインフォルダをコピーせずにリンクします（Windows）。

Fab / Epic Marketplace#

Fabでの掲載は計画されていますが、まだ公開されていません。公開されるまではFabからインストールできるものはないため、アプリまたはCLIを使用してください。

インストールの確認#

エディタが起動すると、Output Log に次のように出力されます:

[Unreal-MCP] plugin loaded

unreal-mcp-cli status --path ./YourProject を実行すると、パッケージ、プロジェクト、プラグイン、接続状態を確認できます。

プラグインはエディタの Tools メニューに AI Game Developer として表示されます。続けて Getting started に進んでください。

プラグインを更新する#

• App: 新しいプラグインリリースがあると、サイドバーに Update Package が表示されます。
• CLI: unreal-mcp-cli update ./YourProject を実行します。バージョンが変わると、インストール済みプラグインの Intermediate/ フォルダとコンパイル済み C++ の Binaries/ を削除して Unreal がクリーンに再ビルドできるようにし、同梱のブリッジは保持します。同じバージョンを再インストールするには --force を、ビルドキャッシュを保持するには --no-clean を追加してください。
• 手動コピー: エディタを閉じ、Plugins/UnrealMCP/Intermediate/ と C++ の Binaries/ を削除し（Binaries/ThirdParty/ は残します）、プロジェクトを再度開きます。

古いビルドキャッシュは、更新が効果を発揮していないように見える最も一般的な原因です。Troubleshooting を参照してください。

プラグインを削除する#

unreal-mcp-cli remove-plugin ./YourProject

または、エディタを閉じた状態で <YourProject>/Plugins/UnrealMCP/ を削除します。

プラグインをパッケージ版ゲームに含めない#

Unreal MCP をエディタ内での AI 支援にのみ使用する場合は、プロジェクトの .uproject のプラグインエントリでパッケージビルドから除外します:

{
  "Name": "UnrealMCP",
  "Enabled": true,
  "TargetDenyList": ["Game", "Client", "Server"]
}

こうするとプラグインはエディタ内で有効なままですが、ブリッジを含め、そのどの部分もコンパイルされたりパッケージ版ゲームにステージングされたりしません。ゲームモジュールの Build.cs の依存関係に UnrealMcp* モジュールを追加しないでください。直接依存すると拒否リストが上書きされます。代わりに実行中のゲーム内で AI ツールを使用するには、in-game tools を参照してください。