Coolify Mcp

Coolify MCP サーバー

Claude、Cursor、または任意の MCP クライアントから Coolify を管理できます。セルフホスト型 PaaS のデプロイ、デバッグ、運用を平易な英語で行うための 46 個のツールを提供します。破壊的な操作の前には人間に確認し、シークレットはマスクされたままです。

📖 coolify-mcp.stumason.dev · ツールリファレンス · プロンプトとリソース · リモート／HTTP モード · フリート · Doctor · 安全性とセキュリティ · 変更履歴

インストール

稼働中の Coolify v4 インスタンスと API トークン（Coolify → Keys & Tokens → API tokens）が必要です。サーバーの実行方法を 3 つから選んでください。

Claude Desktop のワンクリックインストール。 coolify-mcp.mcpb をダウンロードして、Settings → Extensions にドラッグします。Coolify の URL とトークンを尋ねられます。Node のインストールも JSON の編集も不要です。

任意の MCP クライアントでローカル実行。 Claude Code：

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

Codex CLI では codex mcp add と --env を使えば同じです。Cursor、Claude Desktop、または JSON 設定を受け付ける任意のクライアントの場合：

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": ["-y", "@masonator/coolify-mcp"],
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify-instance.com",
        "COOLIFY_ACCESS_TOKEN": "your-api-token"
      }
    }
  }
}

Coolify 内のコンテナとしてリモート実行。 管理対象の Coolify と並ぶ場所にサーバーをデプロイし、claude.ai、Claude Desktop、または Claude Code から https://your-domain/mcp に接続します。Coolify トークンはサーバー側に保持され、クライアントは OAuth 2.1 で認証します。docs/http-mode.md で 5 分で設定できます。

次に doctor を実行する

どの方法で設定した場合も、1 つのコマンドで検証できます。

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

設定にありがちな問題（未展開の ${VAR}、貼り付け時の空白、重複した /api/v1）、Coolify に接続できること、Cloudflare Access のログインで隠されていないこと、トークンが受け入れられデプロイ権限があること、Coolify のバージョンがテスト済みの範囲内であることを確認します。各エラーには 1 行の修正方法が表示されます。スクリプトでは --json を追加してください。シークレットが出力されることはありません。各チェックの説明はdoctor ガイドにあります。

プロキシまたは Cloudflare Access の背後で使う場合

汎用認証プロキシでは --header "Key: Value" 引数を追加します（繰り返し指定できます）。Cloudflare Access の場合は CF_ACCESS_CLIENT_ID と CF_ACCESS_CLIENT_SECRET（Access サービストークン）を設定すると、ローカルモードとリモートモードの両方で Coolify へのすべてのリクエストにこれらが付加されます。設定方法。

できること

すべてのツールは action を受け取ります。引数を指定せずに実行すると、受け付ける値が一覧表示されます。全項目はツールリファレンスをご覧ください。概要は次のとおりです。

• 問題の原因を調べます。 diagnose_app と diagnose_server は名前、ドメイン、IP、UUIDを受け取り、find_issues は環境全体をスキャンし、logs は任意のコンテナのログを読み取ります。
• デプロイとロールバックを行います。 deploy は最終ステータスになるまで待機し、失敗時にはログの末尾を返します。control を使って、任意の対象を起動、停止、再起動できます。
• 作成と削除を行います。 アプリケーション、データベース（8種類のエンジン）、サービス、プロジェクト、環境を作成・削除できます。変更前に紐付けを確認するには、environments verify_app を使います。
• 設定を管理します。 環境変数、ストレージ、スケジュールタスク、バックアップ、タグ、秘密鍵、GitHub アプリ、クラウドトークンを扱います。特定のキーを指定しない限り、シークレットはマスクされて返されます。
• 環境全体を対象に操作します。 bulk_env_update、redeploy_project、stop_all_apps を利用できます。それぞれ、影響範囲を示す人間による確認を挟みます。
• search_docs で Coolify のドキュメントを検索します。

