Penyelesaian Masalah Sambungan Cocos MCP: Kursor Tidak Menunjukkan cocos-creator

Pertama: Lapisan mana yang gagal?

Jika anda kata “Cursor rosak / tidak connect”, mulakan dengan gejala Cursor: Cursor rosak selepas Cocos Creator MCP.

Jika masih tidak jelas apa yang MCP boleh buat dan bagaimana ia berbeza daripada “Cocos Creator AI”, baca dahulu Apakah Cocos Creator MCP.

Laluan MCP mempunyai empat lapisan. Kegagalan pada mana-mana lapisan kelihatan seperti “tidak dapat menyambung”:

1. Sambungan dipasang dan diaktifkan
        ↓
2. Panel diaktifkan (akaun / kod lesen)
        ↓
3. Pelayan MCP menunjukkan Berjalan (localhost)
        ↓
4. Konfigurasi IDE AI ditulis dan senarai MCP menunjukkan bersambung

Apa yang anda lihat	Periksa dahulu
Tiada menu Sambungan → Pelayan MCP Cocos / Pelayan MCP	Lapisan 1: versi pakej, laluan import, mulakan semula
Panel dibuka tetapi tidak dapat dimulakan / kekal tidak diaktifkan	Lapisan 2: akaun dan lesen
Klik Mula tetapi tidak pernah Berjalan	Lapisan 3: port, tembok api, pengaktifan
Creator menunjukkan Berjalan, Kursor tiada cocos-creator	Lapisan 4: konfigurasi pantas, muat semula MCP, fail konfigurasi
Kursor menunjukkan bersambung tetapi tidak dapat menyenaraikan nod scene	Prompt pengesahan, togol alat, projek betul dibuka

Gejala A: Tiada sambungan MCP dalam menu

Punca yang mungkin

1. Campuran pakej 2.x / 3.x
2. 3.x: tidak diimport dalam Pengurus Sambungan, atau masih dilumpuhkan
3. 2.x: tidak di bawah packages/<nama-plugin>/, atau terdapat tahap unzip tambahan
4. 2.x: fail diletakkan tetapi Creator tidak dimulakan semula sepenuhnya

Pembaikan

Creator 3.x:

1. Muat turun dari Cocos MCP 3.x—bukan pakej 2.x
2. Buka projek → Sambungan → Pengurus Sambungan → Import → pilih zip 3.x
3. Sahkan cocos-mcp-server diaktifkan; aktifkan jika dilumpuhkan
4. Jika menu masih hilang: keluar dari Creator dan buka semula projek yang sama

Creator 2.x:

1. Muat turun dari Cocos MCP 2.x
2. Selepas unzip, struktur pokok sepatutnya kelihatan seperti:

akar-projek-anda/
  packages/
    <nama-plugin>/          ← fail plugin terus di sini
      package.json          ← sepatutnya wujud pada laluan ini (nama mengikut pakej)

3. Sarang yang salah contoh:

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

4. Betulkan laluan, kemudian keluar dan mulakan semula Creator (bukan hanya muat semula scene). Periksa Sambungan → Pelayan MCP.

Gejala B: Panel dibuka, tetapi pengaktifan gagal atau perkhidmatan tidak dapat dimulakan

Punca yang mungkin

• Akaun tidak mempunyai hak Pro yang sepadan
• Kod lesen tamat tempoh atau e-mel tidak sepadan
• Klik Mula sebelum pengaktifan

Pembaikan

1. Buka panel MCP (3.x: Sambungan → Pelayan MCP Cocos → Buka Panel Mcp; 2.x: Sambungan → Pelayan MCP)
2. Aktifkan dengan sama ada:
   • Akaun VberAI + kata laluan
   • E-mel + kod lesen
3. Sahkan pelan / kod di pusat akaun rasmi, kemudian cuba semula dalam panel
4. Hanya selepas pengaktifan buka tetapan Pelayan MCP dan klik Mula

Tanpa pengaktifan, pelayan biasanya tidak akan mencapai Berjalan. Betulkan bahagian editor sebelum menyalahkan Kursor.

Gejala C: Klik Mula, tetapi tidak pernah Berjalan

Punca yang mungkin

1. Masih belum diaktifkan (lihat gejala B)
2. Port digunakan (3.x selalunya lalai kepada 3000; 2.x mengikut panel)
3. Tembok api / perisian keselamatan menyekat localhost mendengar

Pembaikan

1. Catat port pada halaman tetapan Pelayan MCP (contoh di bawah menggunakan 3000—gantikan dengan nilai panel anda)
2. Periksa sama ada sesuatu sudah mendengar:

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 percuma dalam panel MCP, kemudian Mula semula
4. Pastikan tembok api membenarkan 127.0.0.1 (jangan dedahkan MCP ke internet awam)
5. Apabila panel menunjukkan Berjalan, konfigurasikan IDE AI

