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 pelo Marketplace (Recomendado)

Execute no terminal do Claude Code:

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

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

Verificar instalação:

/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"]
    }
  }
}

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

# Limpar cache e tentar novamente
/plugin cache clear
/plugin install weppy-roblox-mcp@hope1026-roblox-mcp

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

Ferramentas MCP não aparecem

Verificar no Claude Code:

Mostre a lista de ferramentas MCP disponíveis