Pemecahan Masalah Koneksi Cocos MCP: Kursor Tidak Menampilkan cocos-creator

Pertama: lapisan mana yang gagal?

Jika Anda bilang “Cursor rusak / tidak connect”, mulai dari gejala di Cursor: Cursor rusak setelah Cocos Creator MCP.

Jika belum jelas apa yang bisa dilakukan MCP dan bedanya dari “Cocos Creator AI”, baca dulu Apa itu Cocos Creator MCP.

Jalur MCP memiliki empat lapisan. Kegagalan di lapisan mana pun terlihat seperti “tidak dapat terhubung”:

1. Ekstensi terpasang dan diaktifkan
        ↓
2. Panel diaktifkan (akun / kode lisensi)
        ↓
3. MCP Server menampilkan Running (localhost)
        ↓
4. Konfigurasi AI IDE ditulis dan daftar MCP menampilkan terhubung

Yang Anda lihat	Periksa dulu
Tidak ada menu Extension → Cocos MCP Server / MCP Server	Lapisan 1: versi paket, jalur impor, mulai ulang
Panel terbuka tetapi tidak dapat dimulai / tetap tidak diaktifkan	Lapisan 2: akun dan lisensi
Mengklik Start tetapi tidak pernah Running	Lapisan 3: port, firewall, aktivasi
Creator menampilkan Running, Kursor tidak memiliki cocos-creator	Lapisan 4: konfigurasi cepat, muat ulang MCP, file konfigurasi
Kursor menampilkan terhubung tetapi tidak dapat mencantumkan node scene	Prompt verifikasi, sakelar alat, proyek yang benar terbuka

Gejala A: Tidak ada ekstensi MCP di menu

Kemungkinan penyebab

1. Campuran paket 2.x / 3.x
2. 3.x: tidak diimpor di Extension Manager, atau masih dinonaktifkan
3. 2.x: tidak di bawah packages/<nama-plugin>/, atau ada tingkat unzip ekstra
4. 2.x: file ditempatkan tetapi Creator tidak dimulai ulang sepenuhnya

Perbaikan

Creator 3.x:

1. Unduh dari Cocos MCP 3.x—bukan paket 2.x
2. Buka proyek → Extension → Extension Manager → Import → pilih zip 3.x
3. Pastikan cocos-mcp-server diaktifkan; aktifkan jika dinonaktifkan
4. Jika menu masih hilang: keluar dari Creator dan buka kembali proyek yang sama

Creator 2.x:

1. Unduh dari Cocos MCP 2.x
2. Setelah unzip, struktur harus terlihat seperti:

root-proyek-anda/
  packages/
    <nama-plugin>/          ← file plugin langsung di sini
      package.json          ← harus ada di jalur ini (nama sesuai paket)

3. Contoh salah nesting:

packages/
  xxx-mcp-unzip/
    <nama-plugin>/
      package.json

4. Perbaiki jalur, lalu keluar dan mulai ulang Creator (bukan hanya menyegarkan scene). Periksa Extension → MCP Server.

Gejala B: Panel terbuka, tetapi aktivasi gagal atau layanan tidak mau dimulai

Kemungkinan penyebab

• Akun tidak memiliki hak Pro yang sesuai
• Kode lisensi kedaluwarsa atau email tidak cocok
• Mengklik Start sebelum aktivasi

Perbaikan

1. Buka panel MCP (3.x: Extension → Cocos MCP Server → Open Mcp Panel; 2.x: Extension → MCP Server)
2. Aktifkan dengan salah satu:
   • Akun VberAI + kata sandi
   • Email + kode lisensi
3. Konfirmasi paket / kode di pusat akun resmi, lalu coba lagi di panel
4. Hanya setelah aktivasi buka pengaturan MCP Server dan klik Start

Tanpa aktivasi, server biasanya tidak pernah mencapai Running. Perbaiki sisi editor sebelum menyalahkan Kursor.

Gejala C: Mengklik Start, tetapi tidak pernah Running

Kemungkinan penyebab

1. Masih belum diaktifkan (lihat gejala B)
2. Port sedang digunakan (3.x sering default ke 3000; 2.x mengikuti panel)
3. Firewall / perangkat lunak keamanan memblokir pendengar localhost

Perbaikan

1. Catat port di halaman pengaturan MCP Server (contoh di bawah menggunakan 3000—ganti dengan nilai panel Anda)
2. Periksa apakah ada yang sudah mendengarkan:

macOS / Linux:

lsof -iTCP:3000 -sTCP:LISTEN

Windows (PowerShell):

netstat -ano | findstr :3000

3. Jika proses lain memegang port:
   • hentikan proses itu, atau
   • pilih port yang bebas di panel MCP, lalu Start lagi
