MCP da Cloudways: permissões do Access Token, conexão com Claude e Cursor e gestão do servidor com IA
Conectei o MCP da Cloudways ao Claude Code e concluí a configuração para consultar os servidores da Cloudways por conversa, com um Access Token somente leitura. Pelo nome, dá para achar que algo é instalado no servidor da Cloudways, mas o registro é feito, na verdade, no arquivo de configuração do lado do programa de IA.
Com o mesmo token, consultei a lista de servidores, o status dos serviços e o uso de CPU, e confirmei até que a limpeza de cache é recusada com erro de permissão.
1️⃣ Como funciona o MCP da Cloudways
O MCP da Cloudways é um servidor de conexão que faz programas de IA como Claude, Cursor e ChatGPT chamarem a API da Cloudways por você, e é oferecido a todos os clientes da Cloudways sem custo adicional.
A estrutura se divide em três partes. O programa de IA (cliente MCP) recebe a solicitação e escolhe a ferramenta a usar, e o servidor MCP remoto operado pela Cloudways (mcp.cloudways.com) transforma essa solicitação em uma chamada à API da Cloudways e a executa. Nada é instalado no servidor da Cloudways que está sendo gerenciado.
O registro é feito no computador onde o Claude Code está instalado, e também funciona em um PC com Windows. Desta vez, foi feito não no servidor da Cloudways, mas em um servidor Linux separado onde instalei e uso o Claude Code.
São mais de 250 ferramentas, mas o programa de IA vê primeiro 66. As demais são encontradas e executadas quando você pede, então não há nada a configurar à parte.
2️⃣ Emissão do Access Token e escopo de permissões
Mesmo com o endereço do MCP registrado, a Cloudways não aceita solicitações sem um Access Token. O token é criado no menu de perfil, no canto superior direito da Cloudways, em [API Integration].
Ao clicar em [Create Access Token], abre-se uma janela para definir nome, prazo de validade e escopo de permissões, e você continua ali.
Há três escopos de permissão (Scope), e o padrão é [Limited Access(Beta)]. O [Read-Only Access] só consulta status do servidor, configurações da aplicação e uso, sem criar, alterar ou excluir nada, e o [Full Access] usa todas as APIs dentro das permissões da conta. O [Limited Access] permite só as funções escolhidas.
Na primeira conexão, comece com o [Read-Only Access]. Com o [Read-Only Access] não há risco de apagar algo por engano, mas para fazer a IA executar algo, como limpar o cache ou um backup, é preciso liberar só essa função com o [Limited Access].
O prazo de validade vai de 1 dia até sem expiração, e no teste foi usado 1 mês.
O valor do token aparece uma única vez, na criação; ao fechar a janela, não dá para vê-lo de novo e é preciso revogá-lo (Revoke) e criar outro, então copie o valor do token ainda na página.
O antigo método por API Key termina em meados de outubro de 2026, então um MCP conectado com API Key também precisa passar para Access Token.
3️⃣ Configurar a conexão com Claude, Cursor e VS Code
Mesmo com o token criado, não dá para usá-lo na conversa até registrá-lo no programa de IA. O Claude Code suporta MCP HTTP remoto direto e registra com um único comando. Desta vez, executei-o no terminal de um servidor Linux separado onde instalei e uso o Claude Code (não é o servidor da 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/No comando, [cloudways] é o nome de registro; em [X-Access-Token] vai o Access Token emitido e em [X-Mcp-Host] o nome do programa de IA que você usa (claude-code). Coloque só o valor que começa com [cw_]: se os colchetes angulares (< >) das instruções forem junto, ele não é reconhecido como token.
Com [-s user], as ferramentas da Cloudways aparecem em qualquer pasta onde você rodar o claude; com [-s local], só aparecem ao rodar na pasta onde o comando foi executado. No começo registrei como local na pasta de trabalho, mas ao rodar em outra pasta as ferramentas não apareceram, então mudei para user.
Mesmo registrado como user, o Claude Code carrega primeiro só os nomes das ferramentas e as descrições na hora do uso, então não há grande diferença de consumo de tokens em relação ao local.
claude mcp list
cloudways: https://mcp.cloudways.com/mcp/ (HTTP) - ✔ ConnectedRode [claude mcp list]: se aparecer [Connected] no fim da linha [cloudways], a conexão foi feita. Logo depois de registrar, ainda não dá para usar na conversa atual. As ferramentas MCP são carregadas quando a sessão começa, então as ferramentas da Cloudways aparecem a partir de uma nova sessão.
Os dados de registro ficam salvos em [.claude.json], na pasta pessoal, que é o arquivo de configuração do Claude Code; na conta root do Linux, é [/root/.claude.json]. O user fica registrado em [mcpServers], no topo desse arquivo, e o local em [projects], no caminho da pasta correspondente. No Windows, o Claude Desktop recebe o mesmo endereço e token em [%APPDATA%\Claude\claude_desktop_config.json].
Outros programas de IA, como Cursor e VS Code, também recebem o mesmo endereço e token no arquivo de configuração; para o formato de cada programa, consulte a Central de Ajuda da Cloudways e siga as orientações.
4️⃣ Tarefas que dá para executar com prompts
Conectado com o token Read-Only, pedi em sequência a lista de servidores, os detalhes do servidor, o status dos serviços, o uso de CPU, a lista de aplicações e o status do certificado SSL, e todas as consultas retornaram resultado. Os tempos de resposta abaixo são o tempo que o servidor MCP da Cloudways levou para devolver o resultado e não incluem o tempo que a IA leva para organizar a resposta.
| Solicitação | Ferramenta executada | Tempo de resposta | Conteúdo da resposta |
|---|---|---|---|
| Mostre minha lista de servidores | server_list | 0,72 s | 1 servidor, em execução (running), região Vultr Seul, 1 GB, MariaDB 10.11 |
| Me passe os detalhes do servidor | server_get | 0,68 s | Debian 12, disco de 25 GB, 1 aplicação instalada (WordPress) |
| Verifique o status dos serviços | service_status | 5,10 s | 8 em execução (Nginx·Apache·MySQL·PHP 8.2-FPM·Redis·Varnish·Memcached·Imunify360), 1 parado (New Relic) |
| Uso de CPU nas últimas 24 horas | monitoring_server_graph | 1,75 s | 288 valores a cada 5 minutos, uso médio de cerca de 13%, pico de cerca de 30% |
| Mostre a lista de aplicações | app_list | 0,67 s | 1 WordPress, domínio conectado cw.testpilotweb.com |
| Verifique o status do certificado SSL | app_get | 3,04 s | Let's Encrypt instalado e verificado, renovação automática ativa |
| Limpe o cache | app_purge_cache | 0,42 s | Execução recusada — 403 insufficient_scope |
O uso de CPU vem como proporção de CPU ociosa (Idle CPU), então a média de 86,8% equivale a cerca de 13% de uso. Não há ferramenta própria para consultar o status do SSL, então conferi pelo item Let’s Encrypt nos detalhes da aplicação ([app_get]).
Parece que tudo o que você pede à IA vai ser executado, mas quem decide o alcance são as permissões do token. Ao pedir para limpar o cache, a ferramenta [app_purge_cache] foi executada, mas a Cloudways recusou com o erro [Cloudways API error (403): This token does not have access to this endpoint — insufficient_scope].
Quais ferramentas fazem operações de escrita dá para conferir na lista que a ferramenta [get_write_tools] retorna.
5️⃣ Erros de conexão e atualização da lista de ferramentas
Se não conectar, confira primeiro em [claude mcp list] se a linha [cloudways] está como [Connected]. Se o endereço não for igual a [https://mcp.cloudways.com/mcp/] até a barra final, a conexão falha sem mensagem de erro, e se aparecer [401 Unauthorized], o token foi digitado errado ou foi revogado ou expirou.
Para trocar o token, exclua o registro com [claude mcp remove cloudways -s user] e registre de novo com o novo token; se o comando [claude] não rodar no terminal, execute o arquivo do Claude Code indicando o caminho completo.
É fácil achar que fechar e reabrir a janela atualiza a lista de ferramentas, mas programas como Claude Desktop e Cursor guardam a lista da primeira conexão e continuam rodando na bandeja do sistema mesmo com a janela fechada. Se as novas ferramentas não aparecerem depois que a Cloudways as adicionar, desative e reative a conexão cloudways nas configurações, ou feche o programa por completo (Cmd+Q no macOS, Sair no ícone da bandeja no Windows) e abra de novo.
🔢 FAQ & conteúdo recomendado
ℹ️ Aviso de afiliados
O conteúdo deste site contém links de afiliados. Quando um visitante compra um produto ou serviço por meio de um desses links, o site recebe uma comissão do vendedor. O valor que o comprador paga (em promoções, ele diminui ↓) não aumenta por causa disso. Preços, descontos e informações de estoque valem para o momento em que o texto foi escrito e podem ter mudado, por isso confirme com o vendedor antes de comprar. Os produtos são escolhidos e avaliados por critérios próprios, e o recebimento de comissão não influencia a ordem de apresentação nem o conteúdo das avaliações.