# Servidor MCP

Source : https://webgune.cloud/es-es/docs/mcp · Mis à jour le 2026-10-27

# Servidor MCP

El servidor MCP oficial `webgune-mcp` expone tu cuenta webgune como herramientas [Model Context Protocol](https://modelcontextprotocol.io): puedes listar tus servicios, consultar logs, relanzar un despliegue o revisar tus facturas directamente desde Claude (Desktop, Code) o cualquier otro cliente MCP.

## Instalación

```bash
bun add -g webgune-mcp
# o
npm install -g webgune-mcp
```

## Autenticación

Como el [CLI](/docs/cli), el servidor MCP se autentica con una **clave de API** (prefijo `wgk_`), a crear desde el dashboard: **Configuración → Claves de API**. La clave se pasa mediante la variable de entorno `WEBGUNE_API_KEY`.

Consejo: crea una clave dedicada con scopes limitados. Para un uso de solo lectura, `projects:read` + `services:read` + `billing:read` bastan.

## Configuración

### Claude Desktop / Claude Code

```json
{
  "mcpServers": {
    "webgune": {
      "command": "webgune-mcp",
      "env": {
        "WEBGUNE_API_KEY": "wgk_xxxxxxxx"
      }
    }
  }
}
```

Con Claude Code:

```bash
claude mcp add webgune --env WEBGUNE_API_KEY=wgk_xxxxxxxx -- webgune-mcp
```

## Herramientas disponibles

| Herramienta | Descripción | Solo lectura |
|---|---|:---:|
| `list_projects` | Lista tus proyectos | ✓ |
| `list_services` | Lista tus servicios (filtro por proyecto posible) | ✓ |
| `get_service` | Detalles de un servicio | ✓ |
| `get_service_logs` | Logs de ejecución | ✓ |
| `list_deployments` | Historial de despliegues | ✓ |
| `redeploy_service` | Rebuild + redespliegue | No |
| `restart_service` | Reinicio | No |
| `rollback_deployment` | Vuelta a un despliegue anterior | No |
| `list_plans` | Tabla de precios | ✓ |
| `get_subscription` | Suscripción + estado del mandato SEPA | ✓ |
| `list_invoices` | Facturas | ✓ |
| `list_domains` | Nombres de dominio | ✓ |

Las herramientas de escritura (`redeploy_service`, `restart_service`, `rollback_deployment`) requieren el scope `services:write` en la clave de API. Sin él, la API responde 403 y la acción falla.

## Ejemplo de uso

Una vez configurado, simplemente pídele a Claude:

> «Lista mis servicios webgune y muéstrame los logs del servicio que tiene el estado error.»

> «Haz rollback del servicio api-prod hacia el despliegue anterior.»

## Ver también

- [CLI Webgune](/docs/cli): las mismas operaciones desde el terminal.
- [Referencia de la API](/docs/reference-api): la API HTTP subyacente.