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 pengalaman Anda dalam mode permainan.

Panduan ini menunjukkan cara menghubungkan server MCP Studio ke klien AI populer. Meskipun pengaturannya bervariasi menurut klien, inti ideanya 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 yang terpasang 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 membaca seluruh skrip atau rentang baris tertentu.
multi_edit	Menerapkan beberapa penyuntingan pada skrip dalam satu operasi. Jika jalur target tidak ada, ini akan membuat skrip baru. Memerlukan spesifikasi 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 variasi material kustom. Mengembalikan material dasar dan nama variasi 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 hingga pekerjaan pembuatan model prosedural selesai dan mengembalikan status akhir.
search_asset	Mencari aset di seluruh Creator Store (pasar publik) dan Inventaris Kreator (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	Diunggah sejumlah 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, multi-langkah secara otomatis. Tipe yang tersedia termasuk explore (untuk penyelidikan basis kode dan kueri status permainan) dan playtest (untuk menjalankan skenario permainan 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 dari anak-anak dan keturunannya.
Eksekusi Luau
execute_luau	Menjalankan kode Luau di Studio. Mengembalikan baik hasil atau kesalahan. Memerlukan spesifikasi datamodel_type (Edit, Client, atau Server).
Pengujian permainan
get_studio_state	Mendapatkan status terkini dari Studio, termasuk status permainan dan jenis datamodel yang tersedia.
start_stop_play	Memulai atau menghentikan pengujian permainan.
get_console_output	Mendapatkan keluaran dari log keluaran Studio.
screen_capture	Menangkap tampilan viewport Studio saat ini dan mengembalikan data gambar. Secara opsional menerima posisi kamera kustom dan target lihat.
Simulasi input pemain
character_navigation	Memindahkan karakter pemain ke posisi atau jalur instance tertentu. Mendukung pengubah kecepatan yang dapat dikonfigurasi.
user_keyboard_input	Mengirim satu atau lebih tindakan keyboard secara berurutan: kunci turun, kunci naik, tekan kunci, 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 Kreator, API Cloud, panduan optimasi kinerja). Mendukung pencarian kata kunci dalam konten yang diambil.
skill	Memperoleh pengetahuan terperinci, praktik terbaik, atau materi referensi untuk keterampilan spesifik 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.

Mengaktifkan server MCP di Studio

Untuk mengaktifkan server MCP di Studio:

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

Setelah diaktifkan, panel pengaturan menampilkan opsi cepat sambungan dan instruksi pengaturan untuk klien yang berbeda. Ketika klien terhubung dengan sukses, indikator hijau menunjukkan jumlah klien yang terhubung.

Menghubungkan klien Anda

Anda dapat menghubungkan klien Anda ke server MCP Studio menggunakan sambungan cepat, konfigurasi JSON, atau perintah CLI.

Gunakan sambungan 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 apa 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 mengubah konten di tempat Roblox Anda yang terbuka. Pastikan untuk hanya menghubungkan klien yang Anda percayai.

Sambungan cepat

Sambungan cepat mendukung klien berikut:

Antigravity
Codex CLI
Claude Code
Claude Desktop
Cursor
Gemini CLI
Visual Studio Code

Untuk terhubung menggunakan sambungan cepat:

Pergi ke Pengaturan Assistant ⟩ Server MCP.
Perluas dropdown Sambungan cepat untuk melihat klien yang didukung yang diinstal di komputer Anda.
Nyalakan klien pilihan Anda.

Jika klien yang Anda inginkan tidak muncul dalam daftar Sambungan cepat, instal dan restart Roblox Studio.

Konfigurasi JSON

Kebanyakan 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 oleh koma. Koma yang hilang akan mengakibatkan JSON tidak valid dan mencegah konfigurasi dimuat.

Konfigurasi bervariasi menurut 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 sebagai ganti 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

Menggunakan beberapa instance Studio

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

Anda dapat secara manual beralih instance menggunakan list_roblox_studios dan set_active_studio.

Memverifikasi sambungan Anda

Setelah mengatur klien Anda, verifikasi bahwa sambungan 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 sudah benar dan file tersebut ada.
Periksa sintaks JSON Anda. Bahkan koma atau tanda kurung yang hilang dapat mencegah konfigurasi dimuat.