# Coolify MCP Server

El servidor de Protocolo de Contexto de Modelo (MCP) más completo para Coolify. Permite que asistentes de IA como Claude, Cursor y Claude Code administren tu PaaS auto-hospedado: implementa aplicaciones, depura infraestructura, ejecuta operaciones por lotes y busca en la documentación a través de lenguaje natural.

Canonical URL: https://a2a-mcp.org/entry/coolify-mcp-es

Language: es

Category: MCP Servers

Updated: 2026-04-01

## Resumen

**Coolify MCP Server** es el servidor Model Context Protocol (MCP) construido por la comunidad líder para [Coolify](https://coolify.io/), la popular alternativa de PaaS de código abierto y autohospedado a Heroku, Vercel y Netlify. Permite que los asistentes de IA para programación (Claude Desktop, Cursor, Claude Code, etc.) gestionen y depuren completamente tu instancia de Coolify utilizando comandos en lenguaje natural.

Con **38 herramientas altamente optimizadas**, búsqueda inteligente de recursos (por nombre/dominio/IP en lugar de UUID), respuestas eficientes en tokens y búsqueda de documentación de texto completo integrada, convierte tu IA en un potente co-piloto de DevOps para despliegues autohospedados.

## Características Principales

- **38 Herramientas Optimizadas**: Cubre infraestructura, servidores, proyectos, aplicaciones, bases de datos, servicios, despliegues, variables de entorno, claves privadas, equipos, tokens de nube (Hetzner, DigitalOcean) y más.
- **Diagnósticos Inteligentes**: `diagnose_app`, `diagnose_server`, `find_issues` con identificadores comprensibles para humanos.
- **Operaciones por Lotes**: Reiniciar proyectos completos, actualizaciones masivas de entorno, detener/redesplegar múltiples aplicaciones.
- **Eficiencia de Tokens**: Las respuestas son un 85–99% más pequeñas que la API sin procesar de Coolify (ej., list_applications reducido de ~170KB a ~4.4KB).
- **Búsqueda de Docs en Texto Completo**: Búsqueda integrada a través de más de 1,500 fragmentos de la documentación de Coolify.
- **Respuestas al Estilo HATEOAS**: Incluye acciones siguientes sugeridas y paginación para un mejor contexto de la IA.
- **Listo para Producción**: Cobertura de pruebas >98%, TypeScript estricto, manejo robusto de errores.

## Casos de Uso

- **Despliegues Dirigidos por IA**: "Despliega mi app Next.js desde el repositorio de GitHub X a producción."
- **Gestión de Infraestructura**: "Lista todos los servidores, muestra el uso de recursos y reinicia el servidor de base de datos."
- **Depuración y Diagnósticos**: "Diagnostica por qué está fallando mi app y sugiere soluciones."
- **Gestión por Lotes**: "Actualiza las variables de entorno en todas las apps del Proyecto Y y redespliega."
- **Asistencia de Documentación**: "Busca en la documentación de Coolify cómo configurar copias de seguridad de PostgreSQL."
- **Flujos de Trabajo DevOps Completos**: Combínalo con otros servidores MCP para pipelines de despliegue orquestados por IA de principio a fin.

## Instalación (La más fácil)

### Vía npx (Recomendado para Claude Desktop / Cursor / Claude Code)

```bash
# Para Claude Desktop – agregar a claude_desktop_config.json
npx -y @masonator/coolify-mcp
```

Configura estas variables de entorno:
- `COOLIFY_ACCESS_TOKEN` (tu token de API de Coolify)
- `COOLIFY_BASE_URL` (ej. `https://tu-instancia-coolify.com`)

**Comando rápido de una línea para Claude Code**:
```bash
claude mcp add coolify -e COOLIFY_ACCESS_TOKEN=xxx -e COOLIFY_BASE_URL=https://tu-coolify.com -- npx @masonator/coolify-mcp@latest
```

El código fuente completo y la configuración Docker/manual están disponibles en el repositorio.

## Compatibilidad

- **Clientes**: Claude Desktop, Cursor, Claude Code, cualquier herramienta de IA compatible con MCP.
- **Versión de Coolify**: Probado con v4.0.0-beta.460+ (detecta automáticamente características).
- **Licencia**: MIT

## Comunidad y Alternativas

Esta es la implementación más activamente mantenida y con más funciones (v2.7.3 a partir de febrero de 2026), publicada en el Registro Oficial de MCP. Las bifurcaciones mejoradas (por ejemplo, dazeb/coolify-mcp-enhanced) agregan herramientas de despliegue adicionales si es necesario.

Comienza a gestionar tu PaaS auto-alojado con IA hoy mismo — el Servidor Coolify MCP hace que DevOps sea conversacional y sin esfuerzo.

## Tags

- coolify
- mcp
- paas
- auto-hospedado
- implementación
- devops
- integración-ai
- claude
- cursor
- infraestructura

## Sources

- [Project website](https://github.com/StuMason/coolify-mcp)