Cursor AIをGodotで使う方法（2026年版ステップバイステップガイド）

{/* IMAGE: Hero showing a Godot project open in Cursor on the left with an AI edit mid-stream in a GDScript file, and the Godot editor on the right with the scene tree visible. A dashed line connects them labeled "you wire these two together." 1200x630, illustration. */}

CursorにはGodot専用のボタンはありません。二つをシームレスに統合するプラグインや、自動で連携してくれるマーケットプレイスのエントリも存在しません。実際のところはもっとシンプルで、少しだけ手作業が必要です。CursorはコードエディタであってGodotプロジェクトはファイルの集まりに過ぎないため、そのフォルダをCursorで開き、二つのツールを連携させる設定をするだけです。正しく設定すれば、トップクラスのAIコーディング体験をGDScriptに直接向けることができます。設定を誤ると、CursorはGodot 4のプロジェクトに自信満々でGodot 3のコードを書き込み、存在しないノード名を推測し続けます。

このガイドは実際に機能するセットアップを手順通りに解説し、重要な設定と知っておくべき制限を一つ紹介します。私たちはGodot 4互換のAIネイティブエンジンであるSummer Engineを開発しているため、Cursorが優れている点と限界に達する点について率直にお伝えします。

始める前に：このセットアップが実際に何なのかを理解する

CursorはGodotプロジェクト内のテキストファイルを編集します。Godotプロジェクトはほぼテキストファイルで構成されています。.gdスクリプト、.tscnと.tresのシーンとリソースファイル（人間が読める形式）、project.godotの設定ファイル、シェーダーなどです。Cursorはこれらをすべて適切に読み書きできます。

ただしこのセットアップでCursorはエンジンではありません。ゲームを実行したり、シーンツリーをライブ構造として保持したり、実行時に何が起きているかを観察したりすることはできません。GodotエディタをCursorと並べて開いておく必要があります。Cursorがコードを書き、Godotが実行する。この役割分担が全体のコンセプトであり、一度理解すれば残りは難しくありません。

ステップ1：GodotプロジェクトをCursorで開く

Cursorを起動し、「フォルダを開く」を選択してGodotプロジェクトのルート（project.godotが含まれるフォルダ）を指定します。これでCursorはすべてのスクリプト、シーン、設定ファイルを参照して編集できるようになります。

一つ習慣にしておきたいのは、GodotとCursorを常に並べて開いておくことです。片方にシーンツリーと実行中のゲームを表示するGodot、もう片方にスクリプトを表示するCursorという配置です。「Cursorに書いてもらう」と「Godotで実行して確認する」の繰り返しが作業の基本になります。

ステップ2：GDScript用にgodot-tools拡張機能をインストールする

ほとんどの人が飛ばすステップですが、Cursorが意味のないコードを書かないようにするための重要なステップです。

CursorはVS Codeの拡張機能エコシステムをベースにしているため、公式のgodot-tools拡張機能がそのまま使えます。拡張機能パネルを開き、「godot-tools」を検索してインストールしてください。これによりCursorがGodotの内蔵言語サーバーに接続され、正確なGDScript補完、ホバードキュメント、定義へのジャンプが使えるようになります。特に重要なのは、AIが推測したものではなく実際に使っているGodotバージョンに合った構文が得られることです。

この接続を有効にするには、Godotエディタが言語サーバーを有効にした状態で起動している必要があります（デフォルトで有効、ポート6005）。両方が起動していると、CursorのGDScript補完は汎用的なトレーニングデータではなく実際のエンジンAPIから引き出されます。

C#ユーザーの方は、C#拡張機能とGodot C#ツールをインストールしてください。公開されているC#コードが非常に多いため、モデルはGDScriptと同等かそれ以上にGodot C#を扱えます。言語の品質は高いですが、後述するプロジェクト認識の注意事項は同様に当てはまります。

ステップ3：GodotがスクリプトをCursorで開くように設定する

現在、GodotでスクリプトをダブルクリックするとGodot内蔵のスクリプトエディタが開きます。ワークフローを統一するために、Cursorを外部エディタとして指定します。

Godotで Editor Settings > Text Editor > External を開きます。Use External Editor にチェックを入れ、Exec Path にCursorの実行ファイルのパスを設定します。そして Exec Flags にCursorのgotoコマンド形式 {project} --goto {file}:{line}:{col} を設定します（このフラグはCursorがコマンドラインで行にジャンプするための引数です）。これでGodotのシーンツリーでスクリプトをダブルクリックすると、Cursorの正確な行位置で開かれ、コードを書く作業は常に一つのエディタで完結します。

