# Configuración de Gemini CLI

Cómo usar Roblox MCP con [Google Gemini CLI](https://github.com/google-gemini/gemini-cli).

## Requisitos previos

1. **Node.js** (v18.0.0 o superior)
   ```bash
   node --version
   ```

2. **Gemini CLI** instalado
   ```bash
   npm install -g @google/gemini-cli
   ```

3. **Plugin de Roblox Studio** instalado

## Registrar el servidor MCP

### Método 1: Comando CLI (Recomendado)

Puede registrarse con un solo comando en su terminal:

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

> La bandera `--trust` omite las solicitudes de confirmación para cada llamada de herramienta.

Para registrar globalmente, agregue `-s user`:

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

### Método 2: Editar archivo de configuración

Agregue el siguiente contenido al archivo `.gemini/settings.json`:

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

**Ubicaciones del archivo de configuración:**
| Ámbito | Ruta |
|--------|------|
| Proyecto | `<proyecto>/.gemini/settings.json` |
| Global | `~/.gemini/settings.json` |

### Método 3: Uso de variables de entorno

Si se necesitan variables de entorno específicas:

**CLI:**
```bash
gemini mcp add weppy-roblox-mcp npx --trust -e HTTP_PORT=3002 -- -y @weppy/roblox-mcp
```

**Archivo de configuración:**
```json
{
  "mcpServers": {
    "weppy-roblox-mcp": {
      "command": "npx",
      "args": ["-y", "@weppy/roblox-mcp"],
      "env": {
        "HTTP_PORT": "3002"
      }
    }
  }
}
```

## Prueba de conexión

1. Abra **Roblox Studio** → pestaña Plugins → **W-MCP** → **Connect**
2. Ejecute **Gemini CLI** e ingrese:
   ```
   Dime qué está seleccionado actualmente en Roblox Studio
   ```

## Verificar el estado del servidor MCP

Puede verificar el estado de los servidores conectados con el comando `/mcp` en Gemini CLI:

```
/mcp
```

## Solución de problemas

### El servidor no se inicia

Ejecute el servidor MCP directamente para verificar errores:
```bash
npx -y @weppy/roblox-mcp
```

### Conexión fallida

- Verifique que el plugin de Roblox Studio esté en estado **Connected**
- Verifique si el puerto 3002 está bloqueado por un firewall
- Verifique el estado del servidor con el comando `/mcp`

### Conflictos de herramientas

Si varios servidores MCP tienen herramientas con el mismo nombre, se les agregará el prefijo con el formato `serverAlias__toolName`.

## Referencias

- [Documentación oficial de Gemini CLI MCP](https://geminicli.com/docs/tools/mcp-server/)
- [Guía de configuración de Gemini CLI](https://geminicli.com/docs/get-started/configuration/)
