coolify-mcp MCP — 使用場景, 安裝 & 即時演示

為什麼要用

核心特性

38 個工具，涵蓋伺服器、應用程式、資料庫（8 種引擎）、服務、團隊
批次操作：重啟專案中所有應用程式、批量更新環境變數、緊急停止
內建 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 上有新的 side project，想在 5 分鐘內讓它在 VPS 上線，不想點遍 Coolify 介面。

前置條件

執行中的 Coolify 實例 — 在你的 VPS 上執行 coolify.io 安裝腳本
COOLIFY_ACCESS_TOKEN — Coolify > Settings > API > Create Token

步驟

建立應用程式

在伺服器 'hetzner-fsn1' 的專案 'side-projects' 中建立一個新的 Coolify 應用程式。來源：https://github.com/me/my-app。建置套件：Nixpacks。連接埠：3000。✓ 已複製

→ 應用程式已建立，回傳 UUID
設定環境變數

在應用程式上設定這些環境變數：DATABASE_URL=...、SESSION_SECRET=...、NODE_ENV=production。✓ 已複製

→ 環境變數已儲存
部署並監看日誌

部署應用程式。追蹤建置日誌；告訴我它是否健康運行或發生崩潰。✓ 已複製

→ 即時建置日誌 + 最終成功/失敗結果

結果： 約 5 分鐘內，完全透過對話讓你的 VPS 上線一個新的 HTTPS 應用程式。

注意事項

忘記設定網域；Coolify 會使用自動產生的醜陋網域名稱 — 部署後詢問：「新增自訂網域 app.example.com 並啟用 HTTPS」。Coolify 會自動佈建 Let's Encrypt 憑證。

搭配使用： github

一個提示詞即可為新應用程式建立受管理的 Postgres 資料庫

👤 全端開發者 ⏱ ~5 min beginner

何時使用： 你的應用程式需要資料庫，但不想連線進去執行 docker run，也不想記住備份排程。

步驟

建立資料庫

在專案 'side-projects' 中建立一個名為 'myapp-prod' 的 Postgres 16 資料庫，配置 2GB RAM，每日備份保留 7 天。✓ 已複製

→ 資料庫已建立，回傳憑證資訊
將資料庫連接到應用程式

將此資料庫的 DATABASE_URL 作為環境變數新增到應用程式 'my-app'，並重新部署。✓ 已複製

→ 環境變數已設定 + 重新部署已觸發

結果： 具有排程備份的受管理 Postgres 資料庫，已連接至你的應用程式。

注意事項

預設 Postgres 僅接受來自 Coolify 網路的連線 — 如需外部存取，透過 MCP 切換 Public 開關 — 且只開放特定 IP

搭配使用： postgres

在手機上診斷並恢復生產環境應用程式崩潰

👤 獨立維運人員、小型團隊 ⏱ ~10 min intermediate

何時使用： 你的應用程式掛了，但你不在電腦旁。你手機上有 Claude 和你的 Coolify Token。

步驟

檢查健康狀態

顯示專案 'prod' 中所有應用程式的狀態。有任何異常嗎？✓ 已複製

→ 每個應用程式的狀態列表，標示出異常項目
查看日誌

追蹤應用程式 'api-server' 最後 200 行日誌。發生什麼錯誤？✓ 已複製

→ 日誌摘錄 + 可能原因
回滾或重啟

重啟應用程式。如果在 2 分鐘內再次崩潰，重新部署上一個提交版本。✓ 已複製

→ 已發送重啟指令；持續監控狀態

結果： 無需筆電即可恢復服務。

注意事項

重啟無法修復部署錯誤 — 你只會陷入循環 — 告訴 Claude 查看部署歷史，若重啟無效則回滾到最後一個健康的提交版本

搭配使用： sentry

在專案中所有應用程式輪換共用密鑰

👤 小型 DevOps 團隊 ⏱ ~10 min intermediate

何時使用： 你輪換了一個 API 金鑰（Stripe、Sentry DSN 等），而 6 個應用程式都引用了它。

步驟

列出受影響的應用程式

在專案 'prod' 中，列出所有含有環境變數 'STRIPE_SECRET_KEY' 的應用程式。✓ 已複製

→ 符合條件的應用程式清單
批量更新並重新部署

將所有這些應用程式上的 STRIPE_SECRET_KEY 更新為 [new value]，然後以 30 秒間隔依序觸發每個應用程式重新部署。✓ 已複製

→ 每個應用程式的更新 + 重新部署報告

結果： 在一次對話中完成全部應用程式的密鑰輪換。

注意事項

交錯重新部署仍會造成短暫停機 — 如果需要零停機，請對每個應用程式使用 Coolify 的滾動部署模式

組合

與其他 MCP 搭配，撬動十倍槓桿

coolify + github

當新 repo 就緒時，將其部署到 Coolify 並在 PR 上留言回覆 URL

取得 repo me/new-project。將其部署到 Coolify 的專案 'preview' 下，然後在主分支的 README 上留言預覽 URL。✓ 已複製

coolify + sentry

當 Sentry 顯示 Coolify 託管應用程式發生異常流量突增時，重新部署上一個版本

如果應用程式 'api-server' 的 Sentry 問題數在 10 分鐘內翻倍，將 Coolify 部署回滾到上一個提交版本。✓ 已複製

工具

此 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	佈建新的受管理資料庫（Postgres、MySQL、Redis、MongoDB 等）	1 API call
search_docs	query: str	在對話中查詢 Coolify 功能用法，無需切換視窗	free

成本與限制

運行它的成本

API 配額: 受 Coolify 實例限制 — 沒有正式的速率限制，但呼叫次數應保持合理
每次呼叫 Token 數: 列表呼叫約 500-2000 tokens（已最佳化）；詳細呼叫約 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 以 Token 權限執行 — 客戶端若遭入侵等同完整 PaaS 存取權。在 Coolify 支援的情況下請使用範圍限定的 Token。
破壞性工具（刪除應用程式、刪除資料庫）執行時無需額外確認 — 告訴 Claude 每次操作都要先詢問。

故障排查

常見錯誤與修復

401 Unauthorized

Token 無效或已過期。在 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

DNS 必須先指向 Coolify 伺服器才能簽發 TLS 憑證。驗證 A 記錄後，請 Claude 觸發 Let's Encrypt 重新嘗試簽發。

驗證： dig app.example.com

替代方案

coolify-mcp 對比其他方案

替代方案	何時用它替代	權衡
Dokploy MCP	你使用 Dokploy 而非 Coolify	功能集相近；Dokploy 是最相近的競品
Caprover / Dokku CLI via ssh-manager	你使用 Caprover 或 Dokku，且沒有專用的 MCP	透過 SSH 指令驅動；操作較不流暢但可在任何地方使用

coolify-mcp

為什麼要用

核心特性

即時演示

實際使用效果

安裝

選擇你的客戶端

使用場景

實戰用法： coolify-mcp

前置條件

步驟

注意事項

步驟

注意事項

步驟

注意事項

步驟

注意事項

組合

與其他 MCP 搭配，撬動十倍槓桿

工具

此 MCP 暴露的能力

成本與限制

運行它的成本

安全

權限、密鑰、影響範圍

故障排查

常見錯誤與修復

替代方案

coolify-mcp 對比其他方案

更多

資源