coolify-mcp MCP — ユースケース, インストール & ライブデモ

なぜ使うのか

主な機能

サーバー、アプリケーション、データベース（8エンジン）、サービス、チームにまたがる38のツール
バッチ操作：プロジェクト内の全アプリ再起動、環境変数の一括更新、緊急停止
Coolify ドキュメントの全文検索を内蔵 — タブ切り替え不要
レスポンスが生の Coolify API より90〜99%小さい — 長い会話でも破綻しない
Claude Desktop、Claude Code、Cursor に対応

ライブデモ

実際の動作

coolify.replay ▶ 準備完了

0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": [
        "-y",
        "coolify-mcp"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": [
        "-y",
        "coolify-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": [
        "-y",
        "coolify-mcp"
      ],
      "_inferred": true
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": [
        "-y",
        "coolify-mcp"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "coolify",
      "command": "npx",
      "args": [
        "-y",
        "coolify-mcp"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json

{
  "context_servers": {
    "coolify": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "coolify-mcp"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add coolify -- npx -y coolify-mcp

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方： coolify-mcp

Git URL からチャットで Coolify に新しいアプリをデプロイする

👤 個人開発者、インディーハッカー、セルフホスター ⏱ ~10 min beginner

使うタイミング： GitHub に新しいサイドプロジェクトがあり、Coolify の UI を操作せずに5分以内で VPS 上に公開したいとき。

前提条件

稼働中の Coolify インスタンス — VPS 上で coolify.io のインストールスクリプトを実行
COOLIFY_ACCESS_TOKEN — Coolify > Settings > API > Create Token で発行

フロー

アプリを作成する

Create a new Coolify app in project 'side-projects' on server 'hetzner-fsn1'. Source: https://github.com/me/my-app. Build pack: Nixpacks. Port: 3000.✓ コピーしました

→ UUID 付きでアプリが作成される
環境変数を設定する

Set these env vars on the app: DATABASE_URL=..., SESSION_SECRET=..., NODE_ENV=production.✓ コピーしました

→ 環境変数が保存される
デプロイしてログを監視する

Deploy the app. Tail the build log; tell me when it's healthy or if it crashes.✓ コピーしました

→ ビルドログのリアルタイム表示 + 最終的な成功/失敗の判定

結果： 約5分でチャットだけで VPS 上に HTTPS アプリが稼働する。

注意点

ドメインの設定を忘れると、Coolify が自動生成した見づらい URL になる — デプロイ後に「app.example.com のカスタムドメインを HTTPS で追加して」と依頼する。Coolify が Let's Encrypt を自動プロビジョニングします。

組み合わせ： github

ワンプロンプトで新しいアプリ用のマネージド Postgres を起動する

👤 フルスタック開発者 ⏱ ~5 min beginner

使うタイミング： アプリに DB が必要だが、SSH でログインして docker run を実行し、バックアップの cron を設定するのが面倒なとき。

フロー

データベースを作成する

Create a Postgres 16 database named 'myapp-prod' in project 'side-projects' with 2GB RAM, daily backups retained 7 days.✓ コピーしました

→ データベースが作成され、接続情報が返される
アプリに接続する

Add the DATABASE_URL for this DB as an env var on app 'my-app', and redeploy.✓ コピーしました

→ 環境変数が設定され、再デプロイがトリガーされる

結果： スケジュールバックアップ付きのマネージド Postgres がアプリに接続された状態で稼働する。

注意点

デフォルトの Postgres は Coolify ネットワークからの接続のみ受け付ける — 外部アクセスが必要な場合は MCP で Public トグルを設定し、特定の IP のみ開放する

組み合わせ： postgres

本番アプリのクラッシュをスマホから診断・復旧する

👤 ワンオペ運用者、少人数チーム ⏱ ~10 min intermediate

使うタイミング： アプリがダウンしていてデスクから離れているとき。スマホに Claude があり、Coolify トークンを持っている。

フロー

ヘルスチェック

Show me the status of all apps in project 'prod'. Anything unhealthy?✓ コピーしました

→ アプリごとのステータス一覧、異常があるものはフラグ付き
ログを確認する

Tail the last 200 lines of app 'api-server'. What's the error?✓ コピーしました

→ ログの抜粋 + 推定原因
ロールバックまたは再起動

Restart the app. If it crashes again within 2 minutes, redeploy the previous commit.✓ コピーしました

→ 再起動が実行され、状態が監視される

結果： ノートPCなしでサービスを復旧できる。

注意点

再起動では不正なデプロイは直らない — 同じクラッシュを繰り返すだけ — 再起動で解決しない場合は、Claude にデプロイ履歴を確認させ、最後に正常だったコミットにロールバックするよう指示する

組み合わせ： sentry

プロジェクト内の全アプリで共有シークレットをローテーションする

👤 少人数の DevOps チーム ⏱ ~10 min intermediate

使うタイミング： API キー（Stripe、Sentry DSN など）をローテーションし、6つのアプリがそのキーを参照しているとき。

フロー

対象アプリを一覧表示する

In project 'prod', list all apps that have the env var 'STRIPE_SECRET_KEY'.✓ コピーしました

→ 該当するアプリの一覧
一括更新と再デプロイ

Update STRIPE_SECRET_KEY to [new value] on all those apps, then trigger redeploy for each with a 30-second stagger.✓ コピーしました

→ アプリごとの更新 + 再デプロイの結果レポート

結果： 1回の会話でフリート全体のシークレットローテーションが完了する。

注意点

時間差の再デプロイでも短時間のダウンタイムが発生する可能性がある — ゼロダウンタイムが必要な場合は、アプリごとに Coolify のローリングデプロイモードを使用する

組み合わせ

他のMCPと組み合わせて10倍の力を

coolify + github

新しいリポジトリの準備ができたら Coolify にデプロイし、PR にプレビュー URL をコメントする

Take repo me/new-project. Deploy it to Coolify under project 'preview', then comment the preview URL on the main branch README.✓ コピーしました

coolify + sentry

Sentry で Coolify ホストアプリのエラーが急増したら、前のバージョンに再デプロイする

If Sentry issue count for app 'api-server' doubles in 10 min, roll back the Coolify deploy to previous commit.✓ コピーしました

ツール

このMCPが提供する機能

ツール	入力	呼び出すタイミング	コスト
list_servers		リソース作成前に接続済みサーバーを確認する	1 API call
list_applications	project_uuid?: str	既存アプリを検索する。プロジェクトで絞り込むとノイズが減る	1 API call
create_application	source, server, project, build_pack, port, ...	Git から新しいアプリを作成する	1 API call
deploy_application	app_uuid: str	デプロイを開始する。即座に返るのでステータスをポーリングする	1 API call + build time
get_application_logs	app_uuid, tail?: int	実行中または障害中のアプリをデバッグする	1 API call
update_env_variable	app_uuid, key, value, is_preview?: bool	環境変数を変更する。自動再デプロイはされない	1 API call
create_database	engine, name, project, server, config	新しいマネージド DB（Postgres、MySQL、Redis、MongoDB など）をプロビジョニングする	1 API call
search_docs	query: str	チャットを離れずに Coolify の機能ドキュメントを検索する	free

コストと制限

運用コスト

APIクォータ: Coolify インスタンスの性能に依存 — 公式のレート制限はないが、呼び出しは適度に
呼び出しあたりのトークン: 一覧系は約500〜2000トークン（最適化済み）、詳細系は約200〜1000トークン
金額: 無料、MIT ライセンス。Coolify 自体も無料でセルフホスト。
ヒント: 推測する前に search_docs を使う — Claude が試行錯誤するよりトークンコストが安い。

セキュリティ

権限、シークレット、影響範囲

最小スコープ： A Coolify API token scoped to the team you want to manage

認証情報の保管： MCP クライアントを実行するマシン上の COOLIFY_ACCESS_TOKEN 環境変数

データ送信先： Coolify インスタンスへ直接通信。それ以降は Coolify 側で処理される

絶対に付与しない： Share the token — it's equivalent to full control of your PaaS

MCP はトークン権限で動作する — クライアントが侵害されると PaaS 全体にアクセスされる。Coolify がサポートしている場合はスコープ付きトークンを使用すること。
破壊的なツール（アプリ削除、DB 削除）は追加確認なしで実行される — Claude に必ず事前確認するよう指示すること。

トラブルシューティング

よくあるエラーと対処法

401 Unauthorized

トークンが無効または期限切れです。Coolify > Settings > API で再生成し、環境変数を更新してください。

確認： curl -H 'Authorization: Bearer $TOKEN' $COOLIFY_URL/api/v1/servers

Deploy stuck in 'queued'

Coolify サーバーの CPU/ディスクに空きがあるか確認してください。また、前回のデプロイがハングしてビルドキューをブロックしていないか確認してください。

確認： Use `list_deployments` tool and cancel stale ones

create_application returns 422 build_pack invalid

有効な値は nixpacks、static、dockerfile、dockercompose です。大文字・小文字が区別されます。

Custom domain shows cert error

TLS 証明書を発行するには、DNS が Coolify サーバーを指している必要があります。A レコードを確認してから、Claude に Let's Encrypt の発行リトライをトリガーするよう依頼してください。

確認： dig app.example.com

代替案

coolify-mcp 他との比較

代替案	代わりに使う場面	トレードオフ
Dokploy MCP	Coolify ではなく Dokploy を使用している場合	類似の機能セット。Dokploy は最も近い競合サービス
Caprover / Dokku CLI via ssh-manager	Caprover や Dokku を使用しており、専用の MCP がない場合	SSH コマンドで操作する。専用ツールより使い勝手は劣るが、どの環境でも動作する

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る