Timeweb Cloud Skills

Официальные Agent Skills для работы с инфраструктурой Timeweb Cloud из ИИ-агентов: Claude Code, Cursor, Codex, OpenCode. Скилы дают агенту знания об услугах, а действия он выполняет через hosted MCP-сервер Timeweb Cloud, который подключается вместе с плагином.

Установка

Понадобится API-токен из раздела панели API и Terraform. Выпускайте токен с ограниченными правами и сроком жизни: полный токен открывает все услуги аккаунта, включая создание платных ресурсов.

Токен читается из переменной окружения TIMEWEB_CLOUD_TOKEN. В терминале:

export TIMEWEB_CLOUD_TOKEN='ваш-токен'

В десктопном приложении Claude — в ~/.claude/settings.json, потому что переменные из терминала оно не наследует:

{
  "env": { "TIMEWEB_CLOUD_TOKEN": "ваш-токен" }
}

Claude Code CLI

claude plugin marketplace add timeweb-cloud/skills
claude plugin install timeweb-cloud@timeweb-cloud-skills

Десктопное приложение Claude Code

Маркетплейс и плагин объявляются в ~/.claude/settings.json:

{
  "extraKnownMarketplaces": {
    "timeweb-cloud-skills": {
      "source": { "source": "git", "url": "https://github.com/timeweb-cloud/skills.git" },
      "autoUpdate": true
    }
  },
  "enabledPlugins": {
    "timeweb-cloud@timeweb-cloud-skills": true
  }
}

Если ключи уже есть, дописывайте записи внутрь них. Плагин подключится после перезапуска приложения, выключить его можно в + → Plugins.

npx skills

npx skills add timeweb-cloud/skills

MCP-сервер в этом случае добавляется отдельно:

claude mcp add-json timewebCloud '{"type":"http","url":"https://api.timeweb.cloud/api/v1/mcp/search","headers":{"Authorization":"Bearer ${TIMEWEB_CLOUD_TOKEN}"}}'

Вручную

Скопируйте папки из skills/ в каталог скилов своего агента:

Агент	Каталог	Документация
Claude Code	~/.claude/skills/	docs
Cursor	~/.cursor/skills/	docs
OpenCode	~/.config/opencode/skills/	docs
Codex	~/.codex/skills/	docs

Скилы

Скил загружается сам, когда запрос совпадает с его триггерами.

Скил	Про что
timeweb-servers	Облачные серверы: создание, действия, бэкапы и восстановление, снапшоты, диски, режимы загрузки, PTR, образы, SSH-ключи, мониторинг
timeweb-billing	Баланс и прогноз, стоимость услуг, цены каталога, статус аккаунта
timeweb-ai	AI-агенты, каталог моделей, базы знаний (RAG) и документы, токен-пакеты, статистика расхода
timeweb-kubernetes	Managed Kubernetes: создание кластера, группы нод, автоскейлинг, апгрейд версии, аддоны, kubeconfig
timeweb-databases	Managed БД: создание и ресайз кластеров, пользователи и права, бэкапы и восстановление, реплики, параметры движков
timeweb-s3	S3-хранилище: бакеты и их настройки, ключи доступа, домены и SSL, миграция, aws-cli и rclone
timeweb-account	Аккаунт: блокировки, ограничения входа по IP и странам, уведомления, аварии, проекты
timeweb-domains	Домены и DNS: регистрация и оплата заявок, администраторы доменов, записи, NS, поддомены, почтовые ящики
timeweb-network	Сети: публичные и плавающие IP, балансировщики, приватные сети, NAT, сетевые диски
timeweb-apps	App Platform: создание приложений, подключение VCS по токену, деплои и логи, пауза и рестарт, Container Registry

Если репозиторий добавлен в проект, агент дополнительно читает роутер по скилам из AGENTS.md в корне.

Действия через MCP

Плагин подключает hosted MCP-сервер timewebCloud (см. .mcp.json). У него три инструмента: search_tools ищет операцию по английским ключевым словам, get_tool_definition отдаёт схему аргументов, execute_tool выполняет. Полный список операций — в документации.

Правила, которые скилы соблюдают при работе с ним:

• перед списанием агент берёт цену из живого каталога, называет её и ждёт подтверждения — цены из памяти модели устаревают;
• изменения проходят в два шага: MCP отдаёт confirm_token и сводку операции, второй вызов идёт только после явного согласия;
• удаления ресурсов, уменьшения тарифа сервера и смены модели AI-агента в MCP нет. Скил скажет об этом и отправит в панель, а не будет искать обход.

Примеры запросов

Подними сервер под тестовый стенд: 2 ядра, 4 ГБ, Ubuntu, локация Нидерланды

Сколько денег на балансе и на сколько хватит при текущих тратах?

Создай AI-агента и подключи к нему базу знаний из документации

Поменяй A-запись у домена на новый IP сервера

Ссылки

• Документация Timeweb Cloud MCP
• Публичный API Timeweb Cloud
• Панель управления
• История изменений