# Godot MCP — AI Game Developer Wiki

Godot MCPはClaude、Cursor、CopilotなどのAIエージェントをGodotエディタに接続します。インストール、セットアップ、ツール、拡張機能、CLIはここから始めましょう。

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

Godot MCPはAI Game DeveloperのGodotアドオンです。Claude Code、Cursor、GitHub Copilot、Codex、GeminiなどのAIエージェントがGodotエディタ内で作業できるようにします。シーンツリーの照会と編集、`.tscn`シーンのオープンと保存、`.tres`リソースやプロジェクト設定の変更、C#とGDScriptファイルの読み書き、C#プロジェクトのビルド、エディタ内でのC#スニペットの実行、モデルが確認できるスクリーンショットの取得が可能です。このwikiでは、インストール方法、AIクライアントへの接続方法、日々の使い方を説明します。

## Godot MCPとは

Godot MCPはC#製のエディタアドオン（フォルダー `addons/godot_mcp/`、Project Settingsでは**Godot-MCP**として表示）で、Godot 4の.NETプロジェクト内で動作します。エディタがこれを読み込むと、アドオンは**AI Game Developer**というドックを開き、MCPサーバーに接続します。チャットするAIエージェントは同じサーバーに接続し、Model Context Protocol（MCP）を通じてアドオンのツールを呼び出します。

