Cloudways MCP: права Access Token, подключение Claude и Cursor, управление сервером с помощью ИИ
Cloudways MCP подключён к Claude Code и настроен так, чтобы запрашивать данные серверов Cloudways прямо в диалоге с токеном Access Token только для чтения. Из-за названия легко решить, что на сервер Cloudways что-то устанавливается, но на самом деле регистрация делается в файле настроек ИИ-программы.
С тем же токеном были запрошены список серверов, состояние служб и загрузка CPU, а также проверено, что очистка кеша отклоняется с ошибкой прав доступа.
1️⃣ Как работает Cloudways MCP
Cloudways MCP — это сервер-посредник, через который ИИ-программы вроде Claude, Cursor и ChatGPT вызывают API Cloudways от вашего имени; он доступен всем клиентам Cloudways без доплаты.
Схема состоит из трёх частей. ИИ-программа (MCP-клиент) получает запрос и выбирает нужный инструмент, а удалённый MCP-сервер Cloudways (mcp.cloudways.com) превращает этот запрос в вызов API Cloudways и выполняет его. На управляемый сервер Cloudways ничего не устанавливается.
Регистрация выполняется на компьютере, где установлен Claude Code, — подойдёт и ПК с Windows. В этот раз она делалась не на сервере Cloudways, а на отдельном Linux-сервере, где установлен и используется Claude Code.
Инструментов больше 250, но сначала ИИ-программа видит только 66. Остальные находятся и запускаются по запросу, так что отдельно настраивать ничего не нужно.
2️⃣ Выпуск Access Token и область доступа
Даже если адрес MCP зарегистрирован, без Access Token Cloudways не принимает запросы. Токен создаётся в меню профиля в правом верхнем углу Cloudways — в разделе [API Integration].
Нажмите [Create Access Token] — откроется окно, где задаются имя, срок действия и область доступа; дальше продолжайте в нём.
Областей доступа (Scope) три, по умолчанию выбрана [Limited Access(Beta)]. [Read-Only Access] только запрашивает состояние сервера, настройки приложений и потребление ресурсов и не может ничего создавать, менять или удалять, а [Full Access] даёт все API в пределах прав аккаунта. [Limited Access] разрешает только выбранные функции.
Для первого подключения начните с [Read-Only Access]. С [Read-Only Access] нет риска что-то случайно удалить, но чтобы ИИ мог что-то выполнять — например очищать кеш или делать резервную копию, — нужно открыть только эту функцию через [Limited Access].
Срок действия можно выбрать от 1 дня до бессрочного; для теста использовался 1 месяц.
Значение токена показывается один раз при создании: после закрытия окна его уже не увидеть, придётся отозвать токен (Revoke) и создать новый, поэтому скопируйте значение, пока вы на этой странице.
Старый способ с API Key отключается в середине октября 2026 года, поэтому MCP, подключённый через API Key, тоже нужно перевести на Access Token.
3️⃣ Подключение Claude, Cursor и VS Code
Даже созданный токен нельзя использовать в диалоге, пока он не зарегистрирован в ИИ-программе. Claude Code сразу поддерживает удалённый HTTP MCP и регистрирует его одной командой. В этот раз команда выполнялась в терминале отдельного Linux-сервера, где установлен и используется Claude Code (не сервера 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/В команде [cloudways] — имя регистрации; в [X-Access-Token] вставьте выпущенный Access Token, а в [X-Mcp-Host] — имя используемой ИИ-программы (claude-code). Вставляйте только значение, начинающееся с [cw_]: если вместе с ним вставить угловые скобки из инструкции (< >), оно не распознаётся как токен.
При регистрации с [-s user] инструменты Cloudways видны, из какой бы папки ни запускался claude, а с [-s local] — только при запуске из папки, где выполнялась команда. Сначала регистрация была сделана как local в рабочей папке, но при запуске из другой папки инструменты не появились, поэтому её заменили на user.
Даже при регистрации как user Claude Code сначала загружает только имена инструментов, а описания — при использовании, поэтому по расходу токенов разница с local невелика.
claude mcp list
cloudways: https://mcp.cloudways.com/mcp/ (HTTP) - ✔ ConnectedЗапустите [claude mcp list]: если в конце строки [cloudways] стоит [Connected], подключение работает. Сразу после регистрации в текущем диалоге его ещё не использовать: инструменты MCP загружаются при запуске сессии, поэтому инструменты Cloudways появятся в новой сессии.
Данные регистрации сохраняются в файле настроек Claude Code — [.claude.json] в домашней папке; для учётной записи root в Linux это [/root/.claude.json]. Регистрация user записывается в [mcpServers] в начале этого файла, а local — под путём папки в [projects]. В Claude Desktop для Windows тот же адрес и токен прописываются в [%APPDATA%\Claude\claude_desktop_config.json].
Другие ИИ-программы, например Cursor и VS Code, тоже получают тот же адрес и токен в своём файле настроек; формат для каждой программы описан в справочном центре Cloudways — следуйте его инструкциям.
4️⃣ Какие задачи можно выполнять промптами
С токеном Read-Only по очереди были запрошены список серверов, сведения о сервере, состояние служб, загрузка CPU, список приложений и состояние SSL-сертификата — на все запросы пришёл результат. Время ответа ниже — это время, за которое MCP-сервер Cloudways вернул результат, без времени, которое ИИ тратит на составление ответа.
| Запрос | Выполненный инструмент | Время ответа | Ответ |
|---|---|---|---|
| Покажи список моих серверов | server_list | 0,72 с | 1 сервер, работает (running), регион Vultr Сеул, 1 ГБ, MariaDB 10.11 |
| Покажи сведения о сервере | server_get | 0,68 с | Debian 12, диск 25 ГБ, установленных приложений: 1 (WordPress) |
| Проверь состояние служб | service_status | 5,10 с | Работают: 8 (Nginx·Apache·MySQL·PHP 8.2-FPM·Redis·Varnish·Memcached·Imunify360), остановлена: 1 (New Relic) |
| Загрузка CPU за последние 24 часа | monitoring_server_graph | 1,75 с | 288 значений с интервалом 5 минут, средняя загрузка около 13%, пик около 30% |
| Покажи список приложений | app_list | 0,67 с | WordPress: 1, подключённый домен cw.testpilotweb.com |
| Проверь состояние SSL-сертификата | app_get | 3,04 с | Let's Encrypt установлен и проверен, автопродление включено |
| Очисти кеш | app_purge_cache | 0,42 с | Отказ в выполнении — 403 insufficient_scope |
Загрузка CPU возвращается как доля простаивающего CPU (Idle CPU), так что среднее 86,8% соответствует загрузке около 13%. Отдельного инструмента для проверки SSL нет, поэтому состояние смотрелось по пункту Let’s Encrypt в сведениях о приложении ([app_get]).
Кажется, что ИИ выполнит всё, о чём его попросят, но что именно можно выполнить, решают права токена. На просьбу очистить кеш инструмент [app_purge_cache] запустился, но Cloudways отклонил его с ошибкой [Cloudways API error (403): This token does not have access to this endpoint — insufficient_scope].
Какие инструменты относятся к операциям записи, видно в списке, который возвращает инструмент [get_write_tools].
5️⃣ Ошибки подключения и обновление списка инструментов
Если подключения нет, сначала проверьте в [claude mcp list], стоит ли в строке [cloudways] [Connected]. Если адрес не совпадает с [https://mcp.cloudways.com/mcp/] вплоть до косой черты в конце, подключение не устанавливается без всякого сообщения об ошибке, а [401 Unauthorized] означает, что токен введён неверно, отозван или истёк.
Чтобы сменить токен, удалите регистрацию командой [claude mcp remove cloudways -s user] и зарегистрируйте заново с новым токеном; если команда [claude] не запускается в терминале, запустите исполняемый файл Claude Code по полному пути.
Легко решить, что закрыть и снова открыть окно — значит обновить список инструментов, но программы вроде Claude Desktop и Cursor сохраняют список инструментов с первого подключения и продолжают работать в трее после закрытия окна. Если после того как Cloudways добавил инструменты, новые не видны, отключите и снова включите подключение cloudways в настройках или полностью закройте программу (Cmd+Q в macOS, «Выход» из значка в трее в Windows) и запустите её снова.
🔢 FAQ & рекомендуемые материалы
ℹ️ О партнёрских ссылках
Материалы этого сайта содержат партнёрские ссылки. Если посетитель покупает товар или услугу по такой ссылке, сайт получает комиссию от продавца. При этом сумма, которую платит покупатель (при акционных скидках сумма снижается ↓), не увеличивается. Указанные цены, скидки и наличие актуальны на момент написания и могут отличаться, поэтому перед покупкой уточняйте их у продавца. Товары выбираются и оцениваются по нашим собственным критериям, а комиссия не влияет ни на порядок, ни на содержание обзоров.