How to use the WEPPY MCP Server from WEPPY Roblox AI Toolkit with Claude Code (terminal-based AI coding tool).

Prerequisites

Claude Code installed
WEPPY Roblox Studio Plugin installation complete

Installation

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

Registering the MCP Server

Method 1: Install the WEPPY AI Agent Plugin (Recommended)

Run from your terminal. The WEPPY AI Agent Plugin adds the MCP server config plus WEPPY skills for Studio actions, UI Studio and playtest workflows, and Studio-local sync.

# Add marketplace
claude plugin marketplace add hope1026/weppy-roblox-mcp --scope user

# Install plugin
claude plugin install weppy-roblox-ai-toolkit@hope1026-roblox-mcp --scope user

Verify installation:

claude plugin list

Method 2: Edit Config File Directly

Use this if you only want the MCP server config without the WEPPY AI Agent Plugin. Create a .mcp.json file:

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

Config file location:

Scope	Path
Project	`<project>/.mcp.json`
Global	`~/.claude/mcp.json`

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

Launch Roblox Studio → Plugins tab → WEPPY → Connect
Test from Claude Code:
```
Create a blue Part in Roblox Studio
```

Troubleshooting

Plugin Installation Fails

claude plugin marketplace add hope1026/weppy-roblox-mcp --scope user
claude plugin install weppy-roblox-ai-toolkit@hope1026-roblox-mcp --scope user

Server Won’t Start

Check the Node.js version (18.0 or higher required):
```
node --version
```
Test starting the server manually:
```
npx -y @weppy/roblox-mcp@latest
```

MCP Tools Not Visible

Check in Claude Code:

Show me the list of available MCP tools

Claude Code Setup