Примеры задач для AI-ассистента и нужные разрешения
Готовые формулировки для серверов, SSH-ключей, заказов и баланса — с используемыми инструментами и разрешениями токена.
На этой странице
Здесь собраны готовые формулировки для AI-ассистента, подключённого к вашему аккаунту через MCP (https://api.app.blackbox.md/mcp). Для каждой задачи указаны инструменты, которые вызывает ассистент, и разрешения, которые нужны токену. Разрешения выбираются при создании токена в разделе «Личный кабинет» → «API-токены» (blackbox.md/ru/account/api-tokens).
Доступно: владельцу аккаунта blackbox.md с AI-ассистентом, подключённым по API-токену (Подключение в приложении Claude (пользовательский коннектор) или Подключение из Claude Code, Cursor, VS Code и других клиентов).
Начните с «Вызови whoami»
- В начале каждой сессии напишите ассистенту: «Вызови whoami». Инструмент
whoamiне требует разрешений. - Ассистент подтвердит, что токен работает, и покажет, какие разрешения у токена есть (
scopes) и каких не хватает (missing_scopes). Если у токена есть все разрешения, инструмент отвечает «All scopes granted — every tool is available.» - Если для вашей задачи не хватает разрешения, создайте новый токен с этим разрешением и замените им старый в AI-клиенте. Расширить разрешения существующего токена нельзя. См. Разрешения токенов (scopes).
Инструменты, на которые у токена нет разрешения, ассистент даже не видит. Поэтому иногда он просто отвечает, что подходящего инструмента у него «нет».
Примеры со страницы blackbox.md/ru/info/mcp
На странице blackbox.md/ru/info/mcp опубликованы три примера запросов:
Покажи мои серверы BLACKBOX и их статус
Какой у меня баланс и какие счета не оплачены?
Установи nginx на мой серверОни же есть в таблицах ниже, с нужными разрешениями.
Разрешения из таблиц
| Код | Флажок в форме «Новый токен» | Отмечен по умолчанию |
|---|---|---|
servers:read |
«Читать список и статус моих серверов» | да |
billing:read |
«Читать баланс, счета и заказы» | да |
ssh_keys:read |
«Читать список моих SSH-ключей» | да |
servers:power |
«Управлять питанием серверов (перезагрузка/выкл/вкл)» | нет |
servers:credentials |
«Просматривать пароли/доступы к серверам» | нет |
servers:exec |
«Выполнять любые команды от root на моих серверах» | нет |
orders:write |
«Оформлять и изменять заказы от моего имени» | нет |
Кнопка «AI-администратор — полный доступ» отмечает все разрешения, включая «Добавлять и удалять мои SSH-ключи» (ssh_keys:write).
Готовые задачи
Описывайте задачу своими словами: формулировки ниже — лишь образцы. Если серверов несколько, назовите нужный (имя из панели или IP-адрес). Ассистент сам найдёт его через list_servers, поэтому для задач на сервере нужно ещё и разрешение servers:read.
Чтение
| Задача | Что написать | Инструменты | Разрешения |
|---|---|---|---|
| Серверы и их статус | «Покажи мои серверы BLACKBOX и их статус» | list_servers, get_server |
servers:read |
| Баланс и неоплаченные счета | «Какой у меня баланс и какие счета не оплачены?» | get_balance, list_invoices |
billing:read |
| Последние операции | «Покажи последние 10 операций по балансу» | list_transactions |
billing:read |
| Тарифы и цены | «Какие тарифы VPS с 4 vCPU у вас есть и сколько они стоят?» | list_vm_plans |
не требуются |
Серверы и доступ
| Задача | Что написать | Инструменты | Разрешения |
|---|---|---|---|
| Перезагрузка с проверкой | «Перезагрузи мой сервер и скажи, когда он снова ответит» | power_server, затем get_server |
servers:power, servers:read |
| Место на диске | «Покажи, сколько места занято на диске моего сервера, и 20 самых больших каталогов» | run_server_command |
servers:exec, servers:read |
| Установка nginx | «Установи nginx на мой сервер» | run_server_command |
servers:exec, servers:read |
| Только ключ с ноутбука, без пароля | «Оставь на моём сервере только SSH-ключ „Laptop“ из аккаунта и отключи вход по паролю. Сначала покажи, что сделаешь, и дождись моего подтверждения.» | list_ssh_keys, add_server_ssh_key, затем set_server_password_auth; для остальных ключей — list_server_ssh_keys и remove_server_ssh_key |
servers:credentials, servers:read, ssh_keys:read |
| Удаление старого ключа | «Какие SSH-ключи установлены на моём сервере? Удали тот, что называется old-laptop.» | list_server_ssh_keys, затем remove_server_ssh_key |
servers:credentials, servers:read |
| SSH-команда для rsync | «Дай мне SSH-команду, чтобы копировать файлы на мой сервер через rsync» | get_server_ssh_access |
servers:credentials, servers:read |
- Перезагрузка:
power_serverтолько принимает запрос. Затем ассистент черезget_serverпроверяет, чтоpower_stateравноrunning. SSH и службам может понадобиться ещё 30–60 секунд. - Ключи: на сервере ключ узнают по комментарию в конце его строки (например,
old-laptop). Ключи, сохранённые на странице «SSH-ключи», ассистент находит по названию черезlist_ssh_keys. «Ключ управления (blackbox.md)» всегда остаётся на сервере, удалить его нельзя. - rsync: ассистент получает отдельный SSH-ключ, который BLACKBOX устанавливает на сервер, и готовую команду
ssh. Подробнее: SSH-доступ и SSH-ключи через AI-ассистента.
Деньги и заказы
| Задача | Что написать | Инструменты | Разрешения |
|---|---|---|---|
| Расчёт нового сервера | «Сделай расчёт для сервера Standard M с Ubuntu 24.04 и моим SSH-ключом и дождись моего подтверждения» | list_vm_plans, list_ssh_keys, create_order без подтверждения |
orders:write, ssh_keys:read |
| Оплата заказа | «Оплати с баланса заказ BBX-2026-000123» | list_orders, затем pay_order |
orders:write, billing:read |
| Сколько вернётся при отмене | «Сколько мне вернётся, если я отменю заказ BBX-2026-000123? Пока ничего не отменяй.» | list_orders, затем cancel_order без подтверждения |
orders:write, billing:read |
| Апгрейд после проверки цены | «Сделай апгрейд сервера до следующего тарифа, но сначала покажи цену» | get_server_resize_options, затем resize_server без подтверждения |
servers:read, orders:write |
- Расчёт:
create_orderбез подтверждения только считает сумму и ничего не создаёт. После вашего согласия ассистент повторяет вызов сconfirm=true, и заказ появляется в разделе «Заказы» со статусом «Новый». Деньги списываются только приpay_order. - Оплата и отмена: ассистент находит заказ по номеру через
list_orders— оттуда же он берёт текущую сумму, которую требуетpay_order. - Апгрейд: только на больший тариф той же линейки, с оплатой с баланса. После подтверждения сервер перезагружается, простой длится несколько минут.
Все подробности: Заказы, оплата, отмена и апгрейд через AI.
Деньги и необратимые действия: сначала просите предварительный расчёт
Инструкции, которые BLACKBOX передаёт ассистенту, определяют, когда он спрашивает вашего согласия, а когда действует сам. Это инструкции, а не техническая блокировка, поэтому и сами просите в сообщении остановиться.
| Ситуация | Что делает ассистент |
|---|---|
Деньги: оформление заказа (create_order с confirm=true), оплата (pay_order), апгрейд (resize_server с confirm=true) |
просит подтверждения |
Данные и доступ: отмена заказа (cancel_order с confirm=true), удаление ключа с сервера, отключение входа по паролю, замена SSH-ключа ассистента |
просит подтверждения |
| Остальное: чтение данных, команды на сервере, установка программ, перезагрузка, о которой вы попросили | действует сразу и сообщает результат |
Как работать безопасно:
- Сначала попросите расчёт или предварительный просмотр и добавьте в запрос «дождись моего подтверждения».
- Прочитайте, что покажет ассистент: сумму в MDL, тариф и операционную систему; при отмене — сумму возврата на баланс и будет ли удалён сервер; для ключей — какие ключи останутся на сервере.
- Подтвердите явно, отдельным сообщением.
- Когда AI-клиент попросит одобрить вызов, проверьте, что параметры совпадают с подтверждёнными.
Формулировки, которые останавливают ассистента перед важным шагом:
Сделай расчёт и дождись моего подтверждения, прежде чем оформлять или оплачивать заказ.
Покажи только предварительный просмотр отмены, ничего не подтверждай.
Скажи, какие ключи удалишь и что останется на сервере, и дождись моего подтверждения.
Покажи команду, которую хочешь выполнить, и дождись моего подтверждения.Важно Окно одобрения показывает AI-клиент, а не BLACKBOX. Не разрешайте инструментам выполняться всегда, без вопроса, особенно
create_order,pay_order,cancel_order,resize_server,remove_server_ssh_key,set_server_password_authиrun_server_command. Перед отключением входа по паролю проверьте в новом терминале, что входите по своему ключу: веб-консоли и VNC для клиентов нет (Включение и отключение входа по паролю по SSH).
Необратимо Если у заказа есть сервер, подтверждённая отмена удаляет сервер сразу, со всеми данными и без отсрочки. Всегда сначала просите предварительный просмотр: Заказы, оплата, отмена и апгрейд через AI.
Долгие задачи
Одну команду на сервере ассистент ждёт не дольше 300 секунд (по умолчанию 60). Когда время истекает, результат приходит с timed_out: true, а команда может продолжать работать на сервере. Для долгих задач (обновление системы, резервная копия, сборка) прямо попросите запустить их в фоне через nohup или systemd-run:
Запусти в фоне через nohup обновление системы на моём сервере, вывод — в /root/upgrade.log, и не жди завершения.Позже:
Проверь, закончилось ли обновление на моём сервере, и покажи последние 30 строк /root/upgrade.log.После timed_out: true не просите повторить ту же команду — сначала попросите проверку. Подробнее: Выполнение команд на сервере через AI.
Чего ассистент не умеет
| Задача | Где это сделать |
|---|---|
| Тикеты в поддержку | blackbox.md, «Личный кабинет» → «Помощь и поддержка»: Создание тикета в поддержку |
| Пополнение баланса | blackbox.md: Пополнение баланса |
| Оплата счетов | Автоматическая оплата счетов с баланса или Оплата банковским переводом и реквизиты BLACKBOX |
| DNS-записи | панель app.blackbox.md: Управление DNS-записями из панели |
| Мониторинг и оповещения | панель: Страница «Мониторинг» |
| Переименование сервера | панель: Переименование сервера (личное название) |
| Переустановка операционной системы | по запросу через поддержку: Доступные операционные системы |
Полный список: AI-интеграция (MCP): что это и что умеет.
Частые вопросы
Ассистент говорит, что у него нет нужного инструмента, или получает missing_scope. Что делать?
У токена нет нужного разрешения — ошибка называет его. Создайте новый токен с этим разрешением и замените им старый в AI-клиенте: API-токены: создание, копирование и отзыв.
Нужно ли сообщать ассистенту id сервера?
Нет. Назовите сервер по имени или IP-адресу — ассистент возьмёт id из list_servers. Для этого у токена должно быть разрешение servers:read.
Можно ли выполнять все примеры одним токеном? Да, с «AI-администратор — полный доступ». Но безопаснее каждый день пользоваться токеном только для чтения, а токен с полным доступом создавать, только когда он действительно нужен: Безопасность токенов и AI-агентов.
Ассистент получает rate_limited. Почему?
Превышен лимит инструмента. Предварительные расчёты и просмотры тоже учитываются: create_order — 20 вызовов в час, cancel_order — 5 за 5 минут, resize_server — 3 за 10 минут. Подождите и не повторяйте вызов в цикле: Лимиты и коды ошибок MCP.