Cara Menghubungkan Claude Code ke Unity MCP: Instalasi dan Konfigurasi

Apa yang Dibahas dalam Panduan Ini

Ikuti lima langkah berikut untuk menghubungkan Unity MCP ke proyek Unity lokal agar Claude CLI dapat mengoperasikan, melihat pratinjau, dan men-debug editor—bukan sekadar mengedit skrip di disk.

Setelah selesai, Anda seharusnya dapat:

• Mengimpor Unity MCP melalui Package Manager Add package from disk
• Menyelesaikan aktivasi plugin (akun atau kode aktivasi—ikuti Mcp Panel Anda)
• Menjalankan Unity MCP Server lokal (port default 6589)
• Menyalin perintah CLI dari Quick setup, menjalankannya di Claude CLI, dan memastikan koneksi MCP

Halaman unduhan: Unity MCP

Panduan ini menggunakan Claude CLI. Untuk Gemini CLI, pilih klien yang sesuai di Quick setup dan salin perintah CLI-nya dengan cara yang sama.

Prasyarat

Item	Catatan
Unity	2022.3+ / Unity 6 direkomendasikan (ikuti catatan dukungan terkini untuk build Anda)
Paket plugin	Arsip Unity MCP yang sudah diunduh dan diekstrak
Aktivasi	Akun plugin + kata sandi, atau email + kode aktivasi (sesuai Mcp Panel)
AI IDE	Claude CLI (alur sama untuk Gemini CLI)
Jaringan lokal	Jembatan MCP biasanya berjalan di 127.0.0.1—jangan mengekspos port ke publik

Langkah 1: Unduh Unity MCP

Unduh plugin dari situs vendor Unity MCP Anda atau halaman rilis:

Contoh halaman unduhan: https://www.vberai.com/game-engines/unity?ch=CQZLC2FG

Alur yang disarankan:

1. Buka halaman unduhan dan dapatkan arsip Unity MCP
2. Simpan secara lokal dan ekstrak ke folder tetap (langkah berikutnya memerlukan package.json di dalamnya)
3. Pastikan package.json ada di folder hasil ekstrak sebelum membuka Unity

Perbedaan lisensi dan edisi bervariasi antar vendor—ikuti dokumentasi resmi mereka.

Langkah 2: Impor paket

1. Buka proyek Unity target Anda
2. Menu Window → Package Manager
3. Klik + di kiri atas panel Package Manager
4. Pilih Add package from disk
5. Pilih file package.json dari folder hasil ekstrak di Langkah 1

Setelah impor berhasil, paket Unity MCP akan muncul di daftar Package Manager.

Langkah 3: Aktifkan unity-mcp

1. Menu Window → Unity MCP → Mcp Panel
2. Di layar aktivasi, lakukan salah satu:
   • Masuk dengan akun + kata sandi
   • Atau masukkan email + kode aktivasi
3. Setelah aktivasi berhasil, buka halaman pengaturan MCP Server (langkah berikutnya)

Tanpa aktivasi, layanan biasanya tidak akan berjalan. Pastikan akun atau kode Anda sesuai dengan versi plugin yang dipasang.

Langkah 4: Jalankan unity-mcp-server

1. Setelah aktivasi, buka halaman pengaturan Unity MCP Server
2. Sesuaikan sesuai kebutuhan:
   • Port: default 6589
   • Language: sesuaikan dengan preferensi UI Anda
   • Startup: ikuti opsi panel (mis. mulai otomatis bersama editor, jika tersedia)
3. Klik Start service
4. Saat panel menampilkan Running, Unity MCP Server sudah aktif

Anda kini memiliki jembatan MCP lokal—selanjutnya, konfigurasikan Claude CLI.

Langkah 5: Konfigurasikan Claude CLI

1. Buka Tool management
   • Tinjau alat yang disediakan oleh Unity MCP Server
   • Aktifkan hanya yang Anda ingin model gunakan
2. Buka Quick setup
   • Pilih Claude CLI (Gemini CLI bekerja sama—pilih klien tersebut)
   • Claude CLI / Gemini CLI tidak mendukung Auto configure—klik Copy pada CLI command yang ditampilkan di panel

3. Buka terminal sistem, tempel, dan jalankan perintah yang disalin (di lingkungan tempat Claude CLI terpasang)
4. Kembali ke Claude CLI dan pastikan unity-mcp (atau nama terdaftar yang setara) muncul di daftar MCP

Pemeriksaan cepat setelah terhubung

Di Claude CLI, mulailah dengan pemeriksaan hanya-baca, misalnya:

Sebutkan objek root di Hierarchy dari scene yang sedang terbuka di Unity.

Jika jawabannya sesuai dengan editor, jembatan berfungsi dengan baik. Lalu coba penulisan kecil (buat GameObject kosong sementara lalu hapus) untuk memastikan izin dan pemilihan alat.

FAQ

Add package from disk tidak menemukan package.json?
Pastikan Langkah 1 mengekstrak arsip sepenuhnya dan Anda memilih package.json di root folder tersebut—bukan hasil ekstrak bersarang.

Aktivasi terus gagal?
Periksa bahwa akun atau kode aktivasi Anda valid, belum kedaluwarsa, dan terkait dengan email yang benar, lalu coba lagi di Mcp Panel.

Layanan sudah dijalankan tetapi tidak Running?
Pastikan port 6589 (atau port kustom Anda) bebas dan localhost tidak diblokir. Pastikan aktivasi Langkah 3 berhasil.

Claude CLI tidak menampilkan unity-mcp?
Pastikan Unity masih menampilkan Running; kembali ke Quick setup, salin perintah CLI lagi, dan jalankan sepenuhnya di terminal. Pastikan Anda memilih Claude CLI, bukan Cursor. Untuk Gemini CLI, pilih Gemini CLI dan salin perintah klien tersebut.

Langkah selanjutnya

• Coba kueri scene dengan bahasa alami atau edit kecil untuk mempelajari batas alat
• Commit sebelum perubahan besar; pertahankan jembatan hanya di localhost
• Pola prompt setelah terhubung: Unity MCP dengan Claude Code dan Cursor