Cursor nach Cocos Creator MCP defekt: Verbindung nach Symptom beheben

Nachdem Sie Cocos MCP installiert und einmal in Cursor konfiguriert haben, haben viele das Gefühl, Cursor ist defekt: Der Chat kann die Szene nicht berühren, das MCP-Bedienfeld ist komplett rot, oder es funktionierte gestern und ist heute verschwunden. In den meisten Fällen ist Cursor selbst in Ordnung – die MCP-Brücke ist down. Entweder läuft der Server auf der Creator-Seite nicht, oder die Konfiguration/das Neuladen in Cursor wurde nicht wirksam.

Dieser Leitfaden beginnt mit Symptomen, die Sie in Cursor sehen können, damit Sie wissen, welche Ebene Sie als Nächstes prüfen sollten. Ausführliche Creator-Schritte (Erweiterungsimport, Aktivierungscodes, Portkonflikte) finden Sie im allgemeinen Leitfaden: Cocos MCP Verbindungsprobleme beheben. Wenn Sie noch die Produktabgrenzung benötigen, siehe Was ist Cocos Creator MCP.

Zuerst: Ist Cursor defekt oder die Brücke?

Was Sie fühlen	Wahrscheinlichere Ursache
Cursor schreibt weiterhin normalen Code, kann aber Cocos-Szenen/Knoten nicht erreichen	MCP nicht verbunden oder Tools nicht aktiviert
MCP-Liste hat kein cocos-creator (oder den Namen aus Quick configure)	Konfiguration nicht geschrieben oder Reload erforderlich
Dienstname vorhanden, aber Fehler/getrennt	Creator läuft nicht, falsche URL/Port oder Reload erforderlich
Zeigt verbunden, kann aber Knoten der geöffneten Szene nicht auflisten	Falsches Projekt, Tools nicht aktiviert oder schlechte Read-Only-Prüfung

Claude Code, Codex und ähnliche MCP-Clients folgen derselben Idee: Bestätigen Sie, dass der Client einen gesunden Diensteintrag hat, dann prüfen Sie Creator.

Schritt 1: Nur auf MCP in Cursor schauen

Öffnen Sie die MCP-/Tools-Einstellungen in Cursor (Menübezeichnungen können je nach Version variieren) und prüfen Sie:

1. Ob cocos-creator erscheint (oder der Name, der von Creators Quick configure geschrieben wurde)
2. Ob der Status verbunden/verwendbar ist – nicht in Fehler, getrennt oder leer hängen bleibt
3. Wenn Sie gerade die Konfiguration geändert oder Auto configure in Creator ausgeführt haben: Führen Sie ein Reload Window (oder entsprechendes MCP-Reload) durch und prüfen Sie die Liste erneut

Ein häufiger Fall: Creator zeigt bereits Running, aber Cursor hält noch eine veraltete Konfiguration – ohne Reload fühlt es sich an, als wäre es „plötzlich defekt“.

Schritt 2: Bestätigen Sie, dass die URL auf lokalen Creator zeigt

Der Cursor-MCP-Eintrag sollte auf eine lokale Brücken-URL zeigen, normalerweise:

• http://127.0.0.1:3000/mcp
• oder http://localhost:3000/mcp

Verwenden Sie den Port, der im MCP-Bedienfeld von Creator angezeigt wird (oft standardmäßig 3000; wenn Sie ihn geändert haben, passen Sie ihn an das Bedienfeld an).

Öffnen Sie außerdem Cocos Creator und bestätigen Sie, dass das MCP-Bedienfeld für dasselbe Projekt Running ist. Wenn das Bedienfeld nicht läuft, wird ein Reload in Cursor die Tools nicht magisch verfügbar machen.

Produktseiten (wählen Sie das Paket für Ihre Hauptversion; nicht mischen):

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

Schritt 3: Wenn es immer noch fehlschlägt, springen Sie nach Ebene

Der MCP-Pfad hat vier Ebenen. Ein Fehler auf jeder Ebene kann wie „Cursor ist defekt / verbindet nicht“ aussehen:

1. Plugin im Projekt und aktiviert
        ↓
2. Bedienfeld aktiviert (Konto / Lizenzcode)
        ↓
3. MCP-Server zeigt Running (localhost)
        ↓
4. Cursor hat Konfiguration geschrieben und MCP-Liste zeigt verbunden

Was Sie in Cursor sehen	Gehen Sie zuerst hierhin
Kein Diensteintrag	Ebene 4: zurück zu Creator → Quick configure → Auto configure, dann Reload; Details im allgemeinen Leitfaden
Eintrag vorhanden, aber Fehler / keine Verbindung	Ebene 3: Läuft Creator, stimmt der Port, ist localhost blockiert
Kein MCP-Menü in Creator	Ebene 1: 2.x/3.x-Paketverwechslung, Importpfad, Neustart (allgemeiner Leitfaden Symptom A)
Bedienfeld kann nicht starten / nicht aktiviert	Ebene 2: Konto und Aktivierung (allgemeiner Leitfaden)
Verbunden, aber Knoten können nicht aufgelistet werden	Bestätigen Sie, dass das richtige Projekt geöffnet ist; führen Sie den Read-Only-Smoke unten durch; dann Tool-Schalter prüfen

Vollständige Installation:

• Cocos Creator 3.x MCP installieren
• Cocos Creator 2.x MCP installieren

Schritt 4: Smoke-Test (Bestätigen Sie, dass es behoben ist)

In Cursor beginnen Sie mit einer Read-Only-Prüfung, zum Beispiel:

Listen Sie die Wurzelknoten der aktuell in Cocos Creator geöffneten Szene auf.

Wenn die Antwort mit der Editor-Hierarchie übereinstimmt, funktioniert die Brücke. Optional führen Sie einen umkehrbaren Schreibvorgang durch (temporären Knoten erstellen und löschen). Committen Sie vor größeren Änderungen; halten Sie die Brücke nur auf localhost – setzen Sie den MCP-Port nicht dem öffentlichen Internet aus.

Häufig gestellte Fragen

Was bedeutet „Cursor broken“ nach Cocos Creator MCP normalerweise?
Typische Anzeichen: kein MCP-Diensteintrag, roter/Fehlerstatus oder verbunden, aber keine Tools/Knoten. Meistens handelt es sich nicht um einen Cursor-Absturz – es fehlt eine Ebene in der vierschichtigen Brücke.

Sollte ich zuerst Cursor oder Creator prüfen?
Beginnen Sie mit der MCP-Liste in Cursor (fehlend vs. rot). Überprüfen Sie dann Creator: Plugin importiert/aktiviert, Panel aktiviert, Server läuft, Port stimmt mit der Konfiguration überein. Nutzen Sie die Symptomtabelle in diesem Artikel.

Verbunden, aber keine Knoten – was nun?
Bestätigen Sie, dass das richtige Projekt/die richtige Szene geöffnet ist; führen Sie einen schreibgeschützten Smoke-Test durch (Root-Knoten auflisten). Falls es weiterhin fehlschlägt, prüfen Sie Tool-Schalter und Berechtigungen. Vollständiger Pfad: Verbindungsprobleme beheben.

Muss ich Cursor neu installieren?
Normalerweise nicht. Bevorzugen Sie „Schnellkonfiguration → Automatische Konfiguration“ in Creator, laden Sie MCP neu und überprüfen Sie den Localhost-Port. Kategorie-Abgrenzung: Was ist Cocos Creator MCP.