Gunakan Open Cloud dengan server Studio MCP

*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

Server Studio MCP dapat memanggil API Open Cloud atas nama Anda. Klien MCP Anda dapat mengunggah aset, mengelola produk pengembang dan game passes, mengubah pengaturan game, dan banyak lagi tanpa membuat atau menempelkan kunci API.

Anda memutuskan apa yang diizinkan untuk dilakukan klien Anda. Izin disimpan di akun Roblox Anda untuk setiap game, dan Studio menegakkannya pada setiap permintaan.

Prasyarat

Sebelum Anda menggunakan Open Cloud dengan server Studio MCP:

  • Aktifkan server Studio MCP dan sambungkan klien Anda. Untuk informasi lebih lanjut, lihat Sambungkan ke server Studio MCP Roblox.
  • Buka tempat yang termasuk dalam game yang diterbitkan. Izin disimpan per game, jadi tempat lokal yang belum diterbitkan tidak dapat menggunakannya.
  • Memiliki izin untuk mengelola game. Jika sebuah grup memiliki game, peran grup Anda harus mengizinkan tindakan yang Anda berikan kepada klien.

Cara kerjanya

Server Studio MCP menambahkan alat open_cloud_invoke. Studio mengelola akses untuk Anda. Klien Anda hanya dapat menggunakan ruang lingkup yang telah Anda aktifkan untuk game saat ini, dan tidak pernah melihat atau menangani kredensial. Hanya Anda yang dapat mengubah izin Anda. Klien Anda tidak dapat mengaktifkannya sendiri.

Untuk setiap game, Anda mengontrol ruang lingkup Open Cloud mana yang dapat dipanggil klien Anda, folder mana yang dapat diunggah, apakah panggilan data store dan memory store berfungsi dari execute_luau, dan apakah skrip dapat membuat permintaan HTTP dan ke domain mana.

ParameterDeskripsi
methodGET, POST, PUT, PATCH, atau DELETE.
endpointJalur di bawah https://apis.roblox.com,termasuk string kueri apa pun. Misalnya,/cloud/v2/universes/123`.
bodyBody permintaan yang dikodekan dalam JSON. Hilangkan untuk GET dan DELETE.
scopesRuang lingkup yang diperlukan oleh endpoint, seperti ["universe:read"]. Opsional, tetapi mengembalikan kesalahan yang jelas jika ruang lingkup yang diperlukan tidak diaktifkan.
filesFile lokal untuk endpoint multipart/form-data, seperti unggahan aset. File harus berada di folder unggah yang disetujui.

Mengelola izin

Untuk mengelola izin untuk game yang Anda buka, klik MCP di sudut kanan bawah Studio, lalu pilih tab Izin MCP. Atau, dari Assistant:

  1. Buka Assistant.
  2. Klik … ⟩ Pengaturan.
  3. Pilih tab Izin MCP.
  4. Aktifkan atau nonaktifkan izin. Perubahan berlaku untuk permintaan klien Anda berikutnya.

Tingkat akses

Pilih tingkat akses sebagai titik awal, lalu aktifkan atau nonaktifkan izin individu. Setiap game dimulai pada Seimbang.

Tingkat aksesApa yang diaktifkan
AmanHanya ruang lingkup risiko rendah. Sebagian besar izin dimatikan.
SeimbangRuang lingkup risiko rendah dan sedang.
Akses penuhSemua ruang lingkup, termasuk yang berisiko tinggi yang dapat menghabiskan Robux, mempengaruhi pemain Anda, atau menerbitkan ke game langsung Anda.
KustomDitampilkan saat Anda mengubah izin apa pun setelah memilih tingkat.

Roblox menetapkan tingkat risiko untuk setiap ruang lingkup.

Bagian izin

Izin dikelompokkan berdasarkan apa yang diizinkan untuk dilakukan klien Anda. Setiap bagian dipetakan ke satu atau lebih ruang lingkup Open Cloud atau kemampuan skrip. Untuk detail tentang setiap ruang lingkup, lihat referensi Ruang Lingkup Open Cloud.

