Guida · IA in Roblox Studio

Come collegare Claude, Cursor o ChatGPT a Roblox Studio con MCP

Roblox Studio ha un server Model Context Protocol (MCP) integrato. Attivalo, collega un client di IA come Claude Code, Claude Desktop o Cursor, e quel client può leggere il tuo gioco, modificare script, eseguire Luau e avviare test nella finestra di Studio che hai aperto. Questa guida segue la documentazione di configurazione di Roblox, dice chiaramente dove non basta (ChatGPT è uno di questi casi) e spiega come tenere al sicuro il tuo gioco mentre un agente ci lavora.

Aggiornato il 26 ottobre 202617 min di letturaScritto da

La risposta breve

In Roblox Studio apri Assistant, clicca su … > Manage MCP Servers e attiva Enable Studio as MCP server. Poi collega il tuo client. Claude Code, Claude Desktop, Cursor, Codex CLI, Gemini CLI, Visual Studio Code e Antigravity hanno ognuno un Quick connect con un solo interruttore in quel pannello. Qualsiasi altro client che supporti stdio può usare la configurazione JSON o il comando documentati da Roblox.

  • Un indicatore verde nello stesso pannello mostra quanti client sono collegati. Se il tuo non compare, riavvia Studio e il client.
  • ChatGPT non è nella lista di Quick connect, e Roblox non documenta nessuna configurazione per ChatGPT. Le strade OpenAI che Roblox documenta sono Codex CLI via MCP (OpenAI offre Sign in with ChatGPT per quello) o una chiave API di OpenAI dentro Assistant. OpenAI documenta anche come aggiungere server locali nell'app desktop di ChatGPT in modalità Codex, che Roblox non include.
  • Un client collegato può modificare script, eseguire Luau, inserire asset e avviare test in qualsiasi gioco che hai aperto. Salva una versione prima e collega solo client di cui ti fidi.
In questa pagina
  1. Cosa fa
  2. 1. Attivare il server
  3. 2. Collegare un client
  4. JSON e CLI
  5. 3. Verificare
  6. ChatGPT
  7. Strumenti
  8. Più finestre
  9. Sicurezza
  10. Script Sync e Git
  11. Problemi
  12. Senza configurazione
  13. Domande frequenti
  14. Fonti e letture

Cosa fa il server MCP di Studio

MCP (Model Context Protocol) è uno standard aperto che permette agli strumenti di IA di parlare con altre applicazioni. Roblox integra un server MCP in Studio. Quando è attivo, un client di IA sul tuo computer può esplorare il gioco che hai aperto, leggere e scrivere script, eseguire Luau e testare il gioco in modalità Play, tutto con gli strumenti che il server espone.

Il server gira come processo locale sulla tua macchina e parla con il client tramite stdio (input e output standard). Niente succede da solo: ogni azione parte come richiesta del tuo client, ed è il client a decidere quale strumento chiamare. Ti servono l'ultima versione di Roblox Studio e il client MCP che vuoi usare, installati tutti e due sullo stesso computer.

Due modi di usare Claude o GPT con Studio

Le due strade documentate da Roblox
Server MCP di StudioAssistant con la tua chiave API
Dove scriviNel tuo client di IA, per esempio Claude Desktop, Claude Code o CursorNel pannello Assistant di Studio
Cosa configuriAttivi il server in Studio e colleghi il clientAssistant > … > Manage API Keys, poi scegli il modello
ModelliQuelli che usa il tuo clientAnthropic, OpenAI o Google Gemini
Cosa ti serveIl client e il suo accessoUna chiave API di quel fornitore
Chi agisce in StudioIl tuo client, con gli strumenti MCPAssistant, con il modello che hai scelto

Questa guida parla della prima strada. Se vuoi solo un modello Claude o OpenAI che risponda dentro Studio, la seconda è più breve: prendi una chiave API dal fornitore, apri Assistant, clicca su … > Manage API Keys, scegli il fornitore, incolla la chiave e seleziona il modello nel menu a tendina Model.