一覧では uuid／name／status の概要が返され、サイズは生の API 応答より90～99％小さくなります。get_* ツールは、個別のリソース全体を取得します。ツールリスト全体で必要なコンテキストは約8,900トークンです。

ツールだけでなく、ワークフローも

スラッシュコマンドとして3つのプロンプトが用意されています。troubleshoot_application、explain_failed_deploy、estate_health から1つ選ぶと、モデルが利用可能なツールを使ってワークフローを進めます。coolify://overview と coolify://application/{uuid} の2つのリソースは、クライアントが添付できる読み取り専用のデータです。どちらもすべてのツール呼び出しと同じマスキング処理を通り、平文を要求する方法はありません。使用するツールが登録されていないプロンプトは一覧に表示されないため、読み取り専用モードで行き詰まることはありません。プロンプトとリソース。

複数の Coolify インスタンス

デフォルト設定とともに COOLIFY_INSTANCES に { name, url, token } のJSON配列を設定してください。すると、各ツールで省略可能な instance を指定できるようになり、list_instances で設定済みインスタンスを確認できます。また、削除を伴う操作の確認では、対象のインスタンスが明示されます。単一インスタンスのインストール環境では、バイト単位で同一の動作になります。複数インスタンスは1つの信頼境界として扱われます。クライアントごとに Coolify を運用している代理店は、クライアントごとにサーバーを1台ずつ実行してください。フリートガイド。

本番環境を安心して接続できます

削除を伴う操作では、対応クライアント（Claude Code、VS Code Copilot）上で、何かが実行される前にユーザー自身に確認を求めます。リモートモードでは、ガード機能はフェイルクローズで動作します。シークレットは API の境界でマスクされ、ログ出力は信頼できないデータとして扱われるため、悪意のあるログ行が指示を出すことはできません。また、評価スイートでは変更のたびに、これら2つの安全性に関する主張をレッドチームテストします。詳細。

Coolify v4.0 から v4.3 までに対応しています。v4.2 での GET から POST への変更と、v4.2 で導入されたシークレットおよび Member ロールの制限にも対応しています。互換性をご覧ください。

Coolify 独自の MCP サーバーと、このサーバーを使うべき場合

Coolify には、製品に組み込まれた独自の MCP サーバーが付属しています。Settings → Advanced（チームごとの設定も可能）で有効にし、クライアントから https://your-coolify/mcp に接続すれば、インストールは不要です。インスタンス内で動作するため、サードパーティのコードがトークンを扱うことはありません。Coolify を 1 つ、チームを 1 つだけ運用していて、主に質問をしたい場合は、こちらを使ってください。最短で始められ、費用もかかりません。

執筆時点では、Coolify のドキュメントによると、同サーバーは読み取り専用で、書き込み操作は今後追加される予定です。開発は急速に進んでいるため、現在の状況はCoolify のドキュメントで確認してください。また、会話形式ではなくスクリプトを使いたい場合は、公式 CLIもあります。

このサーバーは、現時点でその 2 つでは対応できない作業向けです。

	Coolify 組み込みの /mcp	公式 CLI	このサーバー
実行場所	Coolify の内部	シェル	ご利用のマシン、または Coolify 内のコンテナ
インストール	不要	バイナリ 1 つ	npx、ワンクリックの Claude Desktop 拡張機能、またはコンテナ
トランスポート	ストリーミング可能な HTTP	MCP サーバーではない	stdio と HTTP。stdio のみを使用するクライアントでも動作します
Coolify インスタンス	1 つ	一度に 1 つのコンテキスト	1 つ以上。フリートモードでは、すべてのツールに instance が必要です
書き込み	現在は読み取り専用と記載	可能	可能
破壊的な呼び出しの前	該当なし	自分で入力	エリシテーションに対応するクライアントでは、影響範囲を明示してご利用のクライアント上で停止し、確認を求めます。HTTP モードではフェイルクローズします
問題が起きたとき	該当なし	シェルの終了コード	原因と一行でできる修正方法を doctor が示します

