Como usar o WEPPY MCP Server do WEPPY Roblox AI Toolkit com o Antigravity CLI.

O Antigravity CLI e o Antigravity IDE compartilham ~/.gemini/config/mcp_config.json como configuração MCP global canônica.

Pré-requisitos

Antigravity CLI instalado
Node.js (v18.0.0 ou superior, com npx disponível)
WEPPY Roblox Studio Plugin instalado

Instalar o WEPPY AI Agent Plugin

Use o instalador one-line da página de instalação do WEPPY. A instalação do WEPPY AI Agent Plugin requer o Antigravity CLI e o comando agy plugin. O instalador prepara localmente a release pública mais recente, executa agy plugin install com esse payload local e verifica o resultado com agy plugin list.

Não passe uma URL do GitHub diretamente para agy plugin install. Se o WEPPY AI Agent Plugin não puder ser verificado, o instalador mantém o fallback shared direct do WEPPY MCP Server.

Fallback MCP manual

Arquivo de configuração global

Adicione ou mescle o conteúdo abaixo no arquivo de configuração MCP global do Antigravity CLI.

OS	Caminho
macOS / Linux	`~/.gemini/config/mcp_config.json`
Windows	`%USERPROFILE%\.gemini\config\mcp_config.json`

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

Configuração do workspace

Se quiser usar o servidor MCP apenas em um projeto, coloque o mesmo JSON em .agents/mcp_config.json na raiz do projeto.

O instalador one-line e o instalador do navegador usam ~/.gemini/config/mcp_config.json como fallback global. O caminho anterior ~/.gemini/antigravity-cli/mcp_config.json é uma entrada legacy para migração, não um novo destino de registro.

Teste de conexão

Abra o Roblox Studio → aba Plugins → WEPPY → Connect

Digite no Antigravity CLI:

Diga o que está selecionado agora no Roblox Studio

Use /mcp na CLI para verificar o status do servidor MCP

Solução de problemas

O servidor não inicia

Execute o servidor MCP diretamente para ver o erro:

npx -y @weppy/roblox-mcp@latest

Falha na conexão

Confirme que o WEPPY Roblox Studio Plugin mostra Connected
Verifique se a porta 3002 não está bloqueada por firewall
Use /mcp no Antigravity CLI para verificar o status do servidor
Confira se você não editou por engano o ~/.gemini/settings.json do Gemini CLI ou a configuração do Antigravity IDE

Configuração do Antigravity CLI