Claude Desktop Integration

Set up RbxGenie as an MCP server in Claude Desktop

Overview

RbxGenie integrates with Claude Desktop via the Model Context Protocol (MCP), giving Claude direct access to all 46 Roblox Studio tools through a standardized interface.

The RbxGenie daemon must be running before configuring MCP integration.

Quick Install

1. Start the daemon

   Ensure the RbxGenie daemon is running on port 7766:

   cd path/to/RbxGenie
   npm run dev
   

   The daemon should display:

   [RbxGenie] Daemon listening on http://127.0.0.1:7766
   
2. Build the MCP server

   Compile the TypeScript MCP server to JavaScript:

   npm run build
   

   This generates dist/mcp.js which Claude Desktop will invoke.

3. Run the auto-installer

   The installer automatically updates Claude Desktop’s configuration:

   npm run install-mcp
   

   Output:

   [RbxGenie Installer]
   
   Claude Desktop:
     ✓ Claude Desktop config updated: C:\Users\...\AppData\Roaming\Claude\claude_desktop_config.json
   
   ✓ Done (1 items configured)
     Restart Claude Desktop to apply changes.
   
4. Restart Claude Desktop

   Completely quit and restart Claude Desktop. The RbxGenie MCP server will be available automatically.

5. Verify connection

   In a Claude conversation, try:

   Can you get the place info from Roblox Studio?
   

   If configured correctly, Claude will use the get_place_info tool.

Manual Configuration

If you prefer manual setup or the auto-installer fails:

1. Locate the config file

   Find your Claude Desktop configuration file:

   Windows:

   %APPDATA%\Claude\claude_desktop_config.json
   

   macOS:

   ~/Library/Application Support/Claude/claude_desktop_config.json
   

   Linux:

   ~/.config/Claude/claude_desktop_config.json
   
2. Add RbxGenie MCP server

   Edit the config file and add the RbxGenie server under mcpServers:

   Windows

   {
     "mcpServers": {
       "RbxGenie": {
         "command": "node",
         "args": ["C:/path/to/RbxGenie/dist/mcp.js"]
       }
     }
   }
   

   Use absolute paths for the mcp.js file. Relative paths will fail.

3. Restart Claude Desktop

   Save the config file and restart Claude Desktop.

How It Works

1. Claude invokes MCP tool

   When Claude needs to interact with Roblox Studio, it calls an MCP tool via the stdio protocol.

2. MCP server proxies to daemon

   The mcp.js script receives the tool call and makes an HTTP POST request to http://127.0.0.1:7766/tool/<tool_name>.

3. Daemon queues command

   The daemon enqueues the command and waits for the Roblox Studio plugin to poll for work.

4. Plugin executes and returns

   The plugin polls /poll, receives the command, executes it in Roblox Studio, and POSTs the result back to /result.

5. Claude receives result

   The result propagates back through the daemon → MCP server → Claude Desktop.

Configuration Options

Custom Daemon URL

If your daemon runs on a different port or host, set the DAEMON_URL environment variable:

Windows

{
  "mcpServers": {
    "RbxGenie": {
      "command": "node",
      "args": ["C:/path/to/RbxGenie/dist/mcp.js"],
      "env": {
        "DAEMON_URL": "http://127.0.0.1:8080"
      }
    }
  }
}

Default: http://127.0.0.1:7766

Troubleshooting

MCP server not appearing in Claude

• Verify the config file syntax is valid JSON
• Check that the path to mcp.js is absolute and correct
• Restart Claude Desktop completely (quit, not just close window)
• Check Claude’s MCP logs (if available) for error messages

Tools timeout or fail

• Ensure the daemon is running: http://127.0.0.1:7766/health
• Verify Roblox Studio plugin is installed and enabled
• Check that the plugin shows a green status indicator
• Tool timeout is 120 seconds — complex operations may need optimization

'APPDATA not set' error during install

• On Windows, ensure APPDATA environment variable exists
• Try manual configuration instead of auto-installer
• Check that Claude Desktop is installed in the default location

Permission denied errors

• Run terminal as administrator (Windows) or use sudo (macOS/Linux)
• Check file permissions on claude_desktop_config.json
• Ensure Claude Desktop is not running during config modification

Available Tools

Once configured, Claude has access to all 46 RbxGenie tools. See the Tools Reference for the complete list.

Example Usage

Create a part

Claude, create a red part at position (0, 10, 0)

Claude will automatically invoke the appropriate tools to complete these tasks.

Next Steps

Cursor Integration

Set up RbxGenie in Cursor IDE

HTTP API

Use the HTTP API directly

Custom Agents

Build your own AI agents

Tools Reference

Browse all available tools