おおまかな目安です。インスタンスが 1 つで、設定不要の読み取り専用の質問が目的なら、Coolify のものを使ってください。スクリプト作成や CI には CLI を使ってください。複数のインスタンスを扱う場合、書き込み前に人による確認を挟みたい場合、stdio のみを使用するクライアントを使う場合、または問題の「理由」も知りたい場合は、このサーバーを使ってください。

Coolify 用のサードパーティ製 MCP サーバーもほかにあります。トランスポート、1 つの接続からアクセスする必要があるインスタンス数、削除の直前に何が起きるかを基準に選んでください。

プロンプトの例

Give me an overview of my infrastructure
Diagnose my shop.example.com app
Find any issues in my infrastructure
Deploy application {uuid} and wait for it to finish
Update the DATABASE_URL env var for application {uuid}
Restart all applications in project {uuid} on instance staging
How do I fix a 502 Bad Gateway error in Coolify?

開発

git clone https://github.com/StuMason/coolify-mcp.git
cd coolify-mcp && npm install
npm run build && npm test

COOLIFY_BASE_URL="https://your-coolify.com" COOLIFY_ACCESS_TOKEN="token" node dist/index.js

ツールの説明はプロンプトであるため、evals/ では、モデルが適切なツールを選ぶか、また攻撃者が制御する出力によって誤動作する可能性があるかを評価します。すべての PR でコントラクトのスナップショットをチェックします。evals/README.mdを参照してください。コントリビューションを歓迎します。CONTRIBUTING.mdと、アーキテクチャおよび API に関する注意事項を記載したCLAUDE.mdをご覧ください。

私と一緒に取り組みましょう

私は Stu Mason です。代理店、中小企業、エンタープライズ向けに、MCP サーバー、AI インテグレーション、エージェント型システムを構築しています。このリポジトリは、そうした仕事をオープンにしたものです。

• 製品向けの MCP サーバー。 このサーバーのように、Claude、Cursor、その他すべての AI クライアントが API を適切に利用できる方法を提供します。
• お手持ちの情報に基づく回答。 推測ではなく、根拠を示しながら、ドキュメントやデータに基づいて回答する AI です。自社サーバー内で運用することもできます。
• 自動で実行される業務。 スケジュールに沿って仕分け、確認、報告を行うジョブを設定し、何かが外部に送信される前に担当者が承認できるようにします。

代理店の場合は、自社の名前でホワイトラベル提供できます。また、業務に AI が不要であれば、費用が発生する前にその旨をお伝えします。

📮 [email protected] · stumason.dev · coolify-mcp.stumason.dev

プライバシーポリシー

このサーバーは、お客様に関する情報を一切収集しません。テレメトリも、アナリティクスも、外部への定期通信もなく、背後で稼働するホステッドサービスもありません。

Coolify API トークンは、設定したインスタンスにのみ送信され、それ以外には送信されません。その他の外部リクエストは、認証情報を含まずキャッシュバリデーターを伴う coolify.io からのドキュメントインデックスの一度限りの更新と、HTTP モードで接続クライアント自身のメタデータドキュメントを認証情報なしで取得するリクエストのみです。ツールの結果はお客様自身の MCP クライアントに送信され、その後の取り扱いはクライアントのプライバシーポリシーに従います。監査ログはお客様自身の stderr に書き込まれ、トークン値が含まれることはありません。

各主張がコードのどこで実装されているかを含む詳細は、PRIVACY.md をご覧ください。

リンク

• Coolify：このサーバーが操作する、オープンソースでセルフホスト可能な PaaS
• MCP Registry：io.github.StuMason/coolify として登録されています
• laravel-coolify：ダッシュボード、Artisan コマンド、生成される Dockerfile を使って Laravel を Coolify にデプロイします
• Model Context Protocol

MIT © Stu Mason。役に立ったら、このリポジトリに ⭐ を付けてください。夕方の時間を節約できたなら、コーヒーをごちそうしてください。