Timeweb Cloud MCP Server

Официальный MCP-сервер Timeweb Cloud. Сервер работает на нашей стороне, ваш AI-клиент подключается к нему по HTTP.

Эндпоинт	https://api.timeweb.cloud/api/v1/mcp/search
Авторизация	заголовок Authorization: Bearer <токен>
Инструменты	доступны через поиск (search_tools → get_tool_definition → execute_tool)

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

Какие инструменты видит ваш клиент

В списке инструментов их три. Все остальные операции выполняются через эти три:

Инструмент	Что делает
search_tools	Ищет нужную операцию по описанию задачи. Принимает ключевые слова на английском (действие + ресурс, например create mailbox), возвращает список подходящих tool_id с namespace и краткой сводкой. Шаг 1.
get_tool_definition	По tool_id возвращает JSON-схему аргументов операции: какие поля обязательны, какие типы, что значат. Шаг 2.
execute_tool	Выполняет операцию: принимает tool_id и объект arguments по схеме из шага 2. Единственный способ что-либо сделать — здесь же проходит подтверждение изменяющих операций. Шаг 3.

Пример: на запрос «создай почтовый ящик» модель вызывает search_tools("create mailbox") → получает tool_id: create_mailbox → get_tool_definition("create_mailbox") → узнаёт обязательные поля → execute_tool("create_mailbox", {...}).

1. Получите токен

Панель управления → раздел «API и Terraform» → выпустите API-токен.

Токен действует от имени вашего аккаунта в объёме прав, выданных ключу. Если хотите ограничить, что сможет делать модель, выпустите отдельный ключ с урезанными правами — сервер учитывает права ключа и вернёт ошибку на запрещённые категории.

2. Подключите клиент

В один клик

Для клиентов с поддержкой MCP-deeplink подключение укладывается в нажатие кнопки. Клиент откроется, попросит токен из шага 1 и сам сохранит конфиг.

VS Code спросит токен в защищённом поле и подставит его в заголовок Authorization. Кнопка для Cursor подставит плейсхолдер API_KEY_HERE — замените его на свой токен в форме, которую откроет Cursor.

Для Claude Code, Claude Desktop, Windsurf, Zed и других клиентов автоподключения пока нет — там нужен ручной конфиг ниже.

Claude Code

claude mcp add --transport http timeweb-cloud \
  https://api.timeweb.cloud/api/v1/mcp/search \
  --header "Authorization: Bearer ВАШ_ТОКЕН"

Проверить: claude mcp list.

Cursor

.cursor/mcp.json в проекте или глобальный ~/.cursor/mcp.json:

{
  "mcpServers": {
    "timeweb-cloud": {
      "url": "https://api.timeweb.cloud/api/v1/mcp/search",
      "headers": {
        "Authorization": "Bearer ВАШ_ТОКЕН"
      }
    }
  }
}

VS Code

.vscode/mcp.json — токен спрашивается при первом запуске и не попадает в репозиторий:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "timeweb-token",
      "description": "Timeweb Cloud API token",
      "password": true
    }
  ],
  "servers": {
    "timeweb-cloud": {
      "type": "http",
      "url": "https://api.timeweb.cloud/api/v1/mcp/search",
      "headers": {
        "Authorization": "Bearer ${input:timeweb-token}"
      }
    }
  }
}

3. Подтверждение изменяющих операций

Инструменты помечены в описании, которое возвращает get_tool_definition: 73 помечены [WRITE] (меняют состояние), 22 — [BILLABLE] (приводят к списанию средств).

Любая такая операция выполняется в два шага. Первый вызов ничего не меняет, а возвращает токен подтверждения:

{
  "status": "confirmation_required",
  "confirm_token": "dbe74d52-a347-44ad-aaab-7402693cc24d",
  "expires_in_seconds": 300,
  "operation_summary": "[WRITE] Обновить VPC network-abda…: name → \"my-vpc\"",
  "next_step": "…вызвать тот же инструмент повторно с теми же аргументами плюс confirm_token…"
}

Модель показывает operation_summary вам и, получив согласие, повторяет вызов с тем же набором аргументов и добавленным confirm_token. Требования второго шага:

• аргументы должны совпадать с первым вызовом — иначе токен не подойдёт;
• токен живёт 300 секунд;
• повторный вызов без confirm_token не выполняет операцию, а выдаёт новый токен.

Так что случайных списаний по одной фразе модели не будет: подтверждение запрашивается всегда.

Если второй шаг не принят, вместо результата придёт один из статусов:

status	Что произошло	Что делать
confirmation_expired	прошло больше 300 секунд, токен уже удалён	начать заново — вызвать инструмент без токена и подтвердить снова
confirmation_args_mismatch	аргументы отличаются от первого вызова	повторить с исходными аргументами, токен ещё действителен
confirmation_tool_mismatch	токен выдан для другого инструмента	использовать токен, полученный именно от этого инструмента

4. Ограничения

• Удаления нет. Среди инструментов нет ни одного delete_*/remove_*: сервер не может удалить ресурс (убедиться можно через search_tools). Удаление — только через панель управления.
• Изменяющие операции требуют двух шагов — обойти подтверждение нельзя, см. раздел 3.
• Права ограничены токеном. Операции с ресурсами — серверы, базы, Kubernetes, домены, S3, сети, приложения, почта, реестры, диски, ключи, проекты, AI-агенты и базы знаний — сервер выполняет от имени вашего API-ключа. Если у ключа нет нужного доступа, инструмент вернёт ошибку.