Panduan Instalasi Cocos Creator 2.x MCP: Instal melalui paket dan Hubungkan AI IDE

Yang Dicakup Panduan Ini

Ikuti lima langkah berikut untuk menghubungkan Cocos Creator 2.x MCP (VberAI Pro) ke proyek Creator 2.x lokal sehingga Cursor (atau AI IDE lain yang mendukung MCP—konsepnya sama) dapat mengoperasikan, melihat pratinjau, dan men-debug editor—bukan hanya mengedit skrip di disk.

Setelah selesai, Anda seharusnya dapat:

• Mengekstrak plugin ke folder packages proyek
• Memulai ulang Creator, lalu mengaktifkan dengan akun VberAI atau email + kode aktivasi
• Memulai Cocos MCP Server lokal
• Menggunakan Konfigurasi cepat → Konfigurasi otomatis untuk mendaftarkan server di Cursor dan mengonfirmasi koneksi

Halaman produk: VberAI Cocos MCP 2.x

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

Prasyarat

Item	Catatan
Cocos Creator	2.4.x+ / proyek 2.x lainnya (jangan campur dengan paket 3.x)
Paket plugin	Arsip Cocos Creator 2.x MCP Pro dari situs resmi
Aktivasi	Akun VberAI + kata sandi, atau email + kode aktivasi
AI IDE	Cursor direkomendasikan; klien MCP lain juga berfungsi
Jaringan lokal	Jembatan MCP biasanya berjalan di 127.0.0.1—jangan ekspos port ke publik

Langkah 1: Unduh Cocos Creator 2.x MCP

Unduh versi Pro dari situs VberAI:

Halaman unduhan: https://www.vberai.com/game-engines/cocos2x?ch=CQZLC2FG

Alur yang disarankan:

1. Buka halaman dan unduh Cocos MCP 2.x Pro dengan izin akun Anda
2. Simpan arsip secara lokal dan siapkan untuk diekstrak
3. Pastikan proyek adalah Creator 2.x—jangan campur dengan MCP 3.x

Perbedaan OSS vs Pro dan penagihan mengikuti teks situs saat ini.

Langkah 2: Instal Plugin (Ke dalam packages)

Berbeda dengan 3.x (Extension Manager → Import Extension), 2.x diinstal dengan menempatkan file di proyek:

1. Ekstrak arsip di mesin Anda
2. Pindahkan folder plugin yang diekstrak ke direktori packages di root proyek Cocos Creator
   • Jika packages belum ada, buat terlebih dahulu
3. Pastikan tata letaknya adalah packages/<nama-plugin>/ dan tidak bersarang satu tingkat ekstraksi tambahan

Jangan konfigurasi dulu: mulai ulang Creator agar ekstensi dimuat dengan benar (langkah berikutnya).

Langkah 3: Aktifkan cocos-mcp-server

1. Mulai ulang sepenuhnya Cocos Creator dan buka proyek yang berisi plugin
2. Menu: Extension → MCP Server
3. Pada layar aktivasi, gunakan salah satu:
   • Akun VberAI + kata sandi
   • Email + kode aktivasi
4. Setelah aktivasi berhasil, buka halaman pengaturan MCP Server (langkah berikutnya)

Tanpa aktivasi, server biasanya tidak akan berjalan. Pastikan paket atau kode Anda sesuai dengan build Pro saat ini.

Langkah 4: Mulai cocos-mcp-server

1. Setelah aktivasi, buka pengaturan MCP Server
2. Sesuaikan sesuai kebutuhan:
   • Port: gunakan default panel atau konvensi lokal Anda
   • Bahasa: sesuaikan dengan preferensi UI Anda
   • Startup: gunakan opsi panel (misalnya mulai otomatis dengan editor, jika tersedia)
3. Klik Mulai layanan
4. Saat panel menampilkan Berjalan, Cocos MCP Server aktif

Anda sekarang memiliki jembatan MCP lokal. Selanjutnya, serahkan ke AI IDE Anda.

Langkah 5: Pengaturan AI IDE Sekali Klik (Contoh Cursor)

1. Buka Manajer alat
   • Tinjau alat yang diekspos oleh Cocos MCP Server
   • Aktifkan hanya yang Anda inginkan untuk digunakan AI
2. Buka Konfigurasi cepat
   • Pilih IDE Anda (misalnya Cursor)
   • Klik Konfigurasi otomatis
   • Konfirmasi UI menampilkan status terkonfigurasi
3. Buka Cursor
   • Dalam daftar MCP / alat, Anda akan melihat cocos-creator (atau nama yang ditampilkan di panel) terhubung
   • Jika tidak ada, klik Muat ulang (atau muat ulang MCP yang setara) di Cursor dan periksa lagi

IDE lain mengikuti jalur yang sama—cukup pilih klien yang berbeda di bawah Konfigurasi cepat.

Verifikasi cepat setelah menghubungkan

Di Cursor, mulailah dengan pemeriksaan hanya-baca, misalnya:

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

Jika jawaban sesuai dengan hierarki editor, jembatan berfungsi. Kemudian coba tulis kecil (buat node sementara dan hapus) untuk mengonfirmasi izin dan pemilihan alat.

FAQ

File sudah di packages, tetapi tidak ada menu Extension → MCP Server?
Pastikan Anda memulai ulang sepenuhnya Creator (bukan hanya memuat ulang scene). Periksa folder berada di packages/<nama-plugin>/ tanpa sarang zip ekstra. Pastikan Anda mengunduh paket 2.x, bukan 3.x.

Aktivasi terus gagal?
Pastikan hak Pro, atau kode aktivasi valid dan terikat ke email yang benar. Periksa pusat akun di situs, lalu coba lagi di panel.

Saya mengklik Mulai layanan tetapi tidak pernah melihat Berjalan?
Pastikan port bebas dan localhost tidak diblokir. Pastikan Langkah 3 selesai dengan sukses.

Cursor tidak menampilkan cocos-creator?
Di Creator, pastikan server masih Berjalan, jalankan Konfigurasi cepat → Konfigurasi otomatis lagi, lalu muat ulang MCP di Cursor. Jika masih gagal, periksa bahwa konfigurasi MCP Cursor menyertakan alamat jembatan lokal.

Langkah Berikutnya

• Gunakan bahasa alami untuk kueri scene atau edit kecil untuk mempelajari batas alat
• Lakukan commit sebelum perubahan besar; jaga jembatan hanya di localhost
• Untuk UI desain-ke-engine, pasangkan dengan VberAI Studio, lalu iterasi di editor dengan MCP

Untuk Creator 3.x, ikuti panduan instalasi Cocos Creator 3.x MCP—jangan campur paket. Untuk memperjelas batas kemampuan dan bedanya dari “Cocos Creator AI” yang kabur, lihat Apa itu Cocos Creator MCP. Untuk konteks MCP lebih lanjut, lihat panduan video Cocos Creator MCP.