Configuração do Cursor

Como usar o Roblox MCP no Cursor.

Pré-requisitos

• Cursor instalado
• Node.js (v18.0.0 ou superior)
• Plugin do Roblox Studio instalado

Registrar o Servidor MCP

Método 1: Configuração do Projeto

Adicione o seguinte ao arquivo .cursor/mcp.json do projeto:

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

Método 2: Configuração Global

Adicione o mesmo conteúdo ao arquivo de configuração global do MCP do Cursor.

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

Se o arquivo já existir, mescle apenas o item weppy-roblox-mcp dentro do objeto mcpServers existente.

Aplicar

Após modificar as configurações, recarregue a janela do Cursor ou reinicie o app.

Testar a Conexão

1. Executar o Roblox Studio → Aba Plugins → WEPPY → Connect
2. Digitar no Cursor:

   Diga-me o que está selecionado atualmente no Roblox Studio

Solução de Problemas

Quando o servidor MCP não aparece

• Verificar se o caminho do arquivo de configuração está correto
• Verificar se a sintaxe JSON é válida
• Verificar se o Cursor foi recarregado após alterar as configurações

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