Guide · AI in Roblox Studio

Roblox Studio MCP not working or not connecting: causes and fixes

The MCP server built into Roblox Studio usually connects with one switch. When it does not, the client rarely says why. This page lists the failures we could ground in a source: Roblox's documentation, Roblox staff replies on the Developer Forum, and bug reports from creators. Each fix says which of those it comes from. Fixes reported by users are labelled that way, because Roblox has not confirmed them. Everything was checked on 13 November 2026. For first-time setup, start with the Studio MCP setup guide.

Updated 13 November 202618 min readChecked 13 November 2026Windows and macOSWritten by

In short

Roblox documents three checks when the server does not show up or its tools are missing: restart both Roblox Studio and your MCP client, check that the command or binary path is correct and the file exists, and check your JSON syntax. Then open Assistant > … > Manage MCP Servers, confirm Enable Studio as MCP server is still on, and look for the green indicator with the number of connected clients.

  • On Windows, several creators report that the generated mcp.bat launcher fails when a folder in the path has a space in its name, for example a Windows user name with a space. The fix they report is to point the client straight at StudioMCP.exe.
  • If Studio says it "couldn't authenticate with the MCP server", Roblox staff confirmed a new connection check was switched on around 27 October 2026 and said a fix is planned. Quit your AI clients, stop every running StudioMCP process, start the client, then start Studio.
  • If the client is connected but the agent sees no Studio window, restart the AI client. Roblox says to restart it once after Studio updates itself.
On this page
  1. Where it breaks
  2. Roblox's three checks
  3. Server switched off
  4. Windows launcher
  5. Authentication
  6. Client updates
  7. No Studio listed
  8. One tool fails
  9. Report it
  10. Error messages
  11. Without MCP
  12. Questions
  13. Sources

How the connection works, and where it breaks

Roblox's documentation describes the server as a local process on your machine that talks to the AI client over stdio (standard input and output). Your client starts that process with a command. On Windows the documented command runs %LOCALAPPDATA%\Roblox\mcp.bat, and on macOS it runs /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP. The process then reaches the Studio windows you have open.

So there are three links in the chain, and each one fails in its own way: the client has to start the launcher, the launcher has to start StudioMCP, and StudioMCP has to find a Studio window with the server switched on. The table sorts the symptoms by link.

Symptoms, likely causes and where to read on
What you seeLikely causeSection
The client shows no Roblox server, or no toolsThe config did not load, the path is wrong, or the client was not restartedRoblox's three checks
Studio shows 0 connected clients and no green indicatorThe server setting is off, or the client never started the launcherThe server is switched off
Windows: the client reports "Connection closed" or error -32000The launcher failed, often on a path with a space in it (reported by users)Windows launcher
Studio shows "Studio couldn't authenticate with the MCP server"A connection check Roblox switched on around 27 October 2026Authentication
It broke right after the client updatedA change in the client that Studio's server did not expectClient updates
The client is connected, but the agent finds no Studio windowA stale connection, or the Assistant plugin did not loadNo Studio listed
Tools connect, but one tool failsA permission, an unsaved place, or a known issueOne tool fails

Start with Roblox's three checks

Roblox's MCP page has a short troubleshooting list for when "the server is not showing up, or the tools aren't available". These are its three items, with the detail the same page gives elsewhere.

  1. Restart both Roblox Studio and your MCP client. The page also says to restart the client after adding the configuration, and to install a missing client and restart Studio if it does not appear under Quick connect.
  2. Verify that the command or binary path is correct and the file exists. On Windows that file is %LOCALAPPDATA%\Roblox\mcp.bat. On macOS it is /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP, so a copy of Studio somewhere else needs a different path. Roblox's agent plugin README names /Applications and ~/Applications as the two places it looks.
  3. Check your JSON syntax. Roblox notes that a missing comma or bracket can stop the configuration from loading. If the file holds other servers, each entry needs a comma between it and the next.

