Cocos MCP Verbindungsprobleme: Cursor zeigt cocos-creator nicht an

Zuerst: Welche Ebene ist fehlgeschlagen?

Wenn es sich anfühlt wie „Cursor kaputt / verbindet nicht“, starten Sie bei Cursor-Symptomen: Cursor kaputt nach Cocos Creator MCP.

Wenn noch unklar ist, was MCP kann und wie es sich von „Cocos Creator AI“ unterscheidet, zuerst Was ist Cocos Creator MCP lesen.

Der MCP-Pfad hat vier Ebenen. Ein Fehler auf einer Ebene sieht aus wie “keine Verbindung”:

1. Erweiterung installiert und aktiviert
        ↓
2. Panel aktiviert (Konto / Lizenzcode)
        ↓
3. MCP-Server zeigt Running (localhost)
        ↓
4. AI-IDE-Konfiguration geschrieben und MCP-Liste zeigt verbunden

Was Sie sehen	Zuerst prüfen
Kein Menü Erweiterung → Cocos MCP Server / MCP Server	Ebene 1: Paketversion, Importpfad, Neustart
Panel öffnet, kann aber nicht starten / bleibt unaktiviert	Ebene 2: Konto und Lizenz
Start geklickt, aber nie Running	Ebene 3: Port, Firewall, Aktivierung
Creator zeigt Running, Cursor hat kein cocos-creator	Ebene 4: Quick Config, MCP-Neuladen, Konfigurationsdatei
Cursor zeigt verbunden, kann aber keine Szenenknoten auflisten	Verifizierungs-Prompt, Tool-Schalter, korrektes Projekt geöffnet

Symptom A: Keine MCP-Erweiterung im Menü

Mögliche Ursachen

1. Gemischte 2.x / 3.x-Pakete
2. 3.x: Nicht im Erweiterungsmanager importiert oder noch deaktiviert
3. 2.x: Nicht unter packages/<Plugin-Name>/ oder eine zusätzliche Entpackungsebene
4. 2.x: Dateien platziert, aber Creator nicht vollständig neu gestartet

Behebungen

Creator 3.x:

1. Download von Cocos MCP 3.x – nicht das 2.x-Paket
2. Projekt öffnen → Erweiterung → Erweiterungsmanager → Import → die 3.x-ZIP-Datei auswählen
3. Bestätigen, dass cocos-mcp-server aktiviert ist; aktivieren, falls deaktiviert
4. Wenn das Menü immer noch fehlt: Creator beenden und dasselbe Projekt erneut öffnen

Creator 2.x:

1. Download von Cocos MCP 2.x
2. Nach dem Entpacken sollte die Struktur so aussehen:

projekt-root/
  packages/
    <Plugin-Name>/          ← Plugin-Dateien direkt hier
      package.json          ← sollte an diesem Pfad existieren (Name je nach Paket)

3. Falsche Verschachtelung Beispiel:

packages/
  xxx-mcp-unzip/
    <Plugin-Name>/
      package.json

4. Pfad korrigieren, dann beenden und neu starten (nicht nur Szene aktualisieren). Prüfen Sie Erweiterung → MCP Server.

Symptom B: Panel öffnet, aber Aktivierung schlägt fehl oder Dienst startet nicht

Mögliche Ursachen

• Konto hat keine passende Pro-Berechtigung
• Lizenzcode abgelaufen oder E-Mail stimmt nicht überein
• Start vor der Aktivierung geklickt

Behebungen

1. MCP-Panel öffnen (3.x: Erweiterung → Cocos MCP Server → Open Mcp Panel; 2.x: Erweiterung → MCP Server)
2. Aktivieren mit entweder:
   • VberAI-Konto + Passwort
   • E-Mail + Lizenzcode
3. Plan / Code im offiziellen Kontozentrum bestätigen, dann im Panel erneut versuchen
4. Nur nach der Aktivierung die MCP-Server-Einstellungen öffnen und Start klicken

Ohne Aktivierung erreicht der Server normalerweise nie Running. Beheben Sie zuerst die Editor-Seite, bevor Sie Cursor die Schuld geben.

Symptom C: Start geklickt, aber nie Running

Mögliche Ursachen

1. Noch nicht aktiviert (siehe Symptom B)
2. Port wird verwendet (3.x standardmäßig oft 3000; 2.x folgt dem Panel)
3. Firewall / Sicherheitssoftware blockiert localhost-Listening

Behebungen

1. Port auf der MCP-Server-Einstellungsseite notieren (Beispiele unten verwenden 3000 – durch Ihren Panel-Wert ersetzen)
2. Prüfen, ob etwas bereits lauscht:

macOS / Linux:

lsof -iTCP:3000 -sTCP:LISTEN

Windows (PowerShell):

netstat -ano | findstr :3000

3. Wenn ein anderer Prozess den Port belegt:
   • diesen Prozess stoppen, oder
   • im MCP-Panel einen freien Port wählen, dann Start erneut
