設定
AI Game Developer ドックで Godot MCP を設定し、AI エージェントが参照するツールを選択し、GODOT_MCP_* 環境変数で設定を上書きする方法を説明します。
ほとんどの人は設定を変更する必要はありません。アドオンは 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 に接続し、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 クライアントの接続を参照してください。
環境変数によってモードまたはホストが強制されている場合、「環境変数により上書きされています (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 に埋め込まれた拡張機能カタログを読み込みます。一覧が空の場合は拡張機能を参照してください。
フッター
ヘルプと問題報告へのリンク、そして選択したノードやオブジェクトが AI 向けにどのようにシリアライズされるかを表示する Serialization Check ウィンドウ（バグ報告時に便利です）。
設定の保存場所
ドックは設定を user://godot-mcp-config.json に保存します。これは Godot のプロジェクトごとのユーザーデータフォルダー内で（プロジェクト内ではありません）。このファイルには、接続モード、カスタムホスト、認証オプション、ログレベル、選択したエージェント、ツールの可視性、および使用したトークンが保存されます。
Cloud のサインイン資格情報は別途、マシンストアの ~/.ai-game-dev/credentials.json に保存され、他の AI Game Developer ツールと共有されます。エージェント設定用のプロジェクトキーは ~/.ai-game-dev/project-keys.json にあります。
ターミナルから godot-cli configure を実行すると、プロジェクトファイル .godot-mcp/features.json 内のツール、プロンプト、リソースの可視性を一覧表示および変更できます:
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 ランタイムにも接続できるようにします。 |
例: ローカルサーバーに対してエディターを起動します。
export GODOT_MCP_CONNECTION_MODE=Custom
export GODOT_MCP_HOST=http://localhost:8080
godot --editor --path ./MyGodotProjectgodot-cli open は --mode、--url、--cloud-url、--token、--auth、--log-level でこれらを設定します。詳細は godot-cli リファレンス を参照してください。
ツールフォーマット
デフォルトの Rql フォーマットでは、ツールは RQL の値("Level/Player" のようなノードパスや godot.find("Name"))を引数として受け取り、より少ないトークンで済むコンパクトなテキストを返します。GODOT_MCP_TOOL_FORMAT=Json または toolFormat キーで設定する Json フォーマットは、それを好むクライアント向けに完全な JSON スキーマと構造化された結果を保持します。RQL の詳細: ツール。