MCP di Cloudways: permessi dell'Access Token, collegamento a Claude·Cursor e gestione del server con l'IA
Ho collegato l'MCP di Cloudways a Claude Code e completato la configurazione per consultare i server Cloudways in conversazione con un Access Token di sola lettura. Dal nome si potrebbe pensare che venga installato qualcosa sul server Cloudways, ma in realtà la registrazione avviene nel file di configurazione del programma di IA.
Con lo stesso token ho consultato l'elenco dei server, lo stato dei servizi e l'uso della CPU, e ho verificato che lo svuotamento della cache viene rifiutato con un errore di permessi.
1️⃣ Come funziona l'MCP di Cloudways
L'MCP di Cloudways è un server di collegamento che permette a programmi di IA come Claude, Cursor e ChatGPT di chiamare l'API di Cloudways al posto tuo, ed è offerto a tutti i clienti Cloudways senza costi aggiuntivi.
La struttura è divisa in tre parti. Il programma di IA (client MCP) riceve la richiesta e sceglie lo strumento da usare, e il server MCP remoto gestito da Cloudways (mcp.cloudways.com) trasforma quella richiesta in una chiamata all'API di Cloudways e la esegue. Sul server Cloudways da gestire non si installa nulla.
La registrazione si fa sul computer su cui è installato Claude Code, ed è possibile anche su un PC Windows. Questa volta non l'ho fatta sul server Cloudways, ma su un server Linux separato su cui ho installato e uso Claude Code.
Gli strumenti sono più di 250, ma il programma di IA all'inizio ne vede 66. Gli altri vengono cercati ed eseguiti quando li chiedi, quindi non c'è nulla da configurare a parte.
2️⃣ Creazione dell'Access Token e ambito dei permessi
Anche con l'indirizzo MCP registrato, Cloudways non accetta richieste senza un Access Token. Il token si crea dal menu del profilo in alto a destra di Cloudways, in [API Integration].
Premendo [Create Access Token] si apre una finestra in cui imposti nome, scadenza e ambito dei permessi, e da lì si prosegue.
Gli ambiti dei permessi (Scope) sono tre e quello predefinito è [Limited Access(Beta)]. [Read-Only Access] si limita a consultare stato del server, impostazioni delle applicazioni e consumi, senza poter creare, modificare o eliminare nulla, mentre [Full Access] usa tutte le API nei limiti dei permessi dell'account. [Limited Access] consente solo le funzioni scelte.
Alla prima connessione parti con [Read-Only Access]. Con [Read-Only Access] non rischi di cancellare qualcosa per errore, ma per far eseguire qualcosa all'IA, come svuotare la cache o fare un backup, devi aprire solo quella funzione con [Limited Access].
La scadenza si può scegliere da 1 giorno a nessuna scadenza; per il test ho usato 1 mese.
Il valore del token compare una sola volta, alla creazione: chiusa la finestra non lo rivedi più e devi revocarlo (Revoke) e crearne uno nuovo, quindi copia il valore del token finché sei ancora nella pagina.
Il vecchio metodo con API Key termina a metà ottobre 2026, quindi anche un MCP collegato con una API Key va passato a un Access Token.
3️⃣ Configurare il collegamento con Claude, Cursor e VS Code
Anche dopo aver creato il token, non puoi usarlo in conversazione finché non lo registri nel programma di IA. Claude Code supporta direttamente l'MCP HTTP remoto e lo registra con un solo comando. Questa volta l'ho eseguito nel terminale di un server Linux separato su cui ho installato e uso Claude Code (non il server Cloudways).
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/Nel comando [cloudways] è il nome della registrazione; in [X-Access-Token] va l'Access Token creato e in [X-Mcp-Host] il nome del programma di IA che usi (claude-code). Inserisci solo il valore che inizia con [cw_]: se includi anche le parentesi angolari (< >) delle istruzioni, non viene riconosciuto come token.
Registrando con [-s user] gli strumenti di Cloudways compaiono in qualunque cartella avvii claude, mentre con [-s local] compaiono solo se lo avvii nella cartella in cui hai eseguito il comando. All'inizio l'avevo registrato come local nella cartella di lavoro, ma avviandolo da un'altra cartella gli strumenti non comparivano, quindi l'ho cambiato in user.
Anche registrato come user, Claude Code carica prima solo i nomi degli strumenti e le descrizioni al momento dell'uso, quindi rispetto a local il consumo di token non cambia molto.
claude mcp list
cloudways: https://mcp.cloudways.com/mcp/ (HTTP) - ✔ ConnectedEsegui [claude mcp list]: se in fondo alla riga [cloudways] compare [Connected], il collegamento è riuscito. Subito dopo la registrazione non puoi ancora usarlo nella conversazione in corso: gli strumenti MCP si caricano all'avvio della sessione, quindi gli strumenti di Cloudways compaiono dalla sessione successiva.
I dati di registrazione vengono salvati in [.claude.json] nella cartella home, il file di configurazione di Claude Code; per l'account root di Linux è [/root/.claude.json]. user viene scritto in [mcpServers] in cima a questo file, local sotto [projects] nel percorso della cartella corrispondente. Su Windows, Claude Desktop riceve lo stesso indirizzo e lo stesso token in [%APPDATA%\Claude\claude_desktop_config.json].
Anche altri programmi di IA come Cursor e VS Code ricevono lo stesso indirizzo e lo stesso token nel file di configurazione; per il formato di ciascun programma consulta il Centro assistenza di Cloudways e segui le istruzioni.
4️⃣ Operazioni eseguibili con i prompt
Con il token Read-Only collegato ho chiesto in sequenza l'elenco dei server, i dettagli del server, lo stato dei servizi, l'uso della CPU, l'elenco delle applicazioni e lo stato del certificato SSL, e tutte le richieste di consultazione hanno restituito un risultato. I tempi di risposta qui sotto sono il tempo impiegato dal server MCP di Cloudways per restituire il risultato e non includono il tempo che l'IA usa per comporre la risposta.
| Richiesta | Strumento eseguito | Tempo di risposta | Contenuto della risposta |
|---|---|---|---|
| Mostrami l'elenco dei miei server | server_list | 0,72 s | 1 server, in esecuzione (running), regione Vultr Seul, 1 GB, MariaDB 10.11 |
| Dimmi i dettagli del server | server_get | 0,68 s | Debian 12, disco da 25 GB, 1 applicazione installata (WordPress) |
| Controlla lo stato dei servizi | service_status | 5,10 s | 8 in esecuzione (Nginx·Apache·MySQL·PHP 8.2-FPM·Redis·Varnish·Memcached·Imunify360), 1 fermo (New Relic) |
| Uso della CPU nelle ultime 24 ore | monitoring_server_graph | 1,75 s | 288 valori a intervalli di 5 minuti, uso medio circa 13%, picco circa 30% |
| Mostrami l'elenco delle applicazioni | app_list | 0,67 s | 1 WordPress, dominio collegato cw.testpilotweb.com |
| Controlla lo stato del certificato SSL | app_get | 3,04 s | Let's Encrypt installato e verificato, rinnovo automatico attivo |
| Svuota la cache | app_purge_cache | 0,42 s | Esecuzione rifiutata — 403 insufficient_scope |
L'uso della CPU viene restituito come percentuale di CPU inattiva (Idle CPU), quindi una media dell'86,8% corrisponde a circa il 13% di utilizzo. Non esiste uno strumento dedicato per consultare lo stato dell'SSL, quindi l'ho verificato tramite la voce Let’s Encrypt nei dettagli dell'applicazione ([app_get]).
Sembra che qualunque cosa chiedi all'IA venga eseguita, ma sono i permessi del token a decidere cosa si può fare. Chiedendo di svuotare la cache, lo strumento [app_purge_cache] è stato eseguito, ma Cloudways ha rifiutato con l'errore [Cloudways API error (403): This token does not have access to this endpoint — insufficient_scope].
Quali strumenti eseguono operazioni di scrittura lo vedi nell'elenco restituito dallo strumento [get_write_tools].
5️⃣ Errori di collegamento e aggiornamento dell'elenco degli strumenti
Se non si collega, controlla prima in [claude mcp list] che la riga [cloudways] sia [Connected]. Se l'indirizzo non coincide con [https://mcp.cloudways.com/mcp/] fino alla barra finale, il collegamento non avviene e non compare alcun messaggio di errore; se compare [401 Unauthorized], il token è stato inserito male oppure è revocato o scaduto.
Per cambiare token elimina la registrazione con [claude mcp remove cloudways -s user] e registralo di nuovo con il nuovo token; se nel terminale il comando [claude] non parte, esegui l'eseguibile di Claude Code indicando il percorso completo.
Viene facile pensare che chiudendo e riaprendo la finestra si aggiorni anche l'elenco degli strumenti, ma programmi come Claude Desktop e Cursor salvano l'elenco della prima connessione e restano in esecuzione nell'area di notifica anche a finestra chiusa. Se dopo un'aggiunta di strumenti da parte di Cloudways quelli nuovi non compaiono, disattiva e riattiva il collegamento cloudways nelle impostazioni, oppure chiudi del tutto il programma (Cmd+Q su macOS, Esci dall'icona nell'area di notifica su Windows) e riavvialo.
🔢 FAQ & contenuti consigliati
ℹ️ Informativa sull'affiliazione
I contenuti di questo sito includono link di affiliazione. Se un visitatore acquista un prodotto o un servizio tramite uno di questi link, il sito riceve una commissione dal venditore. In questo processo l'importo pagato dall'acquirente (durante le promozioni l'importo scende↓) non aumenta. Prezzi, sconti e disponibilità indicati si riferiscono al momento della stesura e possono differire da quelli reali: prima di acquistare verifica sempre presso il venditore. I prodotti vengono scelti e valutati secondo criteri propri, e le commissioni non influiscono sull'ordine di presentazione né sul contenuto delle valutazioni.