Skip to main content

​
Quick Start Guide

This guide gets you from zero to running AI commands in Roblox Studio in under 5 minutes.

​
Prerequisites

  • Roblox Studio installed and running
  • MCP-compatible AI client (Claude Code, Claude Desktop, etc.)
  • Node.js installed (for npx command)

​
Installation Steps

1

Install MCP Server

Choose your AI client and install the MCP server:
Run this command in your terminal:
claude mcp add robloxstudio -- npx -y robloxstudio-mcp
This automatically configures Claude Code to use the Roblox Studio MCP server.
Windows Users: If you encounter issues with npx, use this configuration instead:
{
  "mcpServers": {
    "robloxstudio-mcp": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "robloxstudio-mcp@latest"]
    }
  }
}
2

Install Studio Plugin

The MCP server requires a companion plugin in Roblox Studio:
  1. Visit the Creator Store page
  2. Click “Install” button
  3. Plugin opens automatically in Studio — no restart needed!
3

Enable HTTP Requests

The plugin needs HTTP access to communicate with the MCP server:
  1. In Roblox Studio, open Game Settings (Home tab → Game Settings)
  2. Navigate to Security section
  3. Enable “Allow HTTP Requests”
  4. Click OK to save
Without this setting, the plugin cannot connect to the MCP server. The plugin will show “HTTP 403 Forbidden” errors in the Output window.
4

Activate Plugin

  1. Look for the “MCP Server” button in your Plugins toolbar
  2. Click it to activate the plugin
  3. A dock widget appears showing connection status
  4. Status should show:
    • 🔴 “Disconnected” (normal until your AI makes a request)
    • 🟢 “Connected” (when AI assistant is active)
5

Verify Connection

Test the connection by asking your AI assistant:
Show me the structure of game.Workspace
Your AI should:
  1. Call the get_project_structure or get_file_tree tool
  2. Plugin status changes to 🟢 “Connected”
  3. AI returns a formatted list of Workspace contents
If you see connection errors, check:
  • Plugin is activated (button clicked)
  • HTTP requests are enabled in Game Settings
  • Your AI client successfully started the MCP server
  • Windows Firewall isn’t blocking localhost:3002

​
Your First AI Commands

Now that everything is connected, try these commands with your AI assistant:

​
Explore Your Game

What services are available in my game?
The AI uses get_services to show all Roblox services and child counts.

​
View Game Structure

Show me the complete structure of game.ServerScriptService with depth 5
The AI uses get_project_structure with maxDepth=5 for comprehensive exploration.

​
Find Instances

Find all Part objects in Workspace
The AI uses search_objects or search_by_property to locate instances.

​
Read a Script

Show me the code in game.ServerScriptService.MainScript
The AI uses get_script_source to retrieve and display the script.

​
Edit Properties

Set all parts in Workspace to Transparency 0.5
The AI:
  1. Finds all parts with search_by_property
  2. Uses mass_set_property to update them all at once

​
Smart Duplication

Duplicate game.Workspace.Platform 10 times, spacing them 5 studs apart on the X axis
The AI uses smart_duplicate with position offset.

​
Understanding Tool Results

When your AI uses MCP tools, you’ll see:
  • Plugin Activity Panel — Real-time log of tool executions
  • AI Responses — Formatted, human-readable results
  • Studio Output — Debug logging from the plugin (optional)
The plugin’s activity panel has a Copy button to export logs for debugging or sharing with the community.

​
Next Steps

Installation Guide

Detailed installation with troubleshooting

Tool Reference

Complete guide to all 53+ tools

​
Common Issues

This is normal when your AI client isn’t actively making requests. The plugin only connects when the MCP server has work to do.To test:
  1. Ask your AI: “Show me game.Workspace structure”
  2. Plugin should connect and show 🟢 status
  3. After the request completes, it returns to disconnected state
The MCP server isn’t running. Check:
  • Your AI client configuration file has the correct MCP server entry
  • You’ve restarted your AI client after adding the configuration
  • For Claude Code: claude mcp list should show “robloxstudio-mcp”
HTTP requests are disabled. Go to:
  1. Game Settings → Security
  2. Enable “Allow HTTP Requests”
  3. Restart Studio if the error persists
  1. Check the plugin file is in the correct folder:
    • Windows: %LOCALAPPDATA%/Roblox/Plugins/
    • macOS: ~/Documents/Roblox/Plugins/
  2. Restart Roblox Studio completely
  3. Check Studio Output window for plugin errors

​
Tips for Best Results

  • Use depth parameters: get_project_structure defaults to depth 3. Use 5-10 for thorough exploration.
  • Batch operations: Ask AI to modify multiple objects at once using mass operations.
  • Script line numbers: When editing scripts, AI uses numberedSource from get_script_source to identify lines.
  • Keep Studio open: The plugin needs Studio running to execute API calls.

Build docs developers (and LLMs) love

Get started for freeTalk to us