Il server MCP di Roblox Studio è integrato in Roblox Studio. Implementa il Model Context Protocol (MCP), uno standard aperto che consente agli strumenti AI di comunicare in modo sicuro con applicazioni esterne. Una volta connesso, il tuo client AI può interagire direttamente con la tua sessione di Studio aperta, esplorando il modello di dati, scrivendo script, eseguendo codice Luau e testando il tuo gioco in modalità di gioco.
Questa guida ti mostra come connettere il server MCP di Studio ai client AI più popolari. Sebbene la configurazione vari a seconda del client, l'idea di base è la stessa: configuri il tuo client per connettersi al server MCP e poi invii comandi dal client alla tua sessione attiva di Studio.
Requisiti
Prima di poter connetterti al server, assicurati di avere l'ultima versione di Roblox Studio e il tuo client MCP preferito installato sul tuo computer.
Come funziona il server MCP di Studio
Il server viene eseguito come un processo locale sulla tua macchina e comunica con il client AI utilizzando il trasporto stdio, che utilizza flussi di input/output standard. Tutte le azioni vengono avviate tramite il tuo client AI, che poi invia una richiesta attraverso questo canale per eseguire azioni all'interno della tua sessione di Studio.
Il server fornisce i seguenti strumenti:
| Script | |
|---|---|
| script_read | Legge uno script dal gioco utilizzando percorsi in notazione a punti (ad esempio, game.ServerScriptService.MyScript). Supporta la lettura di script interi o di intervalli di righe specifici. |
| multi_edit | Applica più modifiche a uno script in un'unica operazione. Se il percorso di destinazione non esiste, crea un nuovo script. Richiede di specificare un datamodel_type (Edit). |
| script_search | Cerca script per nome utilizzando il matching fuzzy. Restituisce fino a 10 risultati. |
| script_grep | Cerca un modello di stringa in tutti gli script del gioco. Restituisce fino a 50 corrispondenze. |
| Generazione di asset e contenuti | |
| generate_mesh | Genera una mesh 3D texturizzata da un prompt di testo utilizzando l'AI. |
| generate_material | Genera una variante di materiale personalizzato. Restituisce il materiale di base e il nome della variante di materiale da applicare ai pezzi. |
| generate_procedural_model | Crea oggetti 3D costruiti da parti primitive (blocchi, sfere, cilindri, cunei) come un ProceduralModel con attributi configurabili. Supporta immagini di riferimento e schemi di parti personalizzati. |
| wait_job_finished | Attende che un lavoro di generazione di modello procedurale finisca e restituisce lo stato finale. |
| search_asset | Cerca asset nel Creator Store (mercato pubblico) e nell'Inventario Creatore (utente, gruppo o universo). Supporta il filtraggio per tipo di asset, prezzo, tag e ambito. |
| insert_asset | Inserisce un asset nel gioco tramite il suo ID numerico di asset Roblox. Supporta modelli, mesh, immagini, audio, video, animazioni e pacchetti. |
| upload_image | Carica un lotto di immagini da URL HTTP al server di asset di Roblox, restituendo una mappa di percorso immagine a ID asset. |
| store_image | Carica un'immagine da un percorso di file locale e restituisce un URI immagine che può essere passato ad altri strumenti (ad esempio, come immagine di riferimento per generate_procedural_model). |
| Esplorazione del modello di dati | |
| subagent | Avvia un subagente specializzato per gestire compiti complessi e multi-step in modo autonomo. I tipi disponibili includono explore (per indagini sul codice e query sullo stato del gioco) e playtest (per eseguire scenari di gioco e verificare i risultati). |
| search_game_tree | Esplora la gerarchia delle istanze come un array JSON piatto. Supporta il filtraggio per percorso, tipo di istanza e parole chiave, con limitazione della profondità configurabile. |
| inspect_instance | Restituisce informazioni dettagliate su un'istanza specifica, comprese tutte le proprietà leggibili, gli attributi personalizzati e un riepilogo dei suoi figli e discendenti. |
| Esecuzione di Luau | |
| execute_luau | Esegue codice Luau in Studio. Restituisce il risultato o un errore. Richiede di specificare un datamodel_type (Edit, Client o Server). |
| Playtesting | |
| get_studio_state | Ottiene lo stato attuale di Studio, inclusi lo stato di gioco e i tipi di datamodel disponibili. |
| start_stop_play | Avvia o ferma il playtesting. |
| get_console_output | Recupera l'output dal registro di output di Studio. |
| screen_capture | Cattura l'attuale viewport di Studio e restituisce i dati dell'immagine. Accetta facoltativamente una posizione della fotocamera personalizzata e un obiettivo di sguardo. |
| Simulazione dell'input del giocatore | |
| character_navigation | Sposta il personaggio del giocatore in una posizione o percorso di istanza specificato. Supporta un moltiplicatore di velocità configurabile. |
| user_keyboard_input | Invia una o più azioni da tastiera in ordine: tasto giù, tasto su, pressione del tasto, input di testo o attesa. Supporta il targeting di istanze UI specifiche. |
| user_mouse_input | Invia una o più azioni del mouse in ordine: sposta, clicca, tasto giù/su, scorri o attendi. Supporta il targeting di istanze specifiche o coordinate dello schermo. |
| Documentazione e competenze | |
| http_get | Recupera contenuti da URL di documentazione Roblox consentiti (riferimento API Engine, documenti Creator, API Cloud, guide all'ottimizzazione delle prestazioni). Supporta la ricerca per parole chiave all'interno dei contenuti recuperati. |
| skill | Recupera conoscenze dettagliate, migliori pratiche o materiale di riferimento per competenze specifiche come il debugging, la simulazione dei dispositivi e la ricerca di documentazione. |
| Gestione delle sessioni | |
| list_roblox_studios | Elenca tutte le istanze di Studio connesse, inclusi nome, ID e stato attivo. Questo è utile quando sono aperte più finestre di Studio. |
| set_active_studio | Imposta un'istanza di Studio come attiva in modo che tutte le chiamate agli strumenti successivi mirino a quell'istanza. |
Abilitare il server MCP in Studio
Per abilitare il server MCP in Studio:
- Apri Assistant.
- Clicca su … ⟩ Gestisci server MCP.
- Attiva Abilita Studio come server MCP.
Una volta abilitato, il pannello delle impostazioni mostra l'opzione di connessione rapida e le istruzioni di configurazione per diversi client. Quando un client si connette con successo, un indicatore verde mostra il numero di client connessi.
Connetti il tuo client
Puoi connettere il tuo client al server MCP di Studio utilizzando la connessione rapida, una configurazione JSON o un comando CLI.
- Usa la connessione rapida se il tuo client è supportato.
- In caso contrario, usa una configurazione JSON se il tuo client supporta i file di configurazione MCP.
- Altrimenti, usa un comando CLI.
Il server MCP di Studio funziona con qualsiasi client che supporta il trasporto stdio. Dopo aver aggiunto la configurazione, segui la documentazione del tuo client per completare la configurazione, quindi riavvia il client per applicare le modifiche.
I client MCP possono leggere e modificare contenuti nei tuoi luoghi Roblox aperti. Assicurati di connettere solo client di cui ti fidi.
Connessione rapida
La connessione rapida supporta i seguenti client:
- Antigravity
- Codex CLI
- Claude Code
- Claude Desktop
- Cursor
- Gemini CLI
- Visual Studio Code
Per connetterti utilizzando la connessione rapida:
- Vai su Impostazioni Assistant ⟩ Server MCP.
- Espandi il menu a discesa Connessione rapida per visualizzare i client supportati installati sul tuo computer.
- Attiva il client scelto.
Se il client che desideri non appare nell'elenco Connessione rapida, installalo e riavvia Roblox Studio.
Configurazione JSON
La maggior parte dei client MCP supporta file di configurazione JSON. I seguenti esempi mostrano configurazioni complete che puoi utilizzare.
Se Roblox Studio è il tuo unico server MCP, utilizza queste configurazioni così come sono. Se stai utilizzando più server MCP, copia l'entry Roblox_Studio e aggiungila al tuo dizionario mcpServers esistente.
Il tuo file mcp.json potrebbe già contenere altre voci. Quando aggiungi la configurazione Roblox_Studio, assicurati che ogni voce sia separata da una virgola. Le virgole mancanti porteranno a JSON non valido e impediranno il caricamento della configurazione.
Le configurazioni variano a seconda del sistema operativo:
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}{
"mcpServers": {
"Roblox_Studio": {
"command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
}
}
}Comando CLI
Alcuni client MCP richiedono un comando CLI invece di una configurazione JSON. Usa il comando appropriato per il tuo sistema operativo:
cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat/Applications/RobloxStudio.app/Contents/MacOS/StudioMCPUsa più istanze di Studio
Puoi connettere un singolo client MCP a più istanze di Studio in esecuzione contemporaneamente. Il server determina automaticamente quale istanza utilizzare in base al contesto (ad esempio, se fai riferimento a un gioco specifico o a un oggetto che esiste solo in quell'istanza).
Puoi passare manualmente tra le istanze utilizzando list_roblox_studios e set_active_studio.
Verifica la tua connessione
Dopo aver configurato il tuo client, verifica che la connessione funzioni in Roblox Studio:
- Apri Assistant.
- Clicca su … ⟩ Gestisci server MCP.
- Sotto Abilita Studio come server MCP, controlla l'indicatore verde per confermare che il client si sia connesso con successo.
Risoluzione dei problemi
Se il server non appare o gli strumenti non sono disponibili:
- Riavvia sia Roblox Studio che il tuo client MCP.
- Verifica che il comando o il percorso binario sia corretto e che il file esista.
- Controlla la sintassi JSON. Anche una virgola o una parentesi mancante possono impedire il caricamento della configurazione.