Setup Godot MCP

Pahami koneksi yang disediakan MCP

Coding-Solo/godot-mcp mendokumentasikan tool untuk menjalankan project Godot, mengambil output debug, dan mengoperasikan scene. Ini adalah bridge yang dikelola project, bukan layanan model atau distribusi Godot resmi. Agen tetap memerlukan akses model sendiri dan izin lokal yang sesuai.

Simpan tiga identitas dalam catatan setup: client, revisi server MCP, dan executable Godot. Kegagalan salah satunya bukan bukti yang lain tidak tersedia. Gunakan diagram koneksi untuk menentukan lokasi pemeriksaan: autentikasi provider, konfigurasi client, proses tool lokal, atau project engine.

Inventarisasi prasyarat tanpa mengubahnya diam-diam

Sebelum instalasi, periksa persyaratan service dan pilih versi atau revisi server tertentu untuk ditinjau. Pastikan engine dan runtime yang ada dapat ditemukan dari proses client, bukan hanya shell interaktif Anda. Catat sistem operasi dan direktori project yang dituju.

Tinjau prosedur instalasi service sebelum mengizinkan perubahan dependensi. Nyatakan runtime, revisi server, dan lokasi instalasi, serta pertahankan cara mengembalikan environment sebelumnya. Setelah setup, catat versi yang terselesaikan, bukan hanya URL sumber yang terus berubah. Ini membantu mereproduksi koneksi yang bekerja saat client atau engine nantinya diperbarui.

Gunakan entrypoint build lokal yang terdokumentasi

README service mendukung source build dengan build/index.js sebagai entrypoint client dan GODOT_PATH sebagai override executable eksplisit. JSON di bawah mengilustrasikan rute yang sudah dibangun dengan placeholder. Ganti setiap path dengan instalasi lokal yang telah ditinjau dan pastikan proses client dapat membacanya.

Gunakan schema yang benar-benar didukung client. Object mcpServers generik bukan otomatis file konfigurasi Codex. Terjemahkan hanya melalui pengaturan client yang terdokumentasi dan jauhkan kredensial model dari blok tool engine ini. Path Node absolut berguna saat environment client GUI berbeda dari terminal.

{
  "mcpServers": {
    "godot": {
      "command": "/absolute/path/to/node",
      "args": ["/absolute/path/to/reviewed-godot-mcp/build/index.js"],
      "env": {
        "GODOT_PATH": "/absolute/path/to/godot"
      }
    }
  }
}

Verifikasi jalur tool read-only terlebih dahulu

Periksa tool yang dikembalikan server terkonfigurasi, jangan mengandalkan daftar yang diingat. README menyebut get_godot_version dan get_project_info sebagai operasi inspeksi yang berguna. Periksa schema parameter yang ditemukan, lalu targetkan hanya direktori project yang disetujui.

Bandingkan informasi engine dan project yang dikembalikan dengan catatan setup. Pertahankan hasil serta error terstruktur. Jangan menyetujui pembuatan scene sampai observasi mengidentifikasi workspace yang dimaksud. Jika client menampilkan badge terhubung tetapi tidak dapat menyelesaikan pembacaan ini, koneksi belum siap untuk eksperimen gameplay. Badge saja tidak menunjukkan proses atau project mana yang dicapai.

Otorisasi satu miniflow scene yang dapat dibalik

Setelah akses baca diverifikasi, gunakan scene milik sendiri yang dapat dibuang untuk penulisan pertama. Catat keadaan awal, minta satu perubahan terlihat, periksa scene tersimpan, jalankan, ambil output, dan hentikan project. Pertahankan diff file beserta observasi.

Kondisi penerimaan adalah rantai dari perubahan yang diminta ke resource tersimpan dan perilaku runtime yang terlihat. Saat tool melaporkan sukses tetapi scene tidak berubah, periksa penargetan project serta path penyimpanan sebelum mencoba mutasi kedua. Buka kembali scene setelah menyimpan agar pemeriksaan mencakup persistensi dan keadaan dalam memori saat ini.

Diagnosis kegagalan pada batas yang tepat

Jika startup proses gagal, periksa path runtime dan entry point. Jika Godot tidak ditemukan, verifikasi override executable dari environment client. Jika project tidak dapat diinspeksi, pastikan path menunjuk direktori yang berisi project.godot dan dapat dibaca proses.

Setelah project berjalan, perlakukan error scene atau gameplay sebagai masalah engine dengan konteks reproduksi. Jangan mengubah credential provider untuk memperbaiki masalah path lokal. Tangkap log server dengan hati-hati: sanitasi detail filesystem sensitif sebelum berbagi dan buat debugging detail bersifat sementara, bukan merekam setiap operasi project tanpa seleksi.

Jaga batas persetujuan dan jaringan tetap sempit

Tool engine dapat mengubah project yang berfungsi atau menjalankan kode. Berikan akses ke direktori terkecil yang sesuai dan tinjau permintaan mutasi sampai perilaku dipahami. Jangan menyalin daftar auto-approval luas hanya karena muncul dalam contoh konfigurasi.

Perlakukan script yang diimpor, plugin, dan output tool sebagai materi untuk diperiksa, bukan instruksi yang dapat memperluas otoritas. Unduhan paket, penghapusan file di luar scene milik sendiri, perubahan credential, dan publikasi memerlukan keputusan eksplisit. Miniflow sukses pertama adalah dasar peninjauan kebijakan, bukan alasan mengizinkan setiap tindakan tool berikutnya.

Catat batas setup yang telah diverifikasi

Catatan setup lengkap harus mengidentifikasi revisi server, client, versi engine, path project, tool yang ditemukan, pembacaan yang selesai, perubahan yang dapat dibalik, dan hasil runtime. Nyatakan tindakan yang belum diuji. Simpan bersama bukti game, bukan menyajikannya sebagai jaminan kompatibilitas universal.

Lapisan berikutnya adalah loop produksi: implementasikan fitur, reproduksi perilakunya, ekspor, dan uji di platform target. Konfigurasi di sini mengikuti dokumentasi service dan harus divalidasi untuk client serta versi yang dipilih. Pertahankan hasil terbatas itu bersama project, lalu gunakan gerbang inspeksi yang sama setiap kali server, engine, atau client berubah.

Pertanyaan umum