このページは英語から機械翻訳されています。英語の原文を読む。

AIクライアントの接続

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

2026年11月4日に更新 Markdownで表示

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 のデバイス認可フローを使用します。トークンを手動でコピーする必要はありません。

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 リファレンス と 認証 を参照してください。

固定されたプロジェクト 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 のみになります。

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

カスタムモードでは、アドオンは選択したサーバー URL（例えば自分のマシン上のサーバー）に接続します。サーバーはオープンソースの 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 イメージをダウンロードしてください。

./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 を設定してください。両モードの環境変数は 設定 に記載されています。

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

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

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

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

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

エージェントid設定ファイル
Claude Codeclaude-codeプロジェクト内の .mcp.json
Claude Desktopclaude-desktopClaude のカスタムコネクタを使用します（下記参照）
Cursorcursor.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 CLIgithub-copilot-cli~/.copilot/mcp-config.json
Geminigemini.gemini/settings.json
Antigravityantigravity~/.gemini/config/mcp_config.json と ~/.gemini/antigravity/mcp_config.json
ClineclineVS Code のグローバルストレージ内の cline_mcp_settings.json
Open Codeopen-codeopencode.json
Codexcodex.codex/config.toml
Kilo Codekilo-code.kilocode/mcp.json
その他の MCP クライアントcustomプロジェクト内の mcp.json

例:

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 スイッチ）。ターミナルからは:

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 エンドポイントのページ にあります。