# AIクライアントの接続 — Unity · AI Game Developer Wiki

Claude Code、Cursor、Copilot、Codex、GeminiなどのMCPクライアントを、ai-game.devのクラウドエンドポイントまたはローカルサーバー経由でUnity MCPに接続します。

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

このページでは、AIクライアントがUnity Editorに到達する仕組み、使用するエンドポイントとサインイン、およびサポートされる各エージェントをAI Game Developerウィンドウ、`unity-mcp-cli`、または手動で設定する方法を説明します。

## 2つの接続方法

AIクライアントがUnityと直接通信することはありません。どちらもMCPサーバーに接続し、サーバーがSignalR接続を介してツール呼び出しをEditorにルーティングします。

|  | クラウド（デフォルト） | カスタム（ローカル） |
| --- | --- | --- |
| サーバー | ホストされたエンドポイント `https://ai-game.dev/mcp` | プラグインがダウンロードして起動する `gamedev-mcp-server` |
| Editor接続 | プラグインがai-game.devに接続 | プラグインが `http://localhost:<port>` に接続 |
| クライアントエンドポイント | `https://ai-game.dev/mcp/p/<pin>`（ピン留め）または `https://ai-game.dev/mcp` | `http://localhost:<port>`、またはstdio経由のサーバーバイナリ |
| サインイン | ai-game.devアカウント（OAuthデバイスフロー） | なし、ai-game.dev OAuth、または共有トークン |
| オフライン動作 | 不可 | 可（`none`または`token`認可の場合） |

