Coolify

Servidor MCP Coolify

Um servidor Model Context Protocol (MCP) que oferece cobertura completa da API REST do Coolify v4.3.1. Gerencie aplicações, bancos de dados, serviços, servidores, deploys e muito mais — tudo a partir de qualquer cliente de IA compatível com MCP.

Compatibilidade: Coolify v4.x. Base da API: https://<your-coolify-instance>/api/v1

O Coolify v4.2.0 tornou os endpoints de alteração de estado exclusivos para POST; as antigas rotas GET agora retornam This endpoint has changed to a POST request. Este servidor emite POST para todos eles. As operações de ciclo de vida e deploy permanecem compatíveis com versões anteriores do v4.x, que aceitavam ambos os métodos. Três ferramentas — enable_api, disable_api e validate_server — chamam endpoints que eram exclusivos para GET antes do v4.2.0 e, portanto, exigem Coolify v4.2.0 ou mais recente.

Pré-requisitos

• Node.js 18 ou superior
• Uma instância Coolify v4 em execução (v4.2.0+ para as três ferramentas mencionadas acima)
• Um token de API do Coolify (em Segurança → Tokens de API no painel)

Instalação

# Install globally
npm install -g coolify-mcp-server

# Or use with npx (no install needed)
npx coolify-mcp-server

Configuração

Defina duas variáveis de ambiente:

Variável	Descrição
COOLIFY_BASE_URL	URL base da sua instância Coolify (ex.: https://coolify.example.com)
COOLIFY_TOKEN	Seu token Bearer da API do Coolify

Configurações MCP (Claude Desktop / Windsurf / Cline)

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": ["-y", "coolify-mcp-server"],
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify-instance",
        "COOLIFY_TOKEN": "your-api-token"
      }
    }
  }
}

Usuários Windows (Cline/cmd):

{
  "mcpServers": {
    "coolify": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "coolify-mcp-server"],
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify-instance",
        "COOLIFY_TOKEN": "your-api-token"
      }
    }
  }
}

Ferramentas Disponíveis

Geral

• get_version — Obter versão do Coolify
• health_check — Verificação de saúde da API (sem autenticação)
• enable_api / disable_api — Ativar/desativar a API (token raiz)
• enable_mcp / disable_mcp — Ativar/desativar endpoint MCP integrado (token raiz)

Equipes

• list_teams, get_team, get_team_members
• get_current_team, get_current_team_members

Servidores

• list_servers, get_server, create_server, update_server, delete_server
• validate_server, get_server_resources, get_server_domains
• create_hetzner_server

Projetos

• list_projects, get_project, create_project, update_project, delete_project

Ambientes

• list_environments, get_environment, create_environment, delete_environment

Aplicações

• list_applications, get_application
• create_public_application, create_private_github_app_application, create_private_deploy_key_application
• create_dockerfile_application, create_dockerimage_application
• update_application, delete_application
• start_application, stop_application, restart_application
• get_application_logs
• list_application_envs, create_application_env, update_application_env, bulk_update_application_envs, delete_application_env
• list_application_storages, create_application_storage, delete_application_storage
• list_application_scheduled_tasks, create_application_scheduled_task, delete_application_scheduled_task

Para criar um recurso a partir de um arquivo Docker Compose bruto, use create_service com docker_compose_raw. O Coolify não possui endpoint de criação de compose em nível de aplicação.

Bancos de Dados

• list_databases, get_database, update_database, delete_database
• create_postgresql_database, create_mysql_database, create_mariadb_database, create_mongodb_database
• create_redis_database, create_keydb_database, create_dragonfly_database, create_clickhouse_database
• start_database, stop_database, restart_database
• get_database_backups, create_database_backup, list_database_backup_executions
• list_database_envs, create_database_env, delete_database_env

Serviços

• list_services, get_service, create_service, update_service, delete_service
• start_service, stop_service, restart_service
• list_service_envs, create_service_env, delete_service_env
• list_service_scheduled_tasks, create_service_scheduled_task, delete_service_scheduled_task

Deploys

• list_deployments, get_deployment, cancel_deployment
• list_deployments_by_application, deploy_by_tag_or_uuid

Chaves Privadas

• list_private_keys, get_private_key, create_private_key, update_private_key, delete_private_key

GitHub Apps

• list_github_apps, create_github_app, delete_github_app, list_github_app_repositories

Tokens de Nuvem

• list_cloud_tokens, create_cloud_token, delete_cloud_token

Hetzner

• get_hetzner_locations, get_hetzner_server_types, get_hetzner_images, get_hetzner_ssh_keys
• create_hetzner_server

Recursos

• list_resources — Todos os recursos da instância

Licença

MIT