Menghubungkan ke server MCP Roblox Studio | Dokumentasi

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.

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 mengirimkan 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_mesh	Menghasilkan mesh 3D bertekstur 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, wedge) 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.
search_asset	Mencari aset di seluruh Creator Store (pasar publik) dan Creator Inventory (pengguna, grup, atau universe). 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 yang memerlukan beberapa 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 dilepas, 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 turun/naik, gulir, atau tunggu. Mendukung penargetan instance tertentu atau koordinat layar.
Dokumentasi dan keterampilan
http_get	Menarik 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 sesi
list_roblox_studios	Menampilkan semua instance Studio yang terhubung, termasuk nama, ID, dan status aktif mereka. Ini berguna ketika beberapa jendela Studio terbuka.
set_active_studio	Menetapkan instance Studio sebagai aktif sehingga semua panggilan alat berikutnya menargetkan instance tersebut.

Aktifkan server MCP di Studio

Untuk mengaktifkan server MCP di Studio:

Buka Assistant.
Klik … ⟩ Kelola Server MCP.
Aktifkan Aktifkan Studio sebagai server MCP.

Setelah diaktifkan, panel pengaturan menampilkan opsi koneksi cepat dan instruksi pengaturan untuk berbagai klien. 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.

Klien MCP dapat membaca dan memodifikasi konten di tempat Roblox Anda yang terbuka. Pastikan hanya menghubungkan klien yang Anda percayai.

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 Assistant ⟩ 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.

File mcp.json Anda mungkin sudah berisi entri lain. Saat menambahkan konfigurasi Roblox_Studio, pastikan setiap entri dipisahkan dengan koma. Koma yang hilang akan mengakibatkan JSON tidak valid dan mencegah konfigurasi dimuat.

Konfigurasi bervariasi berdasarkan sistem operasi:

Windows

{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "%LOCALAPPDATA%\\Roblox\\mcp.bat"
      ]
    }
  }
}

macOS

{
  "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:

Windows

cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat

macOS

/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP

Gunakan beberapa instance Studio

Anda dapat menghubungkan satu klien MCP ke beberapa instance Studio yang berjalan pada saat yang sama. Server secara otomatis menentukan instance mana yang akan digunakan berdasarkan konteks (misalnya, jika Anda merujuk ke permainan tertentu atau objek yang hanya ada di instance tersebut).

Anda dapat beralih instance secara manual menggunakan list_roblox_studios dan set_active_studio.

Verifikasi koneksi Anda

Setelah mengatur klien Anda, verifikasi bahwa koneksi berfungsi di Roblox Studio:

Buka Assistant.
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.