Cloudways MCP : permissions de l'Access Token, connexion à Claude et Cursor, gérer ses serveurs avec l'IA
J'ai connecté Cloudways MCP à Claude Code et configuré, avec un Access Token en lecture seule, la consultation des serveurs Cloudways par la conversation. Son nom peut faire croire qu'on installe quelque chose sur le serveur Cloudways, mais on l'enregistre en réalité dans le fichier de configuration du programme d'IA.
Avec le même token, j'ai consulté la liste des serveurs, l'état des services et l'utilisation du CPU, et vérifié que vider le cache était refusé avec une erreur de permissions.
1️⃣ Comment fonctionne Cloudways MCP
Cloudways MCP est un serveur de connexion qui permet à des programmes d'IA comme Claude, Cursor ou ChatGPT d'appeler l'API de Cloudways à votre place ; il est fourni sans supplément à tous les clients Cloudways.
L'ensemble se répartit en trois endroits. Le programme d'IA (client MCP) reçoit la demande et choisit l'outil à utiliser, puis le serveur MCP distant géré par Cloudways (mcp.cloudways.com) traduit cette demande en appels à l'API Cloudways et les exécute. Rien n'est installé sur le serveur Cloudways géré.
L'enregistrement se fait sur l'ordinateur où Claude Code est installé, y compris sur un PC Windows. Cette fois, je l'ai fait non pas sur le serveur Cloudways, mais sur un serveur Linux distinct où j'utilise Claude Code.
Il y a plus de 250 outils, mais le programme d'IA n'en voit d'abord que 66. Les autres sont recherchés et exécutés à la demande : il n'y a rien à configurer.
2️⃣ Créer un Access Token et portée des permissions
Même avec l'adresse MCP enregistrée, Cloudways n'accepte aucune demande sans Access Token. Le token se crée dans le menu de profil en haut à droite de Cloudways, sous [API Integration].
Cliquez sur [Create Access Token] : une fenêtre s'ouvre pour définir le nom, la durée de validité et la portée des permissions, puis continuez.
Il existe trois portées de permissions (Scope), la valeur par défaut étant [Limited Access(Beta)]. [Read-Only Access] ne fait que consulter l'état des serveurs, les réglages des applications et l'utilisation, sans pouvoir créer, modifier ni supprimer ; [Full Access] utilise toutes les API dans la limite des droits du compte. [Limited Access] n'autorise que les fonctions choisies.
Pour la première connexion, commencez avec [Read-Only Access]. [Read-Only Access] ne risque pas d'effacer quoi que ce soit par erreur, mais pour faire exécuter quelque chose comme vider le cache ou une sauvegarde, il faut ouvrir uniquement cette fonction avec [Limited Access].
La durée de validité va d'un jour à sans expiration ; pour le test, j'ai utilisé 1 mois.
La valeur du token ne s'affiche qu'une seule fois, à sa création : une fois la fenêtre fermée, impossible de la revoir, et il faut révoquer (Revoke) le token pour en créer un nouveau. Copiez donc la valeur du token avant de quitter la page.
L'ancienne méthode par API Key prend fin à la mi-octobre 2026 : un MCP connecté par API Key doit lui aussi passer à un Access Token.
3️⃣ Connecter Claude, Cursor et VS Code
Même créé, le token ne sert pas dans la conversation tant qu'il n'est pas enregistré dans le programme d'IA. Claude Code prend directement en charge les MCP HTTP distants, et l'enregistrement se fait en une ligne de commande. Cette fois, je l'ai exécutée dans le terminal d'un serveur Linux distinct (pas un serveur Cloudways) où j'utilise Claude Code.
claude mcp add --transport http --header "X-Access-Token: TOKEN" --header "X-Mcp-Host: claude-code" -s user cloudways https://mcp.cloudways.com/mcp/Dans la commande, [cloudways] est le nom d'enregistrement ; mettez dans [X-Access-Token] l'Access Token créé et dans [X-Mcp-Host] le nom du programme d'IA utilisé (claude-code). Ne saisissez que la valeur commençant par [cw_] : si vous recopiez aussi les chevrons (< >) de l'exemple, le token n'est pas reconnu.
Enregistrés avec [-s user], les outils Cloudways apparaissent quel que soit le dossier d'où vous lancez claude ; avec [-s local], seulement quand vous le lancez depuis le dossier où la commande a été exécutée. Je l'avais d'abord enregistré en local dans mon dossier de travail, mais les outils n'apparaissaient pas en lançant claude depuis un autre dossier : j'ai donc basculé sur user.
Même en user, Claude Code ne charge d'abord que les noms des outils, et leurs descriptions seulement à l'utilisation : la consommation de tokens ne diffère guère de local.
claude mcp list
cloudways: https://mcp.cloudways.com/mcp/ (HTTP) - ✔ ConnectedSi [Connected] s'affiche au bout de la ligne [cloudways] quand vous lancez [claude mcp list], la connexion est établie. Mais l'enregistrement ne rend pas les outils utilisables tout de suite dans la conversation en cours : les outils MCP se chargent au démarrage de la session, et les outils Cloudways n'apparaissent qu'à partir d'une nouvelle session.
Les informations d'enregistrement sont stockées dans [.claude.json], le fichier de configuration de Claude Code dans le dossier personnel, soit [/root/.claude.json] pour le compte root sous Linux. user est écrit dans [mcpServers] en haut de ce fichier, local sous [projects], au chemin du dossier concerné. Sous Windows, Claude Desktop reçoit la même adresse et le même token dans [%APPDATA%\Claude\claude_desktop_config.json].
Les autres programmes d'IA comme Cursor ou VS Code reçoivent aussi la même adresse et le même token dans leur fichier de configuration ; pour le format propre à chaque programme, reportez-vous au centre d'aide de Cloudways et suivez ses instructions.
4️⃣ Tâches exécutables par prompt
Avec la connexion par token Read-Only, j'ai demandé tour à tour la liste des serveurs, le détail d'un serveur, l'état des services, l'utilisation du CPU, la liste des applications et l'état du certificat SSL : toutes les demandes de consultation ont obtenu un résultat. Les temps de réponse ci-dessous sont ceux que le serveur MCP de Cloudways a mis à renvoyer le résultat, sans le temps que met l'IA à rédiger sa réponse.
| Requête | Outil exécuté | Temps de réponse | Contenu de la réponse |
|---|---|---|---|
| Affiche la liste de mes serveurs | server_list | 0.72 s | 1 serveur, en marche (running), région Vultr Séoul, 1 Go, MariaDB 10.11 |
| Affiche le détail du serveur | server_get | 0.68 s | Debian 12, disque de 25 Go, 1 application installée (WordPress) |
| Vérifie l'état des services | service_status | 5.10 s | 8 en marche (Nginx, Apache, MySQL, PHP 8.2-FPM, Redis, Varnish, Memcached, Imunify360), 1 arrêté (New Relic) |
| Utilisation du CPU sur les dernières 24 heures | monitoring_server_graph | 1.75 s | 288 valeurs à 5 minutes d'intervalle, utilisation moyenne d'environ 13 %, pic d'environ 30 % |
| Affiche la liste des applications | app_list | 0.67 s | 1 WordPress, domaine connecté cw.testpilotweb.com |
| Vérifie l'état du certificat SSL | app_get | 3.04 s | Let's Encrypt installé et vérifié, renouvellement automatique activé |
| Vide le cache | app_purge_cache | 0.42 s | Exécution refusée — 403 insufficient_scope |
L'utilisation du CPU est renvoyée sous forme de part de CPU inactif (Idle CPU) : une moyenne de 86,8 % correspond à environ 13 % d'utilisation. Il n'existe pas d'outil dédié à l'état du SSL : je l'ai vérifié avec l'élément Let’s Encrypt du détail de l'application ([app_get]).
On croirait que l'IA exécute tout ce qu'on lui demande, mais c'est la permission du token qui fixe ce qui peut s'exécuter. À la demande de vider le cache, l'outil [app_purge_cache] s'est bien exécuté, mais Cloudways l'a refusé avec l'erreur [Cloudways API error (403): This token does not have access to this endpoint — insufficient_scope].
Pour savoir quels outils sont des opérations d'écriture, consultez la liste renvoyée par l'outil [get_write_tools].
5️⃣ Erreurs de connexion et mise à jour de la liste des outils
Si la connexion échoue, vérifiez d'abord dans [claude mcp list] que la ligne [cloudways] indique [Connected]. Si l'adresse ne correspond pas exactement à [https://mcp.cloudways.com/mcp/], barre oblique finale comprise, la connexion échoue sans message d'erreur ; si [401 Unauthorized] apparaît, le token a été mal saisi, ou bien il est révoqué ou expiré.
Pour changer de token, supprimez l'enregistrement avec [claude mcp remove cloudways -s user], puis enregistrez-le à nouveau avec le nouveau token ; si la commande [claude] ne s'exécute pas dans le terminal, lancez l'exécutable de Claude Code avec son chemin complet.
On pense facilement que fermer puis rouvrir la fenêtre rafraîchit aussi la liste des outils, mais des programmes comme Claude Desktop ou Cursor gardent la liste d'outils de la première connexion et continuent de tourner dans la zone de notification même fenêtre fermée. Si de nouveaux outils ajoutés par Cloudways n'apparaissent pas, désactivez puis réactivez la connexion cloudways dans les réglages, ou quittez complètement le programme (Cmd+Q sous macOS, Quitter depuis l'icône de la zone de notification sous Windows) avant de le relancer.
🔢 FAQ & contenus recommandés
ℹ️ Mention d'affiliation
Le contenu de ce site contient des liens d'affiliation. Lorsqu'un visiteur achète un produit ou un service via l'un de ces liens, le site perçoit une commission du vendeur. Le montant payé par l'acheteur(il baisse lors des promotions ↓), lui, n'augmente pas. Les prix, remises et stocks indiqués correspondent à la date de rédaction et peuvent différer ; vérifiez-les donc auprès du vendeur avant d'acheter. Les produits sont choisis et évalués selon nos propres critères, et les commissions n'influencent ni l'ordre de présentation ni le contenu des évaluations.