# Unityプラグインのセットアップ — AI Game Developer

AI Game DeveloperのUnity用プラグインをステップごとにセットアップします。インストール、サインイン、AIクライアントの接続、拡張機能の追加まで、よくある問題の解決方法もあわせて解説します。

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

Unity · 手動セットアップ

空のUnityプロジェクトから、AIエージェントがエディターで作業できる状態までに必要なすべてを解説します。プラグインのインストール、サインイン、AIクライアントの接続、必要な拡張機能の追加まで。手短に確認したい方は[Unityインストールページ](https://ai-game.dev/ja/engines/unity)をご覧ください。

01

## 始める前に

Unity 2022.3以降、ai-game.devアカウント、AIクライアントが必要です。

- **Unity 2022.3以降** — Unity 6にも対応しています。
- 既定のCloud接続には**ai-game.devアカウント**が必要です。お持ちでない場合は[作成してください](https://ai-game.dev/create-account)。
- **AIクライアント** — AI Game Devアプリ、Claude Code、Cursor、Copilot、Gemini、Codex、その他[対応する14種類のMCPクライアント](https://ai-game.dev/ja/mcp-endpoint-info)のいずれか。
- **初回起動時のインターネット接続** — プラグインはNuGetから.NETパッケージをダウンロードします。

02

## プラグインをインストールする

アプリ、CLI、OpenUPM、インストーラーパッケージのいずれかの方法でインストールできます。

プラグインを追加する方法は4つあります。簡単な順に紹介します。

**デスクトップアプリ**

[AI Game Devアプリ](https://ai-game.dev/ja/download)でUnityプロジェクトを開き、**Install Package**をクリックします。アプリがOpenUPMから最新のプラグインをインストールし、サインインしてエージェントをセットアップします。

**unity-mcp-cli**

npmからCLIをインストールし、プロジェクトにプラグインを追加します（`Packages/manifest.json`は自動で編集されます）。

```bash
npm install -g unity-mcp-cli
unity-mcp-cli install-plugin ./MyUnityProject
```

**OpenUPMパッケージ**

OpenUPM CLIをお使いの場合は、プロジェクトフォルダで次を実行します。

```bash
openupm add com.ivanmurzak.unity.mcp
```

OpenUPM CLIがない場合は、スコープ付きレジストリを`Packages/manifest.json`に追加し、**Window → Package Manager**でパッケージを追加します。

```json
{
  "scopedRegistries": [
    {
      "name": "package.openupm.com",
      "url": "https://package.openupm.com",
      "scopes": ["com.ivanmurzak", "extensions.unity"]
    }
  ]
}
```

**.unitypackage形式**

インストーラーをダウンロードし、**Assets → Import Package → Custom Package…**でインポートします。OpenUPMレジストリとパッケージがプロジェクトに追加されるため、以降の更新はPackage Managerから行えます。

[⬇ AI-Game-Dev-Installer.unitypackageをダウンロード](https://github.com/IvanMurzak/Unity-MCP/releases/latest/download/AI-Game-Dev-Installer.unitypackage)

03

## ウィンドウを開いてサインインする

AI Game Developerウィンドウを開き、アカウントで一度サインインします。

1. Unityで**Window → AI Game Developer — MCP**を選択します（`Ctrl+Alt+A`、macOSでは`Cmd+Option+A`）。
2. **Connection**スイッチを**Cloud**のままにして、**Authorize**をクリックします。
3. ブラウザでai-game.devのサインインページが開き、短いコードが表示されます。コードが一致することを確認して承認してください。
4. Unityのステータスが**Connected**に変わります。

サインイン情報はコンピューター全体に保存されます。アプリまたは`unity-mcp-cli login`で既にサインインしている場合はエディターがその情報を使うため、この手順は省略できます。

04

## AIクライアントを接続する

コマンド1つ、またはウィンドウでのクリック1回で、クライアントの設定が書き込まれます。

ウィンドウでAIエージェントの横にある**Configure**をクリックするか、ターミナルで`setup-mcp`を実行します。どちらもプロジェクト固有のURLとプロジェクトキーをクライアントの設定に書き込むため、すぐに接続できます。

```bash
# Claude Code — use your agent's id (cursor, codex, gemini, vscode-copilot, …)
unity-mcp-cli setup-mcp claude-code ./MyUnityProject
```

設定を変更した後はAIクライアントを再起動してください。その他のクライアントや手動設定については、[AIクライアントの接続](https://ai-game.dev/ja/docs/wiki/unity/connecting-ai-clients)と[MCPエンドポイントのページ](https://ai-game.dev/ja/mcp-endpoint-info)をご覧ください。

05

## 拡張機能を追加する（任意）

アニメーション、Cinemachine、地形、Timelineなど、必要なものだけをインストールできます。

各拡張機能は独立したUnityパッケージです。インストールするとすぐに、RQLを通じてエージェントにUnityの特定分野を教えます。人気のものをいくつか紹介します。

- [AI Animation](https://ai-game.dev/docs/extensions/unity/animation) 3個の機能
  ```bash
  openupm add com.ivanmurzak.unity.mcp.animation
  ```
- [AI Cinemachine](https://ai-game.dev/docs/extensions/unity/cinemachine) 4個の機能
  ```bash
  openupm add com.ivanmurzak.unity.mcp.cinemachine
  ```
- [AI Terrain](https://ai-game.dev/docs/extensions/unity/terrain) 4個の機能
  ```bash
  openupm add com.ivanmurzak.unity.mcp.terrain
  ```
- [AI Timeline](https://ai-game.dev/docs/extensions/unity/timeline) 5個の機能
  ```bash
  openupm add com.ivanmurzak.unity.mcp.timeline
  ```

[全10件のUnity拡張機能 →](https://ai-game.dev/docs/extensions/unity)

?

## トラブルシューティング

よくある問題の解決方法をまとめました。詳しくは[Unityトラブルシューティングガイド](https://ai-game.dev/ja/docs/wiki/unity/troubleshooting)をご覧ください。

**AIクライアントは接続するのにツールが表示されない**

Unityのステータスが**Connected**になっていることを確認してから、クライアントを再接続するか（Claude Codeでは`/mcp`）、再起動してください。それでも何も表示されない場合は、お使いのエージェントで**Configure**をもう一度クリックし、クライアントを再起動してください。

**AI Game Developerウィンドウが表示されない**

プラグインはプロジェクトのコンパイルが完了してから読み込まれます。プロジェクト内のどこかにコンパイルエラーがないかConsoleを確認し、エディターを開き直してください。McpPluginやReflectorNetの型が見つからない場合は、最初のインポートが終わっていないことがほとんどです。しばらく待つか、**Tools → AI Game Developer → Dependencies → Force Resolve NuGet DLLs**を実行してください。

**カスタムモード：ローカルMCPサーバーが起動しない**

カスタムモードでは、プラグインが`gamedev-mcp-server`を`Library/mcp-server/<platform>/`にダウンロードします。ファイアウォールやプロキシにブロックされた場合は、ウィンドウに**Download / Retry**ボタン付きのサーバーエラーが表示されます。クラウドモードではローカルサーバーは不要です。

**カスタムモードでのポート競合**

各プロジェクトには、そのパスから決まる20000〜29999の固定ローカルポートが割り当てられます。すでに別のプロセスがそのポートを使用している場合、サーバーは**External**と表示されます。そのプロセスを停止するか、**Server URL**に別のポートを入力して**Configure**をもう一度クリックしてください。

**Package Managerでパッケージがより新しいUnityを必要とすると表示される**

このプラグインにはUnity 2022.3以降が必要です。プロジェクトをアップグレードするか、`unity-mcp-cli install-unity`でより新しいエディターをインストールしてください。

### 次のステップ

[**Unity ウィキ →** 設定、ツールとRQL、カスタムツール、CLIリファレンスなど。](https://ai-game.dev/ja/docs/wiki/unity) [**Unityツール →** エージェントがUnityでできることのすべてを、例付きで紹介します。](https://ai-game.dev/docs/tools/unity) [**ベストプラクティス →** エージェントが得意な仕事を依頼する方法。](https://ai-game.dev/docs/best-practices/unity)

---

Source (HTML): https://ai-game.dev/ja/docs/unity-plugin-setup

Machine-translated (ja) from the English page: https://ai-game.dev/docs/unity-plugin-setup