# インストール — Unreal Engine · AI Game Developer Wiki

AI Game Devアプリまたはunreal-mcp-cliを使って、Unreal Engine 5.5以降向けのUnreal MCPプラグインをインストールします。要件、更新、削除、Fabでの提供状況について説明します。

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

このページでは、Unreal Engine向けのAI Game DeveloperプラグインであるUnreal MCPをプロジェクトにインストールする方法を説明します。いずれかのインストール方法を選んで手順に従い、その後は[はじめに](https://ai-game.dev/ja/docs/wiki/unreal/getting-started)に進んでください。

## 要件

| 要件 | 詳細 |
| --- | --- |
| Unreal Engine | 5.5以降。リリースビルドは5.5、5.6、5.7、5.8で検証されています。 |
| プロジェクトの種類 | **C++のUnrealプロジェクト**。プラグインにはプロジェクト用にコンパイルされるエディタモジュールが含まれているため、プロジェクトはC++をビルドできる必要があります。 |
| C++ツールチェーン | お使いのプラットフォームで、使用するUnreal Engineのバージョンに必要なコンパイラツールチェーン（例：WindowsではVisual Studio、macOSではXcode）。 |
| オペレーティングシステム | Windows（x64）、macOS（Apple siliconおよびIntel）、Linux（x64）。リリースにはこれらの各環境向けのブリッジビルドが含まれています。 |
| Node.js | `unreal-mcp-cli`の場合のみ：`^20.19.0`または`>=22.12.0`。デスクトップアプリでは不要です。 |
| .NET 9 SDK | ブリッジをソースからビルドする場合のみ。パッケージ版のインストールには同梱されています。 |

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

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

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

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

1. [ダウンロードページ](https://ai-game.dev/ja/download)からAI Game Devをインストールします。手順は[アプリのインストールガイド](https://ai-game.dev/ja/docs/wiki/app/installation)で説明しています。
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`コマンドになります。アプリでは任意の[拡張機能](https://ai-game.dev/ja/docs/wiki/unreal/extensions)もインストールできます。詳細は[プロジェクトとエンジン](https://ai-game.dev/ja/docs/wiki/app/projects-and-engines)にあります。

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

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

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

```bash
npm install -g unreal-mcp-cli
```

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

```bash
npx unreal-mcp-cli@latest status
```

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

```bash
# 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リポジトリ](https://github.com/IvanMurzak/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 に次のように出力されます:

```text
[Unreal-MCP] plugin loaded
```

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

プラグインはエディタの **Tools** メニューに **AI Game Developer** として表示されます。続けて [Getting started](https://ai-game.dev/ja/docs/wiki/unreal/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](https://ai-game.dev/ja/docs/wiki/unreal/troubleshooting#stale-build) を参照してください。

## プラグインを削除する

```bash
unreal-mcp-cli remove-plugin ./YourProject
```

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

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

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

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

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

---

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

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