Configuração do Claude Desktop App

Como usar o Roblox MCP no Claude Desktop App.

Pré-requisitos

• Claude Desktop App instalado
• Node.js (v18.0.0 ou superior)
• Plugin do Roblox Studio instalado

Registrar o Servidor MCP

Método 1: Desktop Extensions (Recomendado)

Instalação com um clique disponível a partir de 2026, como extensões de navegador

1. Claude Desktop → Settings → Extensions
2. Pesquisar weppy-roblox-mcp
3. Clicar em Install

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

1. Claude Desktop → Settings → Developers → Clicar em Edit Config

2. Adicionar o seguinte ao arquivo claude_desktop_config.json:

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

3. Fechar completamente o Claude Desktop e reiniciar

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

Testar a Conexão

1. Executar o Roblox Studio → Aba Plugins → WEPPY → Connect
2. Iniciar uma nova conversa no Claude Desktop e testar:

   Crie uma peça azul no Roblox Studio

Solução de Problemas

Servidor MCP não carrega

1. Verificar sintaxe JSON: Validar o arquivo de configuração com um validador JSON online
2. Reiniciar completamente o Claude Desktop: Após alterar as configurações, fechar completamente o app e reiniciar
3. Verificar caminhos: Confirmar se command e args estão corretos

Quando o servidor não inicia

Execute o servidor MCP diretamente para verificar os erros:

npx -y @weppy/roblox-mcp

Falha na conexão

• Confirmar se o plugin do Roblox Studio está no estado Connected
• Verificar se a porta 3002 não está bloqueada pelo firewall