Como usar o Roblox MCP com o Antigravity CLI.
O Antigravity CLI compartilha a raiz .gemini com o Gemini CLI e o Antigravity / Antigravity IDE, mas usa um arquivo de configuração MCP separado.
Pré-requisitos
- Antigravity CLI instalado
- Node.js (v18.0.0 ou superior, com
npxdisponível) - Plugin do Roblox Studio instalado
Registrar o servidor MCP
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/antigravity-cli/mcp_config.json |
| Windows | %USERPROFILE%\.gemini\antigravity-cli\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 público e a página de instalação web usam a rota global (~/.gemini/antigravity-cli/mcp_config.json) porque ela se aplica à conta do usuário.
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
/mcpna 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 plugin do Roblox Studio mostra Connected
- Verifique se a porta 3002 não está bloqueada por firewall
- Use
/mcpno Antigravity CLI para verificar o status do servidor - Confira se você não editou por engano o
~/.gemini/settings.jsondo Gemini CLI ou a configuração do Antigravity IDE