Cloudways MCP: permisos del Access Token, conexión con Claude y Cursor, y gestión de servidores con IA
Conecté Cloudways MCP a Claude Code y terminé la configuración para consultar los servidores de Cloudways conversando, con un Access Token de solo lectura. Por el nombre se puede pensar que hay que instalar algo en el servidor de Cloudways, pero lo que se registra en realidad es el archivo de configuración del programa de IA.
Con el mismo token consulté la lista de servidores, el estado de los servicios y el uso de CPU, y también comprobé que vaciar la caché se rechaza con un error de permisos.
1️⃣ Cómo funciona Cloudways MCP
Cloudways MCP es un servidor de conexión que permite a programas de IA como Claude, Cursor y ChatGPT llamar a la API de Cloudways en tu nombre, y se ofrece a todos los clientes de Cloudways sin coste adicional.
La configuración se reparte en tres lugares. El programa de IA (cliente MCP) recibe la petición y elige la herramienta, y el servidor MCP remoto que opera Cloudways (mcp.cloudways.com) convierte esa petición en una llamada a la API de Cloudways y la ejecuta. En el servidor de Cloudways que se administra no se instala nada.
El registro se hace en el ordenador donde está instalado Claude Code, y también funciona en un PC con Windows. Esta vez se hizo no en el servidor de Cloudways, sino en otro servidor Linux donde está instalado y se usa Claude Code.
Hay más de 250 herramientas, pero el programa de IA ve primero 66. El resto se busca y ejecuta cuando se pide, así que no hay nada más que configurar.
2️⃣ Emisión del Access Token y su alcance
Aunque registres la dirección MCP, Cloudways no acepta peticiones sin un Access Token. Los tokens se crean desde el menú de perfil, arriba a la derecha en Cloudways, en [API Integration].
Pulsa [Create Access Token] y se abre una ventana para indicar el nombre, el plazo de caducidad y el alcance; continúa desde ahí.
Hay tres alcances (Scope) y el predeterminado es [Limited Access(Beta)]. [Read-Only Access] solo consulta el estado del servidor, la configuración de las aplicaciones y el uso, sin poder crear, cambiar ni eliminar nada, mientras que [Full Access] usa todas las API dentro de los permisos de la cuenta. [Limited Access] permite solo las funciones que elijas.
Para la primera conexión, empieza con [Read-Only Access]. [Read-Only Access] no tiene riesgo de borrar algo por error, pero para que la IA ejecute algo como vaciar la caché o una copia de seguridad, hay que abrir solo esa función con [Limited Access].
El plazo de caducidad va de 1 día a sin caducidad, y en la prueba se usó 1 mes.
El valor del token solo se muestra una vez al crearlo; si cierras la ventana ya no se puede ver y hay que revocarlo (Revoke) y crear otro, así que copia el valor del token mientras sigues en la página.
El método antiguo de API Key termina a mediados de octubre de 2026, así que cualquier MCP conectado con API Key también debe pasarse a Access Token.
3️⃣ Conexión con Claude, Cursor y VS Code
Aunque crees el token, no se puede usar en una conversación hasta registrarlo en el programa de IA. Claude Code admite MCP remoto por HTTP directamente y lo registra con un solo comando. Esta vez se ejecutó en la terminal de otro servidor Linux donde está instalado y se usa Claude Code (no en el servidor de 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/En el comando, [cloudways] es el nombre de registro; en [X-Access-Token] va el Access Token emitido y en [X-Mcp-Host] el nombre del programa de IA que usas (claude-code). Introduce solo el valor que empieza por [cw_]; si incluyes también los corchetes angulares (< >) de las instrucciones, no se reconoce como token.
Registrado con [-s user], las herramientas de Cloudways aparecen ejecutes claude desde la carpeta que sea, mientras que con [-s local] solo aparecen al ejecutarlo desde la carpeta donde se lanzó el comando. Al principio lo registré como local en la carpeta de trabajo, pero al ejecutarlo desde otra carpeta las herramientas no aparecían, así que lo cambié a user.
Aunque se registre como user, Claude Code carga primero solo los nombres de las herramientas y las descripciones cuando se usan, así que el consumo de tokens no difiere mucho del de local.
claude mcp list
cloudways: https://mcp.cloudways.com/mcp/ (HTTP) - ✔ ConnectedEjecuta [claude mcp list]: si al final de la línea [cloudways] aparece [Connected], la conexión funciona. Justo después de registrarlo no se puede usar en la conversación actual. Las herramientas MCP se cargan al iniciar la sesión, así que las de Cloudways aparecen a partir de las sesiones nuevas.
El registro se guarda en [.claude.json], en la carpeta personal, que es el archivo de configuración de Claude Code; para la cuenta root de Linux es [/root/.claude.json]. user se anota en [mcpServers], al principio de este archivo, y local bajo la ruta de la carpeta dentro de [projects]. Claude Desktop en Windows lleva la misma dirección y el mismo token en [%APPDATA%\Claude\claude_desktop_config.json].
Otros programas de IA como Cursor y VS Code también llevan la misma dirección y el mismo token en su archivo de configuración; para el formato de cada programa, sigue las indicaciones del Centro de ayuda de Cloudways .
4️⃣ Tareas que se pueden ejecutar con prompts
Conectado con el token Read-Only, pedí por orden la lista de servidores, los detalles del servidor, el estado de los servicios, el uso de CPU, la lista de aplicaciones y el estado del certificado SSL, y todas las consultas devolvieron resultado. Los tiempos de respuesta de abajo son lo que tardó el servidor MCP de Cloudways en devolver el resultado y no incluyen el tiempo que la IA dedica a redactar la respuesta.
| Petición | Herramienta ejecutada | Tiempo de respuesta | Respuesta |
|---|---|---|---|
| Muéstrame mi lista de servidores | server_list | 0,72 s | 1 servidor, en ejecución (running), región Vultr Seúl, 1 GB, MariaDB 10.11 |
| Dime los detalles del servidor | server_get | 0,68 s | Debian 12, disco de 25 GB, 1 aplicación instalada (WordPress) |
| Comprueba el estado de los servicios | service_status | 5,10 s | 8 en ejecución (Nginx, Apache, MySQL, PHP 8.2-FPM, Redis, Varnish, Memcached, Imunify360), 1 detenido (New Relic) |
| Uso de CPU de las últimas 24 horas | monitoring_server_graph | 1,75 s | 288 valores a intervalos de 5 minutos, uso medio de alrededor del 13 %, máximo de alrededor del 30 % |
| Muéstrame la lista de aplicaciones | app_list | 0,67 s | 1 WordPress, dominio conectado cw.testpilotweb.com |
| Comprueba el estado del certificado SSL | app_get | 3,04 s | Let's Encrypt instalado y verificado, renovación automática activada |
| Vacía la caché | app_purge_cache | 0,42 s | Rechazada — 403 insufficient_scope |
El uso de CPU se devuelve como porcentaje de CPU inactiva (Idle CPU), así que una media del 86,8 % equivale a un uso de alrededor del 13 %. No hay una herramienta dedicada a consultar el estado SSL, así que se comprobó con el apartado Let’s Encrypt de los detalles de la aplicación ([app_get]).
Puede parecer que la IA ejecutará cualquier cosa que le pidas, pero lo que se ejecuta lo deciden los permisos del token. Al pedir vaciar la caché se ejecutó la herramienta [app_purge_cache], pero Cloudways la rechazó con el error [Cloudways API error (403): This token does not have access to this endpoint — insufficient_scope].
Puedes ver qué herramientas son operaciones de escritura en la lista que devuelve la herramienta [get_write_tools].
5️⃣ Errores de conexión y actualización de la lista de herramientas
Si no conecta, comprueba primero en [claude mcp list] si la línea [cloudways] muestra [Connected]. Si la dirección no coincide con [https://mcp.cloudways.com/mcp/] hasta la barra final, no conecta y no muestra ningún mensaje de error, y si aparece [401 Unauthorized], el token se escribió mal o está revocado o caducado.
Para cambiar el token, elimina el registro con [claude mcp remove cloudways -s user] y vuelve a registrarlo con el token nuevo; si el comando [claude] no se ejecuta en la terminal, ejecuta el archivo de Claude Code con su ruta completa.
Es fácil pensar que cerrar y volver a abrir la ventana actualiza la lista de herramientas, pero programas como Claude Desktop y Cursor guardan la lista de la primera conexión y siguen funcionando en la bandeja aunque cierres la ventana. Si después de que Cloudways añada herramientas no aparecen las nuevas, desactiva y vuelve a activar la conexión cloudways en la configuración, o cierra el programa por completo (Cmd+Q en macOS, Salir desde el icono de la bandeja en Windows) y vuelve a abrirlo.
🔢 FAQ & contenido recomendado
ℹ️ Aviso de afiliados
El contenido de este sitio incluye enlaces de afiliado. Cuando un visitante compra un producto o servicio a través de uno de ellos, el sitio recibe una comisión del vendedor. El importe que paga el comprador(baja durante las promociones ↓)no aumenta. Los precios, descuentos y existencias publicados corresponden al momento de redacción y pueden variar, así que confírmalos con el vendedor antes de comprar. Los productos se eligen y evalúan con criterios propios, y las comisiones no influyen en el orden ni en el contenido de las reseñas.