coolifylisted
Install: claude install-skill jurislm/jurislm-tools
# Coolify MCP Server 使用指南
Coolify 是一個開源的自託管 PaaS（Platform as a Service），類似於 Heroku 或 Vercel。此 skill 提供透過 MCP 工具管理 Coolify 基礎設施的完整指南。
## MCP 工具概覽
`@jurislm/coolify-mcp` 提供以下類別的基礎設施管理工具：
| 類別 | 功能 |
|------|------|
| 基礎設施 | 版本檢查、基礎設施概覽 |
| 診斷 | 應用/伺服器診斷、問題掃描 |
| 伺服器 | 列表、詳情、建立/更新/刪除、資源、域名、驗證 |
| 專案與環境 | 專案 CRUD、環境管理 |
| 應用程式 | CRUD（5 種建立方式）、日誌、環境變數、控制 |
| 資料庫 | 8 種類型、備份排程管理、環境變數 |
| 服務 | 建立、更新、刪除、控制 |
| 部署 | 列表、部署、取消、狀態 |
| 私鑰 | SSH 金鑰 CRUD |
| GitHub Apps | 整合管理、儲存庫/分支列表 |
| 儲存空間 | 持久化磁碟區與檔案儲存管理 |
| 排程任務 | Cron 任務 CRUD、執行記錄 |
| 雲端 Token | Hetzner/DigitalOcean Token 管理 |
| 團隊 | 團隊與成員查詢 |
| 批量操作 | 重啟專案、環境變數更新、全面停止、重新部署 |
## 核心概念：Application vs Service
理解 Application 和 Service 的差異對於正確使用 Coolify 至關重要：
| 類型 | 說明 | FQDN 更新方式 |
|------|------|--------------|
| **Application** | 單一應用程式（Git/Dockerfile/Docker Image） | `fqdn` 或 `domains` 欄位 |
| **Application (docker-compose build pack)** | Application 類型但使用 docker-compose 部署 | `docker_compose_domains` 欄位 |
| **Service** | Coolify Service 類型的 Docker Compose 組合 | 修改 `docker_compose_raw` 的 Traefik labels |
### Application (docker-compose) 的 FQDN 更新
使用 `docker_compose_domains` 參數，格式為 `[{name, domain}]` 的陣列：
```
coolify_application update uuid="<uuid>" docker_compose_domains=[{"name": "service-name", "domain": "https://example.com"}]
```
傳 `fqdn` 或 `domains` 給這類 app 會得到：
`The domains field cannot be used for dockercompose applications.`
### Coolify Service 的 FQDN 更新
- Service FQDN 由 `docker_compose_raw` 中的 Traefik labels 控制
- 更新方