小さな設定ですが、常に感じる摩擦を取り除けます。この設定がないと、Godotのエディタで半分書いてCursorで半分書くという状況になり、バッファの不整合やマージの問題が生じやすくなります。

ステップ4：Godot MCPサーバーを追加してCursorがシーンを認識できるようにする

ここからセットアップが大きく改善されます。デフォルトではCursorは.tscnファイルをテキストとして読み取り、シリアライズされたデータは見えますがノードツリーとして理解することはできません。そのため「AnimationPlayerを参照するプレイヤーのスクリプト」と頼むと、ノードのパスを推測してしまいます。推測によるパスがどうなるかというと、実際には$Visuals/AnimationPlayerにあるのに$AnimationPlayerと書かれることになります。

Godot MCPサーバーでこの問題を解決できます。MCP（Model Context Protocol）を使うと、実際のシーン構造を読み取る小さなサーバーをCursorから呼び出せるようになり、実在するノード名をコンテキストとして渡せます。

追加するには、~/.cursor/mcp.json（グローバル設定）または.cursor/mcp.json（プロジェクト設定）をCursorで開き、選択したサーバーのインストール手順に従ってサーバーエントリを追加してCursorを再起動します。登録が完了すると、「Playerシーン配下のノードは何ですか」と聞けば実際のプロジェクトの内容を答えてくれます。利用可能なオプションと各サーバーが提供する情報については、Godot MCPサーバーガイドをご覧ください。

このステップを省いてもCursorはスクリプトをうまく編集できますが、ノードパスやシグナルが関わる編集では推測の問題がついてまわります。

ステップ5：最初のAI編集を行う

プロジェクトが開かれ、拡張機能がインストールされ、理想的にはMCPサーバーも接続されたら準備完了です。最もよく使う二つの操作は次の通りです。

• インライン編集（Cmd/Ctrl+K）： GDScriptのブロックを選択してショートカットを押し、変更内容を入力します。「これをステートマシンに変換して」「この攻撃にクールダウンを追加して」といった用途に適しています。
• Composer / チャット： チャットで機能を説明し、Cursorに複数ファイルにわたる編集を計画・適用させます。「コイン取得システムとHUDカウンターを追加して」といった用途に適しています。

現実的な最初のプロンプトとして、プレイヤースクリプトを開いて移動コードを選択し、Cmd+Kを押して「プレイヤーが床に触れたときにリセットされるダブルジャンプを追加して。Godot 4の構文で」と入力してみましょう。CursorはDiffを提案します。承認する前に必ず確認してください。ここでGodot 3の問題が現れやすいからです。

Godot 3の落とし穴（そしてその対処法）

AIとGodotの組み合わせでよく聞かれる不満は、AIがGodot 3のコードを書いてしまうことです。移動処理を頼むとKinematicBody2Dと古いシグネチャのmove_and_slide(velocity)が返ってきたり、awaitが必要なところにyieldが書かれたりします。公開されているトレーニングデータはGodot 3に大きく偏っているため、指示がなければモデルはGodot 3に引き寄せられます。

対策を効果順に三つ紹介します。

1. godot-tools拡張機能（ステップ2）は言語サーバーを通じて多くの問題を修正します。あなたが実際に使うAPIを理解しているからです。
2. プロジェクトルール。 Cursorの設定または.cursor/rulesファイルにルールを追加できます。次のように記述してください：「これはGodot 4.xのプロジェクトです。await、@export、@onready、CharacterBody2D/CharacterBody3D、引数なしのmove_and_slide()でvelocityプロパティを使用し、Callable形式のシグナルconnect構文を使ってください。Godot 3のAPIは絶対に使わないでください。」これで生成されるコードがすべてこのルールに従います。
3. 一つのサンプルファイル。 プロジェクトから正しいと分かっているGodot 4のスクリプトをコンテキストに貼ります。モデルは近くにあるコードのAPIに強く合わせようとするため、良いサンプル一つが長い説明よりも効果的です。

三つすべてを実施するとGodot 3への逆戻りはほぼなくなります。

避けられない制限：Cursorはゲームを実行できない

これが正直な上限であり、Cursorに限らずすべての外部IDEアシスタント（Cursor、Copilot、Claude Code）に当てはまります。

