Roblox Studio MCP Setup

How to connect Roblox Studio MCP to Claude Code, Codex, Cursor and more

Roblox Studio ships with its own MCP server, and you can add a free one on top for snapshots, git and file sync. This guide sets up both, for every common AI client, in about five minutes.

By Tufan Studio · Updated

What you need

  • The latest version of Roblox Studio, on Windows or macOS.
  • An MCP client: Claude Code, Claude Desktop, Codex CLI, Cursor, Antigravity, Gemini CLI or VS Code.
  • Node.js 18 or newer, only if you add the Tufan plugin in step 2.

MCP, the Model Context Protocol, is how AI coding tools call other software. A Roblox Studio MCP server gives your AI tools to read and change the place you have open, so it can write Luau, build instances and run play tests for you.

Step 1: Turn on Roblox's built-in Studio MCP server

  1. In Roblox Studio, open Assistant.
  2. Click … and choose Manage MCP Servers.
  3. Turn on Enable Studio as MCP server. A green indicator shows how many AI clients are connected.
  4. Under Quick connect, switch on your AI client. Roblox lists Antigravity, Codex CLI, Claude Code, Claude Desktop, Cursor, Gemini CLI and Visual Studio Code.
  5. Restart your AI client so it loads the new server.

For any other MCP client, add the server by hand. The built-in server talks over stdio. This is the entry from Roblox's documentation for Windows:

Built-in server, Windows (JSON)
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "cmd.exe",
      "args": ["/c", "%LOCALAPPDATA%\\Roblox\\mcp.bat"]
    }
  }
}

On macOS, use this as the command instead, with no arguments:

Built-in server, macOS (command)
/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP

The built-in server is the one to use for play tests, viewport screenshots, simulated keyboard and mouse input, and Roblox's AI mesh, material and animation generation. Every one of its tools needs a studio_id, which your AI gets from list_roblox_studios.

Step 2: Add Tufan-Blox-Bridge (free, optional)

The built-in server runs and sees your game. It doesn't keep your work safe or versioned. Tufan-Blox-Bridge is a free, MIT-licensed MCP server and Studio plugin that adds snapshots, a disk copy of your scripts and GUIs with history, git, a backdoor scanner and Luau linting. It runs alongside the built-in server and tells your AI which one to use for each job.

Open a terminal in your Roblox project folder and run:

Install Tufan-Blox-Bridge
npx -y tufan-blox-bridge@latest setup
  • It installs the MCP server globally, so the command tufan-blox-bridge works from anywhere.
  • It copies the Studio plugin into your Plugins folder.
  • It registers the server with Claude Code if the claude command is on your PATH, and with Cursor if the folder has a .cursor folder.
  • For any other client, it prints the config to add. The sections below show it for each one.

Restart Roblox Studio. If Studio asks whether the plugin may connect to 127.0.0.1, allow it, because that is your own machine. Then open the Tufan Studio button in the toolbar. A green pill means your AI is connected.

Claude Code

Built-in server: switch on Claude Code under Quick connect in Studio. Tufan: the setup command registers it for the folder you ran it in. To add it by hand:

Claude Code
claude mcp add tufan --env TUFAN_PROJECT=C:/path/to/your/project -- tufan-blox-bridge

Run claude mcp list to check both servers, or type /mcp inside Claude Code to see their status.

Claude Desktop

Built-in server: switch on Claude Desktop under Quick connect. By hand: open Settings, then Developer, then Edit Config, and add both servers to claude_desktop_config.json. Claude Desktop has no project folder, so set TUFAN_PROJECT here.

claude_desktop_config.json (Windows)
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "cmd.exe",
      "args": ["/c", "%LOCALAPPDATA%\\Roblox\\mcp.bat"]
    },
    "tufan": {
      "command": "tufan-blox-bridge",
      "env": { "TUFAN_PROJECT": "C:/path/to/your/project" }
    }
  }
}

Keep any servers you already have inside mcpServers, separated by commas, then fully quit and reopen Claude Desktop.

Codex CLI

Built-in server: switch on Codex CLI under Quick connect. Tufan: add it with one command:

Codex CLI
codex mcp add tufan --env TUFAN_PROJECT=C:/path/to/your/project -- tufan-blox-bridge

Or add it to ~/.codex/config.toml:

config.toml
[mcp_servers.tufan]
command = "tufan-blox-bridge"

[mcp_servers.tufan.env]
TUFAN_PROJECT = "C:/path/to/your/project"

Cursor

Built-in server: switch on Cursor under Quick connect. Tufan: create a .cursor folder in your project before running the setup command and it writes .cursor/mcp.json for you. To do it by hand, add the tufan entry from the Claude Desktop example to .cursor/mcp.json in your project, or to ~/.cursor/mcp.json for every project.

Antigravity

Built-in server: switch on Antigravity under Quick connect. Tufan: Antigravity keeps MCP servers in mcp_config.json, under the same mcpServers key as the Claude Desktop example. Open it from the MCP servers screen in Antigravity's settings (older builds call it Manage MCP Servers, then View raw config), add the tufan entry, save and restart the agent.

Gemini CLI

Built-in server: switch on Gemini CLI under Quick connect. Tufan:

Gemini CLI
gemini mcp add -e TUFAN_PROJECT=C:/path/to/your/project tufan tufan-blox-bridge

You can also add the tufan entry to the mcpServers object in Gemini CLI's settings.json.

VS Code

Built-in server: switch on Visual Studio Code under Quick connect. Tufan: VS Code uses a servers key instead of mcpServers. Add this to .vscode/mcp.json in your project:

.vscode/mcp.json
{
  "servers": {
    "tufan": {
      "type": "stdio",
      "command": "tufan-blox-bridge",
      "env": { "TUFAN_PROJECT": "C:/path/to/your/project" }
    }
  }
}

Check that it works

  1. Open a place in Roblox Studio. MCP tools work on the places you have open.
  2. In Studio, the built-in server's indicator under Manage MCP Servers should show at least one connected client, and the Tufan Studio pill should be green.
  3. Ask your AI: "List the open Roblox Studio sessions." That uses the built-in server.
  4. Ask your AI: "Use Tufan to run project_health on my place." You should get a count of instances, scripts and parts.

Not connecting? The troubleshooting guide covers every error we've hit. Comparing options first? See the best Roblox Studio MCP servers.