Vi3W
Skip to content

Guides

Roblox Studio MCP server not connecting: fixes

Fix Roblox Studio MCP connection problems with Claude, Codex, Cursor and others: server switch, quick connect, paths, JSON, restarts and more.

3 min read

A glowing cable with an unplugged connector and small sparks beside a low-poly game island
Illustration. Most connection problems are a switch, a path or a restart.

Quick answer

Why won't my AI tool connect to Roblox Studio's MCP server?

Check that Studio is open with a place loaded and Enable Studio as MCP server is on, then restart both Studio and your AI client. If you set it up by hand, make sure the command path exists and your JSON is valid. Web and mobile chat apps can't connect, because the server runs on your computer.

Work through these in order

1. Is the server switched on?

In Studio: Assistant ⟩ … ⟩ Manage MCP Servers (or Settings ⟩ MCP Servers) ⟩ Enable Studio as MCP server. A green indicator shows how many clients are connected (Studio MCP). No indicator means nothing is connected yet.

2. Is Studio open with a place?

Roblox's official plugin setup has you sign in and open a place before connecting (plugin README). Studio's home screen isn't enough.

3. Are both apps up to date, and restarted?

Roblox's first troubleshooting step is to restart both Roblox Studio and your MCP client. Also install the latest Studio. Older versions may lack the server or have different menus.

4. Is your client in quick connect?

Quick connect supports Antigravity, Codex CLI, Claude Code, Claude Desktop, Cursor, Gemini CLI and Visual Studio Code. If your client isn't in the list, Roblox says to install it and restart Studio.

Two glowing connectors almost touching with a gap of light between them
Illustration. Close, but not connected: usually a path or a restart.

5. Manual setup: is the command right?

If you configured it yourself:

  • macOS command: /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP. Check the file exists at that path. If Studio is installed somewhere else, adjust it.
  • Windows command: cmd.exe with args /c and %LOCALAPPDATA%\Roblox\mcp.bat.
  • It's stdio, not a URL. If you're looking for a server URL, there isn't one in the official setup.
  • JSON syntax. A missing comma between mcpServers entries makes the whole config fail to load.

6. Are you on a web or mobile app?

The server runs locally, so claude.ai on the web and ChatGPT web and mobile can't connect. Use Claude Code, Claude Desktop, Codex CLI, the ChatGPT desktop app or a supported editor.

7. Claude Code shows one failed server

With Roblox's plugin, /mcp lists plugin:roblox-studio:macos and plugin:roblox-studio:windows. Only the one for your operating system connects. The other showing as failed is expected.

8. Several Studio windows

One client can connect to several Studio instances, and each tool call takes a studio_id. If commands go to the wrong place, ask the assistant to run list_roblox_studios and pick the right one.

9. Old open-source server still installed

Roblox's earlier open-source MCP server is archived and the built-in one is recommended. Remove old config entries so they don't conflict.

Check it worked

Ask your assistant: "list my open Roblox Studio windows." It should name your place. In Codex, codex mcp list shows Roblox_Studio.

Still stuck?

Post on the DevForum with your OS, Studio version, client and exact error. More setup detail is in Roblox Studio MCP server and build Roblox games with Claude.

Once you're connected

Your agent can handle code, objects and playtests. For models in your own style, Vi3W turns prompts, photos or sketches into textured, retopologised meshes exported as GLB, FBX or OBJ to import. Make models in Vi3W.

Last reviewed