Cursorはファイルを編集します。Godotのライブデバッガ出力を読んだり、ゲームを実行してシーンの動作を観察したりすることはできません。そのためループはこうなります。Cursorがコードを書き、あなたがGodotに切り替えてゲームを実行し、@onreadyのパスが間違っていたためにnull参照エラーが出て、スタックトレースをコピーして貼り付け、Cursorが修正案を提案し、また実行する。あなたが実行時のフィードバックチャンネルになります。開発に慣れた人にとっては小さなコストですが、初心者にとってはランタイムエラーのたびにコンテキストの切り替えが発生し、トレースのどの行が重要かを推測しなければなりません。

Godotではこの問題が他のスタックよりも深刻です。なぜなら多くのGodotのバグは実行時にしか現れないからです。ノード名が変更されたためにnullになっているノード、接続されなかったシグナル、衝突を静かに無効化するフィジックスレイヤーの不一致など。これらはどれもファイルのテキストには現れません。ゲームを実行したときに初めて現れます。

Summer Engineが提供するもの

私たちはGodot 4互換のAIネイティブエンジンであるSummer Engineを開発しており、まさにその上限を解決するために作られています。ファイルを編集するアシスタントがエンジンの外側にいる代わりに、AIエージェントがエンジンの内側で動作します。ライブのシーンツリーを認識し、ゲームを実行し、実行中の診断情報とデバッガエラーを読み取り、あなたが貼り付けたスタックトレースではなく実際のランタイムエラーをもとに自分でGDScriptを修正します。この「書く・実行する・読む」ループこそが、外部エディタが構造的に持てない能力です。エディタはゲームを実行するプログラムではないからです。

正直に二点述べておきます。これをガイドとして維持するためです。

• IDEで作業することを好む経験豊富なGodot開発者で、キーボード主体の編集が好みで、すでにアセットのパイプラインとデバッグのルーティンを持っているなら、上記のセットアップによるCursorは本当に優秀であり、他に何も必要ないかもしれません。理由もなく乗り換えるよりCursorを使い続けてほしいと思います。
• どちらかを選ぶ必要はありません。Summer EngineはMCPサーバーを提供しているため、深いコード編集にはCursorを使いながら、Cursorではできないこと（シーンの実行、アセットの生成、ライブエラーの読み取り）にはSummer Engineを動かす形で組み合わせることができます。Cursorのmcp.jsonでSummerのエンドポイントを指定すれば、最高クラスの編集機能とゲームを実行して自己修正できるエンジンの両方が手に入ります。

各ツールがどこで優れているかの詳細な比較はCursorとGodot vs Summer Engineの比較記事をご覧ください。GodotのベストAIコーディングアシスタントのランキングでは、Copilot、Claude Code、エンジン内蔵オプションを横並びで比較しています。

クイックセットアップチェックリスト

ステップ	行うこと	重要な理由
1. プロジェクトを開く	project.godotがあるフォルダをCursorで開く	すべてのスクリプトとシーンを編集できるようになる
2. godot-tools拡張機能	Cursorでインストールし、Godotも並行して起動する	正確なGodot 4補完が得られ、Godot 3の混入をほぼ防ぐ
3. 外部エディタ	Editor SettingsでGodotからCursorを指定する	コードを一つのエディタで完結させ、バッファの不整合をなくす
4. Godot MCPサーバー	.cursor/mcp.jsonに追加して再起動する	Cursorが実際のシーンツリーを認識し、ノードパスの推測をなくす
5. プロジェクトルール	CursorのSettingsにGodot 4.xのルールを追加する	現在のAPI、await、@export、CharacterBodyを強制する
上限	Cursorはゲームを実行できない	ランタイムのデバッグは自分が担う；エンジンネイティブAIはこれを解消する

まとめ

CursorをGodotで使うのは四つのステップとルール一つです。プロジェクトフォルダを開き、godot-toolsをインストールし、CursorをGodotの外部エディタに設定し、シーン認識のためにGodot MCPサーバーを追加し、Godot 3のコードが生成されないようにGodot 4プロジェクトルールを加える。これだけでCursorはGDScriptに向けた最高クラスのAIコードエディタになります。

難しいのはランタイムです。Cursorはファイルを編集し、ゲームの実行とエラーのフィードバックは自分で行います。AIに自分でそのループを閉じてほしい場合、つまりシーンを実行してライブエラーを読み取り自分のコードを修正してほしい場合、それはAIネイティブエンジンが担うことです。CursorとSummer Engineは競合ではなく、多くの開発者がコーディングにはCursorを、テキストエディタでは届かないエンジン操作にはSummerのMCPを使うという形で両方を活用しています。

エンジンネイティブな方法を試すには、Summer Engineをダウンロード（無料で始められ、アセット生成の月次無料クレジット付き）するか、テンプレートから始めて作りたいものを説明してください。