Timeweb Cloud MCP: облако Timeweb в Claude Code, Cursor и VS Code

timeweb-cloud/mcp· Проверено 12.11.2026· 26на GitHub

Даёт агенту ваш аккаунт Timeweb Cloud: серверы, базы данных, Kubernetes, приложения, домены, почту, S3 и сети. Агент читает, создаёт и меняет ресурсы, каждое изменение подтверждаете вы.

Удалённый сервер Timeweb Cloud по HTTP с API-токеном; все операции агент находит поиском через три инструмента.

Как подключить

Что сделать до подключения

1

Аккаунт Timeweb Cloud и API-токен

2
Authorization

Панель управления → «API и Terraform» (timeweb.cloud/my/api-keys) → выпустить API-токен; чтобы ограничить агента, выпустите ключ с урезанными правами

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http timeweb-cloud https://api.timeweb.cloud/api/v1/mcp/search \
  --header 'Authorization: Bearer <API-токен Timeweb Cloud>'

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Инструменты сервера

search_toolsищет операцию по словам задачи
get_tool_definitionотдаёт схему аргументов операции
execute_toolвыполняет операцию

Что попросить агента

«Создай почтовый ящик <адрес> на домене <домен>»Агент вызовет search_tools("create mailbox"), узнает поля через get_tool_definition("create_mailbox") и после вашего подтверждения выполнит execute_tool
«Покажи, какие серверы и базы данных есть у меня в Timeweb Cloud»Агент найдёт операции чтения через search_tools и вызовет их через execute_tool
«Поменяй команду сборки приложения <имя> на <команда>»Агент найдёт update_app_build_settings через search_tools, покажет operation_summary и после согласия выполнит execute_tool с confirm_token
«Переименуй сеть <id сети> в my-vpc»Агент вызовет execute_tool, получит confirm_token и сводку изменения, а после вашего «да» повторит вызов с токеном

Для каких задач

Создать почтовый ящик, базу данных или сервер одной просьбой в чате
Посмотреть, какие серверы, базы и домены есть в аккаунте
Поменять настройки сборки приложения в App Platform: язык, фреймворк, команды сборки и запуска
Настроить сеть VPC, IP-адреса и хранилище S3
Выдать агенту ключ только на часть ресурсов через роли и проекты

Ограничения

!

Удалять ресурсы сервер не умеет: инструментов delete_* и remove_* нет, удаление только через панель управления

!

22 операции помечены [BILLABLE] и списывают деньги со счёта; подтверждение обязательно, токен подтверждения живёт 300 секунд

!

Каждый вызов update_app_build_settings запускает новый деплой приложения, даже при мелкой правке

!

Агент видит только операции, на которые есть права у ключа; остальные отвечают tool_not_allowed

Если не работает

Агент получает статус confirmation_expired
Прошло больше 300 секунд и токен удалён: вызовите инструмент заново без токена и подтвердите ещё раз.
Агент получает статус confirmation_args_mismatch
Аргументы второго вызова отличаются от первого: повторите с исходными аргументами, токен ещё действует.
Агент получает статус confirmation_tool_mismatch
Токен выдан для другого инструмента: используйте токен, полученный именно от этой операции.
Нужная операция не находится или вызов отвечает tool_not_allowed
У API-ключа нет прав на эту операцию: расширьте права ключа в панели управления, изменения применятся в течение пары минут.

Частые вопросы

Почему клиент видит только три инструмента?
Все операции Timeweb Cloud спрятаны за поиском: агент находит нужную через search_tools, узнаёт аргументы через get_tool_definition и выполняет через execute_tool. Набор операций зависит от прав API-ключа.
Может ли агент потратить деньги без спроса?
Нет: любая операция с пометкой [WRITE] или [BILLABLE] идёт в два шага. Первый вызов возвращает operation_summary и confirm_token, и только повтор с тем же набором аргументов и токеном выполняет её.
Как ограничить, что сможет делать агент?
Выпустите для него отдельный API-ключ с урезанными правами по ролям и проектам. Изменения прав применяются в течение пары минут, перевыпускать ключ не нужно.
А что с репозиторием timeweb-cloud/mcp-server?
Это прежний сервер для деплоя приложений через npx timeweb-mcp-server. Он устарел и больше не развивается, Timeweb Cloud отправляет к репозиторию timeweb-cloud/mcp.
Как подключить Timeweb MCP к Claude Code?
Выполните claude mcp add --transport http timeweb-cloud https://api.timeweb.cloud/api/v1/mcp/search --header "Authorization: Bearer <токен>" и проверьте подключение командой claude mcp list.
Как подключить Timeweb MCP к Cursor и VS Code?
Для VS Code и Cursor есть установка в один клик: VS Code спросит токен в защищённом поле, Cursor подставит плейсхолдер API_KEY_HERE, его замените своим токеном. Вручную сервер прописывается в .cursor/mcp.json или .vscode/mcp.json, готовые фрагменты — во вкладках блока «Как подключить».
Работает ли сервер из России?
Сервер работает на стороне Timeweb Cloud, нужен только аккаунт Timeweb Cloud и API-токен из панели управления.

Похожие серверы