Server MCP Roblox Studio terintegrasi ke dalam Roblox Studio. Ini menerapkan Model Context Protocol (MCP), sebuah standar terbuka yang memungkinkan alat AI berkomunikasi dengan aplikasi eksternal secara aman. Setelah terhubung, klien AI Anda dapat berinteraksi langsung dengan sesi Studio yang terbuka, menjelajahi model data, menulis skrip, menjalankan kode Luau, dan menguji permainan Anda dalam mode bermain.
Panduan ini menunjukkan cara menghubungkan server MCP Studio ke klien AI populer. Meskipun pengaturannya bervariasi tergantung klien, ide dasarnya tetap sama: Anda mengonfigurasi klien Anda untuk terhubung ke server MCP dan kemudian mengirim perintah dari klien ke sesi Studio aktif Anda.
Untuk memanggil API Open Cloud dari klien MCP Anda tanpa kunci API, lihat Gunakan Open Cloud dengan server MCP Studio.
Prasyarat
Sebelum Anda dapat terhubung ke server, pastikan Anda memiliki versi terbaru dari Roblox Studio dan klien MCP pilihan Anda terinstal di komputer Anda.
Cara kerja server MCP Studio
Server berjalan sebagai proses lokal di mesin Anda dan berkomunikasi dengan klien AI menggunakan stdio transport, yang menggunakan aliran input/output standar. Semua tindakan dimulai melalui klien AI Anda, yang kemudian mengirim permintaan melalui saluran ini untuk melakukan tindakan di dalam sesi Studio Anda.
Server menyediakan alat berikut:
| Skrip | |
|---|---|
| script_read | Membaca skrip dari permainan menggunakan jalur notasi titik (misalnya, game.ServerScriptService.MyScript). Mendukung pembacaan seluruh skrip atau rentang baris tertentu. |
| multi_edit | Menerapkan beberapa pengeditan pada skrip dalam satu operasi. Jika jalur target tidak ada, maka akan membuat skrip baru. Memerlukan penentuan datamodel_type (Edit). |
| script_search | Mencari skrip berdasarkan nama menggunakan pencocokan fuzzy. Mengembalikan hingga 10 hasil. |
| script_grep | Mencari pola string di semua skrip dalam permainan. Mengembalikan hingga 50 kecocokan. |
| Generasi aset dan konten | |
| generate_animation | Menghasilkan animasi R15 dari prompt teks, atau mengonversi animasi R6 yang ada ke R15 dari ID asetnya. Mendukung penargetan rig tertentu dan pengaturan durasi hingga 10 detik. |
| generate_mesh | Menghasilkan mesh 3D berpola dari prompt teks menggunakan AI. |
| generate_material | Menghasilkan varian material kustom. Mengembalikan material dasar dan nama varian material untuk diterapkan pada bagian. |
| generate_procedural_model | Membuat objek 3D yang dibangun dari bagian primitif (blok, bola, silinder, baji) sebagai ProceduralModel dengan atribut yang dapat dikonfigurasi. Mendukung gambar referensi dan skema bagian kustom. |
| wait_job_finished | Menunggu pekerjaan generasi model prosedural selesai dan mengembalikan status akhir. |
| generate_avatar | Menghasilkan avatar R15 baru yang dirigging dan dapat dianimasikan (tubuh, kepala, dan pakaian) dari prompt teks. |
| search_asset | Mencari aset di seluruh Toko Creator (pasar publik) dan Inventaris Creator (pengguna, grup, atau alam semesta). Mendukung penyaringan berdasarkan jenis aset, harga, tag, dan cakupan. |
| insert_asset | Menyisipkan aset ke dalam permainan berdasarkan ID aset Roblox numeriknya. Mendukung model, mesh, gambar, audio, video, animasi, dan paket. |
| upload_image | Mengunggah sekumpulan gambar dari URL HTTP ke server aset Roblox, mengembalikan peta jalur gambar ke ID aset. |
| store_image | Memuat gambar dari jalur file lokal dan mengembalikan URI gambar yang dapat diteruskan ke alat lain (misalnya, sebagai gambar referensi untuk generate_procedural_model). |
| Eksplorasi model data | |
| subagent | Meluncurkan subagen khusus untuk menangani tugas kompleks dan multi-langkah secara mandiri. Tipe yang tersedia termasuk explore (untuk penyelidikan basis kode dan kueri status permainan) dan playtest (untuk menjalankan skenario gameplay dan memverifikasi hasil). |
| search_game_tree | Menjelajahi hierarki instance sebagai array JSON datar. Mendukung penyaringan berdasarkan jalur, jenis instance, dan kata kunci, dengan pembatasan kedalaman yang dapat dikonfigurasi. |
| inspect_instance | Mengembalikan informasi rinci tentang instance tertentu, termasuk semua properti yang dapat dibaca, atribut kustom, dan ringkasan anak-anak dan keturunannya. |
| Eksekusi Luau | |
| execute_luau | Menjalankan kode Luau di Studio. Mengembalikan hasil atau kesalahan. Memerlukan penentuan datamodel_type (Edit, Client, atau Server). |
| Uji coba bermain | |
| get_studio_state | Mendapatkan status saat ini dari Studio, termasuk status bermain dan jenis datamodel yang tersedia. |
| start_stop_play | Memulai atau menghentikan uji coba bermain. |
| get_console_output | Mengambil output dari log output Studio. |
| screen_capture | Menangkap viewport Studio saat ini dan mengembalikan data gambar. Secara opsional menerima posisi kamera kustom dan target pandangan. |
| Simulasi input pemain | |
| character_navigation | Memindahkan karakter pemain ke posisi atau jalur instance yang diberikan. Mendukung pengali kecepatan yang dapat dikonfigurasi. |
| user_keyboard_input | Mengirim satu atau lebih tindakan keyboard secara berurutan: tombol ditekan, tombol dilepaskan, tekan tombol, input teks, atau tunggu. Mendukung penargetan instance UI tertentu. |
| user_mouse_input | Mengirim satu atau lebih tindakan mouse secara berurutan: gerakan, klik, tombol ditekan/dilepaskan, gulir, atau tunggu. Mendukung penargetan instance tertentu atau koordinat layar. |
| Dokumentasi dan keterampilan | |
| http_get | Mengambil konten dari URL dokumentasi Roblox yang diizinkan (referensi API Engine, dokumen Creator, API Cloud, panduan optimasi kinerja). Mendukung pencarian kata kunci dalam konten yang diambil. |
| skill | Mendapatkan pengetahuan rinci, praktik terbaik, atau materi referensi untuk keterampilan tertentu seperti debugging, simulasi perangkat, dan pencarian dokumentasi. |
| Manajemen tempat | |
| save_place | Menyimpan tempat yang terbuka dengan cara yang sama seperti File ⟩ Simpan: sebagai versi tempat baru untuk tempat yang dibuka dari Roblox, atau kembali ke file untuk tempat lokal .rbx dan .rbxlx. Tidak membuka dialog apa pun. |
| Manajemen sesi | |
| list_roblox_studios | Menampilkan semua instance Studio yang terhubung, termasuk nama, ID instance Studio, dan ID tempat. Tempat lokal yang tidak memiliki ID tempat hanya ditampilkan berdasarkan nama. Berguna ketika beberapa jendela Studio terbuka; jika dua instance Studio terbuka memiliki nama yang sama, ID tempat memungkinkan Anda untuk membedakannya. |
| Umpan balik | |
| submit_feedback | Mengirim umpan balik ke Roblox ketika alat gagal, kemampuan hilang, atau alur kerja di Studio memerlukan lebih banyak langkah daripada seharusnya, sehingga tim dapat meningkatkan Studio dan alat MCP-nya. |
Automasi uji coba bermain bekerja di seluruh teleportasi. Selama uji coba bermain, agen dapat teleport pemain ke tempat lain dalam pengalaman yang sama, membaca output server tujuan, dan memperbaiki masalah yang ditemukan, semua tanpa menerbitkan. Untuk metode teleportasi yang didukung dan batasan pengujian, lihat Uji teleportasi di Studio.
Aktifkan server MCP di Studio
Untuk mengaktifkan server MCP di Studio:
- Buka Asisten.
- Klik … ⟩ Kelola Server MCP.
- Aktifkan Aktifkan Studio sebagai server MCP.
Setelah diaktifkan, panel pengaturan menampilkan opsi koneksi cepat dan instruksi pengaturan untuk klien yang berbeda. Ketika klien terhubung dengan sukses, indikator hijau menunjukkan jumlah klien yang terhubung.
Hubungkan klien Anda
Anda dapat menghubungkan klien Anda ke server MCP Studio menggunakan koneksi cepat, konfigurasi JSON, atau perintah CLI.
- Gunakan koneksi cepat jika klien Anda didukung.
- Jika tidak, gunakan konfigurasi JSON jika klien Anda mendukung file konfigurasi MCP.
- Jika tidak, gunakan perintah CLI.
Server MCP Studio bekerja dengan klien mana pun yang mendukung transportasi stdio. Setelah menambahkan konfigurasi, ikuti dokumentasi klien Anda untuk menyelesaikan pengaturan, lalu restart klien untuk menerapkan perubahan Anda.
Koneksi cepat
Koneksi cepat mendukung klien berikut:
- Antigravity
- Codex CLI
- Claude Code
- Claude Desktop
- Cursor
- Gemini CLI
- Visual Studio Code
Untuk terhubung menggunakan koneksi cepat:
- Pergi ke Pengaturan Asisten ⟩ Server MCP.
- Perluas dropdown Koneksi cepat untuk melihat klien yang didukung yang terinstal di komputer Anda.
- Aktifkan klien yang Anda pilih.
Jika klien yang Anda inginkan tidak muncul dalam daftar Koneksi cepat, instal dan restart Roblox Studio.
Konfigurasi JSON
Sebagian besar klien MCP mendukung file konfigurasi JSON. Contoh berikut menunjukkan konfigurasi lengkap yang dapat Anda gunakan.
Jika Roblox Studio adalah satu-satunya server MCP Anda, gunakan konfigurasi ini apa adanya. Jika Anda menggunakan beberapa server MCP, salin entri Roblox_Studio dan tambahkan ke kamus mcpServers yang ada.
Konfigurasi bervariasi berdasarkan sistem operasi:
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": ["/c", "%LOCALAPPDATA%\\Roblox\\mcp.bat"]
}
}
}{
"mcpServers": {
"Roblox_Studio": {
"command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
}
}
}Perintah CLI
Beberapa klien MCP memerlukan perintah CLI alih-alih konfigurasi JSON. Gunakan perintah yang sesuai untuk sistem operasi Anda:
cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat/Applications/RobloxStudio.app/Contents/MacOS/StudioMCPGunakan beberapa instance Studio
Anda dapat menghubungkan satu klien MCP ke beberapa instance Studio yang berjalan pada saat yang sama. Setiap panggilan alat menyertakan studio_id yang mengidentifikasi instance Studio yang ditargetkan, yang membuat alur kerja dengan beberapa instance Studio dan beberapa agen atau klien menjadi dapat diandalkan.
Gunakan list_roblox_studios untuk menampilkan instance yang terhubung dengan nama, ID instance Studio, dan ID tempat mereka. Kemudian, kirim ID instance yang Anda inginkan sebagai studio_id pada panggilan berikutnya.
Verifikasi koneksi Anda
Setelah mengatur klien Anda, verifikasi bahwa koneksi berfungsi di Roblox Studio:
- Buka Asisten.
- Klik … ⟩ Kelola Server MCP.
- Di bawah Aktifkan Studio sebagai server MCP, periksa indikator hijau untuk mengonfirmasi bahwa klien telah terhubung dengan sukses.
Pemecahan masalah
Jika server tidak muncul, atau alat tidak tersedia:
- Restart baik Roblox Studio maupun klien MCP Anda.
- Verifikasi bahwa jalur perintah atau biner benar dan file tersebut ada.
- Periksa sintaks JSON Anda. Bahkan koma atau kurung yang hilang dapat mencegah konfigurasi dimuat.