Cursor Rusak Setelah Cocos Creator MCP: Perbaiki Koneksi Berdasarkan Gejala

Pertama: Apakah Cursor Rusak, atau Jembatannya?

Yang Anda rasakan	Kemungkinan penyebab
Cursor masih menulis kode normal, tetapi tidak dapat mencapai scene/node Cocos	MCP tidak terhubung atau alat tidak diaktifkan
Daftar MCP tidak memiliki cocos-creator (atau nama dari Quick configure)	Konfigurasi tidak ditulis, atau perlu Reload
Nama layanan ada tetapi menunjukkan error / terputus	Creator tidak berjalan, URL/port salah, atau perlu reload
Menunjukkan terhubung, tetapi tidak dapat mencantumkan node dari scene yang terbuka	Proyek salah, alat tidak dicentang, atau pemeriksaan read-only buruk

Claude Code, Codex, dan klien MCP serupa mengikuti ide yang sama: pastikan klien memiliki entri layanan yang sehat, lalu periksa Creator.

Langkah 1: Lihat Hanya MCP di Dalam Cursor

Buka pengaturan MCP / alat Cursor (label menu mungkin berbeda tergantung versi) dan periksa:

1. Apakah cocos-creator muncul (atau nama yang ditulis oleh Quick configure Creator)
2. Apakah status terhubung / dapat digunakan—tidak macet dalam error, terputus, atau kosong
3. Jika Anda baru saja mengubah konfigurasi atau menjalankan Auto configure di Creator: lakukan Reload Window (atau reload MCP yang setara), lalu periksa kembali daftar

Kasus umum: Creator sudah menampilkan Running, tetapi Cursor masih memegang konfigurasi basi—tanpa reload terasa “tiba-tiba rusak.”

Langkah 2: Pastikan URL Menunjuk ke Creator Lokal

Entri MCP Cursor harus menargetkan URL jembatan lokal, biasanya:

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

Gunakan port yang ditampilkan di panel MCP Creator (sering 3000 secara default; jika Anda mengubahnya, sesuaikan dengan panel).

Buka juga Cocos Creator dan pastikan panel MCP Running untuk proyek yang sama. Jika panel tidak berjalan, Reload di Cursor tidak akan secara ajaib menampilkan alat.

Halaman produk (pilih paket untuk versi utama Anda; jangan campur):

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

Langkah 3: Jika Masih Gagal, Lompat Berdasarkan Lapisan

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

1. Plugin di proyek dan diaktifkan
        ↓
2. Panel diaktifkan (akun / kode lisensi)
        ↓
3. Server MCP menunjukkan Running (localhost)
        ↓
4. Cursor memiliki konfigurasi yang ditulis dan daftar MCP menunjukkan terhubung

Yang Anda lihat di Cursor	Ke mana harus pergi dulu
Tidak ada entri layanan sama sekali	Lapisan 4: kembali ke Creator → Quick configure → Auto configure, lalu Reload; detail di panduan umum
Entri ada tetapi error / tidak dapat terhubung	Lapisan 3: apakah Creator Running, apakah port cocok, apakah localhost diblokir
Tidak ada menu MCP di dalam Creator	Lapisan 1: campur paket 2.x/3.x, jalur impor, mulai ulang (gejala A di panduan umum)
Panel tidak dapat dimulai / tidak diaktifkan	Lapisan 2: akun dan aktivasi (panduan umum)
Terhubung tetapi tidak dapat mencantumkan node	Pastikan proyek yang benar terbuka; jalankan smoke test read-only di bawah; lalu periksa toggle alat

Instalasi lengkap:

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

Langkah 4: Smoke Test (Pastikan Sudah Diperbaiki)

Di Cursor, mulailah dengan pemeriksaan read-only, misalnya:

Daftarkan node root dari scene yang sedang terbuka di Cocos Creator.

Jika jawaban cocok dengan hierarki editor, jembatan berfungsi. Opsional lakukan satu penulisan yang dapat dibalik (buat node sementara dan hapus). Lakukan commit sebelum edit besar; jaga jembatan hanya di localhost—jangan ekspos port MCP ke internet publik.

Pertanyaan umum

Apa artinya “Cursor rusak” setelah Cocos Creator MCP biasanya?
Tanda-tanda umum: tidak ada entri layanan MCP, status merah/error, atau terhubung tetapi tanpa tools/nodes. Kebanyakan kasus bukan kerusakan Cursor—melainkan satu lapisan yang hilang dalam jembatan empat lapis.

Haruskah saya memeriksa Cursor atau Creator terlebih dahulu?
Mulailah dengan daftar MCP di Cursor (hilang vs merah). Kemudian verifikasi Creator: plugin diimpor/diaktifkan, panel diaktifkan, server Berjalan, port cocok dengan konfigurasi. Gunakan tabel gejala di artikel ini.

Terhubung tetapi tidak ada nodes—langkah selanjutnya?
Pastikan proyek/scene yang benar terbuka; jalankan tes read-only (daftar root nodes). Jika masih gagal, periksa toggle tools dan izin. Jalur lengkap: pemecahan masalah koneksi.

Apakah saya perlu menginstal ulang Cursor?
Biasanya tidak. Lebih baik gunakan Creator “konfigurasi cepat → konfigurasi otomatis,” muat ulang MCP, dan verifikasi port localhost. Batas kategori: Apa Itu Cocos Creator MCP.