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.
| Parameter | Deskripsi |
|---|---|
| method | GET, POST, PUT, PATCH, atau DELETE. |
| endpoint | Jalur di bawah https://apis.roblox.com,termasuk string kueri apa pun. Misalnya,/cloud/v2/universes/123`. |
| body | Body permintaan yang dikodekan dalam JSON. Hilangkan untuk GET dan DELETE. |
| scopes | Ruang lingkup yang diperlukan oleh endpoint, seperti ["universe:read"]. Opsional, tetapi mengembalikan kesalahan yang jelas jika ruang lingkup yang diperlukan tidak diaktifkan. |
| files | File 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:
- Buka Assistant.
- Klik … ⟩ Pengaturan.
- Pilih tab Izin MCP.
- 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 akses | Apa yang diaktifkan |
|---|---|
| Aman | Hanya ruang lingkup risiko rendah. Sebagian besar izin dimatikan. |
| Seimbang | Ruang lingkup risiko rendah dan sedang. |
| Akses penuh | Semua ruang lingkup, termasuk yang berisiko tinggi yang dapat menghabiskan Robux, mempengaruhi pemain Anda, atau menerbitkan ke game langsung Anda. |
| Kustom | Ditampilkan 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.
| Bagian | Apa yang diizinkan | Ruang lingkup |
|---|---|---|
| Lihat game Anda | Membaca pengaturan game dan tempat, riwayat versi, analitik, dan instance. | universe:read, universe.place:read, universe.analytics:read, universe.place.instance:read |
| Edit game Anda | Mengubah pengaturan game dan tempat, menerbitkan, memulai ulang server, dan mengedit instance dari jarak jauh. | universe:write, universe.place:write, universe.place.instance:write |
| Pemain & sosial | Membaca 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 data | Gunakan DataStoreService dan MemoryStoreService dari execute_luau. | universe-datastores.*, universe.ordered-data-store.*, memory-store.* |
| Sambungkan ke internet | Membuat permintaan HTTP dari Luau ke domain yang Anda izinkan, dan menerbitkan pesan lintas server. | kemampuan Network, universe-messaging-service:publish |
| Terbitkan & kelola aset | Mengunggah 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 & monetisasi | Membuat 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 pemain | Membaca, membuat, dan menghapus larangan. | universe.user-restriction:* |
| Keamanan & kredensial | Membaca 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:
- Aktifkan ruang lingkup yang Anda butuhkan di bawah Simpan & muat data. Pembacaan memerlukan universe-datastores.objects:read. Penulisan memerlukan universe-datastores.objects:update.
- 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:
- 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:
Aktifkan Terbitkan & kelola aset ⟩ asset:read dan asset:write.
Setujui folder tempat ekspor Anda masuk.
Buka model di alat 3D Anda, atau ekspor sebagai .glb atau .fbx ke dalam folder yang disetujui.
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.
| Keterampilan | Deskripsi |
|---|---|
| rbx-open-cloud-usage | Memanggil Open Cloud dengan open_cloud_invoke, memilih endpoint yang benar, dan menangani kesalahan. |
| rbx-permissions | Menentukan izin apa yang dibutuhkan suatu tugas, memeriksa mana yang diaktifkan, dan meminta Anda hanya untuk yang hilang. |
| rbx-import-asset | Mengimpor 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.
| Kesalahan | Penyebab | Perbaikan |
|---|---|---|
| Scope '<scope>' has not been granted | Ruang lingkup dinonaktifkan, atau namanya salah ketik. | Aktifkan ruang lingkup di bagian yang cocok. |
| HTTP 403 atau 401, dengan ruang lingkup diaktifkan | Endpoint 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 allowlist | Domain tidak ada dalam daftar izin Anda. | Tambahkan di bawah Sambungkan ke internet ⟩ daftar izin domain HTTP. |
| 502 … Access forbidden dari panggilan data store | Ruang lingkup Simpan & muat data yang cocok dinonaktifkan. | Aktifkan ruang lingkup baca atau pembaruan. |
| Studio access to APIs is not allowed | Akses API Studio dinonaktifkan untuk game ini. | Aktifkan Pengaturan Game ⟩ Keamanan ⟩ Aktifkan Akses Studio ke Layanan API. |
| InternalError dari panggilan memory store | Ruang lingkup memory-store.* dinonaktifkan. | Aktifkan ruang lingkup memory store di bawah Simpan & muat data. |
| File tidak ada di direktori unggah yang disetujui | File berada di luar folder yang disetujui. | Setujui folder, atau pindahkan file ke dalam salah satu. |