Il server Studio MCP può chiamare le API Open Cloud per tuo conto. Il tuo client MCP può caricare asset, gestire prodotti per sviluppatori e pass di gioco, modificare le impostazioni del gioco e altro ancora senza creare o incollare una chiave API.
Decidi tu cosa è consentito fare al tuo client. Le autorizzazioni vengono salvate sul tuo account Roblox per ogni gioco e Studio le applica a ogni richiesta.
Requisiti
Prima di utilizzare Open Cloud con il server Studio MCP:
- Abilita il server Studio MCP e collega il tuo client. Per ulteriori informazioni, consulta Collegati al server Studio MCP di Roblox.
- Apri un luogo che appartiene a un gioco pubblicato. Le autorizzazioni vengono salvate per gioco, quindi i luoghi locali non pubblicati non possono utilizzarle.
- Avere il permesso di gestire il gioco. Se un gruppo possiede il gioco, il tuo ruolo di gruppo deve consentire le azioni che concedi al client.
Come funziona
Il server Studio MCP aggiunge lo strumento open_cloud_invoke. Studio gestisce l'accesso per te. Il tuo client può utilizzare solo gli ambiti che hai abilitato per il gioco corrente e non vede né gestisce mai le credenziali. Solo tu puoi modificare le tue autorizzazioni. Il tuo client non può abilitarle da solo.
Per ogni gioco, controlli quali ambiti Open Cloud il tuo client può chiamare, quali cartelle può caricare, se le chiamate al data store e al memory store funzionano da execute_luau, e se gli script possono effettuare richieste HTTP e a quali domini.
| Parametro | Descrizione |
|---|---|
| method | GET, POST, PUT, PATCH o DELETE. |
| endpoint | Il percorso sotto https://apis.roblox.com,incluso qualsiasi stringa di query. Ad esempio,/cloud/v2/universes/123`. |
| body | Un corpo di richiesta codificato in JSON. Ometti per GET e DELETE. |
| scopes | Gli ambiti richiesti dall'endpoint, come ["universe:read"]. Facoltativo, ma restituisce un errore chiaro se un ambito richiesto non è abilitato. |
| files | File locali per endpoint multipart/form-data, come i caricamenti di asset. I file devono trovarsi in una cartella di caricamento approvata. |
Gestire le autorizzazioni
Per gestire le autorizzazioni per il gioco che hai aperto, fai clic su MCP nell'angolo in basso a destra di Studio, quindi seleziona la scheda Autorizzazioni MCP. Oppure, da Assistant:
- Apri Assistant.
- Fai clic su … ⟩ Impostazioni.
- Seleziona la scheda Autorizzazioni MCP.
- Abilita o disabilita le autorizzazioni. Le modifiche si applicano alla prossima richiesta del tuo client.
Livelli di accesso
Scegli un livello di accesso come punto di partenza, quindi abilita o disabilita autorizzazioni individuali. Ogni gioco inizia con Bilanciato.
| Livello di accesso | Cosa attiva |
|---|---|
| Sicuro | Solo ambiti a basso rischio. La maggior parte delle autorizzazioni è disattivata. |
| Bilanciato | Ambiti a basso e moderato rischio. |
| Accesso completo | Tutti gli ambiti, inclusi quelli ad alto rischio che possono costare Robux, influenzare i tuoi giocatori o pubblicare nel tuo gioco live. |
| Personalizzato | Mostrato quando cambi qualsiasi autorizzazione dopo aver scelto un livello. |
Roblox imposta il livello di rischio per ogni ambito.
Sezioni delle autorizzazioni
Le autorizzazioni sono raggruppate in base a ciò che consentono al tuo client di fare. Ogni sezione corrisponde a uno o più ambiti Open Cloud o capacità degli script. Per dettagli su ciascun ambito, consulta il riferimento agli ambiti Open Cloud.
| Sezione | Cosa consente | Ambiti |
|---|---|---|
| Guarda il tuo gioco | Leggi le impostazioni del gioco e del luogo, la cronologia delle versioni, le analisi e le istanze. | universe:read, universe.place:read, universe.analytics:read, universe.place.instance:read |
| Modifica il tuo gioco | Cambia le impostazioni del gioco e del luogo, pubblica, riavvia i server e modifica le istanze da remoto. | universe:write, universe.place:write, universe.place.instance:write |
| Giocatori e sociale | Leggi profili e inventari, invia notifiche, gestisci gruppi e forum, gestisci eventi e leggi gli oggetti salvati del Creator Store. | user.*, group:*, group-forum:read, universe.event:*, creator-store-save:* |
| Salva e carica dati | Utilizza DataStoreService e MemoryStoreService da execute_luau. | universe-datastores.*, universe.ordered-data-store.*, memory-store.* |
| Collegati a Internet | Effettua richieste HTTP da Luau ai domini che consenti e pubblica messaggi tra server. | Capacità Network, universe-messaging-service:publish |
| Pubblica e gestisci asset | Carica asset e controlla il loro stato, condividi asset, gestisci le inserzioni del Creator Store, pubblica versioni di luoghi e gestisci miniature. | asset:*, asset-permissions:write, creator-store-product:*, universe-places:write, universe.thumbnail:* |
| Denaro e monetizzazione | Crea e modifica prodotti per sviluppatori, pass di gioco e campagne pubblicitarie, e leggi abbonamenti. | developer-product:*, game-pass:*, ad.campaign:*, ad.billing:read, universe.subscription-product.subscription:read |
| Conseguenze per i giocatori | Leggi, crea e rimuovi divieti. | universe.user-restriction:* |
| Sicurezza e credenziali | Leggi nomi segreti e crea segreti, ed esegui Luau nel cloud. | universe.secret:*, universe.place.luau-execution-session:* |
Cartelle di caricamento
Il tuo client può caricare file solo da cartelle che approvi. Aggiungi una cartella prima di chiedere al tuo client di caricare asset e mantieni le esportazioni lì.
Il client non può copiare o spostare file in una cartella approvata per bypassare questa restrizione. Se un file si trova altrove, spostalo tu stesso o approva la sua cartella.
Data store e memory store
Il tuo client accede ai data store e ai memory store tramite DataStoreService e MemoryStoreService in execute_luau, non tramite Open Cloud. Per utilizzarli:
- Abilita gli ambiti di cui hai bisogno sotto Salva e carica dati. Le letture richiedono universe-datastores.objects:read. Le scritture richiedono universe-datastores.objects:update.
- In Impostazioni di gioco ⟩ Sicurezza, abilita Abilita accesso Studio ai servizi API. Questa impostazione di gioco è separata dalle tue autorizzazioni MCP.
Richieste HTTP
Per consentire agli script eseguiti dal tuo client di effettuare richieste HTTP con HttpService:
- Aggiungi ogni dominio di cui il tuo client ha bisogno all'elenco di autorizzazione dei domini HTTP.
Studio nega le richieste a qualsiasi dominio che non è nell'elenco.
Autorizzazioni non disponibili
Alcuni ambiti non possono essere concessi a un client MCP. Questi includono ambiti di badge, universe-datastores.control:*, universe-datastores.objects:create, avvisi analitici e tutti gli ambiti legacy-*. Usa il Creator Dashboard o una chiave API per questi compiti.
Alcuni endpoint rifiutano anche il token utilizzato da Studio, anche quando l'ambito corrispondente è abilitato. Se ciò accade, il tuo client riporta l'errore e suggerisce un altro modo per completare il compito.
Importa un modello 3D
Importare asset da Blender, Maya o un altro strumento 3D è un flusso di lavoro comune. Il tuo client esporta il modello, lo carica, lo inserisce e poi confronta il risultato con la fonte e corregge ciò che l'importazione ha cambiato.
Per importare un modello:
Abilita Pubblica e gestisci asset ⟩ asset:read e asset:write.
Approva la cartella in cui vanno le tue esportazioni.
Apri il modello nel tuo strumento 3D, oppure esportalo come .glb o .fbx nella cartella approvata.
Chiedi al tuo client. Ad esempio:
Importa il castello dal mio file Blender aperto in Studio, accanto al punto di spawn.
L'abilità di importazione dice al tuo client di confermare prima di caricare. Poi:
- Controlla ogni mesh rispetto al limite di triangoli e chiede se dividere o semplificare quelle che lo superano.
- Carica il modello e attende la moderazione.
- Inserisce il modello e corregge scala, rotazione, texture mancanti, colori e ancoraggio.
- Posiziona il modello a terra, lontano da altri oggetti e punti di spawn.
Per i tipi di asset supportati, formati e limiti di dimensione, consulta la Guida all'uso degli asset.
Abilità
Le seguenti abilità insegnano al tuo client come utilizzare queste autorizzazioni. I client connessi tramite MCP le ottengono automaticamente e le caricano con lo strumento skill. Per visualizzarle, apri Assistant, fai clic su … ⟩ Impostazioni Assistant, quindi seleziona Abilità. Per adattarne una al tuo flusso di lavoro, selezionala e fai clic su Duplica, quindi modifica la tua copia. La tua copia sostituisce l'originale, ma non riceve aggiornamenti futuri.
| Abilità | Descrizione |
|---|---|
| rbx-open-cloud-usage | Chiama Open Cloud con open_cloud_invoke, seleziona l'endpoint corretto e gestisce gli errori. |
| rbx-permissions | Determina quali autorizzazioni un compito richiede, controlla quali sono abilitate e ti chiede solo quelle mancanti. |
| rbx-import-asset | Importa un modello da uno strumento 3D esterno, quindi controlla e corregge in Studio. |
Risoluzione dei problemi
Quando una richiesta viene bloccata, il client riporta cosa manca. Non bypassa mai un'autorizzazione che hai disabilitato.
| Errore | Cause | Correzione |
|---|---|---|
| Scope '<scope>' has not been granted | L'ambito è disabilitato o il nome è scritto in modo errato. | Abilita l'ambito nella sezione corrispondente. |
| HTTP 403 o 401, con l'ambito abilitato | L'endpoint non accetta il token MCP. | Usa il Creator Dashboard o una chiave API per questo compito. |
| lacking capability <capability> | Uno script ha bisogno di una capacità che non è concessa. | Abilita Collegati a Internet per Network. Altre capacità non possono essere concesse. |
| domain <domain> is not in the Assistant HTTP allowlist | Il dominio non è nella tua lista di autorizzazione. | Aggiungilo sotto Collegati a Internet ⟩ Elenco di autorizzazione dei domini HTTP. |
| 502 … Access forbidden da una chiamata al data store | L'ambito corrispondente Salva e carica dati è disabilitato. | Abilita l'ambito di lettura o aggiornamento. |
| Studio access to APIs is not allowed | L'accesso API di Studio è disabilitato per questo gioco. | Abilita Impostazioni di gioco ⟩ Sicurezza ⟩ Abilita accesso Studio ai servizi API. |
| InternalError da una chiamata al memory store | Gli ambiti memory-store.* sono disabilitati. | Abilita gli ambiti del memory store sotto Salva e carica dati. |
| File non in una directory di caricamento approvata | Il file si trova al di fuori delle tue cartelle approvate. | Approva la cartella o sposta il file in una di esse. |