Cocos Creator 3.x MCP Installationsanleitung: Erweiterung importieren und eine KI-IDE verbinden

Was diese Anleitung abdeckt

Befolgen Sie diese fünf Schritte, um Cocos Creator 3.x MCP (VberAI Pro) mit einem lokalen Creator-Projekt zu verbinden, damit Cursor (oder eine andere MCP-fähige KI-IDE – gleiche Idee) den Editor bedienen, in der Vorschau anzeigen und debuggen kann – nicht nur Skripte auf der Festplatte bearbeiten.

Wenn Sie fertig sind, sollten Sie in der Lage sein:

• cocos-mcp-server über den Erweiterungsmanager zu importieren und zu aktivieren
• Mit einem VberAI-Konto oder E-Mail + Aktivierungscode zu aktivieren
• Den lokalen Cocos MCP Server zu starten (Standardport 3000)
• Schnellkonfiguration → Automatische Konfiguration zu verwenden, um den Server in Cursor zu registrieren und die Verbindung zu bestätigen

Produktseite: VberAI Cocos MCP 3.x

Dieser Artikel verwendet Cursor als Beispiel. Claude Code, Windsurf, Cline und andere MCP-Clients folgen einem ähnlichen Ablauf.

Voraussetzungen

Element	Hinweise
Cocos Creator	3.0+ (beliebiges 3.x-Projekt)
Plugin-Paket	Cocos Creator 3.x MCP Pro-Archiv von der offiziellen Website
Aktivierung	VberAI-Konto + Passwort oder E-Mail + Aktivierungscode
KI-IDE	Cursor empfohlen; andere MCP-Clients funktionieren ebenfalls
Lokales Netzwerk	Die MCP-Brücke läuft normalerweise auf 127.0.0.1 – Port nicht öffentlich freigeben

Schritt 1: Cocos Creator 3.x MCP herunterladen

Laden Sie den Pro-Build von der VberAI-Website herunter:

Download-Seite: https://www.vberai.com/game-engines/cocos?ch=CQZLC2FG

Empfohlener Ablauf:

1. Öffnen Sie die Seite und laden Sie Cocos MCP 3.x Pro mit Ihren Kontoberechtigungen herunter
2. Speichern Sie das Archiv lokal – Sie müssen es noch nicht in das Projekt entpacken (der nächste Schritt importiert das Archiv)
3. Bestätigen Sie, dass das Projekt Creator 3.0 oder neuer ist; nicht mit dem 2.x-Paket mischen

OSS- vs. Pro-Unterschiede und Abrechnung folgen dem aktuellen Website-Text.

Schritt 2: Erweiterung importieren

1. Öffnen Sie Ihr Cocos Creator 3.x-Projekt
2. Menü: Erweiterung → Erweiterungsmanager → Erweiterung importieren
3. Wählen Sie das Cocos Creator 3.x MCP-Archiv, das Sie gerade heruntergeladen haben
4. Nach erfolgreichem Import sollte die Erweiterungsliste cocos-mcp-server aktiviert anzeigen

Falls es deaktiviert erscheint, aktivieren Sie es, bevor Sie fortfahren.

Schritt 3: cocos-mcp-server aktivieren

1. Menü: Erweiterung → Cocos MCP Server → Mcp-Panel öffnen
2. Verwenden Sie auf dem Aktivierungsbildschirm entweder:
   • VberAI-Konto + Passwort
   • E-Mail + Aktivierungscode
3. Nach erfolgreicher Aktivierung öffnen Sie die MCP-Server-Einstellungsseite (nächster Schritt)

Ohne Aktivierung startet der Server normalerweise nicht. Bestätigen Sie, dass Ihr Plan oder Code zum aktuellen Pro-Build passt.

Schritt 4: cocos-mcp-server starten

1. Nach der Aktivierung öffnen Sie MCP-Server-Einstellungen
2. Passen Sie nach Bedarf an:
   • Port: Standard 3000
   • Sprache: passend zu Ihrer UI-Präferenz
   • Startup: Verwenden Sie Panel-Optionen (z. B. Autostart mit dem Editor, falls verfügbar)
