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

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

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

Godot MCP には、どちらも MCP サーバーに接続する2つの側面があります。Godot エディタ内のアドオンと、チャットする AI クライアントです。このページでは、2つの接続モード、サインインの仕組み、そして `godot-cli setup-mcp` またはドックの **Configure** ボタンを使って、サポートされている各エージェント用の MCP 設定を書く方法を説明します。

## クラウドモード（デフォルト）

クラウドモードでは、アドオンは `https://ai-game.dev` のホスト型バックエンドに接続し、AI クライアントは MCP エンドポイント `https://ai-game.dev/mcp` に接続します。マシン上で追加のものを実行する必要がなく、ファイアウォールを越えて動作します。これがデフォルトのモードであり、ほとんどの人におすすめするモードです。

### デバイスフローでサインインする

クラウドの認証には OAuth 2.1 のデバイス認可フローを使用します。トークンを手動でコピーする必要はありません。

```bash
godot-cli login
```

CLI は短いコードを表示し、ブラウザを開いて、あなたが承認するまで待機します。認証情報（アクセストークン、ローテーションするリフレッシュトークン、有効期限）はマシンストア `~/.ai-game-dev/credentials.json` に保存されます（macOS と Linux ではファイルモード 0600、Windows では DPAPI で保護）。エディタのアドオン、他のエンジン CLI、AI Game Dev アプリはすべてこの認証情報を利用し、期限切れのアクセストークンは自動的に更新されます。ドックの **Authorize** をクリックすると、Godot 内から同じフローが実行されます。

