MCP-Server

Cloady bringt einen MCP-Server mit, über den ein AI-Agent in deinem Konto arbeiten kann – mit Workspaces, Apps, Deploys, Umgebungsvariablen, Domains, Volumes, Mitgliedern, Integrationen, Abrechnung und Support-Tickets.

Worum es geht

Mit dem Model Context Protocol (MCP) kann ein AI-Client Tools auf einem Server finden und aufrufen. Die Operationen der REST-Referenz werden zu Cloady-Tools, und jeder Aufruf geht mit deinem API-Token an den passenden Endpunkt – mit denselben Berechtigungsprüfungen wie deine eigenen Anfragen.

Du kannst den Server lokal über stdio als @cloady/mcp ausführen oder dich mit dem gehosteten Endpunkt https://cloady.com/api/mcp verbinden, der dieselben Tools über Streamable HTTP bereitstellt, ganz ohne Installation. Der gehostete Endpunkt lässt die Tools weg, die Zugangsdaten zurückgeben (revealVar, getDbCredentials, getVolumeKeys, createSshSession, getSshSession, createToken, startCardSetup, die Einladungs-Tools, deren Links jedem Zugang geben, der sie öffnet, und die Tools für den Import von anderen Anbietern), außerdem generateImage. Auch die meisten Monitor-Tools fehlen dort: Am gehosteten Endpunkt lesen Agenten Metriken und Logs mit queryAppMetrics, queryAppMetricsRange, queryAppLogs und queryWorkspaceMetrics. Alles, was dort fehlt, bleibt im lokalen Paket und in der API verfügbar.

Die öffentliche Verbindung im OpenAI-Verzeichnis nutzt https://cloady.com/api/mcp?profile=openai. Sie bietet Diagnosen für Anwendungen, Einblick in Datenbankschemas, Repository-Operationen und die Verwaltung von Domains. Nicht enthalten sind das Abrufen von Zugangsdaten, Verifizierungscodes, das Einrichten von Zahlungen, Änderungen am Abonnement sowie das Anlegen von Anwendungen und das Ändern ihrer Größe. Diese Operationen bleiben über das Cloady-Dashboard, die REST-API und das lokale Paket @cloady/mcp verfügbar. Jede Git-Aktion ist ein eigenes Tool.

Clients mit OAuth-Unterstützung verbinden sich, ohne einen API-Schlüssel zu kopieren. Wähle bei der Zustimmung einen Scope und widerrufe das daraus entstandene Token unter Account → API tokens, sobald du es nicht mehr brauchst. Eine Verbindung auf Kontoebene kann auf alle Workspaces zugreifen, zu denen dein Konto gehört – im Rahmen ihres Scopes und deiner Rolle. Wie Daten weitergegeben, aufbewahrt und gelöscht werden, steht in der Datenschutzerklärung.

Verbinden

Erstelle unter Account → API tokens ein Token und kopiere das Secret cldy_… – es wird nur einmal angezeigt. Du brauchst Node 20 oder neuer.

Claude Code

claude mcp add cloady -e BEARER_TOKEN_CLOADY=cldy_… -- npx -y @cloady/mcp

Gehostet, ohne Installation

claude mcp add --transport http cloady https://cloady.com/api/mcp --header "Authorization: Bearer cldy_…"

Jeder Client, der Streamable HTTP spricht, verwendet dieselbe URL und denselben Authorization: Bearer-Header. Jede Anfrage läuft im Namen des Token-Inhabers, genau wie beim Paket.

Claude Desktop / Cursor / jeder MCP-Client

{
  "mcpServers": {
    "cloady": {
      "command": "npx",
      "args": ["-y", "@cloady/mcp"],
      "env": { "BEARER_TOKEN_CLOADY": "cldy_xxxxxxxxxxxxxxxx" }
    }
  }
}

API_BASE_URL überschreibt den Ziel-Host, wenn du auf etwas anderes als https://cloady.com zeigst.

Tools

Ein Tool pro API-Operation, benannt nach ihrer Operation-ID – listVars, createVar, deployApp, execCommand, listDeploys. Pfad- und Query-Parameter sind Argumente auf oberster Ebene; alles, was ein JSON-Body wäre, kommt in ein verschachteltes requestBody-Objekt. createVar nimmt also workspaceSlug, appSlug, env und region, dazu requestBody: { key, value, isSecret }.

Jede App läuft in einer Region und einer Umgebung, und ihr Name ist innerhalb eines Workspaces und einer Umgebung eindeutig. env ist production (der Standard), preview oder development; region brauchst du nur, wenn es eine App dieses Namens in mehr als einer Region gibt.

Die vollständige Liste mit allen Argumenten ist die API-Referenz – alles, was dort steht, ist ein Tool. Ein paar, die du kennen solltest:

Umbenennen über updateApp ist der sichere Weg, den Namen einer App zu ändern: Die App behält ihre Daten, und ihre Adresse folgt dem neuen Namen – eine App namens My Blog im Workspace acme antwortet unter my-blog-k7q2v9ze-acme.cloady.io und zieht nach dem Umbenennen auf die Adresse des neuen Namens um. Lösche eine App nie und lege sie neu an, nur um sie umzubenennen; beim Löschen werden ihre Daten vernichtet.

Die fünf stream…-Tools (streamAppStatus, streamAppMetrics, streamActiveDeploy, streamDeployLogs, streamTicketMessages) liefern pro Aufruf einen aktuellen Frame statt eines Live-Feeds. Ruf sie also erneut auf, um einen Fortschritt zu verfolgen.

Scopes

Ein Token hat genau einen Scope, und der begrenzt die Workspace-Rolle, mit der das Token handeln kann: read handelt als Viewer, deploy als Developer, full bis hin zum Owner. Jede Operation braucht trotzdem dieselbe Rolle wie im Dashboard – ein Token mit Scope full kann also nichts in einem Workspace löschen, in dem du nur Viewer bist.

Ein Token kann außerdem an einen Workspace gebunden sein; bei einem anderen Workspace wird es mit dem Fehler forbidden abgelehnt.

Fehler

Fehler kommen als Fehler-Body des Endpunkts selbst zurück:

{ "error": { "code": "forbidden", "message": "API token scope 'read' cannot perform 'developer'-level actions" } }

Beispiel-Interaktion

You: Install WordPress in the acme workspace, region usw1, then show me its settings.

Agent → listTemplates
  ← the catalog, including { "slug": "wordpress", … }

Agent → deployApp { workspaceSlug: "acme",
                    requestBody: { name: "My Blog", region: "usw1",
                                   source: { type: "catalog", name: "wordpress" } } }
  ← the created app: slug "my-blog", status "deploying"

Agent → listVars { workspaceSlug: "acme", appSlug: "my-blog" }
  ← its variables and generated credentials

Agent: Installed My Blog in usw1; it's deploying now. Here are its settings — …