CursorがCocos Creator MCP接続後に壊れた？症状から切り分ける

Cocos MCP を入れ、Cursor で一度設定したあと、多くの人が「Cursor が壊れた」と感じます。会話でシーンに届かない、MCP パネルが赤一色、昨日は動いて今日は消えた、などです。多くの場合 Cursor 本体は壊れておらず、MCP の橋が通っていません。Creator 側のサービスが動いていないか、Cursor 側の設定やリロードが効いていないかのどちらかです。

本稿は Cursor で見える症状 から始め、次にどの層を見るかを決めます。Creator の拡張取り込み、有効化コード、ポート競合などの長い手順は汎用排障へ：Cocos MCP 接続トラブルシュート。MCP そのものがまだ曖昧なら：Cocos Creator MCPとは。

まず：壊れているのは Cursor か、橋か

感じ方	よりありそうな原因
Cursor は普通のコードは書けるが、Cocos のシーン/ノードに届かない	MCP 未接続、またはツール未有効
MCP 一覧に cocos-creator（またはクイック設定の名前）がない	設定未書き込み、または Reload が必要
サービス名はあるがエラー / 切断	Creator が Running でない、URL/ポート不一致、または再読み込みが必要
接続済みと出るが、開いているシーンのノードを列挙できない	工程違い、ツール未チェック、または読み取り確認の仕方が違う

Claude Code、Codex など MCP クライアントも同じです。先にクライアント側のサービスが健全か確認し、そのあと Creator を見ます。

手順1：Cursor内のMCPだけを見る

Cursor の MCP / ツール設定を開き（メニュー名は版で違うことがあります）、次を確認します。

1. 一覧に cocos-creator があるか（Creator のクイック設定が書いた名前でも可）
2. 状態が接続済み / 利用可能か。エラー、切断、空白のままではないか
3. 設定を変えた直後、または Creator で自動設定をした直後なら、Reload Window（または同等の MCP 再読み込み）を一度行い、一覧を見直す

よくあるのは、Creator 側はすでに Running なのに、Cursor が古い設定を握ったまま——リロードしないと「急に壊れた」ように見えます。

手順2：URLが本機のCreatorを指しているか

Cursor 側の MCP 項目は 本機 の橋へ向ける必要があります。多くは次の形です。

• http://127.0.0.1:3000/mcp
• または http://localhost:3000/mcp

ポートは Creator の MCP パネル表示に合わせます（既定は 3000 が多い。変えていればパネルに合わせる）。

あわせて Cocos Creator を開き、同じ工程で MCP パネルが Running か確認します。パネルが動いていなければ、Cursor でいくら Reload してもツールは出ません。

製品ページ（メジャー版に合う包を選び、混用しない）：

• Cocos MCP 3.x
• Cocos MCP 2.x

手順3：まだダメなら四層で飛ぶ

MCP の経路は四層です。どれが落ちても、Cursor では「壊れた / 繋がらない」に見えます。

1. プラグインが工程に入り有効
        ↓
2. パネルが有効化済み（アカウント / コード）
        ↓
3. MCP Server が Running（本機 localhost）
        ↓
4. Cursor に設定が書かれ、MCP 一覧が接続済み

Cursor で見えること	先に見る場所
サービス項目がまったくない	第 4 層：Creator でクイック設定 → 自動設定、その後 Reload。詳細は汎用排障
項目はあるがエラー / 繋がらない	第 3 層：Creator が Running か、ポート一致か、localhost が遮断されていないか
Creator のメニューに MCP 自体がない	第 1 層：2.x/3.x 包の混用、取り込みパス、再起動（汎用排障の症状 A）
パネルが起動できない / 未有効化	第 2 層：アカウントと有効化（汎用排障）
接続済みなのにノードが出ない	正しい工程が開いているか確認；下の読み取りスモーク；それでもダメならツールのチェック

インストール全文：

• Cocos Creator 3.x MCP インストール
• Cocos Creator 2.x MCP インストール

手順4：スモーク確認（直ったかの判定）

Cursor ではまず読み取りだけの確認から始めます。例：

いま Cocos Creator で開いているシーンのルートノードを列挙して。

返答が編集器の階層と一致すれば、橋は通っています。必要なら一度だけ可逆な書き込み（一時ノードを作って消す）をします。大きな変更の前に commit。橋は本機 localhost のみにし、MCP ポートを公網に出さないでください。

よくある質問

「Cocos Creator MCP後にCursorが壊れた」とは、通常どのような意味ですか？
典型的な兆候：MCPサービスのエントリがない、赤/エラー状態、または接続されているのにツール/ノードがない。ほとんどの場合、Cursorのクラッシュではなく、4層ブリッジの1つの層が欠けていることを意味します。

CursorとCreatorのどちらを先に確認すべきですか？
まずCursorのMCPリスト（欠落か赤か）を確認します。次にCreatorを検証：プラグインがインポート/有効化されているか、パネルがアクティブか、サーバーがRunning状態か、ポートが設定と一致しているか。この記事の症状テーブルを使用してください。

接続されているのにノードがない場合、次はどうすればよいですか？
正しいプロジェクト/シーンが開いていることを確認し、読み取り専用のスモークテスト（ルートノードの一覧表示）を実行します。それでも失敗する場合は、ツールのトグルと権限を確認してください。完全な手順は：接続トラブルシューティング。

Cursorを再インストールする必要がありますか？
通常は不要です。Creatorの「クイック設定→自動設定」を優先し、MCPをリロードして、localhostポートを検証してください。カテゴリの境界：Cocos Creator MCPとは。