Unity MCP dengan Claude Code dan Cursor: Operasikan Editor Tanpa Menulis Setiap Perubahan Secara Manual
Hubungkan Claude Code, Cursor, dan Codex ke Unity melalui Model Context Protocol—pasang jembatan lokal, pratinjau perubahan, dan debug scene melampaui edit file AI.
- unity-mcp
- mcp-for-unity
- claude-unity-mcp
- unity-claude-code
- unity-ai
- claude-code
- cursor
- vberai
Keterbatasan “AI Menulis C# ke dalam Folder”
Alat coding berbasis chat sangat baik dalam menghasilkan skrip. AI yang hanya mengedit file masih melewatkan status editor langsung—scene yang terbuka, GameObject yang dipilih, varian prefab, perilaku play-mode, dan error Console.
Jika model hanya melihat file di disk, ia menebak hierarki dan tidak dapat mengklik Play, mengganti nama node di Hierarchy, atau memeriksa referensi yang hilang. Tim membutuhkan asisten di dalam loop mesin, bukan hanya di repo.
Model Context Protocol (MCP) adalah cara standar bagi klien AI untuk memanggil alat. Server Unity MCP mengekspos aksi editor melalui jembatan lokal sehingga klien seperti Claude Code, Cursor, dan alur kerja bergaya Codex dapat membaca dan mengubah proyek saat Unity berjalan.
VberAI menyediakan plugin Unity MCP untuk jembatan tersebut. Panduan ini adalah jalur pengaturan dan penggunaan praktis—bukan daftar fitur.
Apa yang Berubah dari Unity MCP dalam Pekerjaan Sehari-hari
| Tanpa MCP | Dengan Unity MCP |
|---|---|
| Tempel skrip yang dihasilkan, lalu perbaiki error kompilasi sendiri | Minta klien untuk membuat skrip dan menempelkannya ke GameObject yang bernama |
| Menduplikasi panel UI secara manual | Perintah: “Kloning Panel_Shop di bawah Canvas dan ganti nama anak-anaknya” |
| Menjelaskan error Console di chat | Biarkan klien membaca log terbaru / konteks seleksi (di mana plugin mengeksposnya) |
| Menebak tata letak scene dari YAML | Query hierarki, lalu edit dengan konfirmasi |
Anda tetap meninjau diff dan hasil play-mode. Anda berhenti mengetik setiap klik editor yang dapat dilakukan agen dengan aman.
Prasyarat
- Proyek Unity terbuka (LTS direkomendasikan untuk kerja tim)
- Klien yang mendukung MCP: Claude Code, Cursor, Windsurf, atau sejenisnya
- Akses jaringan lokal ke
127.0.0.1(jembatan biasanya tetap di loopback) - Paket VberAI Unity MCP untuk versi Unity Anda (unduh / dokumen)
Opsional tetapi berguna: scene contoh kecil (Canvas kosong + dua tombol) sehingga perintah pertama mudah diverifikasi.
Daftar Periksa Pengaturan
1. Instal plugin Unity MCP
- Impor paket ke proyek Anda (atau instal melalui alur kerja paket tim Anda)
- Aktifkan ekstensi / entri menu (nama bervariasi sedikit tergantung build—cari MCP atau AI Bridge)
- Muat ulang editor jika Unity meminta
2. Mulai jembatan MCP lokal
Buka panel plugin dan mulai server. Konfirmasi:
- Status menunjukkan berjalan
- Host adalah localhost (jangan ekspos port ke publik)
- Jalur proyek sesuai dengan proyek Unity yang ingin Anda edit
3. Daftarkan server di klien AI Anda
Di Cursor atau Claude Code, tambahkan entri server MCP yang menunjuk ke jembatan Unity lokal (stdio atau HTTP/SSE—ikuti dokumen plugin saat ini).
Mulai ulang klien jika alat tidak muncul. Anda akan melihat alat terkait Unity terdaftar (pembacaan scene, operasi node, dll.).
4. Jalankan uji asap hanya-baca
Tanyakan:
Daftar GameObject akar di scene aktif.
Jika jawaban cocok dengan Hierarchy, jembatan berfungsi. Hanya setelah itu coba aksi tulis.
5. Jalankan uji tulis kecil
Tanyakan:
Buat GameObject kosong bernama
MCP_SmokeTestdi bawah akar scene.
Temukan di Hierarchy, lalu hapus. Lebih suka tes yang dapat dibalik sebelum refaktor besar.
Pola Perintah yang Berhasil
Struktur dulu
Tampilkan anak dari
Canvas/HUDdan ringkas mana yang merupakan LayoutGroup.
Tulisan terfokus
Di bawah
Canvas/Menu, ganti namaButtonmenjadiBtn_Startdan atur teks label TMP menjadiStart.
Loop debug
Setelah saya menekan Play, ringkas error Console yang terkait dengan
PlayerControllerdan sarankan perbaikan terkecil.
Pasangkan dengan UI yang dihasilkan
Jika Anda mengimpor layar dari AI Studio, gunakan MCP untuk menghubungkan listener onClick atau menyelaraskan penamaan dengan konvensi C# Anda—tanpa membangun ulang prefab secara manual.
Kebiasaan Keamanan
- Jaga jembatan hanya di localhost
- Lebih suka baca → rencana → tulis daripada satu perintah raksasa “bangun ulang game”
- Commit sebelum edit agen besar
- Jangan tempel rahasia ke dalam perintah; MCP tidak menggantikan kontrol akses
- Perlakukan play-mode dan penyegaran aset database sebagai titik pemeriksaan manusia
MCP mengurangi klik mesin manual. Itu tidak menghilangkan tinjauan kode.
Bagaimana Ini Terkait dengan Asisten AI Bawaan Unity
Asisten Unity bawaan dan plugin Unity MCP pihak ketiga menyelesaikan pekerjaan yang tumpang tindih. Evaluasi mereka dengan cara yang sama:
- Dapatkah alat melihat langsung Hierarchy / seleksi?
- Dapatkah membuat edit yang dapat dibalik yang dapat Anda audit?
- Apakah berfungsi dengan klien AI yang sudah digunakan tim Anda (Claude Code, Cursor, …)?
Unity MCP paling kuat ketika tim Anda sudah hidup di klien tersebut dan ingin satu protokol di seluruh mesin (banyak studio juga menjalankan Godot atau Cocos MCP dengan kebiasaan yang sama).
FAQ
Apakah saya masih menulis C#?
Ya. MCP paling baik untuk operasi editor dan perancah. Sistem gameplay, jaringan, dan pekerjaan kinerja masih membutuhkan insinyur.
Claude Code vs Cursor?
Keduanya berfungsi jika mendukung MCP dan Anda menunjuk ke server Unity lokal yang sama. Pilih klien yang sudah digunakan repo Anda; jembatan adalah bagian bersama.
Apakah ini hanya untuk UI?
Tidak. Hierarchy, komponen, dan operasi scene berlaku juga untuk objek gameplay. UI hanyalah demo pertama yang mudah.
Di mana video walkthrough?
Lihat Unity Game Engine MCP Plugin (video guide) di jalur saluran VberAI untuk sesi pengaturan yang direkam.
Langkah Berikutnya
- Instal Unity MCP di scene sekali pakai
- Hubungkan Claude Code atau Cursor dan lulus uji asap hanya-baca
- Otomatiskan satu tugas yang Anda benci (ganti nama batch, duplikat panel, lampirkan skrip)
Ketika desain-ke-prefab adalah hambatan alih-alih operasi editor, pasangkan ini dengan alur kerja Figma → Unity AI Studio.
Lanjutkan membaca
Panduan lain yang mungkin Anda suka
Penghapusan Background Gratis di VberAI: Cutout Glow / VFX / Semi-Transparan dengan PNG + Alpha
VberAI AI Super Matting punya tiga mode: matting gratis untuk FX glow & warna solid, AI background removal untuk scene kompleks hingga 4096×4096, dan Super AI matting untuk rambut, tepi semi-transparan, serta bayangan—dengan PNG transparan plus Alpha.
- vberai
- ai-super-matting
- matting
- super-matting
Godot 4: Letakkan Aturan Sinyal dalam Prompt Anda agar MCP Menghubungkan Health Bar
Sebelum meminta Godot MCP di Cursor, tentukan kontrak sinyal health_changed agar HUD terhubung tanpa jalur get_node yang dalam—template prompt, contoh GDScript, anti-pattern, dan penerimaan Play.
- Godot MCP
- Godot 4
- signals
- HUD
Cara Menghubungkan Claude Code ke Unity MCP: Instalasi dan Konfigurasi
Instal Unity MCP dan hubungkan lewat Claude CLI: impor Package Manager, aktivasi, jalankan MCP Server lokal (port 6589), salin perintah CLI, lalu verifikasi Hierarchy.
- unity
- mcp
- claude-code
- tutorial