モードはAI Game Developerウィンドウの**Connection**スイッチ（**Custom** / **Cloud**）で選択します。[Configuration](https://ai-game.dev/ja/docs/wiki/unity/configuration#connection-modes)ではローカルサーバーの設定について説明しています。

## ピン留めURL

ベースエンドポイント`https://ai-game.dev/mcp`は、フォールバックとして接続済みのEditorの1つにルーティングされます。開いているプロジェクトが1つだけなら問題ありませんが、複数ある場合は曖昧になります。

**ピン留め**URL `https://ai-game.dev/mcp/p/<pin>`は、常に1つのプロジェクトのEditorにルーティングされます。ピンはプロジェクトのIDから生成されます。ウィンドウの**Configure**ボタンと`unity-mcp-cli setup-mcp`はデフォルトでピン留めURLを書き込み、`setup-mcp --no-pin`は代わりにベースURLを書き込みます。stdioトランスポートの場合、ピンは`project=<pin>`引数として渡されます。

## サインイン

Editor、CLI、デスクトップアプリは、`~/.ai-game-dev/credentials.json`に保存されたマシン全体で共有される1つのサインインを共有します。いずれかで一度サインインしてください:

- ウィンドウで: クラウドモードにしてから**Authorize**、ブラウザでコードを承認します。
- ターミナルで: `unity-mcp-cli login`。
- [AI Game Devアプリ](https://ai-game.dev/docs/app)で: **Sign in**。

トークンはバックグラウンドで更新されます。ウィンドウの**Revoke**は、マシン上のすべてのAI Game Devツール（すべてのエンジンプラグイン、CLI、デスクトップアプリ）からサインアウトし、サーバー上のトークンを取り消します。

AIクライアント自体の認証方法は、書き込まれた設定によって異なります:

- **プロジェクトキー（サインイン時のCloud HTTPのデフォルト）。** 設定には`Authorization: Bearer agd_pk_…`が含まれます。これは有効期限がなく、このプロジェクトにのみ紐付けられた取り消し可能なキーです。キーは`~/.ai-game-dev/project-keys.json`に保存されます。ウィンドウの**Regenerate key**、または`setup-mcp --regenerate-key`で置き換えられ、古いキーは取り消されます。
- **OAuth（URLのみ）。** ファイルに認証情報は含まれず、クライアントは初回接続時にブラウザのサインインを開きます。サインインしていない場合、または`setup-mcp --oauth`を指定した場合にこの形式になります。
- **パーソナルアクセストークン。** CIやブラウザログインができないクライアント向けに、ai-game.devアカウントでトークンを作成し（[Authentication](https://ai-game.dev/docs/auth)参照）、`setup-mcp --token <token>`で渡します。

プロジェクトキーとトークンはパスワードと同様に扱ってください。`.mcp.json`などのファイルはプロジェクトフォルダ内にあるため、コミットする前に`.gitignore`を確認してください。アカウント側の説明は[Authentication](https://ai-game.dev/docs/auth)にあります。

## サポートされるAIエージェント

ウィンドウの**AI agent**ドロップダウンにこれらの設定項目が一覧表示されます。**Configure**は表示されたファイルを書き込み、**Remove**はエントリを再び削除します。

| エージェント | 書き込まれる設定ファイル | CLI id |
| --- | --- | --- |
| Claude Code | `.mcp.json`（プロジェクトルート） | `claude-code` |
| Claude Desktop | Claudeのアプリデータフォルダ内の`claude_desktop_config.json` | `claude-desktop` |
| Cursor | `.cursor/mcp.json` | `cursor` |
| Visual Studio Code（Copilot） | `.vscode/mcp.json` | `vscode-copilot` |
| Visual Studio（Copilot） | `.vs/mcp.json` | `vs-copilot` |
| Rider（Junie） | `.junie/mcp/mcp.json` | `rider-junie` |
| GitHub Copilot CLI | `~/.copilot/mcp-config.json` | `github-copilot-cli` |
| Gemini | `.gemini/settings.json` | `gemini` |
| Antigravity | `~/.gemini/config/mcp_config.json` と `~/.gemini/antigravity/mcp_config.json` | `antigravity` |
| Cline | VS Codeのグローバルストレージ内の`cline_mcp_settings.json` | `cline` |
| Open Code | `opencode.json` | `open-code` |
| Codex | `.codex/config.toml` | `codex` |
| Kilo Code | `.kilocode/mcp.json` | ウィンドウのみ |
| Zoo Code | `.roo/mcp.json` | ウィンドウのみ |
| Unity AI | `UserSettings/mcp.json` | `unity-ai` |
| その他 - カスタム | コピー用のJSONを表示 | `custom` |

相対パスはUnityプロジェクト内を指します。サーバーエントリ名は常に`ai-game-developer`です。`unity-mcp-cli setup-mcp --list`を実行すると、お使いのCLIバージョンがサポートするidを確認できます。

**ヒント**

Claude Desktop と Unity AI は生成されたスキルを使用しないため、Custom エントリでスキルフォルダーを選択できます。その他のエージェントでは、**Skills > Auto-generate** をオンにする（または `setup-skills` を実行する）と、エージェントが RQL を学習します。

## unity-mcp-cli で設定する

`setup-mcp` は、Unity を開かずに、ウィンドウの **Configure** ボタンと同じ出力を書き込みます:

```bash
unity-mcp-cli setup-mcp claude-code ./MyUnityProject
unity-mcp-cli setup-mcp cursor ./MyUnityProject --transport stdio
unity-mcp-cli setup-mcp claude-code ./MyUnityProject --no-pin
```

デフォルトのトランスポートは `http` です。`--transport stdio` を指定すると、代わりにローカルサーバーバイナリを起動する設定になります。すべてのフラグは [CLI リファレンス](https://ai-game.dev/ja/docs/wiki/unity/cli#setup-mcp) にあります。

## 手動で設定する

HTTP をサポートする MCP クライアントならどれでも、ホストされたエンドポイントを利用できます。Claude Code の例:

```bash
claude mcp add --transport http ai-game-developer https://ai-game.dev/mcp
```

汎用的な `mcpServers` JSON 設定:

```json
{
  "mcpServers": {
    "ai-game-developer": {
      "url": "https://ai-game.dev/mcp"
    }
  }
}
```

1つのプロジェクトを対象にするには、URL をプロジェクトの固定 URL（ウィンドウの手動設定手順に表示されます）に置き換えてください。[MCP エンドポイントのページ](https://ai-game.dev/ja/mcp-endpoint-info) には、VS Code の `servers` 形式や PAT ヘッダーなど、すべてのクライアント向けのスニペットがあります。

### HTTP 経由のローカルサーバー

Custom モードで HTTP トランスポートを使う場合、クライアントをローカルサーバーに向けます。ポートはウィンドウの **Server URL** に記載されているものです。ウィンドウに表示されるお使いのエージェント向けの手動設定手順には、プロジェクトの固定を含む正確な URL が含まれています:

```json
{
  "mcpServers": {
    "ai-game-developer": {
      "url": "http://localhost:<port>"
    }
  }
}
```

### stdio 経由のローカルサーバー

stdio トランスポートでは、クライアントがサーバーバイナリ自体を起動します。Windows の場合:

```bash
claude mcp add ai-game-developer "<project>/Library/mcp-server/win-x64/gamedev-mcp-server.exe" port=<port> plugin-timeout=10000 client-transport=stdio
```

他のプラットフォームでは `osx-arm64`、`osx-x64`、`linux-x64`、`linux-arm64`、`win-x86`、`win-arm64` を使用します（Windows 以外では `.exe` を付けません）。`<project>` はプロジェクトのフルパスに、`<port>` はウィンドウに表示されるポートに置き換えてください。stdio サーバーを同時に使用できるエージェントは1つだけであり、エージェントがプロセスを所有するため、ウィンドウの Start/Stop ボタンは無効になります。クライアントが HTTP をサポートしていない場合を除き、HTTP を推奨します。

## 設定後

AI クライアントを再起動するか、その MCP サーバーに再接続して、新しい設定を読み込ませてください。その後、[はじめに](https://ai-game.dev/ja/docs/wiki/unity/getting-started#verify) に従って接続を確認します。クライアントにツールが表示されない場合は、[トラブルシューティング](https://ai-game.dev/ja/docs/wiki/unity/troubleshooting#no-tools) を参照してください。

---

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

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