Two requirements sit above that list. Roblox asks for the latest version of Roblox Studio, and the client must be installed on the same computer, because the server is a local process. The server works with any client that supports stdio transport. A client that only connects to remote servers by URL cannot start it.

Check what Studio sees

  1. In Studio, open Assistant and click … > Manage MCP Servers. Roblox's agent plugin README gives the path in newer versions as … > Settings > MCP Servers.
  2. Check that Enable Studio as MCP server is on.
  3. Look for the green indicator under it. Roblox says it shows the number of connected clients.
  4. Hover the tooltip on the MCP Servers page to see which AI clients are connected. Roblox added this list in August 2026 and says to check it when an agent is not responding.

If Studio shows your client as connected, the launcher and the config are fine, and the problem is further along: go to No Studio listed or One tool fails. If it shows no clients, the problem is the setting, the launcher or the client.

The server is switched off, or a new window never starts it

The setting can be off without you having touched it. In its update of 19 August 2026, Roblox said it had fixed "the MCP Server disabling itself": several people had reported the setting turning off on its own, which meant no Studio windows showed up when their client listed them.

  • Check the switch first. Open Assistant > … > Manage MCP Servers and turn Enable Studio as MCP server back on if it is off. Then restart the client.
  • Update Studio. The fix above arrives with a Studio update, and Roblox's page asks for the latest version.
  • Reported by a user on macOS (September 2026): every new Studio window needed the switch turned off and on again before the server was live. Roblox staff replied that this "is definitely a buggy behaviour". The reporter traced it to the place opening before Assistant had loaded. The thread ends without a confirmed fix, so toggling the switch in the new window is the workaround.

If the Manage MCP Servers entry or the Assistant button itself is missing, see how to open or reopen the Assistant panel.

Windows: the launcher fails on a path with a space

This section is built from user bug reports on the Developer Forum, dated 30 May 2026 and 5 November 2026. Neither thread has a reply from Roblox. In a related thread, Roblox staff asked a creator whose client would not connect whether their Windows user name contained spaces or non-Latin characters, which points the same way.

The reports say the mcp.bat file that Studio generates breaks when a folder in the path has a space in its name, such as C:\Users\Jane Doe. The launcher stops before it starts StudioMCP.exe, so the client gets no answer. What creators report seeing:

  • In the client: the connection closes at once, with MCP error -32000 or "Connection closed".
  • When the launcher is run by hand in a command window: a line such as 'C:\Users\Jane' is not recognized as an internal or external command, operable program or batch file. The path is cut at the first space.
  • In Studio: 0 connected clients, even after restarting both programs.

The fix users report: point the client at StudioMCP.exe

Both reports say that skipping the launcher works. StudioMCP.exe sits in Studio's current version folder under %LOCALAPPDATA%\Roblox\Versions. Find the newest copy, then use its full path as the command, with no cmd.exe and no arguments. In JSON every backslash is written twice.

Reported by users, not documented by Roblox · Windows
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "C:\\Users\\YOUR_USER\\AppData\\Local\\Roblox\\Versions\\YOUR_VERSION_FOLDER\\StudioMCP.exe"
    }
  }
}

If your path has no spaces and the launcher still fails, run the documented command in a command window and read what it prints: cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat. If it prints an error line, that line is what to put in a bug report.

Studio says it could not authenticate with the MCP server

A creator reported on 27 October 2026 that Studio stopped connecting overnight with no update on their side. Studio kept showing "Studio couldn't authenticate with the MCP server. Restart your AI clients, then try again.", the Studio log repeated a 401 Unauthorized line, and list_roblox_studios came back empty in Claude Code and Codex. Restarting did not help.

Roblox staff confirmed in that thread that a new check on the link between Studio and StudioMCP was switched on around 27 October 2026, and wrote on 2 November 2026 that they would work on a fix. In this case the cause was the Claude desktop app for Windows. It is installed as a packaged app, so the StudioMCP process it started saved its authentication file inside Claude's private app data folder, where Studio could not see it.