このアドオンはオープンソース（Apache-2.0）で、[Godot-MCP リポジトリ](https://github.com/IvanMurzak/Godot-MCP)で公開されています。MCPライブラリとリフレクションライブラリをUnity MCPやUnreal MCPと共有しているため、3つのエンジンプラグインは同じように動作し、同じクラウドアカウントを使用します。

## 各要素の関係

| 要素 | 役割 |
| --- | --- |
| Godot MCPアドオン | Godotエディタ内で動作し、AIツールを公開してMCPサーバーに接続します。 |
| MCPサーバー | [ai-game.dev](https://ai-game.dev)のクラウドサーバー（デフォルト）、または自分のマシンで実行する独自サーバー。 |
| AIクライアント | Claude Code、Cursor、VS Code Copilot、Codex、Gemini、その他のMCPクライアント。同じサーバーに接続します。 |
| `godot-cli` | アドオンのインストール、サインイン、AIクライアント設定の書き込み、エディタの起動を行うnpmコマンドラインツール。 |
| AI Game Devアプリ | ターミナルなしでアドオンのインストールとエディタの起動を行えるデスクトップアプリ。 |

デフォルトのクラウドモードでは、GodotとAIクライアント以外はマシン上で動作しません。エディタとエージェントの両方がホストされたエンドポイントに接続し、ai-game.devアカウントで一度サインインするだけです。カスタムモードでは、アドオンがローカルMCPサーバーをダウンロードして起動できるため、すべてが自分のコンピューター内で完結します。

## 必要なもの（概要）

- **Godot 4.3以降の.NET（mono）ビルド**。標準のGDScript専用ビルドではこのアドオンをコンパイルできません。
- **.NET 8 SDK**。
- C#の`.csproj`を持つGodotプロジェクト。ゲームコード自体はGDScriptのままでも構いません。アドオンが自身をコンパイルするためにC#プロジェクトが必要なだけです。
- MCPに対応したAIクライアント。

`.csproj`に必要なNuGetパッケージを含む完全なリストは[インストール](https://ai-game.dev/ja/docs/wiki/godot/installation)にあります。

## クイックスタート

ターミナルに慣れているなら、以下のコマンドでGodotのC#プロジェクトをゼロから接続済みのAIエージェントまで持っていけます。

```bash
npm install -g godot-cli
godot-cli install-plugin ./MyGodotProject
godot-cli login
godot-cli setup-mcp claude-code ./MyGodotProject
godot-cli open ./MyGodotProject
```

次に、エージェントに「Camera3DとMeshInstance3Dのキューブを備えたNode3Dシーンを追加し、Main.tscnとして保存して」のように依頼します。[はじめに](https://ai-game.dev/ja/docs/wiki/godot/getting-started)ページでは同じ手順を解説付きで説明しており、サイトの[クイックスタート](https://ai-game.dev/ja/docs/quickstart)では3つのエンジンすべてを扱っています。

## このwikiのページ

- [インストール](https://ai-game.dev/ja/docs/wiki/godot/installation)：すべてのインストール方法（デスクトップアプリ、`godot-cli`、Asset Library、リリースzip）と必要なNuGetパッケージの正確な内容。
- [はじめに](https://ai-game.dev/ja/docs/wiki/godot/getting-started)：最初の接続、最初のプロンプト、すべてが正常に動作しているかの確認方法。
- [AIクライアントの接続](https://ai-game.dev/ja/docs/wiki/godot/connecting-ai-clients)：クラウドエンドポイントと独自サーバーの違い、デバイスサインイン、プロジェクトキー、各エージェント向けの`setup-mcp`。
- [設定](https://ai-game.dev/ja/docs/wiki/godot/configuration)：AI Game Developerドック、保存される設定、`GODOT_MCP_*`環境変数。
- [ツール](https://ai-game.dev/ja/docs/wiki/godot/tools)：組み込みのツールファミリー、RQL、各ツールの用途。
- [カスタムツール](https://ai-game.dev/ja/docs/wiki/godot/custom-tools)：C#で独自のMCPツールを作成し、実行中のゲームからツールを公開する方法。
- [拡張機能](https://ai-game.dev/ja/docs/wiki/godot/extensions)：アニメーション、CSG、ナビゲーション、タイルマップ、および人気のGodotアドオン向けの任意パッケージ。
- [godot-cliリファレンス](https://ai-game.dev/ja/docs/wiki/godot/cli)：すべての`godot-cli`コマンドとそのフラグ。
- [トラブルシューティング](https://ai-game.dev/ja/docs/wiki/godot/troubleshooting)：アドオンが読み込まれない、エージェントにツールが見えない、リロードの問題。
- [FAQ](https://ai-game.dev/ja/docs/wiki/godot/faq)：よくある質問への簡潔な回答。

## サイトのその他の情報

- [Godot MCPのインストール](https://ai-game.dev/ja/engines/godot)：Godotのインストールページ。
- [Godotツールカタログ](https://ai-game.dev/docs/tools/godot)と[Godot拡張機能](https://ai-game.dev/docs/extensions/godot)。
- [Godot のベストプラクティス](https://ai-game.dev/docs/best-practices/godot): うまく機能するプロンプトの書き方。
- [MCP endpoint](https://ai-game.dev/ja/mcp-endpoint-info)と[認証](https://ai-game.dev/docs/auth): ホストされているエンドポイントとサインインの仕組み。
- [AI Game Dev アプリの wiki](https://ai-game.dev/ja/docs/wiki/app)、そして[Unity MCP](https://ai-game.dev/ja/docs/wiki/unity)と[Unreal MCP](https://ai-game.dev/ja/docs/wiki/unreal)の wiki。

- [**インストール** AI Game Devアプリ、godot-cli、Godot Asset Library、リリースzipでGodot MCPアドオンをインストールする方法と、.csprojに必要なNuGetパッケージを解説します。](https://ai-game.dev/ja/docs/wiki/godot/installation)
- [**はじめに** Godot MCP をクラウドに接続し、Claude Code などの AI エージェントを設定して、接続を確認し、Godot エディタで最初の AI プロンプトを実行します。](https://ai-game.dev/ja/docs/wiki/godot/getting-started)
- [**AIクライアントの接続** Claude Code、Cursor、Copilot、Codex、Gemini などの MCP クライアントを、ai-game.dev のクラウドエンドポイントまたはローカルサーバー経由で Godot MCP に接続します。](https://ai-game.dev/ja/docs/wiki/godot/connecting-ai-clients)
- [**設定** AI Game Developer ドックで Godot MCP を設定し、AI エージェントが参照するツールを選択し、GODOT\_MCP\_\* 環境変数で設定を上書きする方法を説明します。](https://ai-game.dev/ja/docs/wiki/godot/configuration)
- [**ツール** GodotエディタでAIエージェントが使用するGodot MCPツール。ノード、シーン、リソース、C#/GDScriptスクリプト、スクリーンショット、ゲーム内ツール向けのRQLクエリを扱います。](https://ai-game.dev/ja/docs/wiki/godot/tools)
- [**カスタムツール** 独自のGodot MCPツールをC#で書き、メインスレッドでGodot APIを呼び出し、実行中のGodotゲームからツール、プロンプト、リソースを公開できます。](https://ai-game.dev/ja/docs/wiki/godot/custom-tools)
- [**拡張機能** AnimationPlayer、CSG、GridMap、ナビゲーション、パーティクル、TileMapLayer、Beehave、Dialogic、Phantom Camera、Terrain3D 向けのオプションの Godot MCP 拡張機能をインストールできます。](https://ai-game.dev/ja/docs/wiki/godot/extensions)
- [**godot-cli リファレンス** Godot MCP 向け godot-cli の全コマンドとフラグを解説します。install-plugin、login、setup-mcp から open、exec、run-tool、configure、install-extension まで。](https://ai-game.dev/ja/docs/wiki/godot/cli)
- [**トラブルシューティング** アドオンが読み込まれない／コンパイルできない問題から、Extensions リストが空、ツールが見つからない、リロードエラー、.NET 10 のクラッシュまで、よくある Godot MCP の問題を解決します。](https://ai-game.dev/ja/docs/wiki/godot/troubleshooting)
- [**FAQ** Godot MCP（Godotエディタ向けAIアシスタント）に関する短い回答集です。Godotのバージョン、GDScriptプロジェクト、オフライン利用、コスト、セキュリティ、エクスポートしたゲームについて説明します。](https://ai-game.dev/ja/docs/wiki/godot/faq)

---

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

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