Cara mengaktifkan plugin MCP di Godot: dari unduh sampai tools di Cursor

Cara mengaktifkan: yang dicakup panduan ini

Mengaktifkan plugin MCP bukan hanya centang di daftar — server lokal harus berjalan dan tools terlihat di Cursor (atau IDE MCP lain). Lima langkah: unduh → addons → aktifkan plugin → Start Server → verifikasi di Cursor.

Setelah selesai Anda bisa:

• Menaruh plugin di addons dan mengaktifkannya di Project Settings
• Menjalankan Godot MCP Server lokal (port default 3000)
• Memakai konfigurasi satu klik dan memastikan godot-mcp di Cursor

Checklist aktivasi (lihat dulu)

1. Folder plugin di addons/<nama>/ (tanpa nest ekstra)
2. Project Settings → Plugins: Godot MCP Server aktif
3. Panel GodotMCP menampilkan Running
4. Daftar MCP Cursor menampilkan godot-mcp (Reload bila perlu)
5. Prompt read-only dapat mendaftar root node scene aktif

Repo: DaxianLee/godot-mcp · Produk: Godot MCP

Prasyarat

Item	Catatan
Godot	Terinstal, dengan proyek yang dapat dibuka
Paket plugin	Rilis godot-mcp atau ZIP sumber dari GitHub
AI IDE	Cursor direkomendasikan; klien MCP lain juga berfungsi
Jaringan lokal	Bridge MCP biasanya berjalan di 127.0.0.1—jangan ekspos port ke publik

Langkah 1: Unduh Godot MCP

Unduh Godot MCP open-source dari GitHub:

Repositori: https://github.com/DaxianLee/godot-mcp

Alur yang disarankan:

1. Buka repositori dan gunakan Code → Download ZIP, atau ambil paket terbaru dari Releases
2. Simpan arsip secara lokal dan siapkan untuk mengekstraknya
3. Pastikan paket terlihat seperti plugin Godot (folder terkait addons, atau folder plugin yang dapat Anda letakkan ke dalam addons)

Langkah 2: Tambahkan Godot MCP ke Proyek Anda

1. Ekstrak arsip di mesin Anda
2. Pindahkan folder plugin yang diekstrak ke direktori addons di root proyek Godot
   • Jika addons belum ada, buat terlebih dahulu
3. Buka (atau muat ulang) proyek di Godot dan pastikan file plugin muncul di dock FileSystem

Contoh tata letak proyek setelah impor:

Langkah 3: Aktifkan Plugin Godot MCP di Project Settings

1. Buka Project → Project Settings (atau yang setara untuk versi Godot Anda)
2. Pergi ke tab Plugins
3. Temukan Godot MCP Server (nama mungkin sedikit berbeda di UI)
4. Aktifkan

Setelah diaktifkan, entri Godot MCP akan muncul di panel samping atau dock sehingga Anda dapat mengatur port dan memulai server selanjutnya.

Langkah 4: Mulai Godot MCP Server

1. Di panel kanan editor Godot, buka dock GodotMCP
2. Tinjau dan sesuaikan sesuai kebutuhan:
   • Port: default 3000
   • Bahasa: pilih yang sesuai dengan preferensi UI Anda
   • Startup: Anda dapat mengaktifkan auto-start sehingga server muncul saat Anda membuka proyek
3. Klik Start
4. Saat panel menunjukkan Running (atau yang setara dalam bahasa lokal), Godot MCP Server aktif

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

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

1. Di panel GodotMCP, buka Tools
   • Tinjau alat yang diekspos oleh server
   • Aktifkan hanya kemampuan yang Anda inginkan untuk digunakan AI
2. Buka Configure
   • Pilih IDE Anda (misalnya Cursor)
   • Klik One-click configure
   • Tunggu pesan konfigurasi berhasil
3. Buka Cursor
   • Di daftar MCP / alat, Anda akan melihat godot-mcp terhubung secara otomatis
   • Jika tidak muncul, klik Reload (atau tindakan muat ulang MCP yang setara) di Cursor dan periksa lagi

Konfigurasi dan koneksi:

Verifikasi cepat setelah terhubung

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

Daftarkan node root dari scene Godot yang aktif.

Jika jawaban cocok dengan Hierarchy editor, bridge berfungsi. Kemudian coba operasi tulis kecil (buat node sementara dan hapus) untuk mengonfirmasi izin dan pemilihan alat.

FAQ

Saya menyalin file ke addons, tetapi Godot MCP Server tidak muncul di daftar plugin?
Pastikan folder berada di addons/<nama-plugin>/ dan tidak bersarang satu tingkat ekstra dari unzip. Muat ulang proyek atau mulai ulang Godot.

Saya klik Start tetapi tidak pernah melihat Running?
Pastikan port 3000 (atau port kustom Anda) bebas, lalu coba lagi. Periksa bahwa tidak ada yang memblokir localhost.

Cursor tidak menampilkan godot-mcp?
Di Godot, pastikan server masih Running, jalankan konfigurasi satu-klik lagi, lalu muat ulang MCP di Cursor. Jika masih gagal, periksa bahwa konfigurasi MCP Cursor menyertakan alamat bridge lokal.

Auto-start aktif, tetapi saya masih harus memulai secara manual?
Beberapa build memerlukan satu kali start manual yang berhasil terlebih dahulu. Pastikan kotak centang tersimpan, lalu buka kembali proyek yang sama dan verifikasi.

Langkah Berikutnya

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

Untuk latar belakang lebih lanjut tentang Godot + MCP, lihat Cara kami membangun server MCP real-time untuk Godot.