coolify-mcp

coolify-mcp — MCP-сервер сообщества (автор — StuMason). Управление инфраструктурой Coolify, диагностика и поиск по документации. Ставится через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
StuMason
Лицензия
MIT
Транспорт
stdio
Авторизация
api_key
ОС
Не указана
Языки
typescript

Уровень риска: high

Деплой, остановка и удаление ресурсов Coolify, смена переменных окружения; разрушительные операции требуют подтверждения (elicitation).

Настройка клиентов

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"coolify\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@masonator/coolify-mcp\"],\n      \"env\": {\n        \"COOLIFY_BASE_URL\": \"https://your-coolify-instance.com\",\n        \"COOLIFY_ACCESS_TOKEN\": \"your-api-token\"\n      }\n    }\n  }\n}",
    "lang": "json",
    "notes": "Дословно из README; подходит и для Claude Desktop",
    "verified": "docs"
}

Что умеет

Coolify MCP Server управляет Coolify — самостоятельно размещаемой PaaS — из Claude, Cursor и любого MCP-клиента. Это 46 инструментов для развёртывания, отладки и сопровождения сервисов обычными словами. Перед разрушительными операциями сервер спрашивает человека, а секреты возвращаются в замаскированном виде.

Что умеет по README:

  • Диагностика: diagnose_app и diagnose_server принимают имя, домен, IP или UUID. find_issues проверяет всю инфраструктуру, logs читает логи любого контейнера;
  • Развёртывание и откат: deploy ждёт итогового статуса и при ошибке возвращает конец лога. Запуск, остановка и перезапуск — через control;
  • Создание и удаление: приложения, базы данных (8 движков), сервисы, проекты и окружения;
  • Конфигурация: переменные окружения, хранилища, задачи по расписанию, бэкапы, теги, приватные ключи, GitHub-приложения, облачные токены;
  • Массовые операции: bulk_env_update, redeploy_project, stop_all_apps — каждая с подтверждением человека и описанием масштаба последствий;
  • Поиск по документации Coolify: search_docs;
  • Несколько инстансов: переменная COOLIFY_INSTANCES, и каждый инструмент принимает параметр instance.

Списки возвращаются кратко (uuid, имя, статус), а весь набор инструментов занимает около 8900 токенов контекста. Есть готовые сценарии troubleshoot_application, explain_failed_deploy и estate_health. Поддерживаются Coolify версий 4.0–4.3.

Кому подойдёт

  • Тем, кто держит свои сервисы на Coolify и хочет разбирать падения и деплои вместе с ассистентом.
  • Владельцам нескольких инстансов (staging и production) — всё доступно из одного подключения.
  • Тем, кому нужны операции записи с подтверждением человека. Встроенный MCP-сервер Coolify, по README, пока документирован как работающий только на чтение.

Похожие серверы — в категории облака и DevOps.

Установка

Нужен работающий Coolify v4 и API-токен: Coolify → Keys & Tokens → API tokens. Есть три способа запуска:

  • Claude Desktop в один клик: перетащите coolify-mcp.mcpb из релизов в Settings → Extensions. Приложение спросит URL и токен;
  • Локально через npx — конфиги ниже;
  • Удалённо, контейнером внутри вашего Coolify: клиенты подключаются к https://your-domain/mcp через OAuth 2.1, а токен Coolify остаётся на сервере.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

claude mcp add coolify \
  -e COOLIFY_BASE_URL="https://your-coolify-instance.com" \
  -e COOLIFY_ACCESS_TOKEN="your-api-token" \
  -- npx @masonator/coolify-mcp@latest

JSON подходит для Cursor, Claude Desktop и любых клиентов с JSON-конфигом. Для Codex CLI команда та же, только codex mcp add и --env. За прокси с авторизацией передавайте аргументы --header. Для Cloudflare Access задайте CF_ACCESS_CLIENT_ID и CF_ACCESS_CLIENT_SECRET.

Проверка

Выполните npx @masonator/coolify-mcp doctor с теми же переменными COOLIFY_BASE_URL и COOLIFY_ACCESS_TOKEN. Команда проверит частые ошибки в конфиге (нераскрытый ${VAR}, лишние пробелы, двойной /api/v1), доступность Coolify, права токена на деплой и версию Coolify. Затем попросите ассистента сделать обзор инфраструктуры.

Примеры задач

Диагностируй приложение shop.example.com и объясни, почему упал последний деплой.
Найди проблемы во всей инфраструктуре и предложи исправления.

Риски

Сервер получает полный доступ к Coolify в рамках токена: может развёртывать, останавливать и удалять приложения, базы данных и сервисы, менять переменные окружения на production. Защита по README:

  • разрушительные операции останавливаются и спрашивают вас прямо в клиенте — в клиентах с поддержкой elicitation (Claude Code, VS Code Copilot). В удалённом режиме без подтверждения операция не выполняется. Локально, в клиенте без elicitation, остаётся только параметр confirm, поэтому выбирайте клиент с поддержкой подтверждений;
  • массовые операции явно называют масштаб последствий и целевой инстанс;
  • секреты возвращаются в замаскированном виде, если не запросить конкретный ключ.

Токен в командной строке попадает в историю оболочки. Удалённый режим хранит токен на сервере. Для работы только на чтение без сторонних компонентов README советует встроенный MCP-сервер Coolify.

Частые вопросы

Чем этот сервер отличается от встроенного MCP в Coolify?

Встроенный пока документирован только на чтение и работает с одним инстансом. Этот сервер умеет записывать с подтверждением, работает с несколькими инстансами и поддерживает stdio.

Какие версии Coolify поддерживаются?

С 4.0 по 4.3.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

Memory

Эталонный сервер постоянной памяти на основе графа знаний.

Риск: high Лицензия: NOASSERTION ★ 92 089

Context7

Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.

Риск: medium Лицензия: MIT ★ 65 087

hindsight

Долговременная память для ИИ-агентов по образцу человеческой.

Риск: medium Лицензия: MIT ★ 61 836

cognee-mcp

Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.

Риск: high Лицензия: Apache-2.0 ★ 33 236

Источники