Primeiros Passos

Para usar o Roblox MCP, você precisa de dois componentes.

App de IA (Claude, Codex, Gemini etc.)
       │
   Servidor MCP  ← Converte comandos de IA para um formato que o Roblox entende
       │
Plugin do Roblox Studio  ← Executa os comandos dentro do Studio

Quando o app de IA diz “crie uma peça azul”, o servidor MCP converte essa solicitação e o plugin do Roblox Studio realmente cria a peça.

Instalação em Uma Linha (Recomendado)

Instale o servidor MCP e o plugin de uma vez com o comando abaixo.

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex

Após a instalação, reabra o app de IA e reinicie o Roblox Studio.

Se ocorrer algum erro durante a instalação, o caminho do arquivo de log temporário será exibido. Na execução interativa, você pode manter o console aberto antes de fechar para verificar a causa.

O registro automático de MCP é compatível com Claude Code, Claude Desktop, Cursor, Codex CLI / App, Gemini CLI e Antigravity.

Se a execução do PowerShell estiver bloqueada no Windows, prossiga com a instalação manual abaixo. Se você estiver usando o pacote ZIP, pode executar setup-plugin.bat e setup-mcp.bat.

Instalação Manual

Procedimento alternativo para quando a instalação em uma linha não funciona ou quando a instalação automática não pode ser usada no seu ambiente.

Passo 1 — Instalar o Plugin do Roblox Studio

Baixe o arquivo do plugin do GitHub e coloque-o na pasta Plugins do Roblox Studio para instalar.

Passo 2 — Registrar o Servidor MCP no App de IA

Escolha o app de IA que você usa e vá para o guia de configuração. Pode ser usado em qualquer app de IA que suporte MCP.

Mesmo que seu app de IA não esteja na lista acima, você pode usá-lo se ele suportar MCP. O comando do servidor MCP é npx -y @weppy/roblox-mcp.

Opcional — WEPPY Roblox Explorer (Extensão VSCode)

Você pode navegar pela árvore de instâncias sincronizadas com ícones de classe Roblox diretamente no VSCode. Esta extensão requer que a instalação do Roblox MCP acima seja concluída primeiro, pois o Explorer lê os dados de Sync de weppy-project-sync abaixo da raiz do projeto.

Após Concluir a Instalação

1. Abra o Roblox Studio e clique em WEPPY → Connect na aba Plugins.

2. Teste com seu app de IA da seguinte forma:

   Crie uma peça azul no Roblox Studio

3. Se a peça for criada com sucesso, a instalação está completa.