Coolify部署管理协议

Coolify MCP

Servidor MCP (Model Context Protocol) para interactuar con Coolify desde Claude Code y otros clientes MCP. Gestiona tus despliegues, aplicaciones y logs de Coolify directamente desde tu asistente de IA.

Características

• Lista todas las aplicaciones desplegadas en Coolify
• Inicia despliegues de aplicaciones
• Obtiene logs de aplicaciones para debugging
• Se integra nativamente con Claude Code

Requisitos Previos

• Node.js 18 o superior
• Una instancia de Coolify en ejecución
• API Key de Coolify (obtenerla desde tu instancia de Coolify)

Instalación Global

Instala el servidor MCP globalmente usando npm:

# Desde el directorio del proyecto
npm install -g .

# O clona y luego instala
git clone <tu-repositorio>
cd coolify-mcp
npm install -g .

Configuración

Variables de Entorno

El servidor MCP requiere dos variables de entorno:

• COOLIFY_URL: La URL de tu instancia de Coolify (ej: https://coolify.tudominio.com)
• COOLIFY_API_KEY: Tu API key de Coolify

Puedes configurarlas de dos maneras:

Opción 1: Variables de entorno del sistema

# Linux/macOS - agregar a ~/.bashrc o ~/.zshrc
export COOLIFY_URL="https://coolify.tudominio.com"
export COOLIFY_API_KEY="tu-api-key-aqui"

Opción 2: Pasar las variables en la configuración de Claude Code

Ver la sección de configuración de Claude Code más abajo.

Configuración en Claude Code

Agrega el servidor MCP a tu configuración de Claude Code. Edita el archivo de configuración:

Linux/macOS: ~/.config/claude-code/mcp_settings.json

Windows: %APPDATA%\claude-code\mcp_settings.json

Agrega esta configuración:

{
  "mcpServers": {
    "coolify": {
      "command": "coolify-mcp",
      "env": {
        "COOLIFY_URL": "https://coolify.tudominio.com",
        "COOLIFY_API_KEY": "tu-api-key-aqui"
      }
    }
  }
}

Si ya tienes otros servidores MCP configurados, simplemente agrega la sección "coolify" dentro de mcpServers.

Reinicia Claude Code para que los cambios tomen efecto.

Herramientas Disponibles

Una vez configurado, tendrás acceso a las siguientes herramientas desde Claude Code:

list_apps

Lista todas las aplicaciones desplegadas en Coolify.

Ejemplo de uso:

Muéstrame todas mis aplicaciones en Coolify

deploy_app

Inicia el despliegue de una aplicación específica.

Parámetros:

• id (string): El ID de la aplicación a desplegar

Ejemplo de uso:

Despliega la aplicación con ID abc123

get_logs

Obtiene los logs de una aplicación específica.

Parámetros:

• id (string): El ID de la aplicación

Ejemplo de uso:

Muéstrame los logs de la aplicación abc123

Desarrollo

Si quieres modificar el servidor MCP:

# Clona el repositorio
git clone <tu-repositorio>
cd coolify-mcp

# Instala las dependencias
npm install

# Prueba el servidor localmente
node index.js

Estructura del Proyecto

coolify-mcp/
├── index.js          # Servidor MCP principal
├── server.js         # Servidor Express HTTP (legacy)
├── package.json      # Configuración del paquete
├── .env             # Variables de entorno (no incluido en git)
└── README.md        # Este archivo

Troubleshooting

El servidor no inicia

Verifica que las variables de entorno COOLIFY_URL y COOLIFY_API_KEY estén configuradas correctamente.

Error de autenticación

Asegúrate de que tu API key de Coolify sea válida. Puedes verificarla accediendo a tu instancia de Coolify.

Claude Code no reconoce el servidor

• Verifica que el archivo de configuración esté en la ubicación correcta
• Asegúrate de que el JSON sea válido (sin comas finales)
• Reinicia Claude Code completamente

Licencia

ISC