Start here: the one-minute checklist
- Update Roblox Studio. The MCP server needs the latest version.
- Check the toggle: Assistant, then …, then Manage MCP Servers, then Enable Studio as MCP server.
- Open a place. The tools act on open places, so an empty Studio start page gives your AI nothing to work on.
- Restart both Roblox Studio and your AI client after any config change. Most clients only read MCP config when they start.
- If you edited a JSON config, check it for a missing comma or bracket. One typo stops the whole file loading.
The built-in server doesn't show up in my AI client
- Your client isn't in Quick connect. Studio only lists clients that were installed when it started. Install the client, restart Studio, then switch it on under Quick connect.
- The path is wrong. On Windows the server is
%LOCALAPPDATA%\Roblox\mcp.bat, run throughcmd.exe /c. On macOS it is/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP. Check the file exists (see below). - The config never loaded. If you added the server next to others in
mcpServers, each entry needs a comma between it and the next. - The client wasn't restarted. Quit it fully, not just the window, and open it again.
Check the Windows path in PowerShell. It should print True:
Test-Path "$env:LOCALAPPDATA\Roblox\mcp.bat"If it prints False, update Studio and turn the MCP server toggle off and on again. The full setup for each client is in the setup guide.
Connected, but tools fail or can't find Studio
- No place is open. Open the place you want the AI to work on.
- More than one Studio window is open. Every built-in tool needs a
studio_id. Ask your AI to calllist_roblox_studiosand pick the right window. - The indicator shows 0 clients. The client didn't really connect. Restart it and watch the indicator under Manage MCP Servers.
- You're in a play test. Edits made while a play session runs change the running copy, not your saved place. Stop the play test first.
The server disconnects in the middle of a session
Restarting or updating Studio closes the connection, and your client may not reconnect on its own. Reconnect from the client: in Claude Code, type /mcp to see each server's status and reconnect it. In other clients, restart the session.
If it drops while Studio stays open, check that only one copy of Studio is running the place, then restart Studio and the client together.
Tufan-Blox-Bridge isn't connecting
Tufan has two parts: the MCP server your AI starts, and a Studio plugin that carries out each command. The pill on the Tufan Studio toolbar button shows whether they're talking.
- There's no Tufan Studio button. The plugin isn't installed. Run
tufan-blox-bridge install-plugin, then restart Studio. - The plugin was blocked from reaching 127.0.0.1. The plugin talks to the server on your own machine at
127.0.0.1:58741. If you denied Studio's permission prompt, open Manage Plugins in Studio and allow the plugin's HTTP access to127.0.0.1. - The server isn't registered properly. In Claude Code, run
claude mcp get tufan. The command should betufan-blox-bridgeornpx -y tufan-blox-bridge. If an argument got dropped, runclaude mcp remove tufanand add it again. - Node.js is too old. Run
node -v. You need version 18 or newer. - The pill goes grey while you work. When the plugin is offline, Tufan makes the script mirror read-only on purpose, so nothing on disk overwrites your place. It switches back when the plugin reconnects.
Windows: "npx" or "tufan-blox-bridge" isn't found
Some clients can't start npx directly on Windows. Install the server once, globally, and point your client at the installed command:
npm i -g tufan-blox-bridgeThen use tufan-blox-bridge as the command in your MCP config. If your client still can't find it, restart it so it picks up the new PATH, or set the command to cmd with the arguments /c npx -y tufan-blox-bridge.
Calls are slow or time out on big jobs
Roblox lets a plugin make about 500 HTTP requests a minute, which is roughly 240 Tufan calls. Past that, Tufan makes calls wait for the budget to refill instead of failing. For big builds, ask your AI to use batch, create_tree or mass_edit, which make thousands of changes in one call.
Still stuck?
- For Tufan-Blox-Bridge, open a GitHub issue with the output of the setup command and what the pill shows.
- For the built-in server, check Roblox's Studio MCP documentation and the Roblox Developer Forum.
- Setting up from scratch? Follow the setup guide for your client.