Passo 1: attiva il server MCP in Studio

  1. Apri Roblox Studio e apri un gioco. Se Studio propone un aggiornamento, installalo prima: il server richiede l'ultima versione.
  2. Clicca su Assistant in alto a destra in Studio (il lato destro della barra superiore) per aprire la finestra di Assistant.
  3. Clicca su … e scegli Manage MCP Servers.
  4. Attiva Enable Studio as MCP server.

Il pannello ora mostra un'opzione Quick connect e le istruzioni di configurazione per i vari client. Lascialo aperto. Ti serve per il passo successivo, ed è lì che compare l'indicatore di connessione.

Se manca il pulsante di Assistant o la finestra non si apre, vedi come aprire o riaprire il pannello di Assistant (in inglese).

Passo 2: collega il tuo client di IA

Roblox offre tre modi di collegarsi, in quest'ordine: Quick connect se il tuo client è nella lista, una configurazione JSON se il client legge file di configurazione MCP, e un comando CLI per i client che ne hanno bisogno.

Quick connect

Quick connect supporta sette client (secondo la lista del 30 settembre 2026): Antigravity, Codex CLI, Claude Code, Claude Desktop, Cursor, Gemini CLI e Visual Studio Code.

  1. Nel pannello del passo 1 (Assistant Settings > MCP Servers), espandi Quick connect. Mostra i client compatibili che hai installato.
  2. Attiva il client che vuoi.
  3. Se il tuo client non è nella lista, installalo e riavvia Roblox Studio. Se l'hai installato con Studio aperto, potresti dover riavviare Studio, il client o tutti e due.

Configurazione per client

Cosa documenta Roblox per ogni client, 30 settembre 2026
ClientStradaNote
Claude Desktop (Anthropic)Quick connectL'app desktop. Roblox non descrive l'uso di Claude in un browser web.
Claude Code (Anthropic)Quick connectLa guida al coding harness di Roblox lo usa come estensione di Visual Studio Code, con un account Anthropic.
CursorQuick connectHa il suo assistente di IA integrato. Accedi con il tuo account Cursor.
Visual Studio CodeQuick connectRichiede un'estensione di IA, come Claude Code.
Codex CLI (OpenAI)Quick connectIl client OpenAI della lista di Roblox. La documentazione di Codex di OpenAI offre Sign in with ChatGPT la prima volta che lo avvii.
Gemini CLI (Google)Quick connect
AntigravityQuick connect
Qualsiasi altro client con supporto stdioConfigurazione JSON, o il comando CLIVedi la sezione successiva. Completa la configurazione con la documentazione del client e riavvialo.
ChatGPTNon documentatoNon è nella lista di Quick connect. OpenAI documenta una strada con l'app desktop di ChatGPT in modalità Codex; vedi ChatGPT può collegarsi a Roblox Studio?

La guida al coding harness di Roblox abbina la connessione MCP a un editor: Cursor, oppure Visual Studio Code con un'estensione come Claude Code. Se vuoi che l'agente scriva codice come file oltre a controllare Studio, vedi Script Sync e Git più sotto.

Altri client: configurazione JSON o comando CLI

Il server funziona con qualsiasi client che supporti il trasporto stdio. Se il tuo non ha Quick connect, aggiungi Roblox Studio alla sua configurazione MCP. Queste sono le configurazioni complete documentate da Roblox. Se Roblox Studio è il tuo unico server MCP, usale così come sono.

Configurazione JSON · Windows
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "%LOCALAPPDATA%\\Roblox\\mcp.bat"
      ]
    }
  }
}
Configurazione JSON · macOS
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
    }
  }
}