These are the steps staff suggested in the thread, in the order that changes least:

  1. Quit every AI client that uses the server (staff named Claude Desktop, Claude Code and Codex), then stop every running StudioMCP process. Staff noted that an old copy still running may not support the new check.
  2. Start the AI client again, then start Studio.
  3. Delete old Studio versions from %LOCALAPPDATA%\Roblox\Versions, keeping the latest one that your Studio shortcut opens.
  4. Check that Studio and the client run as the same Windows user. Staff asked the reporter this.
  5. If the client is a packaged Windows app, the authentication file may be in that app's private folder. Staff's temporary fix was to copy it to the folder Studio reads, %LOCALAPPDATA%\Roblox\StudioMCP. The thread gives the exact file name and a command that finds every copy. Follow the thread for this step, since Roblox says a proper fix is coming.

The reporter also found a settings override that switches the check off. Staff asked them to remove it, so it is not listed here.

It stopped working after the client updated

The server and the clients are updated by different companies, and a change on one side can break the connection until the other side catches up. These are the cases on the Developer Forum this year. If yours broke on the day your client updated, search the forum's Studio Bugs category for the client's name before changing your config.

Client-specific failures reported on the Developer Forum in 2026
ClientWhat was reportedStatus on 13 November 2026
Claude CodeFrom version 2.1.281 (about 25 September 2026) the Studio tools stopped loading. Users saw "Invalid result for tools/list".Fixed by Roblox on 27 September 2026, staff reply. Restart Studio when it offers an update.
AntigravityFrom late July 2026, the connection closed with an EOF error. Users traced it to a server/discover request Antigravity sends before initialize.No Roblox fix confirmed in the threads we read, which closed in September 2026. Users report that an older Antigravity version, or a wrapper script, works. We have not tested either.
ChatGPT desktop appStudio showed 0 connections after adding the server by hand and with quick connect. The reporter fixed it on 22 October 2026 by installing the Roblox Studio plugin from the plugins list in a new ChatGPT chat.That plugin is Roblox's own: its README says to open Plugins in the ChatGPT desktop app, install Roblox Studio and start a new chat, and to turn on ChatGPT (codex) under Quick Connect in Studio. ChatGPT on the web and on a phone cannot connect.
Any client, after a Studio updateOn 19 August 2026 Roblox changed every tool to take a studio_id and removed set_active_studio.Roblox: "restart your AI client once after Studio updates itself". Clients then pick up the new tools.

A client that still calls set_active_studio, or the older run_code and insert_model tools, is working from an old tool list or is connected to the archived open-source server. Restart the client, and check that your config points at the built-in server's command.

The client is connected, but the agent finds no Studio window

Here the client has started StudioMCP, and Studio may even show a connected client, but list_roblox_studios returns an empty list or leaves a window out. The agent then says Studio is not open when it is.

  • Restart the AI client. Roblox's own instruction after a Studio update is to restart the client once. Users on the forum report the same fix when the list comes back empty.
  • Reported by users (July to September 2026): a Studio window opened after StudioMCP was already running was not found, and with several windows open only some were listed. One reporter found that opening the MCP panel inside the new Studio window made it register. Restarting the client, so that it starts a fresh StudioMCP, is the other workaround. No staff reply is in that thread.
  • Check the Output window for a plugin load failure. A creator working in a Team Create place found the line "Failed to load plugin" naming Assistant.rbxm. With the Assistant plugin not loaded there is no server in that window. Roblox staff's fix in that thread: restart Studio; if the line is still there, delete the downloaded copy of Assistant.rbxm so Studio fetches it again, then restart Studio, possibly twice. The file is in ~/Library/Roblox/OTAPlugins/Deployed/BuiltInStandalonePlugins on macOS and %LOCALAPPDATA%\Roblox\OTAPlugins\Deployed\BuiltInStandalonePlugins on Windows.
  • Name the window. Every tool call carries a studio_id. With more than one place open, ask the agent to run list_roblox_studios and tell it which place you mean. Roblox says local places with no place ID are listed by name only.

