К основному содержанию
плагин CX Codex

Coolify — плагин для Claude Code: управление развёртываниями

Плагин подключает Claude Code к облачному Coolify или самостоятельно развёрнутому экземпляру. Через него агент может проверять здоровье системы, запускать приложения, управлять переменными окружения и смотреть логи развёртываний.

MIT ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install coolify@awesome-codex-plugins
Открыть на GitHub

Что делает coolify

Coolify — это платформа для развёртывания приложений, похожая на Heroku. Плагин даёт агенту доступ к основным операциям: список приложений, баз данных, проектов и серверов; управление жизненным циклом сервисов (запуск, остановка, перезагрузка); просмотр истории развёртываний и свежих логов приложений. Внутри плагина — набор готовых инструментов для частых операций, плюс универсальный coolify_request для вызова любого эндпоинта /api/v1, и coolify_openapi_search для поиска по схеме API.

Для работы нужен Node.js 20 или свежее. Если используешь облачный Coolify, просто создай токен в /security/api-tokens. Для самостоятельно развёрнутого экземпляра убедись, что API включён. Токен хранится в системном хранилище учётных данных (Keychain на macOS, Credential Manager на Windows, Secret Service на Linux); если его нет, плагин сохраняет токен локально с правами доступа только владельца.

После установки запусти в Codex «Connect Coolify» — откроется локальная страница настройки, где нужно выбрать тип экземпляра (облако или self-hosted) и ввести токен. Для локальной разработки есть команды npm run setup.

Какие задачи решает

  • Проверить статус приложения и версию Coolify без выхода в браузер
  • Запустить, остановить или перезагрузить приложение через API
  • Просмотреть историю развёртываний и логи текущего приложения
  • Управлять переменными окружения в нескольких приложениях одновременно
  • Запустить развёртывание вручную по UUID или тегу

Примеры запросов агенту

  • «Проверь здоровье Coolify и выведи версию»
  • «Покажи все приложения в проекте, потом перезагрузи приложение tutorial-app»
  • «Выведи последние 50 логов для приложения backend и поищи ошибки»

Как установить coolify

Через маркетплейс плагинов

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install coolify@awesome-codex-plugins

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о coolify

Как установить Coolify плагин в Claude Code?

Запусти /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем /plugin install coolify@awesome-codex-plugins. После этого в новом диалоге напиши «Connect Coolify», и плагин откроет локальную страницу для ввода токена.

Что делает Coolify плагин?

Даёт агенту доступ к API Coolify: проверка здоровья, список приложений и серверов, управление жизненным циклом (запуск, остановка, перезагрузка), просмотр логов и истории развёртываний, управление переменными окружения. Плюс универсальный инструмент для вызова любого эндпоинта API.

Какой Coolify нужен — облачный или self-hosted?

Плагин работает с обоими. Для облачного Coolify токен создаётся в /security/api-tokens на https://app.coolify.io. Для self-hosted нужно убедиться, что API включён, и передать плагину URL экземпляра и токен.

Исходный текст

coolify-codex-plugin · MIT
# Coolify Codex Plugin

Control Coolify Cloud or a self-hosted Coolify instance from Codex through a local MCP server and a Coolify-aware workflow skill.

The plugin is built around a sanitized endpoint index generated from Coolify's official OpenAPI spec for the `v4.x` branch. It includes named tools for the workflows agents use most often, plus a generic API request tool and OpenAPI search for complete endpoint coverage as Coolify evolves.

## Capabilities

- Check Coolify health and version.
- List and inspect applications, databases, deployments, projects, resources, servers, services, and teams.
- Start, stop, and restart applications, databases, and services.
- Trigger deployments by UUID or tag.
- Read deployment history across applications without mistaking the running-deployments endpoint for full history.
- Read recent application logs.
- List, create, update, bulk update, and delete environment variables.
- Call any Coolify `/api/v1` endpoint with `coolify_request`.
- Search the bundled OpenAPI file with `coolify_openapi_search`.

## Requirements

- Node.js 20 or newer.
- Coolify Cloud, or a self-hosted Coolify instance with API access enabled.
- A Coolify API token.

## Install from GitHub

Add the Awesome Codex Plugins marketplace and install Coolify:

```bash
codex plugin marketplace add hashgraph-online/awesome-codex-plugins --ref main
codex plugin add coolify@awesome-codex-plugins
```

