In short
The Roblox Studio MCP server is built into Studio, so there is nothing to download. Open Assistant, click … > Settings > MCP Servers (called Manage MCP Servers in older versions) and turn on Enable Studio as MCP server. Then switch on your client under Quick connect, or paste the JSON config: StudioMCP inside RobloxStudio.app on macOS, %LOCALAPPDATA%\Roblox\mcp.bat on Windows. Step by step for one app: connect Claude Desktop to Roblox Studio or connect the ChatGPT desktop app.
- Quick connect covers Claude Code, Claude Desktop, Cursor, Codex CLI, Gemini CLI, Visual Studio Code and Antigravity. A green indicator in the same panel shows how many clients are connected; if yours does not appear, restart both Studio and the client.
- ChatGPT: Roblox's official agent plugin supports the ChatGPT desktop app and Codex CLI. ChatGPT on the web or on a phone cannot connect, because the server runs on your computer.
- A connected client can edit scripts, run Luau, insert assets, save the place and start playtests in any place you have open. Save a version first, and connect only clients you trust.
- No setup route: RoCode is an independent AI agent for Roblox Studio that works from a web chat and a free plugin, with no config file, command line or MCP server. It cannot use your Claude or ChatGPT subscription.
On this page
What the Studio MCP server does
MCP (Model Context Protocol) is an open standard that lets AI tools talk to other applications. Roblox builds an MCP server into Studio. When it is on, an AI client on your computer can explore the place you have open, read and write scripts, run Luau and test the game in play mode, all through tools the server exposes.
The server runs as a local process on your machine and talks to the client over stdio (standard input and output). Nothing happens on its own: every action starts as a request from your client, and the client decides which tool to call. You need the latest version of Roblox Studio and the MCP client you want to use, both installed on the same computer.
Two ways to use Claude or GPT with Studio
| Studio MCP server | Assistant with your own API key | |
|---|---|---|
| Where you type | In your AI client, for example Claude Desktop, Claude Code or Cursor | In Studio's Assistant panel |
| What you set up | Turn on the server in Studio, then connect the client | Assistant > … > Manage API Keys, then choose the model |
| Models | Whatever your client uses | Anthropic, OpenAI or Google Gemini |
| What you need | The client and its own sign-in | An API key from that provider |
| Who acts in Studio | Your client, through the MCP tools | Assistant, using the model you picked |
This guide is about the first route. If all you want is a Claude or OpenAI model answering inside Studio, the second is shorter: get an API key from the provider, open Assistant, click … > Manage API Keys, choose the provider, paste the key, and select the model in the Model drop-down.
Step 1: Turn on the MCP server in Studio
- Open Roblox Studio and open a place. If Studio offers an update, install it first: the server needs the latest version.
- Click Assistant at the top right of Studio (the right side of the mezzanine bar) to open the Assistant window.
- Click … and choose Settings, then the MCP Servers tab. In older versions of Studio this menu item is called Manage MCP Servers.
- Turn on Enable Studio as MCP server.
Studio also has an MCP button in its bottom-right corner, which opens the same settings, including the MCP Permissions tab described in Open Cloud permissions below.
The panel now shows a Quick connect option and setup instructions for different clients. Keep it open. You need it for the next step, and it is where the connection indicator appears.
If the Assistant button is missing or the window will not open, see how to open or reopen the Assistant panel.
Step 2: Connect your AI client
Roblox gives three ways to connect, in this order: quick connect if your client is on the list, a JSON configuration if the client reads MCP config files, and a CLI command for clients that need one.
Quick connect
Roblox's MCP page lists seven quick connect clients (checked 14 November 2026): Antigravity, Codex CLI, Claude Code, Claude Desktop, Cursor, Gemini CLI and Visual Studio Code. Roblox's agent plugin instructions add a ChatGPT (codex) switch in the same list, used by both the ChatGPT desktop app and Codex.
- In the panel from Step 1 (Assistant Settings > MCP Servers), expand the Quick connect drop-down. It lists the supported clients that are installed on your computer.
- Turn on the client you want.
- If your client is missing from the list, install it and restart Roblox Studio. If you installed it while Studio was open, you may need to restart Studio, the client, or both.
Setup by client
| Client | Route | Notes |
|---|---|---|
| Claude Desktop (Anthropic) | Quick connect | The desktop app. Roblox does not describe using Claude in a web browser. |
| Claude Code (Anthropic) | Quick connect | Roblox's coding harness guide uses it as a Visual Studio Code extension, signed in with an Anthropic account. |
| Cursor | Quick connect | Has its AI assistant built in. Sign in with your Cursor account. |
| Visual Studio Code | Quick connect | Needs an AI extension, such as Claude Code. |
| Codex CLI (OpenAI) | Quick connect | The OpenAI client on Roblox's list. OpenAI's Codex documentation offers Sign in with ChatGPT the first time you run it. |
| Gemini CLI (Google) | Quick connect | |
| Antigravity | Quick connect | |
| Any other client with stdio support | JSON config, or the CLI command | See the next section. Finish setup with the client's own documentation, then restart it. |
| ChatGPT desktop app (OpenAI) | Roblox's agent plugin, then the ChatGPT (codex) switch | Install the Roblox Studio plugin from Plugins in the desktop app. ChatGPT on the web or a phone cannot connect. See Can ChatGPT connect to Roblox Studio? |
Roblox's agent plugin for Claude and ChatGPT
Roblox also publishes an official plugin for AI assistants on GitHub, Roblox/roblox-studio-agent-plugin (MIT licence). It contains no code of its own, only configuration and skill instructions: it starts the same built-in MCP server and walks you through setup. You still turn on Enable Studio as MCP server yourself.
- Claude Code: run
/plugin, search for Roblox Studio and install it. - Claude desktop app (Cowork): Customize > Plugins, find Roblox Studio and install it.
- ChatGPT desktop app: open Plugins, find Roblox Studio, install it and start a new chat.
- Codex CLI: run
codex plugin marketplace add Roblox/roblox-studio-agent-plugin, then install Roblox Studio from/pluginsand start a new thread with/new.
Then ask your assistant Get me set up with Roblox Studio. It checks what is missing and asks you once before it installs or opens Studio. To test the connection, ask it to list your open Roblox Studio windows: it should name the place you have open.
Roblox's coding harness guide pairs the MCP connection with an editor: Cursor, or Visual Studio Code with an extension such as Claude Code. If you want the agent to write code as files as well as drive Studio, see Script Sync and Git below.
Other clients: JSON config or CLI command
The server works with any client that supports stdio transport. If yours has no quick connect, add Roblox Studio to its MCP configuration. These are the complete configurations Roblox documents. If Roblox Studio is your only MCP server, use them exactly as they are.
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}
{
"mcpServers": {
"Roblox_Studio": {
"command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
}
}
}
Where the config file lives depends on the client (Roblox's example calls it mcp.json). Roblox's instructions say to finish setup with your client's own documentation, then restart the client so it picks up the change.
CLI command
Some clients take a command instead of a config file. This is the command that starts the server, for you to register the way your client's documentation describes:
cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat
/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP
Both point at a file that Studio installs. On Windows, %LOCALAPPDATA% is your user's local app data folder. On macOS, the path runs inside RobloxStudio.app in /Applications. If the file is not there, the client cannot start the server: see Troubleshooting.
Step 3: Check the connection
- In Studio, open Assistant and click … > Settings > MCP Servers (Manage MCP Servers in older versions).
- Under Enable Studio as MCP server, look for the green indicator. It shows the number of connected clients.
- In your client, start with a request that only reads, so a wrong setup cannot change anything. For example: Using the Roblox Studio MCP tools, list what is in Workspace. Do not change anything.
On a fresh Baseplate the answer should list the default Camera, Terrain, Baseplate and SpawnLocation. Your client may ask you to approve the tool call, or offer to add the tool to an allowlist. Approving it once is enough for this test.
Can ChatGPT connect to Roblox Studio?
Yes, from the ChatGPT desktop app on macOS or Windows, or from Codex CLI. ChatGPT on the web or on a phone cannot: Studio's MCP server is a program on your computer, and Roblox's plugin page says ChatGPT web and mobile can help you plan and write Luau but cannot connect to Studio. These are the routes, checked 14 November 2026.
- ChatGPT desktop app: open Plugins, install Roblox's Roblox Studio plugin, and start a new chat. In Studio, turn on Enable Studio as MCP server and, under Quick connect, the ChatGPT (codex) switch, then restart ChatGPT. Ask Get me set up with Roblox Studio if anything is missing. We have not tested this route ourselves; the steps are Roblox's.
- Codex CLI: OpenAI's command-line coding agent is on the quick connect list, and OpenAI offers Sign in with ChatGPT the first time you run it, so a ChatGPT account works. The Codex side, including the approval setting that keeps Codex asking before it uses Studio's tools, is in how to connect ChatGPT to Roblox Studio with Codex.
- OpenAI model inside Studio: Assistant accepts an OpenAI API key. Open Assistant, click … > Manage API Keys, choose OpenAI, paste the key and pick a model. This is not MCP: you type in Studio's Assistant panel, not in ChatGPT.
Copying code from a ChatGPT chat into a Script still works, but nothing on that route reads your place or checks the result in Studio. The guide to using AI in Roblox Studio compares the options side by side, and Roblox Assistant vs ChatGPT covers which to use for what.
What tools the server gives your client
Roblox's MCP page lists 30 tools in ten groups (checked 14 November 2026; it listed 26 in September). Your client chooses which to call; you do not call them by hand. Every call carries a studio_id that names the Studio window it targets.
| Group | Tools | What they do |
|---|---|---|
| Scripts | script_read, multi_edit, script_search, script_grep | Read a script by a path such as game.ServerScriptService.MyScript, whole or by line range. Apply several edits in one go, creating the script if the path does not exist. Find scripts by name (up to 10 results) or search text across every script (up to 50 matches). |
| Assets and generation | generate_animation, generate_mesh, generate_material, generate_procedural_model, wait_job_finished, generate_avatar, search_asset, insert_asset, upload_image, store_image | Generate an R15 animation from text (up to 10 seconds) or convert an R6 one, meshes, materials, procedural models and a rigged R15 avatar. Search the Creator Store and your inventories, and insert an asset by ID. Upload images from URLs to Roblox, or load a local image to use as a reference. |
| Data model | subagent, search_game_tree, inspect_instance | Hand a multi-step job to an explore or playtest subagent, walk the instance hierarchy with filters and a depth limit, or read all readable properties and attributes of one instance. |
| Luau execution | execute_luau | Runs Luau in Studio in the Edit, Client or Server data model and returns the result or the error. |
| Playtesting | get_studio_state, start_stop_play, get_console_output, screen_capture | Check the play state, start or stop a playtest, read the Output log, and capture the viewport as an image, optionally from a camera position you give. |
| Player input | character_navigation, user_keyboard_input, user_mouse_input | Move the character to a position or instance, and send key presses, text, clicks and scrolls. |
| Docs and skills | http_get, skill | Fetch pages from allowed Roblox documentation sites, and load reference material for tasks such as debugging and device simulation. |
| Place management | save_place | Saves the open place like File > Save: a new place version for a place opened from Roblox, or back to the file for a local place. |
| Sessions | list_roblox_studios | List the connected Studio windows with their names, Studio instance IDs and place IDs. |
| Feedback | submit_feedback | Sends feedback to Roblox when a tool fails or a workflow takes too many steps. |
Two kinds of tool deserve attention. First, the ones that change things: multi_edit and execute_luau change your place directly, save_place writes a new version of it, insert_asset brings outside content into it by asset ID, and upload_image sends images to Roblox's asset server. Second, the playtest tools, which let an agent check its own work: Roblox's StudioTestService reference says start_stop_play starts a single Play Client session, and the input tools drive the character while it runs.
Roblox also routes other Studio features through the server: Scene Analysis data through SceneAnalysisService, MicroProfiler analysis, control of the Device Simulator, and an AI skill that converts a game to streaming. A playtest can follow a teleport to another place in the same experience and read that server's output, without publishing.
Open Cloud permissions: what the client may do to your game
Roblox adds one more tool, open_cloud_invoke, that calls Open Cloud APIs for you without an API key: uploading assets, editing developer products and game passes, changing game settings and more. Your client only gets what you allow, per game, and it never sees a credential.
- Open the permissions from the MCP button at the bottom right of Studio, or Assistant > … > Settings > MCP Permissions. Changes apply to the client's next request.
- Each game starts at Balanced (low and moderate risk scopes). Safe turns most off; Full access includes scopes that can cost Robux, affect players or publish to your live game.
- It needs a place saved to Roblox, because permissions are saved per game. In a local or unsaved place the tab shows Save to Roblox to manage MCP permissions. Save the place to Roblox, then open the tab again.
- In Studio 0.747 (16 November 2026) the tab sets an Access level and lists nine groups, each with Deny and Allow: Look at your game, Edit your game, Players & social, Save & load data, Connect to the internet, Publish & manage assets, Money & monetization, Player consequences, and Security & credentials. Under them, Open Cloud upload directories lists the folders MCP tools may upload local files from; none are allowed until you add one.
- Data store reads and writes from
execute_luauneed the Save & load data scopes and Enable Studio Access to API Services. Those writes change real player data, so read the DataStore tutorial before you let an agent near them. - Uploads create permanent assets owned by the game's owner, and Open Cloud cannot delete them. Keep upload folders and money scopes off until a task needs them.
Working with more than one Studio window
One client can connect to several running Studio windows at once. Because every tool call names its target with studio_id, the agent has to know which window you mean. It can call list_roblox_studios to see each window's name, Studio instance ID and place ID. Local places with no place ID are listed by name only, and when two windows share a name, the place ID tells them apart.
In practice: name the place in your prompt, and close any place you do not want touched. The server can reach every open place, not only the one you are looking at.
Work safely: back up, approve, review
Roblox's own warning is short: MCP clients can read and modify content in your open places, so connect only clients you trust. With tools that run code, insert assets and start playtests, one misread instruction can do real damage. These habits keep it recoverable.
- Save a version before each session. File > Save to Roblox with Notes (Ctrl+Alt+S, or Cmd+Option+S on Mac) creates a named checkpoint. To go back, open Window > Version History, click ⋮ next to that version, choose Open Local Copy, then use File > Save to Roblox As in the copy to restore it over the place. File > Save to File keeps a copy on your computer as well.
- Do not count on Ctrl+Z. Roblox's MCP page does not say whether a client's edits land in Studio's undo history, so treat your saved version as the way back.
- Work in a test copy, not the live game. With Enable Studio Access to API Services on (File > Experience Settings > Security), Studio reads and writes the same data stores as your live game, and Roblox advises turning it on only for a separate test version. That includes code an agent runs and playtests it starts.
- Keep approvals on for tools that change things. Allowlisting read tools such as
script_readandsearch_game_treeis low risk. Keep approvingmulti_edit,execute_luau,insert_assetandupload_imagecall by call until you trust the workflow. - Review before you keep it. Read the scripts it changed, check the Explorer for new or missing objects, and playtest yourself. An agent's playtest shows what it chose to check, not everything a player will do.
For bigger projects: Script Sync and Git
Roblox's coding harness guide pairs the MCP connection with two more pieces. Script Sync links Studio services to folders on disk, so an editor and an agent can work on .luau files that appear in Studio as scripts, and Git gives that code a history you can roll back. Commit a clean state before you ask an agent for anything big.
Script Sync covers scripts in the services you link; the MCP connection still covers what it cannot reach, such as StarterGui, playtests and the Output. The step-by-step setup, along with Rojo as the alternative, is in how to use Cursor or VS Code with Roblox Studio, and the Claude Code version is in how to use Claude Code with Roblox Studio.
Troubleshooting: when the client will not connect
Roblox's own checklist has three items: restart both Studio and the client, check that the command or binary path is correct and the file exists, and check the JSON syntax. These are the situations behind it. For a longer, step-by-step fix list, see Roblox Studio MCP not working.
I cannot find Manage MCP Servers
In current Studio it has moved: open Assistant from the top right of Studio, click … > Settings and choose the MCP Servers tab. Manage MCP Servers is the older name. If neither is there, update Roblox Studio to the latest version.
My client is not in the Quick connect list
The list shows only supported clients that are installed on your computer. Install the client, then restart Studio. If it is not one of the supported clients, use the JSON configuration or CLI command instead.
The client shows no Roblox tools, or says the server failed to start
Check that the file in your config exists: %LOCALAPPDATA%\Roblox\mcp.bat on Windows, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP on macOS. If Studio is installed somewhere other than /Applications on your Mac, change the path to match. Then restart the client, which Roblox says is needed to apply config changes, and restart Studio.
The config file stopped loading after I added Roblox Studio
A missing comma between two entries in mcpServers, or a stray bracket, makes the file invalid JSON and stops it loading. Check the file with a JSON validator, fix the line it reports, and restart the client.
There is no green indicator in Studio
The client has not connected. Check that Enable Studio as MCP server is still on and that you restarted the client after adding the server, then restart both Studio and the client.
The agent edited the wrong place
With more than one Studio window open, the client picks a target by studio_id. Ask it to run list_roblox_studios and name the place you mean, or close the other windows. Restore the place it changed from Version History.
The client asks for permission on every step
That is your client, not Studio. Roblox notes that you may need to approve a command or add the MCP tool to an allowlist. Allowlist the read-only tools if the prompts slow you down, and keep approving the ones that change your place.
Or skip the MCP setup: RoCode
RoCode (RoCode.app) is a different route, and it is not an MCP product. It is an independent AI agent for Roblox Studio: you describe a change in a web chat at rocode.app, and a free RoCode plugin from the Creator Store carries out the steps in the place you have open. There is no config file, command line or MCP server to set up. You allow the plugin's HTTP and Script Injection permissions in Studio. The plugin then connects by itself when Studio is signed in to the same Roblox account you use on RoCode; otherwise you pair the chat and the plugin once with the 8-character code shown in the plugin panel.
The trade-offs, stated plainly. RoCode cannot connect a Claude, Claude Code or ChatGPT subscription. It runs third-party models through OpenRouter under their own names: GPT-6 Luna on every plan, GLM 5.3 Flash and Claude Sonnet 5.5 from Pro, Claude Opus 5.5 from Studio and GPT-6 Astra from Ultra. With plugin 3.9 or newer it can run a short playtest and read the errors, and with plugin 3.9.11 or newer control a test character to check the game works. With plugin 3.9.14 or newer it also takes screenshots of what it built, in edit mode, and can fix what looks wrong. It does not run code directly or generate meshes, both of which the Studio MCP tools above can do. It can search the Creator Store with your words for free models (any scripts inside removed) or insert a model, decal or mesh by asset ID, and it designs scenery, buildings and props new for each game. The free Starter plan includes 1 credit a day. For how it compares with other tools, see Roblox AI tools compared.
I just playtested and got an error in RoundManager. Find the cause and fix it.
- Reads the Output from the playtest you ran with Check Output, including Server and Client lines, then opens the script around that line with Read Script
- Fixes the failing code in place with Edit Script, in the Studio window that is connected
- Compile-checks the script inside Studio with Check Script before it finishes. That is a compile check, not a type check or a playtest
- Sends its changes in batches, and each batch is an undo point in Studio's own history
With plugin 3.9 or newer, RoCode can run a short playtest and read the errors, and with plugin 3.9.11 or newer it can control a test character to check the game works, but it checks only what it chose to test, so press Play yourself and play a round to confirm the fix. How the plugin and pairing work. RoCode is an independent product, not affiliated with or endorsed by Roblox Corporation.
Questions
Is the Roblox Studio MCP server free?
It is built into Roblox Studio, and Roblox's MCP documentation mentions no charge or sign-up for it. The AI model comes through your client, so any limits or cost are those of the client's own account or plan.
Can I use ChatGPT with the Roblox Studio MCP server?
Yes, from the ChatGPT desktop app or Codex CLI, not from ChatGPT on the web or a phone. Install Roblox's Roblox Studio plugin from Plugins in the desktop app, turn on the MCP server in Studio, and switch on ChatGPT (codex) under Quick connect. The steps are in Can ChatGPT connect to Roblox Studio? above, and the Codex route is in how to connect ChatGPT to Roblox Studio.
Do I need to download the Roblox Studio MCP server from GitHub?
No. The server is built into current Roblox Studio and installs with it: StudioMCP on macOS, mcp.bat in %LOCALAPPDATA%\Roblox on Windows. Roblox's older open-source studio-rust-mcp-server repository is a separate, earlier project. Roblox's roblox-studio-agent-plugin on GitHub is only setup instructions for Claude and ChatGPT; it runs the built-in server.
How many tools does the Roblox Studio MCP server have?
Roblox's MCP page lists 30 tools in ten groups as of 14 November 2026, up from 26 in September, and the Open Cloud page adds open_cloud_invoke. The list grows with Studio updates, so the tool table above is a snapshot.
Can I connect claude.ai in the browser to Roblox Studio?
No. The server runs on your computer and talks over stdio, so it needs a client installed on the same machine: Claude Desktop, Claude Code, Cursor or another desktop client. Roblox's plugin page says claude.ai on the web can help plan and write Luau but cannot connect. For Claude Code, see how to use Claude Code with Roblox Studio.
Do I need an API key to connect Claude to Roblox Studio?
Not for MCP. Roblox's setup has no API key step, and your client uses its usual sign-in: the coding harness guide signs in to Claude Code with an Anthropic account. An API key is only needed for the other route, a Claude model inside Studio's Assistant through Manage API Keys.
Can the AI playtest my game through MCP?
Yes. start_stop_play starts and stops a playtest, get_console_output reads the Output, screen_capture captures the viewport, and the input tools move the character and send keys and clicks. The playtest subagent can run a gameplay scenario and check the outcome. Play it yourself too before you publish.
How do I connect Cursor to Roblox Studio?
In Studio, open Assistant, click … > Settings > MCP Servers and turn on Enable Studio as MCP server. Cursor is on the Quick connect list in that panel, so switch it on there. The green indicator shows when Cursor is connected; if it does not appear, restart both Studio and Cursor. The steps are in Quick connect above.
How do I connect Claude Desktop to Roblox Studio?
The same way: turn on Enable Studio as MCP server in Assistant's MCP Servers settings, then switch on Claude Desktop under Quick connect. It works on Windows and Mac. For Claude in a terminal, see how to connect Claude Code to Roblox Studio.
Does the Studio MCP server work on Mac?
Yes. Roblox documents a macOS configuration that points at /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP, next to the Windows one.
Sources and further reading
- Roblox Creator Docs: Connect to the Roblox Studio MCP server. enabling the server, quick connect, JSON and CLI setup, the tool list, multiple Studio windows and troubleshooting
- Roblox Creator Docs: Use Open Cloud with the Studio MCP server. open_cloud_invoke, MCP Permissions, access levels and permanent uploads
- GitHub: Roblox/roblox-studio-agent-plugin. Roblox's official plugin for Claude Code, Cowork, the ChatGPT desktop app and Codex CLI; the new Settings menu path and the ChatGPT (codex) switch (README read 14 November 2026)
- Roblox Developer Forum: Studio MCP Server Updates and External LLM Support for Assistant. using your own Anthropic, OpenAI or Google API key in Assistant
- Roblox Creator Docs: Build with a coding harness. Script Sync, MCP with Cursor or Visual Studio Code, and Git
- Roblox Creator Docs: Version History. saving with notes and restoring a previous version
- Roblox Creator Docs: Data stores. why Studio access to API services belongs on a test copy
- Roblox Engine API: StudioTestService. how the start_stop_play tool compares with scripted multi-client tests
- OpenAI: Codex CLI. signing in to Codex CLI, including Sign in with ChatGPT
- OpenAI: Model Context Protocol. local STDIO servers in the ChatGPT desktop app in Codex mode, and why ChatGPT on the web does not read local Codex configuration
- Model Context Protocol: Introduction. the open standard the Studio server implements