Servidor MCP
Servidor MCP
El servidor MCP oficial webgune-mcp expone tu cuenta webgune como herramientas Model Context Protocol (nueva ventana): 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
bun add -g webgune-mcp
# o
npm install -g webgune-mcp
Autenticación
Como el 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
{
"mcpServers": {
"webgune": {
"command": "webgune-mcp",
"env": {
"WEBGUNE_API_KEY": "wgk_xxxxxxxx"
}
}
}
}
Con Claude Code:
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: las mismas operaciones desde el terminal.
- Referencia de la API: la API HTTP subyacente.