3. Klicken Sie auf Dienst starten
4. Wenn das Panel Läuft anzeigt, ist Cocos MCP Server aktiv

Sie haben jetzt eine lokale MCP-Brücke. Als Nächstes übergeben Sie sie Ihrer KI-IDE.

Schritt 5: KI-IDE mit einem Klick einrichten (Cursor-Beispiel)

1. Öffnen Sie Tool-Manager
   • Überprüfen Sie die von Cocos MCP Server bereitgestellten Tools
   • Aktivieren Sie nur das, was die KI verwenden soll
2. Öffnen Sie Schnellkonfiguration
   • Wählen Sie Ihre IDE (z. B. Cursor)
   • Klicken Sie auf Automatische Konfiguration
   • Bestätigen Sie, dass die UI einen konfigurierten Zustand anzeigt
3. Öffnen Sie Cursor
   • In der MCP-/Tool-Liste sollten Sie cocos-creator (oder den im Panel angezeigten Namen) verbunden sehen
   • Falls es fehlt, klicken Sie in Cursor auf Neu laden (oder das entsprechende MCP-Reload) und prüfen Sie erneut

Andere IDEs folgen demselben Pfad – wählen Sie einfach einen anderen Client unter Schnellkonfiguration.

Schnelle Überprüfung nach dem Verbinden

Beginnen Sie in Cursor mit einer schreibgeschützten Prüfung, zum Beispiel:

Listen Sie die Root-Knoten der aktuell in Cocos Creator geöffneten Szene auf.

Wenn die Antwort mit der Editor-Hierarchie übereinstimmt, funktioniert die Brücke. Versuchen Sie dann eine kleine Schreiboperation (temporären Knoten erstellen und löschen), um Berechtigungen und Tool-Auswahl zu bestätigen.

FAQ

Import fehlgeschlagen oder cocos-mcp-server fehlt in der Liste?
Verwenden Sie das offizielle 3.x-Archiv (nicht 2.x). Creator muss 3.0+ sein. Falls es deaktiviert bleibt, aktivieren Sie es im Erweiterungsmanager und starten Sie Creator neu.

Aktivierung schlägt ständig fehl?
Bestätigen Sie Pro-Berechtigungen oder dass der Aktivierungscode gültig und mit der richtigen E-Mail verknüpft ist. Überprüfen Sie das Kontozentrum auf der Website und versuchen Sie es dann im Panel erneut.

Ich habe Dienst starten geklickt, sehe aber nie Läuft?
Bestätigen Sie, dass Port 3000 (oder Ihr benutzerdefinierter Port) frei ist und localhost nicht blockiert wird. Stellen Sie sicher, dass Schritt 3 erfolgreich abgeschlossen wurde.

Cursor zeigt cocos-creator nicht an?
Bestätigen Sie in Creator, dass der Server noch Läuft, führen Sie Schnellkonfiguration → Automatische Konfiguration erneut aus und laden Sie dann MCP in Cursor neu. Wenn es weiterhin fehlschlägt, überprüfen Sie, ob die MCP-Konfiguration von Cursor die lokale Brückenadresse enthält.

Nächste Schritte

• Verwenden Sie natürliche Sprache für eine Szenenabfrage oder eine kleine Bearbeitung, um die Tool-Grenzen kennenzulernen
• Committen Sie vor größeren Änderungen; halten Sie die Brücke nur auf localhost
• Für Design-to-Engine-UI kombinieren Sie mit VberAI Studio und iterieren Sie dann im Editor mit MCP

Für Fähigkeitsgrenzen und den Unterschied zum vagen „Cocos Creator AI“ siehe Was ist Cocos Creator MCP. Für Creator 2.x folgen Sie der Cocos Creator 2.x MCP-Installationsanleitung – mischen Sie keine Pakete. Für mehr MCP-Kontext siehe den Cocos Creator MCP-Videoleitfaden.