Coolify MCP Server

Resumen

Coolify MCP Server es el servidor Model Context Protocol (MCP) construido por la comunidad líder para Coolify, 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)

# 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:

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.