De Roblox Studio MCP-server is ingebouwd in Roblox Studio. Het implementeert het Model Context Protocol (MCP), een open standaard die AI-tools in staat stelt veilig te communiceren met externe applicaties. Zodra je verbonden bent, kan je AI-client direct interactie hebben met je open Studio-sessie, de datamodel verkennen, scripts schrijven, Luau-code uitvoeren en je game testen in de speelmodus.
Deze gids laat je zien hoe je de Studio MCP-server kunt verbinden met populaire AI-clients. Hoewel de setup per client verschilt, is het kernidee hetzelfde: je configureert je client om verbinding te maken met de MCP-server en vervolgens stuur je opdrachten van de client naar je actieve Studio-sessie.
Vereisten
Voordat je verbinding kunt maken met de server, zorg ervoor dat je de laatste versie van Roblox Studio en je voorkeurs MCP-client op je computer hebt geïnstalleerd.
Hoe de Studio MCP-server werkt
De server draait als een lokaal proces op je machine en communiceert met de AI-client via stdio transport, dat gebruikmaakt van standaard invoer/uitvoer streams. Alle acties worden geïnitieerd via je AI-client, die vervolgens een verzoek via dit kanaal verzendt om acties binnen je Studio-sessie uit te voeren.
De server biedt de volgende tools:
| Scripts | |
|---|---|
| script_read | Leest een script uit de game met behulp van dot-notatie paden (bijvoorbeeld, game.ServerScriptService.MyScript). Ondersteunt het lezen van volledige scripts of specifieke regelbereiken. |
| multi_edit | Past meerdere bewerkingen toe op een script in één operatie. Als het doelpad niet bestaat, wordt er een nieuw script aangemaakt. Vereist het specificeren van een datamodel_type (Bewerken). |
| script_search | Zoekt naar scripts op naam met behulp van fuzzy matching. Retourneert tot 10 resultaten. |
| script_grep | Zoekt naar een tekenreeks patroon in alle scripts in de game. Retourneert tot 50 overeenkomsten. |
| Asset- en contentgeneratie | |
| generate_mesh | Genereert een getextureerde 3D-mesh vanuit een tekstprompt met behulp van AI. |
| generate_material | Genereert een aangepaste materiaalvariant. Retourneert het basismateriaal en de naam van de materiaalvariant die op onderdelen kan worden toegepast. |
| generate_procedural_model | Creëert 3D-objecten opgebouwd uit primitieve onderdelen (blokken, sferen, cilinders, wiggen) als een ProceduralModel met configureerbare attributen. Ondersteunt referentieafbeeldingen en aangepaste onderdeel-schema's. |
| wait_job_finished | Wacht tot een procedurele modelgeneratiejob is voltooid en retourneert de uiteindelijke status. |
| search_asset | Zoekt naar assets in de Creator Store (openbare marktplaats) en Creator Inventory (gebruiker, groep of universum). Ondersteunt filteren op assettype, prijs, tags en scope. |
| insert_asset | Voegt een asset toe aan de game op basis van de numerieke Roblox asset ID. Ondersteunt modellen, meshes, afbeeldingen, audio, video, animaties en pakketten. |
| upload_image | Uploadt een batch afbeeldingen van HTTP-URL's naar de Roblox assetserver en retourneert een afbeeldingspad naar asset ID-kaart. |
| store_image | Laadt een afbeelding van een lokaal bestandspad en retourneert een afbeeldings-URI die kan worden doorgegeven aan andere tools (bijvoorbeeld, als een referentieafbeelding voor generate_procedural_model). |
| Datamodelverkenning | |
| subagent | Start een gespecialiseerde subagent om complexe, meerstaps taken autonoom af te handelen. Beschikbare types zijn explore (voor codebase-onderzoek en game-statusvragen) en playtest (voor het uitvoeren van gameplay-scenario's en het verifiëren van uitkomsten). |
| search_game_tree | Verken de instantiehiërarchie als een platte JSON-array. Ondersteunt filteren op pad, instantie-type en trefwoorden, met configureerbare dieptebeperkingen. |
| inspect_instance | Retourneert gedetailleerde informatie over een specifieke instantie, inclusief alle leesbare eigenschappen, aangepaste attributen en een samenvatting van zijn kinderen en afstammelingen. |
| Luau-uitvoering | |
| execute_luau | Voert Luau-code uit in Studio. Retourneert ofwel het resultaat of een fout. Vereist het specificeren van een datamodel_type (Bewerken, Client of Server). |
| Playtesting | |
| get_studio_state | Haalt de huidige staat van Studio op, inclusief de speelstatus en beschikbare datamodeltypes. |
| start_stop_play | Start of stopt playtesting. |
| get_console_output | Haal output op uit het Studio-outputlog. |
| screen_capture | Vangt het huidige Studio-viewport en retourneert de afbeeldingsgegevens. Accepteert optioneel een aangepaste camerapositie en kijkdoel. |
| Spelerinvoersimulatie | |
| character_navigation | Verplaatst de speler karakter naar een gegeven positie of instantiepad. Ondersteunt een configureerbare snelheidsvermenigvuldiger. |
| user_keyboard_input | Stuurt een of meer toetsenbordacties in volgorde: toets omlaag, toets omhoog, toets indrukken, tekstinvoer of wachten. Ondersteunt het richten op specifieke UI-instanties. |
| user_mouse_input | Stuurt een of meer muisacties in volgorde: verplaatsen, klikken, knop omlaag/omhoog, scrollen of wachten. Ondersteunt het richten op specifieke instanties of schermcoördinaten. |
| Documentatie en vaardigheden | |
| http_get | Haal inhoud op van toegestane Roblox documentatie-URL's (Engine API-referentie, Creator-docs, Cloud API, prestatieoptimalisatiegidsen). Ondersteunt zoekopdrachten op trefwoorden binnen de opgehaalde inhoud. |
| skill | Haal gedetailleerde kennis, best practices of referentiemateriaal op voor specifieke vaardigheden zoals debugging, apparaat simulatie en documentatiezoekopdrachten. |
| Sessiebeheer | |
| list_roblox_studios | Geeft een lijst van alle verbonden Studio-instanties, inclusief hun naam, Studio-instantie-ID en plaats-ID. Lokale plaatsen zonder een plaats-ID worden alleen bij naam vermeld. Handig wanneer meerdere Studio-vensters open zijn; als twee open Studio-instanties dezelfde naam delen, laat de plaats-ID je ze onderscheiden. |
Schakel de MCP-server in Studio in
Om de MCP-server in Studio in te schakelen:
- Open Assistant.
- Klik op … ⟩ Beheer MCP-servers.
- Zet Studio inschakelen als MCP-server aan.
Zodra deze is ingeschakeld, toont het instellingenpaneel de snelle verbindingsoptie en installatie-instructies voor verschillende clients. Wanneer een client succesvol verbinding maakt, toont een groene indicator het aantal verbonden clients.
Verbind je client
Je kunt je client verbinden met de Studio MCP-server met behulp van snelle verbinding, een JSON-configuratie of een CLI-opdracht.
- Gebruik snelle verbinding als je client wordt ondersteund.
- Zo niet, gebruik dan een JSON-configuratie als je client MCP-configuratiebestanden ondersteunt.
- Anders, gebruik een CLI-opdracht.
De Studio MCP-server werkt met elke client die stdio transport ondersteunt. Nadat je de configuratie hebt toegevoegd, volg je de documentatie van je client om de installatie te voltooien, en start je de client opnieuw op om je wijzigingen toe te passen.
Snelle verbinding
Snelle verbinding ondersteunt de volgende clients:
- Antigravity
- Codex CLI
- Claude Code
- Claude Desktop
- Cursor
- Gemini CLI
- Visual Studio Code
Om verbinding te maken met behulp van snelle verbinding:
- Ga naar Assistant-instellingen ⟩ MCP-servers.
- Vouw de Snelle verbinding dropdown uit om ondersteunde clients te bekijken die op je computer zijn geïnstalleerd.
- Zet je gekozen client aan.
Als de client die je wilt niet verschijnt in de lijst Snelle verbinding, installeer deze dan en start Roblox Studio opnieuw op.
JSON-configuratie
De meeste MCP-clients ondersteunen JSON-configuratiebestanden. De volgende voorbeelden tonen complete configuraties die je kunt gebruiken.
Als Roblox Studio je enige MCP-server is, gebruik deze configuraties zoals ze zijn. Als je meerdere MCP-servers gebruikt, kopieer dan de Roblox_Studio-vermelding en voeg deze toe aan je bestaande mcpServers-woordenboek.
Configuraties variëren per besturingssysteem:
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}{
"mcpServers": {
"Roblox_Studio": {
"command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
}
}
}CLI-opdracht
Sommige MCP-clients vereisen een CLI-opdracht in plaats van een JSON-configuratie. Gebruik de juiste opdracht voor je besturingssysteem:
cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat/Applications/RobloxStudio.app/Contents/MacOS/StudioMCPGebruik meerdere Studio-instanties
Je kunt een enkele MCP-client verbinden met meerdere draaiende instanties van Studio tegelijkertijd. Elke toolaanroep bevat een studio_id die de Studio-instantie identificeert waarop je je richt, wat workflows met meerdere Studio-instanties en meerdere agenten of clients betrouwbaar maakt.
Gebruik list_roblox_studios om de verbonden instanties met hun namen, Studio-instantie-ID's en plaats-ID's te vermelden. Geef vervolgens de ID van de instantie die je wilt door als studio_id bij volgende aanroepen.
Verifieer je verbinding
Na het instellen van je client, verifieer of de verbinding werkt in Roblox Studio:
- Open Assistant.
- Klik op … ⟩ Beheer MCP-servers.
- Controleer onder Studio inschakelen als MCP-server of de groene indicator aangeeft dat de client succesvol is verbonden.
Probleemoplossing
Als de server niet verschijnt, of de tools niet beschikbaar zijn:
- Herstart zowel Roblox Studio als je MCP-client.
- Controleer of het commando of het binaire pad correct is en of het bestand bestaat.
- Controleer je JSON-syntaxis. Zelfs een ontbrekende komma of haakje kan voorkomen dat de configuratie wordt geladen.