Gejala D: Creator Berjalan, Kursor tiada cocos-creator

Kebanyakan laporan “sambungan gagal” berada di sini: editor OK, klien tidak pernah mengambil konfigurasi.

Pembaikan (mengikut urutan)

1. Dalam Creator, sahkan panel MCP masih Berjalan (perubahan port atau mulakan semula editor mungkin menghentikannya)
2. Buka Pengurus Alat dan aktifkan alat yang anda perlukan
3. Buka Konfigurasi Pantas → pilih Kursor → Konfigurasi Auto sehingga UI menunjukkan Dikonfigurasi
4. Dalam Kursor → senarai MCP / alat:
   • Anda sepatutnya melihat cocos-creator (atau nama yang ditunjukkan dalam panel)
   • Jika tiada: Muat Semula MCP (atau mulakan semula Kursor) dan periksa semula
5. Masih tiada: sahkan konfigurasi MCP Kursor mengandungi jambatan tempatan (127.0.0.1 + port panel)

Output Konfigurasi Auto berbeza mengikut versi Kursor. Apabila memeriksa secara manual:

• Nama perkhidmatan sepadan dengan Cocos MCP (cth. cocos-creator)
• Hos ialah 127.0.0.1 atau localhost, port sepadan dengan Creator
• Bukan IP LAN atau awam secara tidak sengaja

Selepas sebarang edit konfigurasi, muat semula MCP sekali lagi atau UI mengekalkan keadaan lama.

IDE AI lain

Dalam Konfigurasi Pantas, pilih Claude Code, Codex, Windsurf, Cline, dsb., kemudian Konfigurasi Auto → muat semula MCP dalam klien tersebut. Mengonfigurasi Kursor tidak menyambungkan setiap IDE.

Gejala E: Menunjukkan bersambung, tetapi tidak dapat menyenaraikan scene / mengedit nod

Punca yang mungkin

1. Projek / scene yang dibuka dalam Creator tidak sepadan dengan apa yang anda tanya
2. Alat yang diperlukan tidak ditandakan dalam Pengurus Alat
3. Anda hanya mengesahkan “fail pada cakera,” bukan konteks editor

Pengesahan

Hantar prompt hanya-baca dalam Kursor:

Senaraikan nama nod akar scene yang sedang dibuka dalam Cocos Creator.

Hasil	Makna
Sepadan dengan Hierarki	Jambatan OK; cuba tulis kecil seterusnya
Ralat jelas / tiada alat	Kembali ke gejala C/D
Nama nod direka	MCP mungkin tidak digunakan; periksa sambungan dan togol alat

Kemudian cuba tulis kecil (cipta nod sementara dan padamkannya). Komit sebelum edit besar.

Jadual pantas 2.x vs 3.x

Item	Creator 3.x	Creator 2.x
Halaman produk	cocos (3.x)	cocos2x
Pemasangan	Pengurus Sambungan → Import	Unzip ke dalam projek packages/
Selepas pemasangan	Aktifkan dalam senarai	Mesti mulakan semula Creator
Pakej	3.x sahaja	2.x sahaja
Langkah penuh	Pemasangan 3.x	Pemasangan 2.x

Pakej bercampur sering menunjukkan “tiada menu” atau “import gagal”—gunakan jadual ini dahulu.

Urutan yang disyorkan (senarai semak 5 minit)

Tandakan mengikut urutan; kebanyakan kegagalan berada dalam empat yang pertama:

1. Versi utama Creator sepadan dengan zip MCP (2.x ↔ 2.x, 3.x ↔ 3.x)
2. Sambungan diaktifkan / laluan packages betul; 2.x dimulakan semula
3. Panel diaktifkan dengan jayanya
4. Panel menunjukkan Berjalan; port bebas
5. Konfigurasi Pantas → Konfigurasi Auto untuk IDE semasa
6. MCP dimuat semula dalam IDE AI; cocos-creator disenaraikan
7. Prompt hanya-baca menyenaraikan akar scene yang sedang dibuka

Jika masih gagal, tangkap ini

Apabila meminta sokongan atau rakan sepasukan, sertakan:

• Versi Creator yang tepat (cth. 3.8.x / 2.4.x)
• Jenis pakej MCP (2.x atau 3.x Pro)
• Sama ada panel Berjalan, dan port
• Nama/versi IDE AI dan tangkapan skrin senarai MCP
• Prompt hanya-baca yang tepat dan balasan

Kekalkan jambatan pada localhost sahaja; jangan terbitkan port MCP.

Dokumen berkaitan

• Pemasangan Cocos Creator 3.x MCP
• Pemasangan Cocos Creator 2.x MCP
• Panduan video persediaan Cocos Creator MCP
• Panduan pilih enjin: Godot MCP vs Unity MCP vs Cocos MCP