Cloudways MCP: Access-Token-Berechtigungen, Claude und Cursor verbinden, Server mit KI verwalten
Ich habe Cloudways MCP mit Claude Code verbunden und mit einem schreibgeschützten Access Token eingerichtet, sodass ich Cloudways-Server im Gespräch abfragen kann. Der Name verleitet zu der Annahme, man installiere etwas auf dem Cloudways-Server – tatsächlich trägst du es aber in die Einstellungsdatei des KI-Programms ein.
Mit demselben Token habe ich die Serverliste, den Dienststatus und die CPU-Auslastung abgefragt und außerdem geprüft, dass das Leeren des Caches mit einem Berechtigungsfehler abgelehnt wird.
1️⃣ So funktioniert Cloudways MCP
Cloudways MCP ist ein Verbindungsserver, über den KI-Programme wie Claude, Cursor und ChatGPT die Cloudways-API für dich aufrufen, und steht allen Cloudways-Kunden ohne Aufpreis zur Verfügung.
Der Aufbau verteilt sich auf drei Stellen. Das KI-Programm (MCP-Client) nimmt die Anfrage entgegen und wählt das passende Tool, und der von Cloudways betriebene Remote-MCP-Server (mcp.cloudways.com) setzt die Anfrage in einen Aufruf der Cloudways-API um und führt ihn aus. Auf dem verwalteten Cloudways-Server wird nichts installiert.
Die Registrierung erfolgt auf dem Rechner, auf dem Claude Code installiert ist, und funktioniert auch auf einem Windows-PC. Diesmal habe ich sie nicht auf dem Cloudways-Server, sondern auf einem separaten Linux-Server durchgeführt, auf dem ich Claude Code installiert habe und nutze.
Es gibt über 250 Tools, das KI-Programm sieht aber zunächst nur 66. Die übrigen werden bei Bedarf gesucht und ausgeführt, du musst also nichts zusätzlich einstellen.
2️⃣ Access Token erstellen und Berechtigungsumfang
Auch wenn die MCP-Adresse eingetragen ist, nimmt Cloudways ohne Access Token keine Anfragen an. Den Token erstellst du im Profilmenü oben rechts in Cloudways unter [API Integration].
Klickst du auf [Create Access Token], öffnet sich ein Fenster, in dem du Name, Ablaufzeit und Berechtigungsumfang festlegst; dort geht es weiter.
Es gibt drei Berechtigungsumfänge (Scope), Standard ist [Limited Access(Beta)]. [Read-Only Access] fragt Serverstatus, Anwendungseinstellungen und Nutzung nur ab und kann nichts erstellen, ändern oder löschen, [Full Access] nutzt jede API im Rahmen der Kontoberechtigungen. [Limited Access] erlaubt nur die Funktionen, die du auswählst.
Für die erste Verbindung beginnst du mit [Read-Only Access]. Mit [Read-Only Access] kannst du nichts versehentlich löschen; soll die KI aber etwas ausführen, etwa den Cache leeren oder ein Backup anlegen, musst du genau diese Funktion mit [Limited Access] freigeben.
Die Ablaufzeit lässt sich von 1 Tag bis unbegrenzt wählen; für den Test habe ich 1 Monat verwendet.
Der Token-Wert wird nur einmal beim Erstellen angezeigt. Schließt du das Fenster, kannst du ihn nicht mehr einsehen und musst ihn widerrufen (Revoke) und neu erstellen – kopiere den Token-Wert also, solange du noch auf der Seite bist.
Die bisherige API-Key-Methode endet Mitte Oktober 2026, daher musst du auch ein per API Key verbundenes MCP auf einen Access Token umstellen.
3️⃣ Claude, Cursor und VS Code verbinden
Auch mit erstelltem Token kannst du ihn im Gespräch erst nutzen, wenn er im KI-Programm eingetragen ist. Claude Code unterstützt Remote-HTTP-MCP direkt und registriert es mit einem einzigen Befehl. Diesmal habe ich ihn im Terminal eines separaten Linux-Servers ausgeführt, auf dem ich Claude Code installiert habe und nutze (nicht auf dem Cloudways-Server).
claude mcp add --transport http --header "X-Access-Token: TOKEN" --header "X-Mcp-Host: claude-code" -s user cloudways https://mcp.cloudways.com/mcp/Im Befehl ist [cloudways] der Registrierungsname; bei [X-Access-Token] trägst du den erstellten Access Token ein und bei [X-Mcp-Host] den Namen deines KI-Programms (claude-code). Gib nur den Wert ein, der mit [cw_] beginnt – übernimmst du die spitzen Klammern (< >) aus der Anleitung mit, wird er nicht als Token erkannt.
Mit [-s user] erscheinen die Cloudways-Tools, egal aus welchem Ordner du claude startest; mit [-s local] nur, wenn du es in dem Ordner startest, in dem du den Befehl ausgeführt hast. Anfangs hatte ich es als local im Arbeitsordner eingetragen, aber aus einem anderen Ordner gestartet waren die Tools nicht zu sehen, also habe ich auf user umgestellt.
Auch bei user lädt Claude Code zuerst nur die Tool-Namen und die Beschreibungen erst bei Gebrauch, daher unterscheidet sich der Token-Verbrauch kaum von local.
claude mcp list
cloudways: https://mcp.cloudways.com/mcp/ (HTTP) - ✔ ConnectedFühre [claude mcp list] aus: Steht am Ende der Zeile [cloudways] ein [Connected], ist die Verbindung hergestellt. Im laufenden Gespräch kannst du es direkt nach der Registrierung noch nicht nutzen. MCP-Tools werden beim Start einer Sitzung geladen, die Cloudways-Tools erscheinen also erst in neu geöffneten Sitzungen.
Die Registrierung wird in [.claude.json] im Home-Ordner gespeichert, der Einstellungsdatei von Claude Code; beim Linux-Konto root ist das [/root/.claude.json]. user steht in [mcpServers] ganz oben in dieser Datei, local unter dem jeweiligen Ordnerpfad in [projects]. Claude Desktop unter Windows bekommt dieselbe Adresse und denselben Token in [%APPDATA%\Claude\claude_desktop_config.json].
Andere KI-Programme wie Cursor und VS Code bekommen dieselbe Adresse und denselben Token in ihre Einstellungsdatei; wie das Format für jedes Programm aussieht, kannst du im Cloudways Help Center nachlesen.
4️⃣ Aufgaben, die du per Prompt ausführen kannst
Mit dem Read-Only-Token habe ich nacheinander Serverliste, Serverdetails, Dienststatus, CPU-Auslastung, Anwendungsliste und SSL-Zertifikatsstatus angefragt, und jede Abfrage lieferte ein Ergebnis. Die Antwortzeiten unten sind die Zeit, bis der Cloudways-MCP-Server das Ergebnis zurückgab; die Zeit, in der die KI ihre Antwort formuliert, ist nicht enthalten.
| Anfrage | Ausgeführtes Tool | Antwortzeit | Antwort |
|---|---|---|---|
| Zeig mir meine Serverliste | server_list | 0,72 s | 1 Server, läuft (running), Region Vultr Seoul, 1GB, MariaDB 10.11 |
| Zeig mir die Serverdetails | server_get | 0,68 s | Debian 12, 25GB Speicher, 1 installierte Anwendung (WordPress) |
| Prüf den Dienststatus | service_status | 5,10 s | 8 laufen (Nginx, Apache, MySQL, PHP 8.2-FPM, Redis, Varnish, Memcached, Imunify360), 1 gestoppt (New Relic) |
| CPU-Auslastung der letzten 24 Stunden | monitoring_server_graph | 1,75 s | 288 Werte im 5-Minuten-Takt, durchschnittliche Auslastung etwa 13 %, Spitze etwa 30 % |
| Zeig mir die Anwendungsliste | app_list | 0,67 s | 1 WordPress, verbundene Domain cw.testpilotweb.com |
| Prüf den Status des SSL-Zertifikats | app_get | 3,04 s | Let's Encrypt installiert und geprüft, automatische Verlängerung aktiv |
| Leer den Cache | app_purge_cache | 0,42 s | Abgelehnt – 403 insufficient_scope |
Die CPU-Auslastung wird als Anteil der ungenutzten CPU (Idle CPU) zurückgegeben; ein Durchschnitt von 86,8 % entspricht also etwa 13 % Auslastung. Ein eigenes Tool für den SSL-Status gibt es nicht, deshalb habe ich ihn über den Eintrag Let’s Encrypt in den Anwendungsdetails ([app_get]) geprüft.
Es wirkt, als würde alles ausgeführt, worum du die KI bittest – was tatsächlich laufen darf, bestimmen aber die Berechtigungen des Tokens. Auf die Bitte, den Cache zu leeren, wurde zwar das Tool [app_purge_cache] ausgeführt, Cloudways lehnte es aber mit dem Fehler [Cloudways API error (403): This token does not have access to this endpoint — insufficient_scope] ab.
Welche Tools Schreibvorgänge sind, siehst du in der Liste, die das Tool [get_write_tools] zurückgibt.
5️⃣ Verbindungsfehler und Aktualisieren der Tool-Liste
Kommt keine Verbindung zustande, prüfst du zuerst in [claude mcp list], ob die Zeile [cloudways] [Connected] zeigt. Stimmt die Adresse nicht bis zum Schrägstrich am Ende mit [https://mcp.cloudways.com/mcp/] überein, schlägt die Verbindung ohne Fehlermeldung fehl; erscheint [401 Unauthorized], wurde der Token falsch eingegeben oder ist widerrufen bzw. abgelaufen.
Um den Token zu wechseln, löschst du die Registrierung mit [claude mcp remove cloudways -s user] und trägst den neuen Token erneut ein; lässt sich der Befehl [claude] im Terminal nicht ausführen, startest du die Claude-Code-Programmdatei mit ihrem vollständigen Pfad.
Man denkt leicht, dass sich mit dem Schließen und erneuten Öffnen des Fensters auch die Tool-Liste aktualisiert. Programme wie Claude Desktop und Cursor speichern aber die Tool-Liste der ersten Verbindung und laufen nach dem Schließen des Fensters im Infobereich weiter. Erscheinen neue Tools nicht, nachdem Cloudways sie hinzugefügt hat, deaktivierst du die cloudways-Verbindung in den Einstellungen und aktivierst sie wieder, oder du beendest das Programm vollständig (macOS Cmd+Q, unter Windows Beenden über das Symbol im Infobereich) und startest es neu.
🔢 FAQ & empfohlene Inhalte
ℹ️ Affiliate-Hinweis
Die Inhalte dieser Website enthalten Affiliate-Links. Kauft ein Besucher über einen dieser Links ein Produkt oder eine Dienstleistung, erhält die Website vom Verkäufer eine Provision. Der Betrag, den der Käufer zahlt(bei Aktionsrabatten sinkt er ↓), steigt dadurch nicht. Angegebene Preise, Rabatte und Lagerbestände entsprechen dem Stand bei Erstellung und können abweichen; prüfe sie daher vor dem Kauf beim Verkäufer. Produkte werden nach eigenen Kriterien ausgewählt und bewertet, und Provisionen beeinflussen weder die Reihenfolge noch den Inhalt der Bewertungen.