BagianApa yang diizinkanRuang lingkup
Lihat game AndaMembaca pengaturan game dan tempat, riwayat versi, analitik, dan instance.universe:read, universe.place:read, universe.analytics:read, universe.place.instance:read
Edit game AndaMengubah pengaturan game dan tempat, menerbitkan, memulai ulang server, dan mengedit instance dari jarak jauh.universe:write, universe.place:write, universe.place.instance:write
Pemain & sosialMembaca profil dan inventaris, mengirim notifikasi, mengelola grup dan forum, mengelola acara, dan membaca item Creator Store yang disimpan.user.*, group:*, group-forum:read, universe.event:*, creator-store-save:*
Simpan & muat dataGunakan DataStoreService dan MemoryStoreService dari execute_luau.universe-datastores.*, universe.ordered-data-store.*, memory-store.*
Sambungkan ke internetMembuat permintaan HTTP dari Luau ke domain yang Anda izinkan, dan menerbitkan pesan lintas server.kemampuan Network, universe-messaging-service:publish
Terbitkan & kelola asetMengunggah aset dan memeriksa statusnya, membagikan aset, mengelola daftar Creator Store, menerbitkan versi tempat, dan mengelola thumbnail.asset:*, asset-permissions:write, creator-store-product:*, universe-places:write, universe.thumbnail:*
Uang & monetisasiMembuat dan mengedit produk pengembang, game passes, dan kampanye iklan, serta membaca langganan.developer-product:*, game-pass:*, ad.campaign:*, ad.billing:read, universe.subscription-product.subscription:read
Konsekuensi pemainMembaca, membuat, dan menghapus larangan.universe.user-restriction:*
Keamanan & kredensialMembaca nama rahasia dan membuat rahasia, serta menjalankan Luau di cloud.universe.secret:*, universe.place.luau-execution-session:*

Folder unggah

Klien Anda hanya dapat mengunggah file dari folder yang Anda setujui. Tambahkan folder sebelum meminta klien Anda untuk mengunggah aset, dan simpan ekspor di sana.

Klien tidak dapat menyalin atau memindahkan file ke dalam folder yang disetujui untuk menghindari pembatasan ini. Jika file berada di tempat lain, pindahkan sendiri atau setujui foldernya.

Data stores dan memory stores

Klien Anda mengakses data stores dan memory stores melalui DataStoreService dan MemoryStoreService di execute_luau, bukan melalui Open Cloud. Untuk menggunakannya:

  1. Aktifkan ruang lingkup yang Anda butuhkan di bawah Simpan & muat data. Pembacaan memerlukan universe-datastores.objects:read. Penulisan memerlukan universe-datastores.objects:update.
  2. Di Pengaturan Game ⟩ Keamanan, aktifkan Aktifkan Akses Studio ke Layanan API. Pengaturan game ini terpisah dari izin MCP Anda.

Permintaan HTTP

Untuk membiarkan skrip yang dijalankan klien Anda membuat permintaan HTTP dengan HttpService:

  1. Aktifkan Sambungkan ke internet. Ini memberikan kemampuan Network skrip.
  2. Tambahkan setiap domain yang dibutuhkan klien Anda ke daftar izin domain HTTP.

Studio menolak permintaan ke domain mana pun yang tidak ada dalam daftar.

Izin yang tidak tersedia

Beberapa ruang lingkup tidak dapat diberikan kepada klien MCP. Ini termasuk ruang lingkup lencana, universe-datastores.control:*, universe-datastores.objects:create, peringatan analitik, dan semua ruang lingkup legacy-*. Gunakan Dasbor Kreator atau kunci API untuk tugas ini.

Beberapa endpoint juga menolak token yang digunakan Studio, bahkan ketika ruang lingkup yang cocok diaktifkan. Jika itu terjadi, klien Anda melaporkan kesalahan dan menyarankan cara lain untuk menyelesaikan tugas.

Impor model 3D

Mengimpor aset dari Blender, Maya, atau alat 3D lainnya adalah alur kerja yang umum. Klien Anda mengekspor model, mengunggahnya, menyisipkannya, lalu membandingkan hasilnya dengan sumber dan memperbaiki apa yang diubah oleh impor.

