Godot MCP vs 手書き：AI にエディタを任せる判断基準

Godot 4 の作業の大半はシーンツリー編集と GDScript です。手書きは正確だが反復が多い。Godot MCP は Cursor や Claude Code から自然言語でエディタを操作できます。論点は「AI を使うか」ではなく、どの変更を MCP に渡すのが得かです。

二つの働き方

	手書き	Godot MCP
進め方	スクリプトとシーンで実装	意図を述べ、MCP 経由でノード／シーン／スクリプトを更新
強み	境界条件・性能・レビュー可能な設計	定型・素早い試遊・横断配線
リスク	遅い CRUD	構造が乱れると保守困難

製品ページ：Godot 4.x、ネイティブ C++ GDExtension、MIT。ツール数／カテゴリは製品ページを正とする（執筆時点で約 62 ツール／23 カテゴリ）。Claude Desktop、Claude Code、Cursor、Windsurf、Cline 等に対応。対象はエディタ文脈であり、単なる補完ではありません。

手順：Godot MCP インストール。

先に守る Godot 慣例

• 自己完結シーン — 深いパス直参照を避け、シグナル／export／公開メソッドで外へ出す（Scene organization）
• 合成優先 — 移動・HP・見た目を分割
• シグナルは応答用 — 過去形命名、深いバブルを避ける。Autoload は真のグローバルのみ（Autoloads vs nodes）
• 構造はシーン、振る舞いはスクリプト

プロンプトに制約を書く（例：「HP と HUD はシグナルで。Autoload を新規作成しない」）。

Godot MCP が効くとき

1. 試作 — 操作感、巡回、仮 HUD
2. 定型 — 体力バインド、簡易インベントリ、セーブ骨格、メニュー足場
3. 一括配線 — スクリプト付与、シグナル接続、リネーム
4. 学習 — 生成結果の diff を読む

res://player/player.tscn の CharacterBody2D にダッシュ（冷却 1s）。HUD へはシグナル。Autoload 禁止。

手書きを選ぶとき

1. ホットパス — 大量パス探索、毎フレーム確保
2. 独自メカ — 一言で説明しにくいルール
3. コア系統 — 戦闘解決、セーブ互換、ネット同期
4. デバッグ — 先に既存コード／シーンを読む

レビューで説明できない生成コードはマージしない。

実務ループ

1. シーン境界とシグナル契約を決める
2. MCP で足場と最小プレイ可能版
3. コアとホットパスを手で固める
4. 周辺は再度 MCP

UI／アートは AI Studio、エンジン内は Godot MCP または手書き。

次の一歩

1. インストール手順
2. 整ったシーンで読み取り確認 → 小さな変更
3. 慣例に合う diff だけ残す

関連：Godot MCP で 2D プラットフォーマー、AI Studio + エンジン MCP エンドツーエンド。