Configuração do Claude Code

Como usar o Roblox MCP no Claude Code (ferramenta de codificação com IA baseada em terminal).

Pré-requisitos

• Claude Code instalado
• Plugin do Roblox Studio instalado

Instalação

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

Registrar o Servidor MCP

Método 1: Instalar WEPPY Roblox AI Toolkit (Recomendado)

Execute no terminal do Claude Code. O WEPPY Roblox AI Toolkit adiciona a configuração do servidor MCP e skills do WEPPY para ações no Studio, fluxos de UI Studio e playtest, e sync local com o Studio:

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

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

Verificar instalação:

claude plugin list

Método 2: Editar Arquivo de Configuração Diretamente

Criar o arquivo .mcp.json:

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

Localização do arquivo de configuração:

Gerenciamento Automático do Servidor

O Claude Code gerencia o servidor MCP automaticamente:

• Inicia automaticamente quando necessário
• Para automaticamente ao encerrar a sessão
• Sem necessidade de configuração adicional

Testar a Conexão

1. Executar o Roblox Studio → Aba Plugins → WEPPY → Connect
2. Testar no Claude Code:

   Crie uma peça azul no Roblox Studio

Solução de Problemas

Falha na instalação do plugin

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

Servidor não inicia

1. Verificar versão do Node.js (18.0 ou superior é necessário):

   node --version

2. Testar iniciar o servidor manualmente:

   npx -y @weppy/roblox-mcp@latest

Ferramentas MCP não aparecem

Verificar no Claude Code:

Mostre a lista de ferramentas MCP disponíveis