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).
Настройка клиентов
{
"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@latestJSON подходит для 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
Эталонный сервер постоянной памяти на основе графа знаний.
Context7
Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.
hindsight
Долговременная память для ИИ-агентов по образцу человеческой.
cognee-mcp
Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.