Claude Code Setup

How to use Roblox MCP with Claude Code (terminal-based AI coding tool).

Prerequisites

• Claude Code installed
• Roblox Studio plugin installation complete

Installation

npm install -g @anthropic-ai/claude-code

Registering the MCP Server

Method 1: Install from Marketplace (Recommended)

Run in the Claude Code terminal:

# Add marketplace
/plugin marketplace add hope1026/weppy-roblox-mcp

# Install plugin
/plugin install weppy-roblox-mcp@hope1026-roblox-mcp

Verify installation:

/plugin list

Method 2: Edit Config File Directly

Create a .mcp.json file:

{
  "mcpServers": {
    "weppy-roblox-mcp": {
      "command": "npx",
      "args": ["-y", "@weppy/roblox-mcp"]
    }
  }
}

Config file location:

Automatic Server Management

Claude Code manages the MCP server automatically:

• Starts automatically when needed
• Stops automatically when the session ends
• No additional configuration required

Connection Test

1. Launch Roblox Studio → Plugins tab → WEPPY → Connect
2. Test from Claude Code:

   Create a blue Part in Roblox Studio

Troubleshooting

Plugin Installation Fails

# Clear cache and retry
/plugin cache clear
/plugin install weppy-roblox-mcp@hope1026-roblox-mcp

Server Won’t Start

1. Check the Node.js version (18.0 or higher required):

   node --version

2. Test starting the server manually:

   npx -y @weppy/roblox-mcp

MCP Tools Not Visible

Check in Claude Code:

Show me the list of available MCP tools