Roblox also fixed, in the 19 August 2026 update, the server returning "method not implemented" for valid tool calls, which it says happened when parts of the server lost connection to each other. If you still see that message, update Studio and restart the client.

The tools connect, but one of them fails

Single-tool failures with a documented or staff-confirmed cause
What failsCauseFixSource
execute_luau cannot make HTTP requestsThe place has not been saved to Roblox. Roblox lists this as a known issue: the client can only reach domains on your HTTP allow list, and you cannot add domains until the place is saved.Save with File > Save to Roblox or Publish to Roblox, then add the domains under Connect to the internet > HTTP domain allow list.Roblox announcement, update of 5 November 2026
open_cloud_invoke is refusedOpen Cloud permissions are saved per game, so an unpublished local place cannot use them. The client can only use scopes you have enabled, and you need permission to manage the game.Open a place that belongs to a published game. Click MCP in the bottom-right corner of Studio, open the MCP Permissions tab and enable what the task needs.Roblox docs
Data store or memory store calls fail from execute_luauWhether they work is one of the per-game MCP permissions.Check the MCP Permissions tab. Use a test copy of the game, because the calls touch real data.Roblox docs
"Target is not reachable" during a playtestA Studio bug in May 2026: execute_luau, screen_capture and the input tools failed in Play mode while Edit mode worked.Fixed by Roblox on 27 May 2026. Staff said restarting Studio a few times picks up the fix.Staff reply on the Developer Forum
Assistant itself answers "User is not authenticated"Studio's sign-in had lapsed. This is Assistant's own request failing, not the MCP link.Reported by a user: sign out of Studio and sign in again.User report, September 2026

If the client asks you to approve every tool call, that is the client's own safety setting and not a fault. Roblox staff note that clients handle approvals differently and point to each client's documentation. The setup guide covers which tools are reasonable to allowlist.

Still stuck: report it so Roblox can fix it

Several of the fixes above exist because someone filed a clear report and Roblox staff answered within days. If nothing here matches, a report is the fastest route.

  1. Search first. Search the Developer Forum for the exact error text and your client's name. Add to an open thread rather than starting a second one.
  2. Collect the facts staff ask for. In the threads we read, staff asked for the MCP config, Studio log files, whether the Windows user name has spaces, and whether Studio and the client run as the same user. Add your Studio version, your client and its version, and your operating system.
  3. Follow the forum's how to post a bug report guide. It explains how to send log files privately. Leave API keys and authentication files out of public posts.
  4. Let the agent report tool failures. The server has a submit_feedback tool that, in Roblox's words, sends feedback to Roblox when a tool fails, a capability is missing, or a workflow takes more steps than it should.

While you wait, Assistant inside Studio can do much of the same work without an outside client: Roblox says every MCP tool available in Assistant is also available through the built-in server. If Assistant's own limits are the reason you set up MCP, the Assistant limits guide covers the options.

Error messages and what they point to

Roblox's documentation lists no error messages for the MCP server. These are messages creators quoted in Developer Forum reports, with the section that covers each one.

"Connection closed" or "MCP error -32000"

The client started the command and the process ended before it answered. On Windows, creators report this when the mcp.bat launcher fails on a path with a space. See Windows launcher. On any system, check that the path in your config exists.

"is not recognized as an internal or external command, operable program or batch file"

A Windows command window could not run part of the launcher line, usually because a path was cut at a space. Reported by users. See the direct path workaround.

"Studio couldn't authenticate with the MCP server. Restart your AI clients, then try again."

A connection check Roblox switched on around 27 October 2026, confirmed by staff. Quit the clients, stop every StudioMCP process, start the client, then Studio. See Authentication.

