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 dei dati, scrivendo script, eseguendo codice Luau e testando la tua esperienza in modalità di gioco.
Questa guida ti mostra come connettere il server MCP di Studio ai client AI più diffusi. Sebbene la configurazione vari da client a 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 di Studio attiva.
Prerequisiti
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 gira 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 sono avviate tramite il tuo client AI, il quale invia poi una richiesta tramite 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 (per esempio, game.ServerScriptService.MyScript). Supporta la lettura di script interi o di specifici intervalli di linee. |
| multi_edit | Applica più modifiche a uno script in un'unica operazione. Se il percorso di destinazione non esiste, crea un nuovo script. Richiede la specifica di un datamodel_type (Modifica). |
| script_search | Cerca script per nome utilizzando il fuzzy matching. 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 testuale utilizzando l'AI. |
| generate_material | Genera una variante di materiale personalizzata. Restituisce il materiale di base e il nome della variante di materiale da applicare alle parti. |
| generate_procedural_model | Crea oggetti 3D costruiti da parti primitive (blocchi, sfere, cilindri, cunei) come modello procedurale con attributi configurabili. Supporta immagini di riferimento e schemi di parti personalizzati. |
| wait_job_finished | Attende il completamento di un lavoro di generazione di un modello procedurale 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 batch di immagini da URL HTTP al server di asset di Roblox, restituendo una mappa del percorso immagine all'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 (per esempio, come immagine di riferimento per generate_procedural_model). |
| Esplorazione del modello di dati | |
| subagent | Avvia un subagente specializzato per gestire compiti complessi e a più fasi in modo autonomo. I tipi disponibili includono explore (per indagini sul codice e query sullo stato del gioco) e playtest (per l'esecuzione di scenari di gameplay e la verifica dei 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, attributi personalizzati e un riepilogo dei suoi figli e discendenti. |
| Esecuzione Luau | |
| execute_luau | Esegue codice Luau in Studio. Restituisce il risultato o un errore. Richiede la specifica di un datamodel_type (Modifica, 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 log di output di Studio. |
| screen_capture | Cattura l'attuale viewport di Studio e restituisce i dati dell'immagine. Accetta opzionalmente una posizione della fotocamera personalizzata e un target di visione. |
| Simulazione dell'input del giocatore | |
| character_navigation | Muove il personaggio del giocatore a 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 la selezione di istanze UI specifiche. |
| user_mouse_input | Invia una o più azioni del mouse in ordine: movimento, clic, tasto giù/su, scorrimento o attesa. Supporta la selezione di istanze specifiche o coordinate dello schermo. |
| Documentazione e competenze | |
| http_get | Recupera contenuti da URL di documentazione Roblox consentiti (riferimento API del motore, documentazione del creatore, API Cloud, guide all'ottimizzazione delle prestazioni). Supporta la ricerca per parole chiave all'interno dei contenuti recuperati. |
| skill | Recupera conoscenze dettagliate, pratiche migliori o materiale di riferimento per competenze specifiche come debugging, simulazione di dispositivi e ricerca nella documentazione. |
| Gestione della sessione | |
| list_roblox_studios | Elenca tutte le istanze di Studio collegate, comprese le loro 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 degli strumenti successivi puntino 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.
Collega il tuo client
Puoi collegare il tuo client al server MCP di Studio utilizzando la connessione rapida, una configurazione JSON o un comando CLI.
- Usa connessione rapida se il tuo client è supportato.
- In caso contrario, usa una configurazione JSON se il tuo client supporta file di configurazione MCP.
- In caso contrario, 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 tue 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:
Windows
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}
macOS
{
"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:
Windows
macOS
Usa più istanze di Studio
Puoi collegare 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'esperienza specifica o a un oggetto che esiste solo in quella 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 del file binario sia corretto e che il file esista.
- Controlla la sintassi del tuo JSON. Anche una virgola o una parentesi mancante possono impedire il caricamento della configurazione.