> ## Documentation Index
> Fetch the complete documentation index at: https://docs.raigal.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Servidor MCP de Raigal

> Conecta el servidor MCP de Raigal a Claude Code, Cursor, Claude Desktop, Windsurf, Cline y Antigravity.

El servidor Model Context Protocol (MCP) de Raigal conecta los motores de análisis y calidad directamente con tus asistentes de código e IDEs mediante `npx --yes @methiu/raigal@latest mcp`.

## Requisitos y autenticación

Raigal MCP se autentica de dos formas:

* Sesión local: si ya ejecutaste `raigal login` en tu equipo, el servidor detecta tus credenciales locales automáticamente sin necesidad de tokens adicionales.
* Variable de entorno: en servidores sin interfaz gráfica o CI, pasa tu clave con `RAIGAL_TOKEN=rgl_live_...`.

## Configuración de clientes

**Claude Code**

Ejecuta este comando en tu terminal:

```bash theme={null}
claude mcp add raigal -- npx --yes @methiu/raigal@latest mcp
```

Si necesitas pasar el token explícitamente:

```bash theme={null}
claude mcp add raigal -e RAIGAL_TOKEN=rgl_live_... -- npx --yes @methiu/raigal@latest mcp
```

**Cursor**

1. Abre los ajustes de Cursor con `Cmd + ,` o `Ctrl + ,`.
2. Ve a **Features** > **MCP**.
3. Pulsa en **Add New MCP Server**.
4. Rellena los campos:
   * Nombre: `raigal`
   * Tipo: `command`
   * Comando: `npx --yes @methiu/raigal@latest mcp`

También puedes configurarlo en `.cursor/mcp.json`:

```json theme={null}
{
  "mcpServers": {
    "raigal": {
      "command": "npx",
      "args": ["--yes", "@methiu/raigal@latest", "mcp"],
      "env": {
        "RAIGAL_TOKEN": "rgl_live_TU_TOKEN_AQUI"
      }
    }
  }
}
```

**Claude Desktop**

Añade el servidor a tu archivo de configuración de Claude Desktop:

* macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
* Windows: `%APPDATA%\Claude\claude_desktop_config.json`

```json theme={null}
{
  "mcpServers": {
    "raigal": {
      "command": "npx",
      "args": ["--yes", "@methiu/raigal@latest", "mcp"],
      "env": {
        "RAIGAL_TOKEN": "rgl_live_TU_TOKEN_AQUI"
      }
    }
  }
}
```

**Windsurf**

Añade el servidor a `~/.codeium/windsurf/mcp_config.json`:

```json theme={null}
{
  "mcpServers": {
    "raigal": {
      "command": "npx",
      "args": ["--yes", "@methiu/raigal@latest", "mcp"]
    }
  }
}
```

**Cline / Roo Code**

1. Abre la barra lateral de **Cline / Roo Code** en VS Code.
2. Pulsa en el icono de **MCP Servers**.
3. Pulsa en **Edit Global MCP Settings** y añade:

```json theme={null}
{
  "mcpServers": {
    "raigal": {
      "command": "npx",
      "args": ["--yes", "@methiu/raigal@latest", "mcp"]
    }
  }
}
```

**Antigravity**

Añade el servidor a `~/.gemini/config/mcp_config.json` o a `.agents/mcp_config.json` en tu repositorio:

```json theme={null}
{
  "mcpServers": {
    "raigal": {
      "command": "npx",
      "args": ["--yes", "@methiu/raigal@latest", "mcp"]
    }
  }
}
```

## Herramientas disponibles

Una vez conectado, los asistentes pueden invocar cuatro herramientas:

| Herramienta | Descripción |
| - | - |
| `raigal_scan` | Analiza el repositorio buscando defectos (comentarios obvios, errores silenciados, conversiones `as any`), problemas de seguridad, linters y formato, devolviendo una nota de 0 a 100. |
| `raigal_fix` | Aplica correcciones automáticas y seguras para los problemas detectados. |
| `raigal_why` | Explica por qué saltó una regla concreta y ofrece consejos para solucionarla. |
| `raigal_baseline` | Crea o actualiza una línea base para que el asistente se centre únicamente en los cambios nuevos. |

## Instrucciones para prompts de agentes

Para que los asistentes verifiquen su trabajo antes de dar una tarea por terminada, añade este texto a `AGENTS.md`, `CLAUDE.md` o al prompt de tu agente:

```markdown wrap theme={null}
Antes de entregar cambios en el código, ejecuta la herramienta MCP `raigal_scan` para verificar que no hay malos patrones de IA, errores silenciados ni regresiones de tipos. Si encuentras incidencias, utiliza `raigal_fix` o corrígelas antes de terminar.
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.