Configuração do Gemini CLI

Como usar o Roblox MCP no Google Gemini CLI.

Pré-requisitos

1. Node.js (v18.0.0 ou superior)

   node --version

2. Gemini CLI instalado

   npm install -g @google/gemini-cli

3. Plugin do Roblox Studio instalado

Registrar o Servidor MCP

Método 1: Comando CLI (Recomendado)

Você pode registrar com uma linha no terminal:

gemini mcp add weppy-roblox-mcp npx --trust -- -y @weppy/roblox-mcp

A flag --trust ignora o prompt de confirmação a cada chamada de ferramenta.

Para registrar como configuração global, adicione -s user:

gemini mcp add weppy-roblox-mcp npx -s user --trust -- -y @weppy/roblox-mcp

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

Adicione o seguinte ao arquivo .gemini/settings.json:

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

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

Método 3: Usar Variáveis de Ambiente

Quando variáveis de ambiente específicas são necessárias:

CLI:

gemini mcp add weppy-roblox-mcp npx --trust -e HTTP_PORT=3002 -- -y @weppy/roblox-mcp

Arquivo de configuração:

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

Testar a Conexão

1. Executar o Roblox Studio → Aba Plugins → WEPPY → Connect
2. Executar o Gemini CLI e digitar:

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

Verificar Status do Servidor MCP

Você pode verificar o status do servidor conectado com o comando /mcp dentro do Gemini CLI:

/mcp

Solução de Problemas

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
• Verificar o status do servidor com o comando /mcp

Conflito de ferramentas

Se vários servidores MCP têm ferramentas com o mesmo nome, elas recebem o prefixo no formato serverAlias__toolName.