# 設定 — Godot · AI Game Developer Wiki

AI Game Developer ドックで Godot MCP を設定し、AI エージェントが参照するツールを選択し、GODOT_MCP_* 環境変数で設定を上書きする方法を説明します。

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

ほとんどの人は設定を変更する必要はありません。アドオンは Cloud モードで起動し、サインイン後に接続し、すべてのツールを公開します。このページでは、必要に応じて変更できる項目について、**AI Game Developer** ドック、保存される設定、そして CI やスクリプト実行向けの環境変数を通じた方法を説明します。

## **AI Game Developer** ドック

このアドオンは、Godot エディターの右上のドック領域に **AI Game Developer** という名前のドックを追加します。上から下へ、次のセクションがあります。

### ヘッダー

ヘッダーにはアドンのバージョンと **Log Level** セレクターが表示されます。ログレベルは、アドオンとその接続が出力パネルにどれだけ出力するかを制御します（`Trace`、`Debug`、`Info`、`Warning`、`Error`、`None`。デフォルトは `Info`）。接続の問題を診断するときは `Debug` または `Trace` に上げてください。`GODOT_MCP_LOG_LEVEL` が設定されている場合、セレクターは無効になり、その旨の注記が表示されます。

### 接続

- **Cloud / Custom**: 接続モードです。Cloud は [ai-game.dev](https://ai-game.dev) に接続し、Custom は選択したサーバー URL に接続します。
- **Connect / Stop**: MCP サーバーへの接続を開始または停止します。接続できるまで、アドオンはバックグラウンドで再試行を続けます。
- Cloud モードの場合: **Authorize**（ブラウザでのデバイスサインインを開始します）と **Sign out** を備えたサインイン状態。
- Godot、MCP サーバー、AI エージェントの 3 つの点をつなぐ線で、何が接続されているかを示します。AI エージェントの行には、接続中のクライアントが名前で一覧表示され、まだ何も接続されていない場合は「（オンデマンドで接続）」と表示されます。

Custom モードでは **MCP server** カードが追加されます:

- **Server URL**: 接続先のサーバー。デフォルトは `http://localhost:8080` です。
- **Authorization Token**: `none`、`oauth`（ai-game.dev アカウントのトークンで、localhost のサーバーにのみ送信されます）、または `token`（ベアラートークン。**New** で生成します）。
- **Start Server / Stop Server**: アドオンに固定されたサーバーバージョンと一致するローカルサーバーをダウンロード、起動、停止します。詳しくは[AI クライアントの接続](https://ai-game.dev/ja/docs/wiki/godot/connecting-ai-clients#custom-mode)を参照してください。

環境変数によってモードまたはホストが強制されている場合、「環境変数により上書きされています (GODOT\_MCP\_\*)」という黄色の注記が表示され、ドックでの変更は反映されません。

### AI エージェント

使用する AI クライアントを選択します（デフォルトは Claude Code）。その後、次のセクションが表示されます:

- **Skills**: エージェントのスキルファイルの保存先、アドオンの読み込み時にそれらを更新する **Auto-generate** スイッチ、そして **Generate** ボタン。スキルをサポートしていないエージェントでは「このエージェントはスキルをサポートしていません」と表示されます。
- **Model Context Protocol (MCP)**: エージェントの MCP 設定が済んでいるかどうかと、**Configure** / **Reconfigure**、**Remove**。エージェントを設定した後にサーバー設定が変更された場合は、**Reconfiguration Required** の通知が表示されます。

### MCP の機能

**Tools**、**Prompts**、**Resources** の 3 行があり、それぞれ可視項目数が全体数とともに表示され（ツールには推定トークンコストも表示されます）、**Open** ボタンがあります。開くウィンドウには、すべての項目が **Visible** スイッチとフィルターフィールドとともに一覧表示されます。

**Visible** は、MCP クライアントのツール一覧にその項目を表示するかどうかだけを決めます。不要なツールを非表示にすると、エージェントのコンテキストを小さく保てます。これはアクセス制御ではありません。非表示のツールでも、クライアントが名前で呼び出せば実行されます。

### 拡張機能

オプションの Godot MCP 拡張機能の一覧で、**Install** と **Update** ボタンがあります。この一覧は `.csproj` に埋め込まれた拡張機能カタログを読み込みます。一覧が空の場合は[拡張機能](https://ai-game.dev/ja/docs/wiki/godot/extensions)を参照してください。

### フッター

ヘルプと問題報告へのリンク、そして選択したノードやオブジェクトが AI 向けにどのようにシリアライズされるかを表示する **Serialization Check** ウィンドウ（バグ報告時に便利です）。

## 設定の保存場所

ドックは設定を `user://godot-mcp-config.json` に保存します。これは Godot のプロジェクトごとのユーザーデータフォルダー内で（プロジェクト内ではありません）。このファイルには、接続モード、カスタムホスト、認証オプション、ログレベル、選択したエージェント、ツールの可視性、および使用したトークンが保存されます。

**注意**

このファイルはトークンをプレーンな JSON として保存します。コミット、同期、共有はしないでください。トークンをローテーションするには、サインアウトするかドックでクリアする（またはファイルを削除する）かしたうえで、もう一度接続してください。

Cloud のサインイン資格情報は別途、マシンストアの `~/.ai-game-dev/credentials.json` に保存され、他の AI Game Developer ツールと共有されます。エージェント設定用のプロジェクトキーは `~/.ai-game-dev/project-keys.json` にあります。

ターミナルから `godot-cli configure` を実行すると、プロジェクトファイル `.godot-mcp/features.json` 内のツール、プロンプト、リソースの可視性を一覧表示および変更できます:

```bash
godot-cli configure ./MyGodotProject --list
godot-cli configure ./MyGodotProject --disable-tools script-delete,script-execute
godot-cli configure ./MyGodotProject --enable-all-tools
```

## 環境変数

環境変数はファイルを編集することなく保存済みの設定を上書きするため、CI、ヘッドレス実行、ローカル開発に便利です。アドオンはプロジェクト内の `.env` ファイルからもこれらを読み込みます。プロセスの環境変数が `.env` より優先されます。

| 変数 | 値 | 用途 |
| --- | --- | --- |
| `GODOT_MCP_CONNECTION_MODE` | `Cloud`、`Custom` | 接続モードを強制します。デフォルトは `Cloud`。 |
| `GODOT_MCP_CLOUD_URL` | URL | クラウドのベース URL を上書きします。デフォルトは `https://ai-game.dev`。 |
| `GODOT_MCP_HOST` | URL | Custom モードのサーバー URL。デフォルトは `http://localhost:8080`。 |
| `GODOT_MCP_AUTH_OPTION` | `none`、`oauth`、`token` | Custom モードの認証。 |
| `GODOT_MCP_TOKEN` | 文字列 | アクティブなモード用の Bearer トークン。保存済みのトークンを上書きし、書き戻されることはありません。 |
| `GODOT_MCP_LOG_LEVEL` | `Trace` から `None` まで | ログの詳細度。 |
| `GODOT_MCP_CREDENTIALS_DIR` | 絶対パス | 分離したテスト用に、別の認証情報ストアを使用します。 |
| `GODOT_MCP_TOOL_FORMAT` | `Rql`、`Json` | ツールが引数を受け取り結果を返す方法。デフォルトは `Rql`(コンパクトなテキスト)で、`Json` は JSON スキーマと結果を保持します。 |
| `GODOT_MCP_SERVER_PATH` | 絶対パス | エディター専用: 固定されたリリースをダウンロードする代わりに、この既存のサーバーバイナリを起動します。 |
| `GODOT_MCP_RUNTIME_FROM_EDITOR` | `1` | Play で起動したゲームが、自身のゲーム内 MCP ランタイムにも接続できるようにします。 |

例: ローカルサーバーに対してエディターを起動します。

```bash
export GODOT_MCP_CONNECTION_MODE=Custom
export GODOT_MCP_HOST=http://localhost:8080
godot --editor --path ./MyGodotProject
```

`godot-cli open` は `--mode`、`--url`、`--cloud-url`、`--token`、`--auth`、`--log-level` でこれらを設定します。詳細は [godot-cli リファレンス](https://ai-game.dev/ja/docs/wiki/godot/cli#open) を参照してください。

## ツールフォーマット

デフォルトの `Rql` フォーマットでは、ツールは RQL の値(`"Level/Player"` のようなノードパスや `godot.find("Name")`)を引数として受け取り、より少ないトークンで済むコンパクトなテキストを返します。`GODOT_MCP_TOOL_FORMAT=Json` または `toolFormat` キーで設定する `Json` フォーマットは、それを好むクライアント向けに完全な JSON スキーマと構造化された結果を保持します。RQL の詳細: [ツール](https://ai-game.dev/ja/docs/wiki/godot/tools#rql)。

---

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

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