AI-интеграция (MCP): что это и что умеет

AI-интеграция позволяет управлять аккаунтом BLACKBOX — серверами, SSH-доступом, балансом, заказами и счетами — через AI-ассистента, простыми словами. Для этого BLACKBOX предоставляет MCP-сервер blackbox по адресу https://api.app.blackbox.md/mcp. Обзор возможностей — на странице blackbox.md/ru/info/mcp, а токены доступа создаются в разделе «Личный кабинет» → «API-токены» (blackbox.md/ru/account/api-tokens).

Доступно: владельцу аккаунта blackbox.md. В панели app.blackbox.md настроек для AI нет: всё делается в аккаунте на blackbox.md и в самом AI-клиенте.

Что такое MCP

Model Context Protocol (MCP) — открытый стандарт, по которому AI-ассистент подключается к внешним сервисам и пользуется их «инструментами». MCP-сервер BLACKBOX даёт ассистенту инструменты для одного аккаунта blackbox.md — вашего.

• Совместимые клиенты: Claude (веб-приложение и Claude Desktop через «Custom connector», а также Claude Code), Cursor, VS Code с GitHub Copilot и любой другой клиент, который подключается к удалённым MCP-серверам по HTTP (Streamable HTTP) и позволяет добавить собственный заголовок (header).
• Авторизация: персональный API-токен вида bbx_pat_…, который вы создаёте на blackbox.md. Пароль от аккаунта, пароль root или ваш SSH-ключ ассистенту не нужны — достаточно токена.
• Разрешения: при создании токена вы отмечаете, что ассистенту можно делать. Инструменты, на которые у токена нет разрешения, ассистент даже не видит.
• Стоимость: интеграция бесплатна. За токены и вызовы MCP плата не взимается — вы платите только за заказанные услуги.

Подключение за 3 шага

1. Создайте токен

1. На blackbox.md откройте «Личный кабинет» → «API-токены» (страница «Токены доступа (API)»).
2. В карточке «Новый токен» заполните «Название токена», например «Claude Desktop (ноутбук)».
3. В блоке «Разрешения» три разрешения на чтение уже отмечены. Отметьте и другие, если ассистент должен что-то менять, или нажмите «AI-администратор — полный доступ», чтобы выбрать все восемь.
4. Нажмите «Создать токен».
5. Появится карточка «Ваш новый токен» с предупреждением «Скопируйте токен сейчас — он не будет показан снова.» Нажмите «Копировать» (надпись сменится на «Скопировано!»), сохраните токен в надёжном месте и нажмите «Готово».

Подробнее: API-токены: создание, копирование и отзыв.

2. Добавьте сервер в AI-клиент

Значения одинаковы для всех клиентов:

В Cursor сервер добавляется в JSON-файл конфигурации в формате со страницы blackbox.md/ru/info/mcp:

{
  "mcpServers": {
    "blackbox": {
      "url": "https://api.app.blackbox.md/mcp",
      "headers": {
        "Authorization": "Bearer bbx_pat_..."
      }
    }
  }
}

Замените bbx_pat_... своим токеном и перезапустите клиент, если он этого требует. В других клиентах (например, в VS Code) формат немного отличается. Пошаговые инструкции для каждого клиента: Подключение в приложении Claude (пользовательский коннектор) и Подключение из Claude Code, Cursor, VS Code и других клиентов.

3. Проверьте подключение

Напишите ассистенту: «Вызови whoami». Инструмент whoami не требует разрешений. Он подтверждает, что токен работает, и показывает, какие разрешения у токена есть, а каких не хватает (missing_scopes). Если нужного разрешения нет, создайте новый токен: расширить разрешения существующего токена нельзя.

Если AI-клиент сообщает об ошибке invalid_token, см. Лимиты и коды ошибок MCP.

Что умеет ассистент

Чтобы найти нужный сервер, ассистенту нужно ещё и servers:read. Полный список инструментов с параметрами и лимитами: Список инструментов MCP. Что даёт каждое разрешение: Разрешения токенов (scopes).

Внимание С разрешением orders:write ассистент может тратить средства с баланса и отменять заказы. Отмена заказа с работающим сервером удаляет сервер сразу, со всеми данными и без отсрочки. Разрешения servers:credentials и servers:exec дают доступ root ко всем вашим серверам. Выдавайте их, только когда они действительно нужны.

Чего ассистент не умеет

Доступа к профилю, паролю аккаунта, реквизитам и удалению аккаунта у ассистента тоже нет.

REST API для клиентов нет

Токены bbx_pat_… работают только по адресу https://api.app.blackbox.md/mcp. Отдельного REST API для клиентов у BLACKBOX нет: остальные адреса сайта и панели принимают только сессию браузера и отклоняют токен. Если хотите автоматизировать что-то из своего кода, используйте тот же MCP: Использование MCP из кода (AI API и HTTP).

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

Первые три примера опубликованы на странице blackbox.md/ru/info/mcp. Больше примеров: Примеры задач для AI-ассистента и нужные разрешения.

Какие данные видит провайдер AI

Всё, что возвращают инструменты, попадает в AI-клиент и к провайдеру, который обслуживает AI-модель: список серверов, IP-адреса, баланс, счета, вывод команд на сервере, а если вы выдали servers:credentials — ещё пароли root и ключи доступа к серверам. Пользуйтесь провайдером AI, которому доверяете, и выдавайте разрешения на доступ только по необходимости. В журнале действий BLACKBOX отмечается только сам факт запуска команды — без её текста и вывода.

Безопасность Токен — это ключ к вашему аккаунту: любой, у кого он есть, может откуда угодно делать всё, что позволяют выданные токену разрешения. Не публикуйте его в чатах, на скриншотах и в git-репозиториях. Создавайте отдельный токен для каждого клиента или устройства и отзывайте его кнопкой «Отозвать», когда он больше не нужен: доступ прекращается сразу. Смена пароля аккаунта blackbox.md отключает все токены, созданные до неё. Подробнее: Безопасность токенов и AI-агентов.

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

Какие AI-клиенты подходят? Любой клиент, который подключается к удалённым MCP-серверам по HTTP и позволяет добавить собственный заголовок: приложение Claude (через «Custom connector» с заголовком x-api-key), Claude Code, Cursor, VS Code с GitHub Copilot и другие. Приложения, которые подключаются только через OAuth (вход в учётную запись, без заголовка), подключить нельзя: сервер BLACKBOX принимает только токен.

Это платно? Нет. Интеграция и токены бесплатны. Вы платите только за заказанные услуги, в том числе заказанные через ассистента.

Может ли ассистент потратить мои деньги? Только с баланса и только если у токена есть разрешение orders:write. Инструменты для заказов, отмены и апгрейда по умолчанию лишь показывают предварительный расчёт (цену или сумму возврата) и действуют только после подтверждения, а заказ оплачивается отдельным шагом, который проходит, только если указанная сумма в точности равна текущей цене. Пополнить баланс или оплатить картой ассистент не может. Он получает указание спрашивать ваше согласие перед любой тратой, но окно подтверждения показывает AI-клиент, поэтому не включайте для этих инструментов автоматическое одобрение. Подробнее: Заказы, оплата, отмена и апгрейд через AI.

Нужно ли давать ассистенту пароль root или мой SSH-ключ? Нет. Ассистент работает с сервером через защищённое соединение BLACKBOX, и ему нужен только токен. См. Ключи BLACKBOX на вашем сервере.

Можно ли подключить несколько ассистентов или устройств? Да. Создайте для каждого отдельный токен с подходящими разрешениями. Отзывать их можно по одному, не затрагивая остальные.