Untuk mengimpor model:

  1. Aktifkan Terbitkan & kelola aset ⟩ asset:read dan asset:write.

  2. Setujui folder tempat ekspor Anda masuk.

  3. Buka model di alat 3D Anda, atau ekspor sebagai .glb atau .fbx ke dalam folder yang disetujui.

  4. Arahkan klien Anda. Misalnya:

    Impor kastil dari file Blender saya yang terbuka ke dalam Studio, di samping titik spawn.

Keterampilan impor memberi tahu klien Anda untuk mengonfirmasi sebelum mengunggah. Kemudian:

  • Memeriksa setiap mesh terhadap batas segitiga, dan bertanya apakah akan membagi atau menyederhanakan yang melebihi batas tersebut.
  • Mengunggah model dan menunggu moderasi.
  • Menyisipkan model dan memperbaiki skala, rotasi, tekstur yang hilang, warna, dan penempatan.
  • Menempatkan model di tanah, jauh dari objek lain dan titik spawn.

Untuk jenis aset yang didukung, format, dan batas ukuran, lihat Panduan penggunaan untuk aset.

Keterampilan

Keterampilan berikut mengajarkan klien Anda cara menggunakan izin ini. Klien yang terhubung melalui MCP mendapatkannya secara otomatis dan memuatnya dengan alat skill. Untuk melihatnya, buka Assistant, klik … ⟩ Pengaturan Assistant, lalu pilih Keterampilan. Untuk menyesuaikan salah satu dengan alur kerja Anda, pilih dan klik Duplikat, lalu edit salinan Anda. Salinan Anda menggantikan yang asli, tetapi tidak menerima pembaruan di masa mendatang.

KeterampilanDeskripsi
rbx-open-cloud-usageMemanggil Open Cloud dengan open_cloud_invoke, memilih endpoint yang benar, dan menangani kesalahan.
rbx-permissionsMenentukan izin apa yang dibutuhkan suatu tugas, memeriksa mana yang diaktifkan, dan meminta Anda hanya untuk yang hilang.
rbx-import-assetMengimpor model dari alat 3D eksternal, lalu memeriksa dan memperbaikinya di Studio.

Pemecahan masalah

Ketika permintaan diblokir, klien melaporkan apa yang hilang. Klien tidak pernah melewati izin yang telah Anda nonaktifkan.

KesalahanPenyebabPerbaikan
Scope '<scope>' has not been grantedRuang lingkup dinonaktifkan, atau namanya salah ketik.Aktifkan ruang lingkup di bagian yang cocok.
HTTP 403 atau 401, dengan ruang lingkup diaktifkanEndpoint tidak menerima token MCP.Gunakan Dasbor Kreator atau kunci API untuk tugas ini.
lacking capability <capability>Skrip membutuhkan kemampuan yang tidak diberikan.Aktifkan Sambungkan ke internet untuk Network. Kemampuan lain tidak dapat diberikan.
domain <domain> is not in the Assistant HTTP allowlistDomain tidak ada dalam daftar izin Anda.Tambahkan di bawah Sambungkan ke internet ⟩ daftar izin domain HTTP.
502 … Access forbidden dari panggilan data storeRuang lingkup Simpan & muat data yang cocok dinonaktifkan.Aktifkan ruang lingkup baca atau pembaruan.
Studio access to APIs is not allowedAkses API Studio dinonaktifkan untuk game ini.Aktifkan Pengaturan Game ⟩ Keamanan ⟩ Aktifkan Akses Studio ke Layanan API.
InternalError dari panggilan memory storeRuang lingkup memory-store.* dinonaktifkan.Aktifkan ruang lingkup memory store di bawah Simpan & muat data.
File tidak ada di direktori unggah yang disetujuiFile berada di luar folder yang disetujui.Setujui folder, atau pindahkan file ke dalam salah satu.
©2026 Roblox Corporation. Roblox, logo Roblox, dan Powering Imagination termasuk dalam merek dagang kami yang terdaftar dan tidak terdaftar di AS dan negara lainnya.