このページは英語から機械翻訳されています。英語の原文を読む。
Unityプラグインをステップごとにセットアップ
空のUnityプロジェクトから、AIエージェントがエディターで作業できる状態までに必要なすべてを解説します。プラグインのインストール、サインイン、AIクライアントの接続、必要な拡張機能の追加まで。手短に確認したい方はUnityインストールページをご覧ください。
始める前に
Unity 2022.3以降、ai-game.devアカウント、AIクライアントが必要です。
- Unity 2022.3以降 — Unity 6にも対応しています。
- 既定のCloud接続にはai-game.devアカウントが必要です。お持ちでない場合は作成してください。
- AIクライアント — AI Game Devアプリ、Claude Code、Cursor、Copilot、Gemini、Codex、その他対応する14種類のMCPクライアントのいずれか。
- 初回起動時のインターネット接続 — プラグインはNuGetから.NETパッケージをダウンロードします。
プラグインをインストールする
アプリ、CLI、OpenUPM、インストーラーパッケージのいずれかの方法でインストールできます。
プラグインを追加する方法は4つあります。簡単な順に紹介します。
AI Game DevアプリでUnityプロジェクトを開き、Install Packageをクリックします。アプリがOpenUPMから最新のプラグインをインストールし、サインインしてエージェントをセットアップします。
npmからCLIをインストールし、プロジェクトにプラグインを追加します(Packages/manifest.jsonは自動で編集されます)。
npm install -g unity-mcp-cli
unity-mcp-cli install-plugin ./MyUnityProjectOpenUPM CLIをお使いの場合は、プロジェクトフォルダで次を実行します。
openupm add com.ivanmurzak.unity.mcpOpenUPM CLIがない場合は、スコープ付きレジストリをPackages/manifest.jsonに追加し、Window → Package Managerでパッケージを追加します。
{
"scopedRegistries": [
{
"name": "package.openupm.com",
"url": "https://package.openupm.com",
"scopes": ["com.ivanmurzak", "extensions.unity"]
}
]
}インストーラーをダウンロードし、Assets → Import Package → Custom Package…でインポートします。OpenUPMレジストリとパッケージがプロジェクトに追加されるため、以降の更新はPackage Managerから行えます。
⬇ AI-Game-Dev-Installer.unitypackageをダウンロードウィンドウを開いてサインインする
AI Game Developerウィンドウを開き、アカウントで一度サインインします。
- UnityでWindow → AI Game Developer — MCPを選択します(
Ctrl+Alt+A、macOSではCmd+Option+A)。 - ConnectionスイッチをCloudのままにして、Authorizeをクリックします。
- ブラウザでai-game.devのサインインページが開き、短いコードが表示されます。コードが一致することを確認して承認してください。
- UnityのステータスがConnectedに変わります。
サインイン情報はコンピューター全体に保存されます。アプリまたはunity-mcp-cli loginで既にサインインしている場合はエディターがその情報を使うため、この手順は省略できます。
AIクライアントを接続する
コマンド1つ、またはウィンドウでのクリック1回で、クライアントの設定が書き込まれます。
ウィンドウでAIエージェントの横にあるConfigureをクリックするか、ターミナルでsetup-mcpを実行します。どちらもプロジェクト固有のURLとプロジェクトキーをクライアントの設定に書き込むため、すぐに接続できます。
# Claude Code — use your agent's id (cursor, codex, gemini, vscode-copilot, …)
unity-mcp-cli setup-mcp claude-code ./MyUnityProject設定を変更した後はAIクライアントを再起動してください。その他のクライアントや手動設定については、AIクライアントの接続とMCPエンドポイントのページをご覧ください。
拡張機能を追加する(任意)
アニメーション、Cinemachine、地形、Timelineなど、必要なものだけをインストールできます。
各拡張機能は独立したUnityパッケージです。インストールするとすぐに、RQLを通じてエージェントにUnityの特定分野を教えます。人気のものをいくつか紹介します。
- AI Animation3個の機能
openupm add com.ivanmurzak.unity.mcp.animation - AI Cinemachine4個の機能
openupm add com.ivanmurzak.unity.mcp.cinemachine - AI Terrain4個の機能
openupm add com.ivanmurzak.unity.mcp.terrain - AI Timeline5個の機能
openupm add com.ivanmurzak.unity.mcp.timeline
トラブルシューティング
よくある問題の解決方法をまとめました。詳しくはUnityトラブルシューティングガイドをご覧ください。
/mcp)、再起動してください。それでも何も表示されない場合は、お使いのエージェントでConfigureをもう一度クリックし、クライアントを再起動してください。gamedev-mcp-serverをLibrary/mcp-server/<platform>/にダウンロードします。ファイアウォールやプロキシにブロックされた場合は、ウィンドウにDownload / Retryボタン付きのサーバーエラーが表示されます。クラウドモードではローカルサーバーは不要です。unity-mcp-cli install-unityでより新しいエディターをインストールしてください。