4. Firewall erlaubt 127.0.0.1 (MCP nicht für das öffentliche Internet freigeben)
5. Wenn das Panel Running zeigt, die AI-IDE konfigurieren

Symptom D: Creator läuft, Cursor hat kein cocos-creator

Die meisten “Verbindung fehlgeschlagen”-Meldungen landen hier: Editor OK, Client hat die Konfiguration nie übernommen.

Behebungen (in Reihenfolge)

1. In Creator prüfen, ob das MCP-Panel noch Running ist (Portänderungen oder Editor-Neustarts können es stoppen)
2. Tool-Manager öffnen und die benötigten Tools aktivieren
3. Quick Config öffnen → Cursor wählen → Auto Config, bis die UI Configured zeigt
4. In Cursor → MCP / Tools-Liste:
   • Sie sollten cocos-creator sehen (oder den Namen, der im Panel angezeigt wird)
   • Wenn fehlt: MCP neu laden (oder Cursor neu starten) und erneut prüfen
5. Immer noch fehlt: Cursors MCP-Konfiguration prüfen, ob sie die lokale Brücke enthält (127.0.0.1 + der Panel-Port)

Die Auto-Config-Ausgabe variiert je nach Cursor-Version. Bei manueller Prüfung:

• Dienstname entspricht Cocos MCP (z. B. cocos-creator)
• Host ist 127.0.0.1 oder localhost, Port entspricht Creator
• Nicht versehentlich eine LAN- oder öffentliche IP

Nach jeder Konfigurationsänderung MCP erneut laden, sonst behält die UI den alten Zustand.

Andere AI-IDEs

In Quick Config Claude Code, Codex, Windsurf, Cline usw. wählen, dann Auto Config → MCP in diesem Client neu laden. Die Konfiguration von Cursor verbindet nicht jede IDE.

Symptom E: Zeigt verbunden, kann aber Szenen nicht auflisten / Knoten bearbeiten

Mögliche Ursachen

1. Das in Creator geöffnete Projekt / Szene entspricht nicht dem, worüber Sie fragen
2. Benötigte Tools im Tool-Manager nicht aktiviert
3. Sie haben nur “Dateien auf der Festplatte” verifiziert, nicht den Editor-Kontext

Verifizierung

Senden Sie einen schreibgeschützten Prompt in Cursor:

Liste die Namen der Root-Knoten der aktuell in Cocos Creator geöffneten Szene auf.

Ergebnis	Bedeutung
Entspricht der Hierarchie	Brücke OK; als nächstes einen kleinen Schreibversuch wagen
Klarer Fehler / keine Tools	Zurück zu Symptomen C/D
Erfundene Knotennamen	MCP wahrscheinlich nicht verwendet; Verbindung und Tool-Schalter prüfen

Dann einen kleinen Schreibversuch wagen (temporären Knoten erstellen und löschen). Vor größeren Änderungen committen.

2.x vs 3.x Schnellübersicht

Element	Creator 3.x	Creator 2.x
Produktseite	cocos (3.x)	cocos2x
Installation	Erweiterungsmanager → Import	In Projekt packages/ entpacken
Nach Installation	In der Liste aktivieren	Muss Creator neu starten
Paket	Nur 3.x	Nur 2.x
Vollständige Schritte	3.x-Installation	2.x-Installation

Gemischte Pakete zeigen oft “kein Menü” oder “Import fehlgeschlagen” – zuerst diese Tabelle verwenden.

Empfohlene Reihenfolge (5-Minuten-Checkliste)

In Reihenfolge abhaken; die meisten Fehler liegen in den ersten vier:

1. Creator-Hauptversion passt zum MCP-ZIP (2.x ↔ 2.x, 3.x ↔ 3.x)
2. Erweiterung aktiviert / packages-Pfad korrekt; 2.x neu gestartet
3. Panel erfolgreich aktiviert
4. Panel zeigt Running; Port frei
5. Quick Config → Auto Config für die aktuelle IDE
6. MCP in der AI-IDE neu geladen; cocos-creator aufgelistet
7. Schreibgeschützter Prompt listet Roots der aktuell geöffneten Szene

Wenn es immer noch fehlschlägt, erfassen Sie dies

Wenn Sie Support oder einen Kollegen um Hilfe bitten, fügen Sie bei:

• Genaue Creator-Version (z. B. 3.8.x / 2.4.x)
• MCP-Pakettyp (2.x oder 3.x Pro)
• Ob das Panel Running ist, und den Port
• AI-IDE-Name/-Version und Screenshot der MCP-Liste
• Genaue schreibgeschützte Anfrage und Antwort

Halten Sie die Brücke nur auf localhost; veröffentlichen Sie den MCP-Port nicht.

Verwandte Dokumentation

• Cocos Creator 3.x MCP-Installation
• Cocos Creator 2.x MCP-Installation
• Cocos Creator MCP Video-Setup
• Engine-Auswahl-Leitfaden: Godot MCP vs Unity MCP vs Cocos MCP