Cloudways MCP: rechten van het Access Token, Claude en Cursor koppelen, servers beheren met AI
Cloudways MCP heb ik aan Claude Code gekoppeld, met een alleen-lezen Access Token, zodat ik Cloudways-servers via een gesprek kan opvragen. Door de naam denk je misschien dat er iets op de Cloudways-server wordt geïnstalleerd, maar je registreert het in werkelijkheid in het instellingenbestand aan de kant van het AI-programma.
Met hetzelfde token heb ik de serverlijst, de status van diensten en het CPU-gebruik opgevraagd, en gecontroleerd dat het legen van de cache met een rechtenfout wordt geweigerd.
1️⃣ Hoe Cloudways MCP werkt
Cloudways MCP is een verbindingsserver waarmee AI-programma's zoals Claude, Cursor en ChatGPT namens jou de Cloudways-API aanroepen, en alle Cloudways-klanten krijgen hem zonder meerprijs.
De opzet bestaat uit drie delen. Het AI-programma (de MCP-client) ontvangt het verzoek en kiest welke tool het gebruikt, en de externe MCP-server van Cloudways (mcp.cloudways.com) zet dat verzoek om in een aanroep van de Cloudways-API en voert die uit. Op de Cloudways-server die je beheert, wordt niets geïnstalleerd.
Je registreert het op de computer waarop Claude Code is geïnstalleerd; dat kan ook op een Windows-pc. Deze keer gebeurde dat niet op de Cloudways-server, maar op een aparte Linux-server waarop ik Claude Code heb geïnstalleerd en gebruik.
Er zijn meer dan 250 tools, maar het AI-programma ziet er eerst 66. De rest wordt opgezocht en uitgevoerd wanneer je erom vraagt, dus je hoeft niets extra in te stellen.
2️⃣ Access Token aanmaken en het bereik van de rechten
Ook met het MCP-adres geregistreerd neemt Cloudways geen verzoeken aan zonder Access Token. Het token maak je aan via het profielmenu rechtsboven in Cloudways, onder [API Integration].
Klik op [Create Access Token]: er opent een venster waarin je de naam, de vervaltermijn en het bereik van de rechten instelt, en daar ga je verder.
Er zijn drie rechtenniveaus (Scope), en de standaard is [Limited Access(Beta)]. [Read-Only Access] kan de serverstatus, applicatie-instellingen en het gebruik alleen opvragen en niets aanmaken, wijzigen of verwijderen; [Full Access] gebruikt alle API's binnen de rechten van het account. [Limited Access] staat alleen de functies toe die je kiest.
Begin bij de eerste koppeling met [Read-Only Access]. Met [Read-Only Access] loop je geen risico dat er per ongeluk iets wordt verwijderd, maar wil je de AI iets laten uitvoeren, zoals de cache legen of een back-up maken, dan moet je met [Limited Access] alleen die functie openzetten.
De vervaltermijn kun je instellen van 1 dag tot geen vervaldatum; voor de test is 1 maand gebruikt.
De tokenwaarde wordt alleen bij het aanmaken één keer getoond. Sluit je het venster, dan zie je hem niet meer terug en moet je het token intrekken (Revoke) en een nieuw maken, dus kopieer de tokenwaarde terwijl je nog op de pagina bent.
De oude methode met een API Key stopt halverwege oktober 2026, dus ook een MCP die met een API Key is gekoppeld, moet je overzetten naar een Access Token.
3️⃣ Claude, Cursor en VS Code koppelen
Ook met een token kun je het pas in een gesprek gebruiken als het in het AI-programma is geregistreerd. Claude Code ondersteunt externe HTTP-MCP direct, dus registreren gaat met één opdracht. Deze keer heb ik die uitgevoerd in de terminal van een aparte Linux-server waarop ik Claude Code heb geïnstalleerd en gebruik (niet de Cloudways-server).
claude mcp add --transport http --header "X-Access-Token: YOUR_TOKEN" --header "X-Mcp-Host: claude-code" -s user cloudways https://mcp.cloudways.com/mcp/In de opdracht is [cloudways] de registratienaam; bij [X-Access-Token] vul je het aangemaakte Access Token in en bij [X-Mcp-Host] de naam van het AI-programma dat je gebruikt (claude-code). Vul alleen de waarde in die met [cw_] begint: neem je de punthaken (< >) uit de instructie mee, dan wordt het niet als token herkend.
Registreer je met [-s user], dan zie je de Cloudways-tools in welke map je claude ook start; met [-s local] zie je ze alleen als je claude start in de map waar je de opdracht hebt uitgevoerd. Eerst had ik het als local in de werkmap geregistreerd, maar toen ik claude vanuit een andere map startte, waren de tools er niet, dus heb ik het naar user omgezet.
Ook als user geregistreerd laadt Claude Code eerst alleen de namen van de tools en de beschrijvingen pas bij gebruik, dus vergeleken met local is er weinig verschil in tokenverbruik.
claude mcp list
cloudways: https://mcp.cloudways.com/mcp/ (HTTP) - ✔ ConnectedVoer [claude mcp list] uit: staat er [Connected] aan het eind van de regel [cloudways], dan is de koppeling gelukt. Direct na het registreren kun je het nog niet in het huidige gesprek gebruiken. MCP-tools worden geladen bij het starten van een sessie, dus de Cloudways-tools verschijnen pas in een nieuwe sessie.
De registratie wordt opgeslagen in [.claude.json] in je thuismap, het instellingenbestand van Claude Code; voor het root-account op Linux is dat [/root/.claude.json]. user komt bovenaan dit bestand onder [mcpServers] te staan, local onder [projects] bij het pad van de betreffende map. Claude Desktop op Windows krijgt hetzelfde adres en token in [%APPDATA%\Claude\claude_desktop_config.json].
Andere AI-programma's zoals Cursor en VS Code krijgen hetzelfde adres en token in hun instellingenbestand; het formaat per programma staat in het helpcentrum van Cloudways beschreven.
4️⃣ Taken die je met prompts kunt uitvoeren
Met het Read-Only-token gekoppeld heb ik achtereenvolgens de serverlijst, de serverdetails, de status van diensten, het CPU-gebruik, de lijst met applicaties en de status van het SSL-certificaat opgevraagd, en elke opvraging leverde een resultaat op. De responstijden hieronder zijn de tijd die de Cloudways MCP-server nodig had om het resultaat terug te geven, zonder de tijd die de AI besteedt aan het opstellen van het antwoord.
| Verzoek | Uitgevoerde tool | Responstijd | Antwoord |
|---|---|---|---|
| Laat mijn serverlijst zien | server_list | 0,72 s | 1 server, actief (running), Vultr-regio Seoul, 1 GB, MariaDB 10.11 |
| Geef de details van de server | server_get | 0,68 s | Debian 12, schijf 25 GB, 1 geïnstalleerde applicatie (WordPress) |
| Controleer de status van de diensten | service_status | 5,10 s | 8 actief (Nginx·Apache·MySQL·PHP 8.2-FPM·Redis·Varnish·Memcached·Imunify360), 1 gestopt (New Relic) |
| CPU-gebruik van de afgelopen 24 uur | monitoring_server_graph | 1,75 s | 288 waarden met een interval van 5 minuten, gemiddeld gebruik ongeveer 13%, piek ongeveer 30% |
| Laat de lijst met applicaties zien | app_list | 0,67 s | 1 WordPress, gekoppeld domein cw.testpilotweb.com |
| Controleer de status van het SSL-certificaat | app_get | 3,04 s | Let's Encrypt geïnstalleerd en gecontroleerd, automatische verlenging aan |
| Leeg de cache | app_purge_cache | 0,42 s | Geweigerd — 403 insufficient_scope |
Het CPU-gebruik komt terug als aandeel inactieve CPU (Idle CPU), dus een gemiddelde van 86,8% komt overeen met ongeveer 13% gebruik. Een aparte tool om de SSL-status op te vragen is er niet; ik heb die gecontroleerd via het onderdeel Let’s Encrypt in de applicatiedetails ([app_get]).
Het lijkt alsof alles wordt uitgevoerd wat je de AI vraagt, maar wat er mag, bepalen de rechten van het token. Toen ik vroeg de cache te legen, werd de tool [app_purge_cache] wel uitgevoerd, maar Cloudways weigerde met de fout [Cloudways API error (403): This token does not have access to this endpoint — insufficient_scope].
Welke tools schrijfbewerkingen zijn, zie je in de lijst die de tool [get_write_tools] teruggeeft.
5️⃣ Verbindingsfouten en de lijst met tools vernieuwen
Lukt de koppeling niet, controleer dan eerst in [claude mcp list] of de regel [cloudways] op [Connected] staat. Komt het adres niet tot en met de slash aan het eind overeen met [https://mcp.cloudways.com/mcp/], dan komt er zonder foutmelding geen verbinding, en krijg je [401 Unauthorized], dan is het token verkeerd ingevoerd, ingetrokken of verlopen.
Wil je het token vervangen, verwijder dan de registratie met [claude mcp remove cloudways -s user] en registreer opnieuw met het nieuwe token. Start de opdracht [claude] niet in de terminal, voer het uitvoerbare bestand van Claude Code dan uit met het volledige pad.
Je denkt misschien dat de lijst met tools vernieuwd wordt als je het venster sluit en weer opent, maar programma's zoals Claude Desktop en Cursor bewaren de lijst van de eerste koppeling en blijven in het systeemvak draaien, ook als het venster dicht is. Zie je na een uitbreiding door Cloudways de nieuwe tools niet, schakel dan de koppeling cloudways in de instellingen uit en weer in, of sluit het programma volledig af (op macOS Cmd+Q, op Windows Afsluiten via het pictogram in het systeemvak) en start het opnieuw.
🔢 FAQ & aanbevolen content
ℹ️ Affiliatemelding
De content van deze site bevat affiliatelinks. Koopt een bezoeker via een van deze links een product of dienst, dan ontvangt deze site een commissie van de verkoper. Het bedrag dat de koper betaalt (bij acties gaat het omlaag ↓) wordt daardoor niet hoger. De vermelde prijzen, kortingen en voorraad gelden op het moment van schrijven en kunnen afwijken; controleer ze daarom vóór je aankoop bij de verkoper. Producten worden gekozen en beoordeeld volgens onze eigen criteria, en commissies hebben geen invloed op de volgorde of de inhoud van de beoordelingen.