Dove si trova il file di configurazione dipende dal client (l'esempio di Roblox lo chiama mcp.json). Le istruzioni di Roblox dicono di completare la configurazione con la documentazione del tuo client e poi riavviarlo perché legga la modifica.

Comando CLI

Alcuni client accettano un comando invece di un file di configurazione. Questo è il comando che avvia il server, da registrare come descrive la documentazione del tuo client:

Comando CLI · Windows
cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat
Comando CLI · macOS
/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP

Tutti e due puntano a un file installato da Studio. Su Windows, %LOCALAPPDATA% è la cartella dei dati locali delle applicazioni del tuo utente. Su macOS, il percorso è dentro RobloxStudio.app in /Applications. Se il file non c'è, il client non può avviare il server: vedi Risoluzione dei problemi.

Passo 3: verifica la connessione

  1. In Studio, apri Assistant e clicca su … > Manage MCP Servers.
  2. Sotto Enable Studio as MCP server, cerca l'indicatore verde. Mostra il numero di client collegati.
  3. Nel tuo client, inizia con una richiesta che legge soltanto, così una configurazione sbagliata non può cambiare niente. Per esempio: Usando gli strumenti MCP di Roblox Studio, elenca cosa c'è in Workspace. Non cambiare niente.

In un Baseplate nuovo, la risposta dovrebbe includere gli oggetti predefiniti Camera, Terrain, Baseplate e SpawnLocation. Il tuo client potrebbe chiederti di approvare la chiamata allo strumento, o offrirti di aggiungerlo a una lista di consentiti. Approvarla una volta basta per questa prova.

ChatGPT può collegarsi a Roblox Studio?

ChatGPT in un browser web no: il server MCP di Studio è un programma locale, e OpenAI dice che ChatGPT sul web non legge i file di configurazione locali di Codex. La strada documentata da Roblox è Codex CLI, a cui puoi accedere con il tuo account ChatGPT. All'11 ottobre 2026, la pagina MCP di Roblox non descrive nessuna configurazione per ChatGPT, e ChatGPT non è nella lista di Quick connect. Ecco cosa copre ogni strada.

  • Documentato da Roblox: Codex CLI, l'agente di programmazione da riga di comando di OpenAI, è un client di Quick connect. Configuralo come gli altri al passo 2. La documentazione di Codex di OpenAI offre Sign in with ChatGPT la prima volta che lo avvii, quindi è il modo documentato più vicino per portare un account ChatGPT in Studio. La parte su Codex, compresa l'impostazione di approvazione che fa chiedere a Codex prima di usare gli strumenti di Studio, è in come usare OpenAI Codex con Roblox Studio (in inglese).
  • Documentato da Roblox: Assistant accetta una chiave API di OpenAI. Apri Assistant, clicca su … > Manage API Keys, scegli OpenAI, incolla la chiave e scegli un modello. Assistant usa poi quel modello dentro Studio.
  • Documentato da OpenAI, non da Roblox: l'app desktop di ChatGPT in modalità Codex. La pagina MCP di OpenAI dice che l'app desktop può aggiungere un server STDIO locale da Settings > MCP servers > Add server, e condivide quella configurazione con Codex CLI. OpenAI non dice se le normali chat di ChatGPT possono usare il server. Roblox non include l'app desktop in Quick connect, e noi non l'abbiamo provata, quindi considerala non confermata. Il comando che serve è quello di Comando CLI.

Copiare codice da una chat di ChatGPT in uno Script funziona ancora, ma niente in quella strada legge il tuo gioco o controlla il risultato in Studio. La guida all'uso dell'IA in Roblox Studio confronta le opzioni fianco a fianco.

Quali strumenti dà il server al tuo client

Roblox elenca 26 strumenti in otto gruppi (al 30 settembre 2026). È il tuo client a scegliere quali chiamare; tu non li chiami a mano. Ogni chiamata porta uno studio_id che indica a quale finestra di Studio è diretta.

Strumenti del server MCP di Studio, secondo la documentazione di Roblox
GruppoStrumentiCosa fanno
Scriptscript_read, multi_edit, script_search, script_grepLeggere uno script da un percorso come game.ServerScriptService.MyScript, intero o per intervallo di righe. Applicare più modifiche insieme, creando lo script se il percorso non esiste. Trovare script per nome (fino a 10 risultati) o cercare testo in tutti gli script (fino a 50 corrispondenze).
Modello datisearch_game_tree, inspect_instance, subagentPercorrere la gerarchia delle istanze con filtri e un limite di profondità, leggere tutte le proprietà e gli attributi leggibili di un'istanza, o passare un lavoro a più passaggi a un subagente explore o playtest.
Esecuzione Luauexecute_luauEsegue Luau in Studio nel modello dati Edit, Client o Server e restituisce il risultato o l'errore.
Test di giocoget_studio_state, start_stop_play, get_console_output, screen_captureControllare lo stato di gioco, avviare o fermare un test, leggere il log dell'Output e catturare il viewport come immagine.
Input del giocatorecharacter_navigation, user_keyboard_input, user_mouse_inputMuovere il personaggio verso una posizione o un'istanza, e inviare pressioni di tasti, testo, clic e scorrimenti.
Asset e generazionegenerate_mesh, generate_material, generate_procedural_model, wait_job_finished, search_asset, insert_asset, upload_image, store_imageGenerare mesh, materiali e modelli procedurali partendo dal testo. Cercare nel Creator Store e nei tuoi inventari, e inserire un asset per ID. Caricare su Roblox immagini da URL, o caricare un'immagine locale da usare come riferimento.
Documentazione e skillhttp_get, skillScaricare pagine da siti di documentazione di Roblox consentiti, e caricare materiale di riferimento per lavori come il debug e la simulazione di dispositivi.
Sessionilist_roblox_studiosElencare le finestre di Studio collegate con i loro nomi, gli ID di istanza di Studio e gli ID di gioco.

Due tipi di strumenti meritano attenzione. Primo, quelli che cambiano le cose: multi_edit ed execute_luau cambiano direttamente il tuo gioco, insert_asset porta contenuto esterno per ID dell'asset, e upload_image invia immagini al server degli asset di Roblox. Secondo, gli strumenti di test, che permettono a un agente di controllare il proprio lavoro: la reference di StudioTestService di Roblox dice che start_stop_play avvia una singola sessione Play Client, e gli strumenti di input controllano il personaggio mentre gira.

Roblox fa passare dal server anche altre funzioni di Studio: i dati di Scene Analysis tramite SceneAnalysisService, l'analisi del MicroProfiler, il controllo del Device Simulator e una skill di IA che converte un gioco allo streaming.

Lavorare con più di una finestra di Studio

Un client può collegarsi a più finestre di Studio insieme. Siccome ogni chiamata indica la destinazione con studio_id, l'agente deve sapere a quale finestra ti riferisci. Può chiamare list_roblox_studios per vedere il nome, l'ID di istanza di Studio e l'ID di gioco di ogni finestra. I giochi locali senza ID di gioco compaiono solo con il nome, e quando due finestre hanno lo stesso nome è l'ID di gioco a distinguerle.

In pratica: indica il gioco nel tuo prompt e chiudi ogni gioco che non vuoi che tocchi. Il server può raggiungere tutti i giochi aperti, non solo quello che stai guardando.

Lavora in sicurezza: copia, approva, controlla

L'avvertimento di Roblox è breve: i client MCP possono leggere e modificare il contenuto dei tuoi giochi aperti, quindi collega solo client di cui ti fidi. Con strumenti che eseguono codice, inseriscono asset e avviano test, un'istruzione fraintesa può fare danni veri. Queste abitudini rendono tutto recuperabile.

  • Salva una versione prima di ogni sessione. File > Save to Roblox with Notes (Ctrl+Alt+S, o Cmd+Option+S su Mac) crea un punto di controllo con nome. Per tornare indietro, apri Window > Version History, clicca su ⋮ accanto a quella versione, scegli Open Local Copy e poi usa File > Save to Roblox As sulla copia per ripristinarla sopra il gioco. File > Save to File salva anche una copia sul tuo computer.
  • Non contare su Ctrl+Z. La pagina MCP di Roblox non dice se le modifiche di un client entrano nella cronologia di annullamento di Studio, quindi considera la versione salvata come il tuo modo per tornare indietro.
  • Lavora su una copia di prova, non sul gioco live. Con Enable Studio Access to API Services attivo (File > Experience Settings > Security), Studio legge e scrive gli stessi data store del tuo gioco live, e Roblox consiglia di attivarlo solo su una versione di prova separata. Questo vale anche per il codice che esegue un agente e i test che avvia.
  • Tieni le approvazioni sugli strumenti che cambiano le cose. Mettere tra i consentiti strumenti di lettura come script_read e search_game_tree è a basso rischio. Continua ad approvare multi_edit, execute_luau, insert_asset e upload_image chiamata per chiamata finché non ti fidi del flusso di lavoro.
  • Controlla prima di tenere le modifiche. Leggi gli script che ha cambiato, controlla l'Explorer per oggetti nuovi o mancanti, e testa il gioco tu. Il test di un agente mostra quello che ha deciso di controllare, non tutto quello che farà un giocatore.

Per progetti più grandi: Script Sync e Git

La guida al coding harness di Roblox abbina la connessione MCP a due pezzi in più. Script Sync collega i servizi di Studio a cartelle su disco, così un editor e un agente lavorano su file .luau che compaiono in Studio come script, e Git dà a quel codice una cronologia a cui puoi tornare. Fai un commit di uno stato pulito prima di chiedere qualcosa di grosso a un agente.

Script Sync copre gli script dei servizi che colleghi; la connessione MCP continua a coprire quello che non raggiunge, come StarterGui, i test e l'Output. La configurazione passo per passo, con Rojo come alternativa, è in come usare Cursor o VS Code con Roblox Studio, e la versione per Claude Code in come usare Claude Code con Roblox Studio (tutte e due in inglese).

Risoluzione dei problemi: quando il client non si collega

La checklist di Roblox ha tre punti: riavvia Studio e il client, controlla che il percorso del comando o del binario sia corretto e che il file esista, e controlla la sintassi JSON. Ecco le situazioni che ci stanno dietro.

Non trovo Manage MCP Servers

Aggiorna Roblox Studio all'ultima versione, apri Assistant in alto a destra in Studio e clicca su …. Manage MCP Servers è in quel menu.

Il mio client non è nella lista di Quick connect

La lista mostra solo i client compatibili che hai installato. Installa il client e riavvia Studio. Se non è uno dei sette client compatibili, usa la configurazione JSON o il comando CLI.

Il client non mostra strumenti di Roblox, o dice che il server non si è potuto avviare

Controlla che esista il file della tua configurazione: %LOCALAPPDATA%\Roblox\mcp.bat su Windows, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP su macOS. Se sul tuo Mac Studio è installato altrove rispetto a /Applications, cambia il percorso. Poi riavvia il client, cosa che secondo Roblox serve per applicare le modifiche alla configurazione, e riavvia Studio.

Il file di configurazione ha smesso di caricarsi quando ho aggiunto Roblox Studio

Una virgola mancante tra due voci di mcpServers, o una parentesi di troppo, rende il file JSON non valido e smette di caricarsi. Controlla il file con un validatore JSON, correggi la riga che indica e riavvia il client.

Non c'è l'indicatore verde in Studio

Il client non si è collegato. Controlla che Enable Studio as MCP server sia ancora attivo e di aver riavviato il client dopo aver aggiunto il server, poi riavvia Studio e il client.

L'agente ha modificato il gioco sbagliato

Con più di una finestra di Studio aperta, il client sceglie la destinazione tramite studio_id. Chiedigli di eseguire list_roblox_studios e indica il gioco che vuoi, oppure chiudi le altre finestre. Ripristina il gioco che ha cambiato da Version History.

Il client chiede il permesso a ogni passaggio

Quello è il tuo client, non Studio. Roblox indica che potresti dover approvare un comando o aggiungere lo strumento MCP a una lista di consentiti. Aggiungi gli strumenti di sola lettura se gli avvisi ti rallentano, e continua ad approvare quelli che cambiano il tuo gioco.

Oppure salta la configurazione MCP: RoCode

RoCode (RoCode.app) è un'altra strada, e non è un prodotto MCP. È un agente di IA indipendente per Roblox Studio: descrivi una modifica in una chat web su rocode.app e un plugin gratis di RoCode dal Creator Store esegue i passaggi nel gioco che hai aperto. Non c'è file di configurazione, riga di comando né server MCP da configurare. In Studio accetti i permessi HTTP e Script Injection del plugin. Dopo, il plugin si collega da solo quando Studio ha fatto l'accesso con lo stesso account Roblox che usi su RoCode; altrimenti abbini la chat e il plugin una volta sola con il codice di 8 caratteri che mostra il pannello del plugin.

I compromessi, detti chiaramente. RoCode non può collegare un abbonamento Claude, Claude Code o ChatGPT. Fa girare modelli di terze parti tramite OpenRouter con i loro nomi: DeepSeek V4 Flash su tutti i piani, GLM 5.3 Flash e Claude Sonnet 5.5 da Pro, Claude Opus 5.5 da Studio e GPT-6 Astra da Ultra. Con il plugin 3.9 o successivo può fare un breve test e leggere gli errori, e con il plugin 3.9.11 o successivo guidare un personaggio di prova per verificare che il gioco funzioni. Con il plugin 3.9.14 o successivo fa anche screenshot di quello che ha costruito, in modalità modifica, e può correggere ciò che sembra sbagliato. Non esegue codice direttamente né genera mesh, cose che invece possono fare gli strumenti MCP di Studio visti sopra. Cerca però nel Creator Store, con parole tue, modelli gratuiti (togliendo loro gli script) o inserisce un modello, decal o mesh tramite il suo ID dell'asset, e progetta scenografia, edifici e prop nuovi per ogni gioco. Il piano gratis Starter include 1 credito al giorno. Per vedere come si confronta con altri strumenti, leggi le migliori IA per Roblox Studio a confronto.

Tu scrivi

Ho appena testato il gioco e mi è uscito un errore in RoundManager. Trova la causa e sistemalo.

RoCode fa
  • Legge l'Output del test che hai fatto con Check Output, comprese le righe Server e Client, e apre lo script attorno a quella riga con Read Script
  • Corregge sul posto il codice che non funziona con Edit Script, nella finestra di Studio collegata
  • Controlla dentro Studio con Check Script che lo script compili prima di finire. È un controllo di compilazione, non dei tipi né un test di gioco
  • Invia le sue modifiche a gruppi, e ogni gruppo è un punto di annullamento nella cronologia di Studio

Con il plugin 3.9 o successivo, RoCode può fare un breve test e leggere gli errori, e con il plugin 3.9.11 o successivo guidare un personaggio di prova, ma controlla solo quello che ha deciso di testare, quindi premi Play tu e gioca un round per confermare la correzione. Come funzionano il plugin e l'abbinamento. RoCode è un prodotto indipendente, non affiliato a Roblox Corporation né approvato da essa.

Domande frequenti

Il server MCP di Roblox Studio è gratis?

È integrato in Roblox Studio, e la documentazione MCP di Roblox non parla di costi né di registrazione. Il modello di IA arriva tramite il tuo client, quindi limiti o costi sono quelli dell'account o del piano di quel client.

Posso usare ChatGPT con il server MCP di Roblox Studio?

ChatGPT sul web no, all'11 ottobre 2026: non può avviare il server locale di Studio. La strada OpenAI documentata da Roblox è Codex CLI, a cui puoi accedere con un account ChatGPT. OpenAI documenta anche come aggiungere server locali nell'app desktop di ChatGPT in modalità Codex, che Roblox non include e che noi non abbiamo provato. L'altra strada è una chiave API di OpenAI in Assistant, con Manage API Keys. I passaggi per Codex sono in come usare OpenAI Codex con Roblox Studio (in inglese).

Mi serve una chiave API per collegare Claude a Roblox Studio?

Per MCP no. La configurazione di Roblox non ha un passaggio con chiave API, e il tuo client usa il suo accesso normale: la guida al coding harness accede a Claude Code con un account Anthropic. Una chiave API serve solo per l'altra strada, un modello Claude dentro Assistant di Studio con Manage API Keys.

L'IA può testare il mio gioco tramite MCP?

Sì. start_stop_play avvia e ferma un test, get_console_output legge l'Output, screen_capture cattura il viewport, e gli strumenti di input muovono il personaggio e inviano tasti e clic. Il subagente playtest può giocare uno scenario e controllare il risultato. Gioca anche tu prima di pubblicare.

Il server MCP di Studio funziona su Mac?

Sì. Roblox documenta una configurazione per macOS che punta a /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP, accanto a quella per Windows.

Fonti e letture

Prova RoCode nel tuo gioco.

Crediti gratis ogni giorno, senza carta. Installa il plugin, descrivi la funzione e controlla cosa compare in Studio.