便利な `login` フラグ: `--force` は既存の認証情報に対して再度サインインします。`--project <path>` はプロジェクトごとに別の認証情報を保持します。`--tools-only` は CI ランナー向けのより限定された認証情報を作成します。詳細は [godot-cli リファレンス](https://ai-game.dev/ja/docs/wiki/godot/cli#login) と [認証](https://ai-game.dev/docs/auth) を参照してください。

### 固定されたプロジェクト URL

通常のエンドポイント `https://ai-game.dev/mcp` は、あなたのエージェントを接続済みのエディタのいずれかにルーティングします。複数のプロジェクトが開かれている場合は曖昧になるため、`setup-mcp` はデフォルトで固定 URL `https://ai-game.dev/mcp/p/<pin>` を書き込みます。ここで pin はプロジェクトから導出されます。この設定で起動したエージェントは、常にこのプロジェクトのエディタに到達します。通常の URL を使いたい場合は `--no-pin` を渡してください。

### プロジェクトキー

サインインしている場合、`setup-mcp` はエージェントの設定にプロジェクトキーを `Authorization: Bearer agd_pk_…` として書き込みます。プロジェクトキーは有効期限がなく、このプロジェクトの pin に対してのみ機能するため、あなたのアカウント上の他のプロジェクトには到達できません。プロジェクトごとに一度作成され、`~/.ai-game-dev/project-keys.json` から再利用されます。

- `--regenerate-key` は新しいキーを作成し、設定を書き換え、古いキーを無効化します。
- `--oauth` は代わりに URL のみの設定を書き込みます。エージェントは自身の OAuth プロンプトでサインインします。
- マシンでのサインインがない場合も、設定は URL のみになります。

**注意**

プロジェクトキーは認証情報です。プロジェクトキーを含む設定ファイル（例えば `.mcp.json` や `.cursor/mcp.json`）を公開リポジトリにコミットしないでください。

## カスタムモード: 独自のサーバー

カスタムモードでは、アドオンは選択したサーバー URL（例えば自分のマシン上のサーバー）に接続します。サーバーはオープンソースの [GameDev-MCP-Server](https://github.com/IvanMurzak/GameDev-MCP-Server) で、Unity MCP や Unreal MCP が使用するのと同じバイナリです。

最も簡単な方法は、アドオンにサーバーを実行させることです。

1. ドックでモードを **Custom** に切り替えます。
2. **Server URL** を `http://localhost:8080` のままにするか、別のローカル URL を入力します。
3. **Start Server** をクリックします。アドオンは固定されたサーバーバージョンのビルドを GitHub から（HTTPS、github.com のみ）ダウンロードし、`.godot/mcp-server/<platform>/` にキャッシュして、起動し接続します。

**Stop Server** で停止し、エディタを閉じても停止します。CI 環境ではダウンロードはスキップされます。代わりに自分でサーバーを実行するには、リリースバイナリまたは `aigamedeveloper/mcp-server` Docker イメージをダウンロードしてください。

```bash
./gamedev-mcp-server --client-transport streamableHttp --port 8080
```

### カスタムサーバーの認可

カスタムモードには、3つの値を持つ **Authorization Token** スイッチがあります。

| 値 | 意味 |
| --- | --- |
| `none` | 認証なし。自分のマシン上でのみ待ち受けるサーバーには問題ありません。 |
| `oauth` | サインイン済みの ai-game.dev アカウントトークンを送信しますが、localhost サーバー（`localhost`、`127.0.0.0/8`、`::1`）にのみ送信します。 |
| `token` | ベアラートークン。**New** をクリックして生成します。マスクされた状態で保存されます。 |

`oauth` を指定した非ローカルのホストの場合、アドオンはアカウントトークンの送信を拒否します。代わりに `GODOT_MCP_TOKEN` を設定してください。両モードの環境変数は [設定](https://ai-game.dev/ja/docs/wiki/godot/configuration#environment-variables) に記載されています。

エージェントをローカルサーバーに向けるには、URL を `setup-mcp` に渡します。

```bash
godot-cli setup-mcp claude-code ./MyGodotProject --url http://localhost:8080
```

ローカルサーバーの設定にはプロジェクトキーが含まれることはありません。

## サポートされているエージェントと設定ファイル

`godot-cli setup-mcp --list` を実行すると、すべてのエージェント id を確認できます。以下は現在の CLI が認識している id と、設定の書き込み先です:

| エージェント | id | 設定ファイル |
| --- | --- | --- |
| Claude Code | `claude-code` | プロジェクト内の `.mcp.json` |
| Claude Desktop | `claude-desktop` | Claude のカスタムコネクタを使用します（下記参照） |
| Cursor | `cursor` | `.cursor/mcp.json` |
| Visual Studio Code (Copilot) | `vscode-copilot` | `.vscode/mcp.json` |
| Visual Studio (Copilot) | `vs-copilot` | `.vs/mcp.json` |
| Rider (Junie) | `rider-junie` | `.junie/mcp/mcp.json` |
| GitHub Copilot CLI | `github-copilot-cli` | `~/.copilot/mcp-config.json` |
| Gemini | `gemini` | `.gemini/settings.json` |
| Antigravity | `antigravity` | `~/.gemini/config/mcp_config.json` と `~/.gemini/antigravity/mcp_config.json` |
| Cline | `cline` | VS Code のグローバルストレージ内の `cline_mcp_settings.json` |
| Open Code | `open-code` | `opencode.json` |
| Codex | `codex` | `.codex/config.toml` |
| Kilo Code | `kilo-code` | `.kilocode/mcp.json` |
| その他の MCP クライアント | `custom` | プロジェクト内の `mcp.json` |

例:

```bash
godot-cli setup-mcp cursor ./MyGodotProject
godot-cli setup-mcp codex ./MyGodotProject
godot-cli setup-mcp vscode-copilot ./MyGodotProject --oauth
```

どの設定も HTTP トランスポート（`type: http` と URL）を使用します。Codex ではキーは `http_headers` に記述します。

### Claude Desktop と claude.ai

Claude Desktop は `claude_desktop_config.json` から HTTP サーバーのエントリを受け付けません。代わりに Claude Desktop と claude.ai は、Claude のカスタムコネクタとしてクラウドエンドポイントにアクセスします。Claude の設定でカスタムコネクタを追加し、プロジェクトに固定されたクラウド URL を貼り付けて、ai-game.dev アカウントでサインインしてください。Claude Desktop は Custom モードのサーバーを使用できません。Godot MCP がそのための stdio トランスポートを提供していないためです。ローカルサーバーを使う場合は、Claude Code など、HTTP をサポートする表内のエージェントを使用してください。

## ドックから設定する

ドックの **AI agent** セクションは `setup-mcp` と同じ役割を果たします。リストからエージェントを選び、**Configure**（または **Reconfigure**）をクリックします。ステータス行にはエージェントの設定ファイルが設定済みかどうかが表示され、設定後にサーバー URL、モード、認可を変更すると **Reconfiguration Required** の通知が表示されます。**Remove** をクリックすると、そのエージェントの設定から Godot MCP のエントリが削除されます。

## エージェント向けのスキル

一部のエージェントは、ツールの使い方を教えるスキルファイル（`SKILL.md`）を読み込みます。AI agent セクション内にあるドックの **Skills** 行でそれらを生成できます（**Generate**、または **Auto-generate** スイッチ）。ターミナルからは:

```bash
godot-cli setup-skills claude-code ./MyGodotProject
```

これにより、エディタを起動していなくても、Claude Code の `.claude/skills` など、エージェントのスキルフォルダにファイルが書き込まれます。`setup-skills --list` を実行すると、スキルをサポートするエージェントを確認できます。

## コピー＆ペースト用の設定

お使いのクライアントがリストにない場合でも、HTTP サーバーをサポートする MCP クライアントならどれでも使用できます。`https://ai-game.dev/mcp`（または固定 URL）を指定して OAuth でサインインさせるか、bearer ヘッダーを追加してください。多くのクライアント向けのすぐに使えるスニペットは [MCP エンドポイントのページ](https://ai-game.dev/ja/mcp-endpoint-info) にあります。

---

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

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