Panduan Pemasangan Cocos Creator 3.x MCP: Import Ekstensi dan Sambungkan AI IDE

Apa yang Diliputi oleh Panduan Ini

Ikuti lima langkah ini untuk menyambungkan Cocos Creator 3.x MCP (VberAI Pro) ke projek Creator tempatan supaya Cursor (atau AI IDE lain yang menyokong MCP—konsep yang sama) boleh mengendalikan, mempratonton, dan menyahpepijat editor—bukan hanya menyunting skrip pada cakera.

Apabila selesai, anda sepatutnya dapat:

• Mengimport dan mengaktifkan cocos-mcp-server melalui Extension Manager
• Mengaktifkan dengan akaun VberAI atau e-mel + kod pengaktifan
• Memulakan Cocos MCP Server tempatan (port lalai 3000)
• Menggunakan Quick configure → Auto configure untuk mendaftarkan pelayan dalam Cursor dan mengesahkan sambungan

Halaman produk: VberAI Cocos MCP 3.x

Artikel ini menggunakan Cursor sebagai contoh. Claude Code, Windsurf, Cline, dan klien MCP lain mengikuti aliran yang serupa.

Prasyarat

Item	Catatan
Cocos Creator	3.0+ (mana-mana projek 3.x)
Pakej plugin	Arkib Cocos Creator 3.x MCP Pro dari laman rasmi
Pengaktifan	Akaun VberAI + kata laluan, atau e-mel + kod pengaktifan
AI IDE	Cursor disyorkan; klien MCP lain juga berfungsi
Rangkaian tempatan	Jambatan MCP biasanya berjalan pada 127.0.0.1—jangan dedahkan port secara awam

Langkah 1: Muat Turun Cocos Creator 3.x MCP

Muat turun binaan Pro dari laman VberAI:

Halaman muat turun: https://www.vberai.com/game-engines/cocos?ch=CQZLC2FG

Aliran yang dicadangkan:

1. Buka halaman dan muat turun Cocos MCP 3.x Pro dengan kebenaran akaun anda
2. Simpan arkib secara tempatan—anda tidak perlu menyahzip ke dalam projek lagi (langkah seterusnya mengimport arkib)
3. Sahkan projek adalah Creator 3.0 atau lebih baru; jangan campurkan dengan pakej 2.x

Perbezaan OSS vs Pro dan pengebilan mengikut salinan laman semasa.

Langkah 2: Import Ekstensi

1. Buka projek Cocos Creator 3.x anda
2. Menu: Extension → Extension Manager → Import Extension
3. Pilih arkib Cocos Creator 3.x MCP yang baru anda muat turun
4. Selepas import berjaya, senarai ekstensi harus menunjukkan cocos-mcp-server diaktifkan

Jika ia kelihatan dinyahaktifkan, aktifkan sebelum meneruskan.

Langkah 3: Aktifkan cocos-mcp-server

1. Menu: Extension → Cocos MCP Server → Open Mcp Panel
2. Pada skrin pengaktifan, gunakan salah satu daripada:
   • Akaun VberAI + kata laluan
   • E-mel + kod pengaktifan
3. Selepas pengaktifan berjaya, buka halaman tetapan MCP Server (langkah seterusnya)

Tanpa pengaktifan, pelayan biasanya tidak akan bermula. Sahkan pelan atau kod anda sepadan dengan binaan Pro semasa.

Langkah 4: Mulakan cocos-mcp-server

1. Selepas pengaktifan, buka tetapan MCP Server
2. Laraskan mengikut keperluan:
   • Port: lalai 3000
   • Bahasa: padankan dengan pilihan UI anda
   • Permulaan: gunakan pilihan panel (contohnya auto-mula dengan editor, jika ada)
3. Klik Start service
4. Apabila panel menunjukkan Running, Cocos MCP Server telah berjalan

Anda kini mempunyai jambatan MCP tempatan. Seterusnya, serahkan kepada AI IDE anda.

Langkah 5: Persediaan AI IDE Satu-Klik (Contoh Cursor)

1. Buka Tool manager
   • Semak alat yang didedahkan oleh Cocos MCP Server
   • Aktifkan hanya apa yang anda mahu AI gunakan
2. Buka Quick configure
   • Pilih IDE anda (contohnya Cursor)
   • Klik Auto configure
   • Sahkan UI menunjukkan keadaan configured
3. Buka Cursor
   • Dalam senarai MCP / alat, anda sepatutnya melihat cocos-creator (atau nama yang ditunjukkan dalam panel) disambungkan
   • Jika tiada, klik Reload (atau setara muat semula MCP) dalam Cursor dan semak semula

IDE lain mengikuti laluan yang sama—hanya pilih klien yang berbeza di bawah Quick configure.

Pengesahan pantas selepas menyambung

Dalam Cursor, mulakan dengan semakan baca-sahaja, contohnya:

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

Jika jawapan sepadan dengan hierarki editor, jambatan berfungsi. Kemudian cuba tulis kecil (buat nod sementara dan padamkannya) untuk mengesahkan kebenaran dan pemilihan alat.

Soalan Lazim

Import gagal, atau cocos-mcp-server tiada dalam senarai?
Gunakan arkib 3.x rasmi (bukan 2.x). Creator mesti 3.0+. Jika ia kekal dinyahaktifkan, aktifkan dalam Extension Manager dan mulakan semula Creator.

Pengaktifan terus gagal?
Sahkan hak Pro, atau kod pengaktifan sah dan terikat pada e-mel yang betul. Semak pusat akaun di laman, kemudian cuba semula dalam panel.

Saya klik Start service tetapi tidak pernah melihat Running?
Sahkan port 3000 (atau port tersuai anda) bebas, dan localhost tidak disekat. Pastikan Langkah 3 selesai dengan jayanya.

Cursor tidak menunjukkan cocos-creator?
Dalam Creator, sahkan pelayan masih Running, jalankan Quick configure → Auto configure sekali lagi, kemudian muat semula MCP dalam Cursor. Jika masih gagal, semak konfigurasi MCP Cursor termasuk alamat jambatan tempatan.

Langkah Seterusnya

• Gunakan bahasa semula jadi untuk pertanyaan scene atau suntingan kecil untuk mempelajari sempadan alat
• Komit sebelum perubahan besar; kekalkan jambatan hanya pada localhost
• Untuk UI reka-ke-enjin, pasangkan dengan VberAI Studio, kemudian lelar dalam editor dengan MCP

Untuk Creator 2.x, ikuti panduan pemasangan Cocos Creator 2.x MCP—jangan campurkan pakej. Untuk menjelaskan sempadan keupayaan dan perbezaan daripada “Cocos Creator AI” yang kabur, lihat Apakah Cocos Creator MCP. Untuk konteks MCP lanjut, lihat panduan video Cocos Creator MCP.