Usa Open Cloud con il server Studio MCP

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

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.

ParametroDescrizione
methodGET, POST, PUT, PATCH o DELETE.
endpointIl percorso sotto https://apis.roblox.com,incluso qualsiasi stringa di query. Ad esempio,/cloud/v2/universes/123`.
bodyUn corpo di richiesta codificato in JSON. Ometti per GET e DELETE.
scopesGli ambiti richiesti dall'endpoint, come ["universe:read"]. Facoltativo, ma restituisce un errore chiaro se un ambito richiesto non è abilitato.
filesFile 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:

  1. Apri Assistant.
  2. Fai clic su … ⟩ Impostazioni.
  3. Seleziona la scheda Autorizzazioni MCP.
  4. 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 accessoCosa attiva
SicuroSolo ambiti a basso rischio. La maggior parte delle autorizzazioni è disattivata.
BilanciatoAmbiti a basso e moderato rischio.
Accesso completoTutti gli ambiti, inclusi quelli ad alto rischio che possono costare Robux, influenzare i tuoi giocatori o pubblicare nel tuo gioco live.
PersonalizzatoMostrato 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.

SezioneCosa consenteAmbiti
Guarda il tuo giocoLeggi 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 giocoCambia 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 socialeLeggi 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 datiUtilizza DataStoreService e MemoryStoreService da execute_luau.universe-datastores.*, universe.ordered-data-store.*, memory-store.*
Collegati a InternetEffettua richieste HTTP da Luau ai domini che consenti e pubblica messaggi tra server.Capacità Network, universe-messaging-service:publish
Pubblica e gestisci assetCarica 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 monetizzazioneCrea 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 giocatoriLeggi, crea e rimuovi divieti.universe.user-restriction:*
Sicurezza e credenzialiLeggi 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:

  1. 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.
  2. 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:

  1. Abilita Collegati a Internet. Questo concede la capacità Network script capability.
  2. 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:

  1. Abilita Pubblica e gestisci asset ⟩ asset:read e asset:write.

  2. Approva la cartella in cui vanno le tue esportazioni.

  3. Apri il modello nel tuo strumento 3D, oppure esportalo come .glb o .fbx nella cartella approvata.

  4. 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-usageChiama Open Cloud con open_cloud_invoke, seleziona l'endpoint corretto e gestisce gli errori.
rbx-permissionsDetermina quali autorizzazioni un compito richiede, controlla quali sono abilitate e ti chiede solo quelle mancanti.
rbx-import-assetImporta 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.

ErroreCauseCorrezione
Scope '<scope>' has not been grantedL'ambito è disabilitato o il nome è scritto in modo errato.Abilita l'ambito nella sezione corrispondente.
HTTP 403 o 401, con l'ambito abilitatoL'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 allowlistIl 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 storeL'ambito corrispondente Salva e carica dati è disabilitato.Abilita l'ambito di lettura o aggiornamento.
Studio access to APIs is not allowedL'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 storeGli ambiti memory-store.* sono disabilitati.Abilita gli ambiti del memory store sotto Salva e carica dati.
File non in una directory di caricamento approvataIl file si trova al di fuori delle tue cartelle approvate.Approva la cartella o sposta il file in una di esse.
© 2026 Roblox Corporation. Roblox, il logo Roblox e Powering Imagination sono tra i nostri marchi registrati e non registrati negli Stati Uniti. e altri paesi.