# はじめに — Unity · AI Game Developer Wiki

Unity MCPで最初のAIエージェントをUnity Editorに接続し、接続を確認して、Claude Code、Cursor、Copilotで最初のプロンプトを試しましょう。

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

このページでは、プラグインをインストール済みの状態から、AIエージェントがUnityシーンを変更するまでの流れを説明します。ここではai-game.dev経由のデフォルトのCloud接続と、例としてClaude Codeを使用しますが、手順は他のクライアントでも同じです。プラグインがまだインストールされていない場合は、[Installation](https://ai-game.dev/ja/docs/wiki/unity/installation)から始めてください。

## ステップ1: AI Game Developerウィンドウを開く

Unityでプロジェクトを開き、**Window > AI Game Developer — MCP**を選択します（Ctrl+Alt+A、macOSではCmd+Option+A）。ウィンドウのタブ名は**Game Developer**です。Scene Viewのツールバーにある**AI**ボタンをクリックしても開けます。

ウィンドウには接続状況が上から下へのタイムラインとして表示されます: **Unity**、次に**MCP server**、次に**AI agent**です。各ポイントにはステータスサークルがあります。3つすべてを緑にすることが目標です。

## ステップ2: サインインする（Cloudモード）

上部の**Connection**スイッチには**Custom**と**Cloud**の2つのオプションがあります。新規インストールでは**Cloud**が使用されます。

1. **Cloud Token**フィールドの横にある**Authorize**をクリックします。
2. ブラウザでai-game.devのデバイスサインインページが開きます。ウィンドウには短いコード（「Code: … — Authorize in browser」）が表示されます。ブラウザにも同じコードが表示されていることを確認して承認します。
3. フィールドが「Signed in via account」に変わり、Unityのステータスが**Connected**になります。

サインイン情報はマシン全体に対して`~/.ai-game-dev/credentials.json`に保存されます。すでに`unity-mcp-cli login`やAI Game Devアプリでサインインしている場合、Editorはその認証情報を引き継ぐため、このステップは省略できます。詳細は[Authentication](https://ai-game.dev/docs/auth)にあります。

**メモ**

プラグインを試すのにアカウントは必要ありません。接続を**Custom**に切り替えれば、代わりにローカルMCPサーバーを自分のマシンで実行できます。[Configuration](https://ai-game.dev/ja/docs/wiki/unity/configuration#connection-modes)を参照してください。

## ステップ3: AIエージェントを設定する

1. **AI agent**セクションで、ドロップダウンからクライアントを選択します。たとえば**Claude Code**です。
2. **Model Context Protocol (MCP)**の下にある**Configure**をクリックします。プラグインは、このプロジェクトに固定されたURLを含むクライアントのMCP設定ファイル（Claude Codeの場合はプロジェクトルートの`.mcp.json`）を書き込みます。
3. **Skills**の下で**Auto-generate**をオンにするか、**Generate**をクリックします。これにより、エージェントがUnity MCPとRQLの使い方を学ぶために読むスキルファイルが書き込まれます（Claude Codeの場合は`.claude/skills`内）。スキルをサポートするエージェントは、スキルがあると明らかにうまく動作します。
4. プロジェクトフォルダからAIクライアントを起動するか、すでに起動している場合は再起動して、新しい設定を読み込ませます。

同じことはターミナルからも実行できます:

```bash
unity-mcp-cli setup-mcp claude-code ./MyUnityProject
unity-mcp-cli setup-skills claude-code ./MyUnityProject
```

`setup-skills`にはEditorが開かれ、接続されている必要があります。他のクライアントや手動セットアップについては[Connecting AI clients](https://ai-game.dev/ja/docs/wiki/unity/connecting-ai-clients)で説明しています。

## ステップ4: 接続を確認する

- ウィンドウでUnityのステータスが**Connected**と表示され、AI agentのポイントにクライアントが設定済みとして表示されます。
- AIクライアントでMCPサーバーまたはツールを一覧表示します。Claude Codeでは`/mcp`を実行します。`ai-game-developer`が表示され、`rql-query`、`rql-mutate`、`rql-schema`、`script-execute`、`screenshot-isolated`、`tests-run`、`unity-tool-list`などのツールが確認できるはずです。
- Unityの準備ができる前にクライアントが接続されていた場合は、再接続してツールを再度一覧表示させてください。

ターミナルからは、`unity-mcp-cli status ./MyUnityProject`でUnityが実行中かどうか、設定されたサーバーに到達できるかどうかを確認できます。

## ステップ5: 最初のプロンプト

まずシーンを読み取るリクエストから始め、次にシーンを変更するリクエストを試します:

```text
Explain my scene hierarchy.
```

```text
Create 3 spheres stacked on top of each other, then save the scene.
```

```text
Create a metallic golden material and assign it to a new sphere.
```

Hierarchyを確認してください。エージェントが作業するにつれてオブジェクトが表示されます。内部ではエージェントがRQLを送信しています。たとえば次のようなミューテーションです:

```text
editor | call CreateGameObject({name: "Ground", primitive: "Plane"})
```

RQLによる変更はすべて1つのUndoステップとして記録されるため、Ctrl+Z（Cmd+Z）で手動編集と同じように元に戻せます。

複数のツールを試す、より長い例:

```text
Create a new scene called Playground. Add a plane scaled to 10, 1, 10 and a capsule
named Player at 0, 1, 0 with a Rigidbody. Write a PlayerController script that moves
the Player with WASD, attach it, and take a screenshot of the Player.
```

他に試せるアイデア:

- 「Consoleを読み取って、エラーがあるか教えてください。」
- 「すべてのEditModeテストを実行し、失敗を要約してください。」
- 「開いているシーン内のすべてのRigidbodyを質量とともに一覧表示してください。」
- 「Profilerを開始し、Playモードを数秒間記録して、フレームタイムを報告してください。」

## より良い結果を得るためのヒント

- 名前、位置、ファイルパスを具体的に指定してください。リクエストが正確であればあるほど、修正が少なくて済みます。
- クライアントでは強力なモデルを選択してください。ツールを多用する作業ではその利点が活きます。
- Copilotを使用するVS Codeでは、チャットを**Agent**モードに切り替えてください。そうしないとツールが呼び出されません。
- エージェントのツール一覧は短く保ってください。非表示のツールも名前で呼び出せば実行されますが、表示されるツールが少ないほど、推論に使えるコンテキストが増えます。[Configuration](https://ai-game.dev/ja/docs/wiki/unity/configuration#tools-prompts-resources)を参照してください。

[Unity best practices](https://ai-game.dev/docs/best-practices/unity)ページには、さらにプロンプトのアドバイスがあります。

## 次のステップ

- [Tools and RQL](https://ai-game.dev/ja/docs/wiki/unity/tools-and-rql): エージェントが実行できるすべての操作。
- [Extensions](https://ai-game.dev/ja/docs/wiki/unity/extensions): Animation、Cinemachine、ProBuilder、Tilemapなどのパックを追加します。
- [Custom tools](https://ai-game.dev/ja/docs/wiki/unity/custom-tools): 独自のC#メソッドをエージェントに公開します。
- 困ったときは[Troubleshooting](https://ai-game.dev/ja/docs/wiki/unity/troubleshooting)を参照してください。

---

Source (HTML): https://ai-game.dev/ja/docs/wiki/unity/getting-started

Machine-translated (ja) from the English page: https://ai-game.dev/docs/wiki/unity/getting-started