Coolify Cloud

July 31, 2026 · View on GitHub

Nutze awesome-coolify-mcp mit Coolify Cloud. Der Server stellt 19 Tools und sechs Prompts mit team-scoped Tokens, Routing pro Request und strukturierten Cloud-Fehlern bereit.

Branding: Icons via serverInfo.icons — eingebettete Data-URI (primär) + jsDelivr-CDN-Einträge (mcp-icon-192.png, favicon-32.png). Siehe docs/assets/README.md und Maintainer-Verifizierung.

Zurück zur Haupt-Installationsanleitung: README.de — Installation.

Überblick

Coolify Cloud (https://app.coolify.io) ist Coolifys gehostetes SaaS. Dieser MCP-Server behandelt Cloud-Instanzen wie Self-Hosted für Day-2-Ops (Deploy, Logs, Diagnose, Resource-CRUD usw.), aber einige Infrastruktur-Endpunkte unterscheiden sich oder sind auf Cloud nicht verfügbar.

Nutze die instance-Action cloud-info für lokale/statische Discovery — sie liefert isCloud, aufgelöste URL, Credential-Quelle, Setup-Hinweise, bekannte Limits und einen Docs-Link. Es erfolgt kein Coolify-API-Call.

instance({ action: "cloud-info" })

`cloud-info`-Response-Felder

Feld	Bedeutung
`isCloud`	`true`, wenn der aufgelöste Hostname `*.coolify.io` ist oder Registry-`type: "cloud"`
`url`	Aufgelöste Coolify-Basis-URL (ohne trailing slash)
`source`	Credential-Quelle: `registry` · `env` · `infer`
`knownLimits`	Statische Liste Cloud-API-Lücken (spiegelt Bekannte Limits unten)
`docs`	Link zurück zu dieser Seite

Setup

Erzeuge ein team-scoped API-Token in app.coolify.io unter Keys & Tokens. Niemals echte Tokens committen — Platzhalter oder Umgebungsvariablen verwenden.

Multi-Instance-Registry

Für Flotten mit Self-Hosted und Cloud jede Instanz in ~/.coolify-mcp/instances.json registrieren:

instance({
  action: "add",
  name: "cloud",
  url: "https://app.coolify.io",
  token: "<team-scoped-token>",
  type: "cloud",
})
instance({ action: "list" })
instance({ action: "set-default", name: "cloud" })

Registry-Verzeichnis: 0o700; instances.json: 0o600
Credential-Auflösung pro Request — kein Cross-Instance-Token-Leak
instance: "<name>" auf Ops-Tools setzen, um eine Registry-Instanz zu adressieren

Pfad 1 — `instance.add` (Registry)

Cloud in ~/.coolify-mcp/instances.json registrieren:

instance({
  action: "add",
  name: "cloud",
  url: "https://app.coolify.io",
  token: "<team-scoped-token>",
  type: "cloud",
})

Pfad 2 — `import-env` (Prozess-Umgebung)

Env-Variablen in der MCP-Client-Config setzen (siehe README.de — Installation), dann importieren:

{
  "COOLIFY_URL": "https://app.coolify.io",
  "COOLIFY_TOKEN": "<team-scoped-token>"
}

instance({ action: "import-env" })

import-env kopiert COOLIFY_URL + COOLIFY_TOKEN aus der Prozess-Umgebung in die lokale Registry — nur opt-in.

Optional — Token-Sanity-Check (curl)

Token vor dem MCP-Setup prüfen:

curl -H "Authorization: Bearer $COOLIFY_TOKEN" \
  https://app.coolify.io/api/v1/version

Bei Erfolg JSON-Version erwarten; 401 bedeutet Token neu erzeugen.

Branding

Der MCP-Server bewirbt Icons in initialize via eingebetteter PNG-Data-URI (primär) und jsDelivr-CDN-URLs für mcp-icon-192.png und favicon-32.png. Cursor kann weiterhin einen Buchstaben-Fallback anzeigen — siehe Maintainer-Verifizierung. Das ist nur ein Cursor/MCP-Listen-Anzeigepfad; kein Coolify-API-Call.

Lokaler Manifest-Cache

Der Workspace-Cache unter .coolify/manifest.json beschleunigt Discovery und UUID-Hinweise:

manifest({ action: "sync" })   // gegen live API abgleichen
manifest({ action: "diff" })   // nicht-destruktiver Diff-Report

Best-Effort-Auto-Hooks aktualisieren den Cache nach App/Service/DB-Mutationen
Veraltete Einträge liefern _meta.manifestWarning bei verwandten Ops — sync oder diff zum Abgleichen
Manifest ist Cache, keine Source of Truth — Remote-API gewinnt bei Konflikten; 404 nur als Hinweis (D-15)

Smoke-Test

Nach dem Connect diesen agent-first Pfad ausführen:

Discovery (lokal, kein API-Call):
```
instance({ action: "cloud-info" })
```
Erwartet isCloud: true, url: "https://app.coolify.io" und source als registry, env oder infer.

Connectivity:

system({ action: "health" })
meta({ action: "version" })

Leichter Resource-Read (eine bekannte UUID aus dem Cloud-Dashboard):

resource({ action: "list", per_page: 5 })
// oder
application({ action: "get", uuid: "<app-uuid>" })

Optional — Agent Intelligence (v3.3):

system({ action: "version" })
// capabilities.intelligence_scorecard, deployment_preflight, diagnose_analyze prüfen
intelligence({ action: "scorecard" })

Agent Intelligence (v3.3)

Auf Coolify 4.1.x funktionieren Composite-Intelligence-Actions auf Cloud wie Self-Hosted (nur lesend, außer confirm: true):

Workflow	Einstiegs-Action
Instanz-Gesundheit	`intelligence({ action: "scorecard" })`
Dependency-Graph	`intelligence({ action: "graph" })`
Manifest-Drift	`manifest({ action: "audit" })`
Deploy-Risiko	`deployment({ action: "preflight", uuid: "<app-uuid>" })`
Log-Muster	`diagnose({ action: "analyze", uuid: "<app-uuid>" })`

Vor Nutzung system.version.capabilities lesen. Rollback, Env-Promote und Janitor-Cleanup erfordern explizite Human-Bestätigung.

Bekannte Limits

Log-Unterstützung in Coolify 4.1.x hängt vom Ressourcentyp ab:

Log-Quelle	Unterstützung
Application Runtime Logs und Follow	Unterstützt über `application.logs`
Deployment-/Build-Logs	Unterstützt über `application.logs` mit `deployment_uuid`
`diagnose.logs`	Nur für Applications unterstützt
Service-/Database-Logs	Nicht verfügbar, weil Coolify 4.1.x keine REST-Endpunkte bietet

Prüfe system.version.capabilities, bevor du einen Ablauf auswählst. Leite Support nicht aus der Existenz eines Ressourcen-Tools ab.

Limit	Detail
Server-CRUD via API	Cloud unterstützt kein Server-Create, -Validate oder -Delete über die REST-API — Server-Management über das Cloud-Dashboard.
Self-Hosted-only Endpunkte	Manche Self-Hosted-Endpunkte liefern auf Cloud 404 → strukturierter Code `COOLIFY_CLOUD_UNSUPPORTED`.
Team-scoped Tokens	Tokens sind team-gebunden — prüfen, ob das Token-Team die Ziel-Ressource besitzt.
Gleiche Tool-Oberfläche	Alle 19 MCP-Tools bleiben verfügbar; Fehler als strukturierte Codes, keine stillen Stubs.

cloud-info knownLimits spiegelt diese Liste lokal — kein Live-Capability-Probe.

Fehlercodes

Cloud-spezifische strukturierte Codes greifen, wenn der Instanz-Hostname *.coolify.io ist (oder Registry-type: cloud):

`COOLIFY_CLOUD_FORBIDDEN` (HTTP 403)

Token- oder Team-Berechtigungsproblem auf Cloud.

Recovery-Hints:

Team-scoped Token in app.coolify.io unter Keys & Tokens neu erzeugen und benötigte Abilities prüfen.
Cloud-Tokens sind team-scoped — prüfen, ob das Token zum Team der Ziel-Ressource gehört.

`COOLIFY_CLOUD_UNSUPPORTED` (HTTP 404)

Endpunkt auf Coolify Cloud nicht verfügbar.

Recovery-Hints:

Endpunkt auf Coolify Cloud nicht unterstützt oder nicht verfügbar — Self-Hosted-Alternative oder Cloud-Dashboard nutzen.
Siehe dieses Doc für bekannte Cloud-unsupported Endpunkte.

Generische Codes (COOLIFY_401, COOLIFY_404 usw.) gelten weiterhin als Fallback auf Nicht-Cloud-Hostnames.