Список инструментов MCP

MCP-сервер blackbox (https://api.app.blackbox.md/mcp) даёт AI-ассистенту 25 инструментов. Ассистент сам выбирает нужный инструмент, когда вы описываете задачу, а вы через разрешения токена определяете, какими инструментами ему можно пользоваться. Токен создаётся на blackbox.md: «Личный кабинет» → «API-токены» (blackbox.md/ru/account/api-tokens).

Доступно: владельцу аккаунта blackbox.md — через AI-ассистента, подключённого с API-токеном. Инструменты работают только с данными аккаунта, в котором создан токен.

Как читать таблицы

• Разрешение: код разрешения, которое должно быть у токена; «—» означает, что разрешение не нужно. Какая галочка ему соответствует на странице «Токены доступа (API)», см. Разрешения токенов (scopes).
• Параметры: данные, которые ассистент передаёт инструменту. Вводить их самим не нужно, но их полезно узнавать, когда AI-клиент просит подтвердить вызов.
• Лимит: сколько вызовов разрешено на весь аккаунт, для всех токенов вместе. Эти лимиты считаются отдельно от лимитов панели app.blackbox.md. Кроме того, на все инструменты, кроме whoami и list_vm_plans, действует общий лимит — 120 вызовов в минуту.
• Суммы: поля …_mdl указаны в целых MDL, поля …_bani — в банях, сотых долях лея (1 MDL = 100 бань).

Общее поведение

Кроме заказанных вами серверов, list_servers может показывать серверы компании, к которым BLACKBOX открыл вам доступ. Если can_manage равно false, сервер доступен только для просмотра (в панели у него отметка «Обслуживается»), и инструменты управления с ним не работают. Если BLACKBOX выдал вам права на управление, разрешённые действия перечислены в поле capabilities; апгрейд для таких серверов недоступен.

Все коды ошибок с пояснениями: Лимиты и коды ошибок MCP.

Обзор и чтение данных

Характеристики и цены тарифов: Тарифы VPS: как выбрать. Личное название сервера задаётся в панели: Переименование сервера (личное название).

В ответе list_servers нет номера заказа. Чтобы узнать, из какого заказа создан сервер, попросите ассистента вызвать list_orders и найти заказ, у которого server_id совпадает с id сервера.

Статусы в ответах

Инструменты возвращают коды на английском. В таблице — как они называются на blackbox.md, а если на сайте такой метки нет, что они означают:

Управление сервером

• power_server. Перезагрузка обычная, не принудительная; после reboot сервер, как правило, снова отвечает через 30–60 секунд. У некоторых серверов компании, на которые у вас есть права управления, возможна только перезагрузка (остальные действия отвечают no_instance_id). См. также Перезагрузка, остановка и запуск сервера.
• reset_server_password. На сервере «Только ключ» пароль меняется, но вход по паролю по SSH остаётся отключённым: Сброс пароля root.
• run_server_command. Истечение времени — не ошибка: приходит timed_out: true, а процесс может продолжать работать на сервере. Подробнее: Выполнение команд на сервере через AI.
• get_server_ssh_access. Ключ агента один на сервер и общий для всех ваших токенов: SSH-доступ и SSH-ключи через AI-ассистента.
• Апгрейд. Только на больший тариф, обратно — никогда. Тарифы «VPS hosting» и выделенные серверы отвечают not_upgradeable_plan (апгрейд через поддержку). Если на балансе не хватает средств, insufficient_balance приходит уже на предпросмотре. См. Апгрейд сервера: переход на больший тариф.

Безопасность reveal_server_credentials, reset_server_password и get_server_ssh_access возвращают пароли и приватные ключи в открытом виде. Они попадают в AI-клиент и к поставщику AI-модели. Выдавайте servers:credentials только при необходимости и просите ассистента не выводить секреты в переписку.

SSH-ключи

Ключи, сохранённые в аккаунте на странице «SSH-ключи» (SSH-ключи в аккаунте (blackbox.md)), и ключи, установленные на сервере в /root/.ssh/authorized_keys (Добавление и удаление SSH-ключей на сервере), управляются разными инструментами. Удаление в одном месте не убирает ключ из другого.

Защита от потери доступа:

• remove_server_ssh_key не удаляет ключ управления (management_key_protected) и последний ключ на сервере «Только ключ» (last_key_on_key_only_server).
• set_server_password_auth не отключает вход по паролю, если на сервере нет ни одного вашего ключа (no_customer_key_installed).

Деньги: заказы, оплата и отмена

Все три инструмента требуют orders:write. Оплата и возвраты проходят только через баланс: пополнить баланс или заплатить картой ассистент не может.

Правила возврата те же, что на сайте: Отмена заказа и возврат средств. Шаги и защиты: Заказы, оплата, отмена и апгрейд через AI.

Необратимо С confirm: true инструмент cancel_order сразу удаляет сервер заказа со всеми данными — без 24-часового периода ожидания, который даёт кнопка «Удалить» в панели. Прежде чем подтверждать, прочитайте предпросмотр.

Параметры create_order

Ассистент составляет параметры сам; тариф, операционную систему и ключи можно назвать ему явно. Пример для рекомендуемого тарифа с Ubuntu 24.04 и ключом, сохранённым в аккаунте:

{
  "source": "static-plan",
  "plan_slug": "vm-iops1-m",
  "config": {
    "kind": "static-plan",
    "plan_id": "vm-iops1-m",
    "os": "ubuntu-24",
    "ssh": { "key_ids": ["ID_КЛЮЧА"] }
  },
  "confirm": false
}

Возможные значения plan_slug (то же значение указывается и в config.plan_id) приведены ниже. Тарифы VPS имеют вид vm-СЕМЕЙСТВО-РАЗМЕР:

Поля config:

Внимание Указывайте в extras только monitoring. MCP-сервер принимает и другие коды дополнительных услуг и добавляет их к сумме заказа и к ежемесячной цене сервера, но автоматически они не подключаются: в личном кабинете, в разделе «Заказы», они остаются в состоянии «В процессе активации». Не просите ассистента добавлять в заказ другие дополнительные услуги — для них напишите в поддержку. Перед подтверждением проверьте total_mdl в расчёте цены: это должна быть цена тарифа плюс 98 MDL, если вы заказали мониторинг. В line_items расчёта только одна строка с общей суммой, поэтому услуги отдельно не видны.

Конфигуратор (source: configurator) и старые тарифы vps-2, vps-3, vps-4 заменены фиксированными тарифами: на них приходят ошибки configurator_retired и plan_retired соответственно. Для старого тарифа в ошибке может быть предложен близкий тариф vm-…. Если в расчёте цены provisionable: false, тариф временно недоступен и подтверждение вернёт plan_unavailable.

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

Ассистент говорит, что у него нет нужного инструмента. Почему? У токена нет нужного разрешения, поэтому инструмент скрыт. Попросите ассистента вызвать whoami: в поле missing_scopes видно, чего не хватает. Затем создайте новый токен с этим разрешением. В тексте hint пресет называется «AI agent — full access», а на странице это кнопка «AI-администратор — полный доступ».

Почему status равен active, хотя сервер остановлен? status показывает только то, что сервер числится в вашем аккаунте. Запущен он или остановлен, видно в поле power_state инструмента get_server.

Можно ли пользоваться инструментами без AI-ассистента? Да, из любого MCP-клиента или из кода, но только через адрес MCP: в других местах токены bbx_pat_… не работают. См. Использование MCP из кода (AI API и HTTP).

Что значит 57800 в balance_bani? Сумма указана в банях: 57 800 бань — это 578,00 MDL.