The plugin is also listed in the [Awesome Codex Plugins registry](https://github.com/hashgraph-online/awesome-codex-plugins#tools--integrations).

Create an API token in Coolify at `/security/api-tokens`. Use the least-privileged token that can perform the work you want Codex to do.

After installing from the Codex plugin marketplace, start a new Codex thread and ask:

```text
Connect Coolify
```

Codex will open a short-lived local setup page. Choose Coolify Cloud or self-hosted first; for self-hosted instances, enter the instance URL so the matching token page is shown. The token is saved locally and is not returned to the chat.

For local development, you can also run:

```bash
npm run setup
npm run setup -- --save
```

For local development without a URL argument, the terminal helper targets Coolify Cloud at `https://app.coolify.io`. Pass a URL when you want to use a self-hosted instance.

## Configuration

Marketplace users should use the browser setup opened by `coolify_configure`; it asks whether the instance is Coolify Cloud or self-hosted before showing a token link. For local development, run:

```bash
npm run setup -- --save
```

For self-hosted instances, pass either the instance root or the API root:

```bash
npm run setup -- --save https://coolify.example.com
npm run setup -- --save https://coolify.example.com/api/v1
```

The token is stored in the operating system credential store when available: macOS Keychain, Windows Credential Manager, or Linux Secret Service via `secret-tool`. If no native credential store is available, the plugin stores it in a local config file under `CODEX_HOME` or `~/.codex` with owner-only permissions. `COOLIFY_BASE_URL` and `COOLIFY_API_TOKEN` are still supported as fallbacks for automation.

## MCP Tools

| Tool | Purpose |
| --- | --- |
| `coolify_setup` | Generate setup URLs and token guidance. |
| `coolify_configure` | Open a local browser setup page or save a Coolify URL and API token locally. |
| `coolify_config_status` | Check whether a connection is configured without revealing the token. |
| `coolify_logout` | Remove the saved local connection. |
| `coolify_health` | Check instance health and version. |
| `coolify_openapi_search` | Find official endpoints, schemas, and request shapes. |
| `coolify_request` | Call any relative Coolify API path. |
| `coolify_list` | List common resource kinds. |
| `coolify_get` | Fetch one common resource. |
| `coolify_lifecycle` | Start, stop, or restart a resource. |
| `coolify_deploy` | Trigger a deployment. |
| `coolify_deployment_history` | List deployment history for one application or all applications. |
| `coolify_application_logs` | Fetch application logs. |
| `coolify_envs` | Manage environment variables. |

Sensitive-looking fields are redacted by default. Some tools accept `revealSensitive: true` for cases where the raw API response is explicitly needed.

`coolify_list` with `kind: "deployment"` mirrors Coolify's `GET /deployments` endpoint, which lists currently running deployments. Use `coolify_deployment_history` when you need historical deployments.

## Development

```bash
npm run setup -- --no-open
npm run setup -- --no-open https://coolify.example.com
npm run setup -- --save https://coolify.example.com
npm run check
npm run inspect:openapi
```

The MCP server and setup helper are dependency-free and use only Node.js built-ins. The server is written in plain JavaScript so the plugin can run directly without a TypeScript build step.

## Sources

- Coolify authorization docs: <https://coolify.io/docs/api-reference/authorization>
- Coolify OpenAPI source: <https://github.com/coollabsio/coolify/blob/v4.x/openapi.json>
- Coolify CLI automation reference: <https://github.com/coollabsio/coolify-cli>

## License

MIT

© Severin Hilbert · MIT · hashgraph-online/awesome-codex-plugins

Похожие плагины

Все плагины по теме «DevOps и инфраструктура» →
coolify-manager ajmcclary Скилл coolify-manager для работы с Coolify через официальный CLI и API: диагностика упавших сервисов, логи, SSL, контейнеры, WordPress. CX Codex +1 520установок Sevalla sevalla-hosting Деплой, логи, метрики, переменные окружения и базы данных Sevalla прямо из чата. CX Codex +1 ★ 10звёзд репо mcp sota-deploy MCP-сервер mcp развёртывает веб-приложения на PaaS-платформу sota.io одной фразой агенту. Управляет переменными окружения, доменами и откатом версий. CX Codex +1 catalyst-appsail catalystbyzoho Развёртывание постоянных серверов на Catalyst AppSail — managed-среды Node.js, Java, Python и кастомные Docker-контейнеры. CX Codex +1 1 200установок Dokku MCP Server dokku-MCP Подключает Dokku по SSH и позволяет управлять приложениями, базами данных, доменами и сертификатами. Деплой и мониторинг пет-проектов — прямо в чате. CX Codex +1 ★ 9звёзд репо docker oakoss Скилл для сборки Docker-образов, настройки Compose-стеков и подготовки контейнеров к продакшену. CX Codex +1 145установок

Из того же набора391

Весь набор →
dataproduct-builder-dbt Плагин dataproduct-builder-dbt для Claude Code и Codex ведёт dbt-проект от скаффолдинга до синхронизации метаданных с Entropy Data. Строит модели по требованиям из ODCS-файла. CX Codex ★ 1 596звёзд репо darkmoon MCP-сервер для вашего self-hosted Darkmoon Pro: запускает авторизованный пент-тест, показывает статус прогона, кампании и находки прямо из агента. CX Codex ★ 1 596звёзд репо damnpdfs Подключает 71 инструмент для обработки PDF, офисных документов и картинок через вкладку DamnPDFs в браузере. CX Codex ★ 1 596звёзд репо court-rules Плагин court-rules для Claude Code и Codex ищет правила подачи документов в федеральные суды и суды штатов США, распоряжения судей и календарь судебных выходных. Ответы содержат ссылки на документы суда. CX Codex ★ 1 596звёзд репо context-pack Плагин context-pack собирает краткую сводку по репозиторию для ИИ-агента за один проход. Экономит вызовы инструментов при первом знакомстве с кодовой базой. CX Codex ★ 1 596звёзд репо contam-tools Плагин contam-tools подключает агента к локальному MCP-серверу CONTAM для проверки проектов, запуска симуляций и разбора результатов. Подходит для работы с файлами .prj и сценариями ContamW. CX Codex ★ 1 596звёзд репо computer-usage-summary-skill Плагин computer-usage-summary-skill собирает отчёт по времени за компьютером из локального ActivityWatch: приложения, AFK, таймлайн и страницы в браузере. Данные не покидают машину. CX Codex ★ 1 596звёзд репо cometchat-skills Плагин подключает навыки интеграции текстового чата, голосовых и видеозвонков CometChat для React, Angular, React Native, iOS, Android и Flutter через официальный MCP с документацией. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой