Cocos Creator 2.x MCP Installationsanleitung: Installation über Pakete und Verbindung mit einer KI-IDE

Was diese Anleitung abdeckt

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

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

• Das Plugin in den Projektordner packages zu entpacken
• Creator neu zu starten und dann mit einem VberAI-Konto oder E-Mail + Aktivierungscode zu aktivieren
• Den lokalen Cocos MCP Server zu starten
• Schnellkonfiguration → Automatische Konfiguration zu verwenden, um den Server in Cursor zu registrieren und die Verbindung zu bestätigen

Produktseite: VberAI Cocos MCP 2.x

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

Voraussetzungen

Punkt	Hinweise
Cocos Creator	2.4.x+ / andere 2.x-Projekte (nicht mit dem 3.x-Paket mischen)
Plugin-Paket	Cocos Creator 2.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 2.x MCP herunterladen

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

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

Empfohlener Ablauf:

1. Öffnen Sie die Seite und laden Sie Cocos MCP 2.x Pro mit Ihren Kontoberechtigungen herunter
2. Speichern Sie das Archiv lokal und bereiten Sie die Extraktion vor
3. Bestätigen Sie, dass das Projekt Creator 2.x ist – nicht mit dem 3.x MCP Paket mischen

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

Schritt 2: Plugin installieren (in packages)

Im Gegensatz zu 3.x (Erweiterungsmanager → Erweiterung importieren) erfolgt die Installation bei 2.x durch Ablegen der Dateien im Projekt:

1. Entpacken Sie das Archiv auf Ihrem Rechner
2. Verschieben Sie den entpackten Plugin-Ordner in das packages-Verzeichnis im Stammverzeichnis des Cocos-Creator-Projekts
   • Wenn packages noch nicht existiert, erstellen Sie es zuerst
3. Bestätigen Sie, dass die Struktur packages/<plugin-name>/ ist und nicht eine zusätzliche Entpackungsebene verschachtelt ist

Noch nicht konfigurieren: Starten Sie Creator neu, damit die Erweiterung korrekt geladen wird (nächster Schritt).

Schritt 3: cocos-mcp-server aktivieren

1. Cocos Creator vollständig neu starten und das Projekt öffnen, das das Plugin enthält
2. Menü: Erweiterung → MCP Server
3. Verwenden Sie auf dem Aktivierungsbildschirm entweder:
   • VberAI-Konto + Passwort
   • E-Mail + Aktivierungscode
4. 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. Öffnen Sie nach der Aktivierung die MCP-Server-Einstellungen
2. Passen Sie bei Bedarf an:
   • Port: Verwenden Sie die Panel-Standardeinstellung oder Ihre lokale Konvention
   • Sprache: Passen Sie sie an Ihre UI-Präferenz an
   • 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. Übergeben Sie sie als Nächstes an Ihre KI-IDE.

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

1. Öffnen Sie den 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-/Tools-Liste sollten Sie cocos-creator (oder den im Panel angezeigten Namen) verbunden sehen
   • Wenn 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 der Verbindung

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

Listen Sie die Stammknoten der Szene auf, die gerade in Cocos Creator geöffnet ist.

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

Dateien sind in packages, aber es gibt kein Menü Erweiterung → MCP Server?
Bestätigen Sie, dass Sie Creator vollständig neu gestartet haben (nicht nur ein Szenen-Reload). Überprüfen Sie, ob der Ordner unter packages/<plugin-name>/ liegt, ohne zusätzliche Zip-Verschachtelung. Bestätigen Sie, dass Sie das 2.x-Paket heruntergeladen haben, nicht 3.x.

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 Kontrollzentrum auf der Website und versuchen Sie es dann im Panel erneut.

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

Cursor zeigt cocos-creator nicht?
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-zu-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 3.x folgen Sie der Cocos Creator 3.x MCP Installationsanleitung – mischen Sie keine Pakete. Für mehr MCP-Kontext siehe den Cocos Creator MCP Video-Guide.