Verbinden met de Roblox Studio MCP-server

*Deze inhoud is vertaald met behulp van AI (bèta) en kan fouten bevatten. Klik hier om deze pagina in het Engels te bekijken.

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_readLeest 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_editPast 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_searchZoekt naar scripts op naam met behulp van fuzzy matching. Retourneert tot 10 resultaten.
script_grepZoekt naar een tekenreeks patroon in alle scripts in de game. Retourneert tot 50 overeenkomsten.
Asset- en contentgeneratie
generate_meshGenereert een getextureerde 3D-mesh vanuit een tekstprompt met behulp van AI.
generate_materialGenereert een aangepaste materiaalvariant. Retourneert het basismateriaal en de naam van de materiaalvariant die op onderdelen kan worden toegepast.
generate_procedural_modelCreë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_finishedWacht tot een procedurele modelgeneratiejob is voltooid en retourneert de uiteindelijke status.
search_assetZoekt naar assets in de Creator Store (openbare marktplaats) en Creator Inventory (gebruiker, groep of universum). Ondersteunt filteren op assettype, prijs, tags en scope.
insert_assetVoegt een asset toe aan de game op basis van de numerieke Roblox asset ID. Ondersteunt modellen, meshes, afbeeldingen, audio, video, animaties en pakketten.
upload_imageUploadt een batch afbeeldingen van HTTP-URL's naar de Roblox assetserver en retourneert een afbeeldingspad naar asset ID-kaart.
store_imageLaadt 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
subagentStart 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_treeVerken de instantiehiërarchie als een platte JSON-array. Ondersteunt filteren op pad, instantie-type en trefwoorden, met configureerbare dieptebeperkingen.
inspect_instanceRetourneert gedetailleerde informatie over een specifieke instantie, inclusief alle leesbare eigenschappen, aangepaste attributen en een samenvatting van zijn kinderen en afstammelingen.
Luau-uitvoering
execute_luauVoert 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_stateHaalt de huidige staat van Studio op, inclusief de speelstatus en beschikbare datamodeltypes.
start_stop_playStart of stopt playtesting.
get_console_outputHaal output op uit het Studio-outputlog.
screen_captureVangt het huidige Studio-viewport en retourneert de afbeeldingsgegevens. Accepteert optioneel een aangepaste camerapositie en kijkdoel.
Spelerinvoersimulatie
character_navigationVerplaatst de speler karakter naar een gegeven positie of instantiepad. Ondersteunt een configureerbare snelheidsvermenigvuldiger.
user_keyboard_inputStuurt een of meer toetsenbordacties in volgorde: toets omlaag, toets omhoog, toets indrukken, tekstinvoer of wachten. Ondersteunt het richten op specifieke UI-instanties.
user_mouse_inputStuurt 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_getHaal inhoud op van toegestane Roblox documentatie-URL's (Engine API-referentie, Creator-docs, Cloud API, prestatieoptimalisatiegidsen). Ondersteunt zoekopdrachten op trefwoorden binnen de opgehaalde inhoud.
skillHaal gedetailleerde kennis, best practices of referentiemateriaal op voor specifieke vaardigheden zoals debugging, apparaat simulatie en documentatiezoekopdrachten.
Sessiebeheer
list_roblox_studiosGeeft 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:

  1. Open Assistant.
  2. Klik op … ⟩ Beheer MCP-servers.
  3. 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:

  1. Ga naar Assistant-instellingen ⟩ MCP-servers.
  2. Vouw de Snelle verbinding dropdown uit om ondersteunde clients te bekijken die op je computer zijn geïnstalleerd.
  3. 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:

Windows
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}
macOS
{
"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:

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

Gebruik 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:

  1. Open Assistant.
  2. Klik op … ⟩ Beheer MCP-servers.
  3. 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.
©2026 Roblox Corporation. Roblox, het Roblox-logo en Powering Imagination behoren tot onze geregistreerde en niet-geregistreerde handelsmerken in de VS en andere landen.