4. Pastikan firewall mengizinkan 127.0.0.1 (jangan mengekspos MCP ke internet publik)
5. Saat panel menampilkan Running, konfigurasikan AI IDE

Gejala D: Creator Running, Kursor tidak memiliki cocos-creator

Sebagian besar laporan “koneksi gagal” berada di sini: editor OK, klien tidak pernah menelan konfigurasi.

Perbaikan (secara berurutan)

1. Di Creator, pastikan panel MCP masih Running (perubahan port atau mulai ulang editor dapat menghentikannya)
2. Buka Tool Manager dan aktifkan alat yang Anda butuhkan
3. Buka Quick Config → pilih Cursor → Auto Config hingga UI menampilkan Configured
4. Di Kursor → daftar MCP / alat:
   • Anda akan melihat cocos-creator (atau nama yang ditampilkan di panel)
   • Jika hilang: Reload MCP (atau mulai ulang Kursor) dan periksa lagi
5. Masih hilang: verifikasi konfigurasi MCP Kursor berisi jembatan lokal (127.0.0.1 + port panel)

Output Auto Config bervariasi tergantung versi Kursor. Saat memeriksa secara manual:

• Nama layanan cocok dengan Cocos MCP (mis. cocos-creator)
• Host adalah 127.0.0.1 atau localhost, port cocok dengan Creator
• Bukan IP LAN atau publik secara tidak sengaja

Setelah mengedit konfigurasi apa pun, muat ulang MCP lagi atau UI mempertahankan status lama.

AI IDE lainnya

Di Quick Config, pilih Claude Code, Codex, Windsurf, Cline, dll., lalu Auto Config → muat ulang MCP di klien tersebut. Mengonfigurasi Kursor tidak menghubungkan setiap IDE.

Gejala E: Menampilkan terhubung, tetapi tidak dapat mencantumkan scene / mengedit node

Kemungkinan penyebab

1. Proyek / scene yang terbuka di Creator tidak cocok dengan yang Anda tanyakan
2. Alat yang diperlukan tidak dicentang di Tool Manager
3. Anda hanya memverifikasi “file di disk,” bukan konteks editor

Verifikasi

Kirim prompt hanya-baca di Kursor:

Daftarkan nama node root dari scene yang saat ini terbuka di Cocos Creator.

Hasil	Arti
Cocok dengan Hierarchy	Jembatan OK; coba tulis kecil berikutnya
Kesalahan jelas / tidak ada alat	Kembali ke gejala C/D
Nama node yang dibuat-buat	MCP kemungkinan tidak digunakan; periksa koneksi dan sakelar alat

Lalu coba tulis kecil (buat node sementara dan hapus). Lakukan commit sebelum pengeditan besar.

Tabel cepat 2.x vs 3.x

Item	Creator 3.x	Creator 2.x
Halaman produk	cocos (3.x)	cocos2x
Instalasi	Extension Manager → Import	Ekstrak ke packages/ proyek
Setelah instalasi	Aktifkan di daftar	Harus mulai ulang Creator
Paket	Hanya 3.x	Hanya 2.x
Langkah lengkap	Instal 3.x	Instal 2.x

Paket campuran sering muncul sebagai “tidak ada menu” atau “impor gagal”—gunakan tabel ini terlebih dahulu.

Urutan yang disarankan (daftar periksa 5 menit)

Centang secara berurutan; sebagian besar kegagalan berada di empat pertama:

1. Versi utama Creator cocok dengan zip MCP (2.x ↔ 2.x, 3.x ↔ 3.x)
2. Ekstensi diaktifkan / jalur packages benar; 2.x dimulai ulang
3. Panel berhasil diaktifkan
4. Panel menampilkan Running; port bebas
5. Quick Config → Auto Config untuk IDE saat ini
6. Muat ulang MCP di AI IDE; cocos-creator terdaftar
7. Prompt hanya-baca mencantumkan root dari scene yang saat ini terbuka

Jika masih gagal, tangkap ini

Saat meminta dukungan atau rekan tim, sertakan:

• Versi Creator yang tepat (mis. 3.8.x / 2.4.x)
• Jenis paket MCP (2.x atau 3.x Pro)
• Apakah panel Running, dan port
• Nama/versi AI IDE dan tangkapan layar daftar MCP
• Prompt hanya-baca yang tepat dan balasannya

Jaga jembatan hanya di localhost; jangan publikasikan port MCP.

Dokumen terkait

• Instal Cocos Creator 3.x MCP
• Instal Cocos Creator 2.x MCP
• Video pengaturan Cocos Creator MCP
• Panduan pilih engine: Godot MCP vs Unity MCP vs Cocos MCP