Guide · AI in Roblox Studio

How to connect Claude, Cursor or ChatGPT to Roblox Studio with MCP

Roblox Studio has a Model Context Protocol (MCP) server built in. Turn it on, connect an AI client such as Claude Code, Claude Desktop or Cursor, and that client can read your place, edit scripts, run Luau and start playtests in the Studio window you have open. This guide follows Roblox's own setup documentation and its official agent plugin for Claude and ChatGPT, and covers how to keep your place safe while an agent works in it.

Updated 16 November 202620 min readBeginnerWindows and macOSWritten by

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
  1. What it does
  2. 1. Turn on the server
  3. 2. Connect a client
  4. JSON config and CLI
  5. 3. Check it works
  6. ChatGPT
  7. Tools it exposes
  8. Open Cloud permissions
  9. Several Studio windows
  10. Work safely
  11. Script Sync and Git
  12. Troubleshooting
  13. Or skip the setup
  14. Questions
  15. Sources

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

The two routes Roblox documents
Studio MCP serverAssistant with your own API key
Where you typeIn your AI client, for example Claude Desktop, Claude Code or CursorIn Studio's Assistant panel
What you set upTurn on the server in Studio, then connect the clientAssistant > … > Manage API Keys, then choose the model
ModelsWhatever your client usesAnthropic, OpenAI or Google Gemini
What you needThe client and its own sign-inAn API key from that provider
Who acts in StudioYour client, through the MCP toolsAssistant, 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

  1. Open Roblox Studio and open a place. If Studio offers an update, install it first: the server needs the latest version.
  2. Click Assistant at the top right of Studio (the right side of the mezzanine bar) to open the Assistant window.
  3. Click … and choose Settings, then the MCP Servers tab. In older versions of Studio this menu item is called Manage MCP Servers.
  4. Turn on Enable Studio as MCP server.
Roblox Studio Assistant Settings, MCP Servers tab: the Enable Studio as MCP server switch, No clients connected, and Quick connect switches for ChatGPT (codex), Claude Code CLI and Claude Desktop
Studio screenshot. Assistant Settings > MCP Servers in Roblox Studio 0.747 (16 November 2026). Quick connect lists only the clients installed on that computer, here ChatGPT (codex), Claude Code CLI and Claude Desktop.

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.

  1. 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.
  2. Turn on the client you want.
  3. 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

What Roblox documents for each client, 30 September 2026
ClientRouteNotes
Claude Desktop (Anthropic)Quick connectThe desktop app. Roblox does not describe using Claude in a web browser.
Claude Code (Anthropic)Quick connectRoblox's coding harness guide uses it as a Visual Studio Code extension, signed in with an Anthropic account.
CursorQuick connectHas its AI assistant built in. Sign in with your Cursor account.
Visual Studio CodeQuick connectNeeds an AI extension, such as Claude Code.
Codex CLI (OpenAI)Quick connectThe 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
AntigravityQuick connect
Any other client with stdio supportJSON config, or the CLI commandSee 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) switchInstall 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 /plugins and 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.

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

CLI command · Windows
cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat
CLI command · macOS
/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

  1. In Studio, open Assistant and click … > Settings > MCP Servers (Manage MCP Servers in older versions).
  2. Under Enable Studio as MCP server, look for the green indicator. It shows the number of connected clients.
  3. 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.

Studio MCP server tools, from Roblox's documentation
GroupToolsWhat they do
Scriptsscript_read, multi_edit, script_search, script_grepRead 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 generationgenerate_animation, generate_mesh, generate_material, generate_procedural_model, wait_job_finished, generate_avatar, search_asset, insert_asset, upload_image, store_imageGenerate 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 modelsubagent, search_game_tree, inspect_instanceHand 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 executionexecute_luauRuns Luau in Studio in the Edit, Client or Server data model and returns the result or the error.
Playtestingget_studio_state, start_stop_play, get_console_output, screen_captureCheck 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 inputcharacter_navigation, user_keyboard_input, user_mouse_inputMove the character to a position or instance, and send key presses, text, clicks and scrolls.
Docs and skillshttp_get, skillFetch pages from allowed Roblox documentation sites, and load reference material for tasks such as debugging and device simulation.
Place managementsave_placeSaves 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.
Sessionslist_roblox_studiosList the connected Studio windows with their names, Studio instance IDs and place IDs.
Feedbacksubmit_feedbackSends 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_luau need 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.
Roblox Studio Assistant Settings, MCP Permissions tab showing the message Save to Roblox to manage MCP permissions, the Access level drop-down and Deny or Allow choices for Look at your game and Edit your game
Studio screenshot. MCP Permissions in a place that is not saved to Roblox: the banner at the top is the "Save to Roblox to manage MCP permissions" message. Roblox Studio 0.747, 16 November 2026.

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_read and search_game_tree is low risk. Keep approving multi_edit, execute_luau, insert_asset and upload_image call 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.

You type

I just playtested and got an error in RoundManager. Find the cause and fix it.

RoCode does
  • 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

Try RoCode on your own place.

Free every day, no card required. Install the plugin, describe the feature, and review what lands in Studio.