Connect MCP

Connect MCP in your IDE

Editors such as Cursor, Visual Studio Code, and Claude Desktop load MCP servers from an mcpServers configuration. Point that configuration at the Roblox Studio MCP server (below) or at any other MCP server that exposes source tools.

1. Open your editor's MCP config file — e.g. .cursor/mcp.json in Cursor, .vscode/mcp.json in VS Code, or claude_desktop_config.json in Claude Desktop.
2. Add an entry to the mcpServers dictionary using the appropriate command for your OS:

Windows

{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "%LOCALAPPDATA%\\Roblox\\mcp.bat"
      ]
    }
  }
}

macOS

{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
    }
  }
}

If your config already has entries, merge the Roblox_Studio key into the existing mcpServers object and keep each entry comma-separated — a missing comma makes the whole file invalid.

Roblox Studio official MCP

Roblox Studio ships a built-in MCP server. Once connected, your AI client can explore the data model, read and edit scripts, run Luau code, and start playtesting inside your open Studio session. Use the latest version of Studio and install your preferred MCP client first.

1. Open Studio and go to Assistant. (top right beside the avatar icon) Click AI Assistant
2. Click … > Then click Manage MCP Servers.
3. Turn on Enable Studio as MCP server.
4. Connect your client using Quick connect, the JSON config above, or the CLI command below.

Quick connect — supported for Antigravity, Codex CLI, Claude Code, Claude Desktop, Cursor, Gemini CLI, and Visual Studio Code. In Assistant Settings ⟩ MCP Servers, expand Quick connect and turn on your installed client. Restart Studio if your client is not listed.

CLI command — if your client needs a command instead of a JSON file, use the one for your OS:

Windows

macOS

After adding the config or command, restart your client to apply changes, then confirm the connection in Studio under Manage MCP Servers — a green indicator shows the number of connected clients. You can connect to multiple Studio instances and switch between them with list_roblox_studios and set_active_studio.

What the Studio MCP server can do

• Scripting — read scripts by dot-notation path, apply edits, fuzzy-search script names, and grep across the game.
• Data model — search the instance hierarchy and inspect instance properties.
• Luau execution — run Luau in Edit, Client, or Server datamodels and read the result.
• Playtesting — start/stop play mode, read console output, capture the viewport, and simulate keyboard/mouse/character input.
• Assets — search and insert Creator Store assets, upload images, and generate meshes, materials, and procedural models.

Combine these tools with the AI workflow: let your assistant install components with npx robloxui add, sync with Rojo, then use the Studio MCP tools to inspect and playtest the result.

Troubleshooting & security

• Restart both Roblox Studio and your MCP client.
• Verify the command or binary path is correct and the file exists.
• Check your JSON syntax — a missing comma or bracket prevents loading.
• MCP clients can read and modify open places. Only connect clients you trust, and never commit MCP credentials or API keys.