Unity AI オープンベータ:MCP の使用を開始する方法
Unity AI オープンベータに関する本日の記事では、Claude Code、Github Copilot、その他の AI エージェントを Unity のモデルコンテキストプロトコル (MCP) サーバーを使用して Unity エディターに直接接続する方法を学びます。
Unity AI の MCP サーバーは、IDE で AI エージェントを操作する新しい方法を開きます。コードエディターと Unity を切り替える代わりに、Claude Code、Cursor、Windsurf、VS Code Copilot などのエージェントを実行中の Unity プロジェクトに直接接続できます。これにより、コンテキストをコピーして貼り付けることなく、シーンの検査、コンソール出力の読み取り、スクリプトの編集、エディターのアクションのトリガーなど、プロジェクトの完全なコンテキストを IDE に取得させることができます。
この投稿では、MCP とは何か、エージェントを接続する方法、利用できるツール、そしてバグの修正やシーンの管理などの一般的な開発タスクをスピードアップするためにMCPを使用する方法について説明します。
モデルコンテキストプロトコルとは
モデルコンテキストプロトコル (MCP) は、AI エージェントが外部ツールやデータと構造化された方法で通信できるようにするオープンスタンダードです。Unity の MCP サーバーはこのプロトコルを実装しているので、すべての MCP 互換性のあるの AI エージェントが Unity エディターに接続して、あたかも呼び出し可能なツールのセットであるかのように操作できます。
MCP を使用しない場合、IDE の AI エージェントには、開いているファイル、貼り付けたコード、コピーしたエラーなど、表示されている内容のみが表示されます。MCP では、標準化されたプロトコルを通じて Unity プロジェクトのランタイムステート (シーン階層、ゲームオブジェクト、コンポーネント値、ビルド設定、コンソールメッセージ) にリアルタイムでアクセスできます。
Unity の公式 MCP サーバーは AI アシスタントパッケージに含まれており、使用するには Unity サブスクリプションが必要です (ただし Unity AI クレジットは消費されません)。
前提条件
MCP の使用を開始するには、お使いの環境が次の要件を満たしている必要があります。
- AI アシスタントパッケージがインストールされている Unity 6 (6000.0) 以降
- Claude Code、Cursor、Windsurf、Claude Desktop などの MCP 互換性のある AI クライアント
- ユニティクラウドに接続された Unity プロジェクト
- Unity AI のアクティブなトライアルまたはサブスクリプション
AI エージェントを Unity と統合する方法
Unity MCP のセットアップはほんの数分で完了します。プロセス全体は次のとおりです。
1.Unity MCP ブリッジが動作していることを確認する
Unity エディターで、[編集] > [プロジェクト設定] > [AI] > [Unity MCP] に移動します。Unity Bridge が「実行中」(緑色のインジケーター) と表示されていることを確認します。ブリッジは、エディターがロードされると自動的に起動します。[停止] と表示されている場合は、[開始] を選択します。
2.AI クライアントを設定する
Unity MCP 設定ページのインテグレーションセクションでは、サポートされているクライアントを自動的に設定できます。インテグレーションを展開し、クライアントを選択して、設定を選択します。サポートされているクライアントには、お使いの Unity MCP バージョンによっては、クロードコード、カーソル、ウィンドサーフ、クロードデスクトップなどがあります。
3.リレーパスを手動で追加 (必要な場合)
クライアントが自動設定リストない場合は、Unity リレーバイナリを指すサーバーエントリーを追加します。Unity が起動すると、リレーは ~/.unity/relay/ にインストールされます。--mcp をコマンドライン引数としてリレー実行ファイル渡します。
4.Unity で接続を承認する
エージェントが初めて接続すると、Unity は接続待ちのメッセージを表示します。[編集] > [プロジェクト設定] > [AI] > [Unity MCP] に移動し、クライアントの詳細を確認して [承認] を選択します。以前に承認されたクライアントは自動的に再接続します。
5.接続をテストする
これで、エージェントは利用可能な Unity MCP ツールリストできるはずです。「Unity コンソールメッセージを読み、警告やエラーを要約する」などの簡単なコマンドを実行して、接続が機能していることを確認します。
プラットフォーム固有リレーパス
リレーバイナリパスはオペレーティングシステムによって異なります。エージェントを手動で設定するときは、プラットフォームパスを使用してください。
- macOS (Apple Silicon): ~/.unity/relay/relay_mac_arm64.app/Contents/MacOS/relay_mac_arm64
- macOS (Intel): ~/.unity/relay/relay_mac_x64.app/Contents/MacOS/relay_mac_x64
- Windows: %USERPROFILE%\.unity\relay\relay_win.exe
- Linux: ~/.unity/リレー /relay_linux
利用可能なツール
接続すると、AI エージェントはビルトインの Unity MCP ツールにアクセスできるようになります。これらのツールは、エージェントが指示を出すときに呼び出すものです。エージェントは Unity と直接やり取りするのではなく、プロトコルを経由します。
主なツールカテゴリには以下が含まれます。
- シーン管理:階層の読み込み、ゲームオブジェクトの作成/変更/削除、シーンの管理
- スクリプト編集:プロジェクト内の C# スクリプトの作成、読み取り、変更
- コンソールアクセス:Unity コンソールからのログ、警告、エラーの読み取り
- ゲームオブジェクトインスペクション:特定のゲームオブジェクトのコンポーネント値の読み取りと書き込み
- ビルド設定:プラットフォームを検査して構成をビルドする
また、C# でカスタム MCP ツールを登録して、接続しているエージェントに独自の編集ワークフローを公開することもできます。これは、プロジェクト固有のタスクを自動化したいチームに役立ちます。
AI エージェントからの Unity のコントロール
MCP 接続がアクティブな状態で、AI エージェントに自然言語による指示を与えると、その指示は Unity のツールを使用して実行されます。いくつかの例:
- 「PlayerSpawn という新しい空のゲームオブジェクトを (0, 0, 0) の位置に作成して」
- 「シーンの階層構造を読んで、どのオブジェクトに欠けているコンポーネントがあるか教えて」
- 「プレイヤーに追従するようにカメラを動かすスクリプトを書いて、メインカメラにアタッチして」
- 「コンソールにエラーがないか確認し、null 参照に関連するものはすべて修正してください」
エージェントはMCPツールを使用して各ステップを実行し、その理由と実行したツール呼び出しを示します。ずっとIDEを使っているので、結果を確認するまでUnity に切り替える必要はありません。
Unity MCP によるコンソールエラーの修正
Unity MCP の最も実用的な用途の 1 つは、エージェントがコンソールエラーを自律的に読み取って修正できるようにすることです。エージェントは同じセッションでコンソール読み取りとスクリプトの編集の両方を行うことができるため、何もコピーしなくてもエラーから修正まで進めることができます。
目次エージェントは Unity_Readコンソール経由でコンソールを読み取ります
2.関連するスクリプトを識別し、そのコンテンツ読み取ります
3.修正を書き込み、ファイルをプロジェクトに保存します
4.コンソールを再度読み込んで、エラーが解決されたことを確認します
これにより、通常は Unity と AI アシスタントの間で手動でコピーアンドペーストする必要があるフィードバックループが終了します。エージェントがエンドツーエンドで処理します。
Unity AI の詳細
Unity AI オープンベータで利用できる内容について詳しく知りたい場合は、このシリーズの他の記事もぜひお読みください。
今すぐ Unity AI をお試しください
Unity AI オープンベータは、すべての Unity 6 開発者が利用できるようになりました。無料トライアルにサインアップして Unity AI Assistant を試し、Unity AI Gateway 経由で好みのツールを接続して、組み込みのプロジェクト対応 AI エージェントで開発ワークフローがどのようなものかを試してみ開始。
登録して、unity.com/features/ai でプラン、価格設定、データプライバシーについて詳しく学んでください
完全なドキュメントは、エディターからリンクされている Unity AI ドキュメントまたは docs.unity3d.com で入手できます。
Unity AI アシスタントは現在オープンベータ版です。そのため、この投稿に記載されている機能、動作、および可用性は現在開発中であり、予告なく変更、制限、または中止される場合があります。