← Kembali ke blog

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.

Diterbitkan
  • 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 MCPDengan Unity MCP
Tempel skrip yang dihasilkan, lalu perbaiki error kompilasi sendiriMinta klien untuk membuat skrip dan menempelkannya ke GameObject yang bernama
Menduplikasi panel UI secara manualPerintah: “Kloning Panel_Shop di bawah Canvas dan ganti nama anak-anaknya”
Menjelaskan error Console di chatBiarkan klien membaca log terbaru / konteks seleksi (di mana plugin mengeksposnya)
Menebak tata letak scene dari YAMLQuery 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

  1. Impor paket ke proyek Anda (atau instal melalui alur kerja paket tim Anda)
  2. Aktifkan ekstensi / entri menu (nama bervariasi sedikit tergantung build—cari MCP atau AI Bridge)
  3. 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_SmokeTest di 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/HUD dan ringkas mana yang merupakan LayoutGroup.

Tulisan terfokus

Di bawah Canvas/Menu, ganti nama Button menjadi Btn_Start dan atur teks label TMP menjadi Start.

Loop debug

Setelah saya menekan Play, ringkas error Console yang terkait dengan PlayerController dan 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:

  1. Dapatkah alat melihat langsung Hierarchy / seleksi?
  2. Dapatkah membuat edit yang dapat dibalik yang dapat Anda audit?
  3. 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

  1. Instal Unity MCP di scene sekali pakai
  2. Hubungkan Claude Code atau Cursor dan lulus uji asap hanya-baca
  3. 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.

Panduan lain yang mungkin Anda suka