"expect initialized request" with "server/discover" and "EOF"

Reported by Antigravity users from late July 2026: the client sends a request the server does not expect before initialize, and the server closes the connection. No Roblox fix was confirmed in the threads we read. See Client updates.

"Invalid result for tools/list"

Reported with Claude Code 2.1.281 and later in late September 2026. Roblox staff said a fix rolled out on 27 September 2026. Update and restart Studio.

"method not implemented"

Roblox says this was returned for valid tool calls when parts of the server lost connection to each other, and that it was fixed in the 19 August 2026 update. Update Studio and restart the client.

"Target is not reachable"

In May 2026 this was a Studio bug during playtests, fixed by Roblox on 27 May 2026. A creator also reported it in September 2026 alongside a Studio window listed with no name, where the Assistant plugin had failed to load. See No Studio listed.

"Failed to load plugin" naming Assistant.rbxm

The Assistant plugin did not load in that window, so there is no MCP server in it. Staff's fix: restart Studio, and if it persists delete the downloaded Assistant.rbxm so Studio fetches a fresh copy. The paths are in No Studio listed.

Claude Code shows one Roblox Studio server as failed

If you installed Roblox's official plugin, this is expected. Its README says /mcp lists a macOS entry and a Windows entry, and only the one for your operating system connects.

The agent says "please open Roblox Studio" when it is open

list_roblox_studios returned nothing. Check that Enable Studio as MCP server is on in that window, then restart the AI client.

A route with no MCP server: RoCode

RoCode (RoCode.app) is an independent AI agent for Roblox Studio, and it is not an MCP product. 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 launcher. You allow the plugin's HTTP and Script Injection permissions in Studio, and the plugin connects by itself when Studio is signed in to the same Roblox account you use on RoCode, or with the 8-character code shown in the plugin panel. The trade-offs: RoCode cannot connect a Claude, Claude Code or ChatGPT subscription, and it does not run code directly or generate meshes, both of which the Studio MCP tools can do. The free Starter plan includes 1 credit a day.

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, 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

Press Play yourself afterwards to confirm the fix. How the plugin and pairing work. RoCode is an independent product, not affiliated with or endorsed by Roblox Corporation.

Questions

Why is my Roblox Studio MCP server not connecting?

The usual causes are a client that was not restarted after setup, a wrong path in the config, invalid JSON, or the Enable Studio as MCP server setting being off. Those are the cases Roblox documents. On Windows, creators also report the launcher failing when a folder in the path has a space, and since late October 2026 an authentication check can block the link until the clients and Studio are restarted in order.

Where is the Roblox Studio MCP setting?

In Studio, open Assistant, click … and choose Manage MCP Servers. The switch is Enable Studio as MCP server. A green indicator under it shows the number of connected clients.

Do I need to install the Roblox MCP server from GitHub?

No. The server is built into Studio. Roblox's GitHub repository for the older standalone server is archived, and its README says it is no longer actively developed and recommends the built-in server.

Why does the agent say no Studio instance is connected?

The client reached the server, but the server did not find your Studio window. Check that the setting is on in that window, restart the AI client, and look in Studio's Output window for a "Failed to load plugin" line that names Assistant.

Does the Studio MCP server work with ChatGPT?

With the ChatGPT desktop app, yes, through Roblox's official Roblox Studio plugin: its README lists the ChatGPT desktop app and the Codex CLI. A creator whose desktop app showed 0 connections reported in October 2026 that installing that plugin fixed it. We have not tested it ourselves. The same README says ChatGPT on the web and on a phone cannot connect, because the server runs on your computer. More in the setup guide.

Is it safe to edit the MCP config by hand?

Yes, if you keep the JSON valid. Roblox documents the full configuration for Windows and macOS. Copy only the Roblox_Studio entry into an existing file, keep a comma between entries, and restart the client afterwards.

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.