AI-интеграция · MCP

Управляйте инфраструктурой через AI

Подключите вашего AI-ассистента (Claude Desktop, Cursor или любой MCP-совместимый клиент) напрямую к аккаунту blackbox.md. Спрашивайте о серверах, балансе и счетах и управляйте своими серверами — на естественном языке. Доступ ограничен персональным токеном, который вы можете отозвать в любой момент.

Создать API-токен Связаться с нами

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

Создайте токен доступа

Войдите в аккаунт и откройте «API-токены». Выберите разрешения (по умолчанию — только чтение) — или нажмите пресет «AI-администратор — полный доступ», если хотите, чтобы ассистент управлял серверами. Задайте имя и создайте токен: ассистенту больше ничего не нужно, кроме этого токена. Он показывается один раз — скопируйте его сразу.

Добавьте подключение в AI-клиент

Откройте настройки Claude Desktop, Cursor или другого MCP-совместимого клиента и добавьте сервер BLACKBOX, указав адрес и токен в заголовке Authorization (см. пример ниже).

Перезапустите клиент и спросите

После перезапуска AI-ассистент увидит инструменты BLACKBOX. Просто спросите его о своих серверах или счетах — он вызовет нужный инструмент сам.

Пример конфигурации

Замените bbx_pat_... на созданный вами токен. Адрес подключения один для всех клиентов:

Адрес MCP-сервера

https://api.app.blackbox.md/mcp

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

Подключение через коннектор в приложении Claude (claude.ai / Claude Desktop)

В диалоге «Custom connector» приложения Claude заголовок Authorization зарезервирован под OAuth и недоступен. Поэтому токен передаётся в пользовательском заголовке x-api-key — сервер BLACKBOX принимает его так же, как Authorization: Bearer.

Settings → Connectors → Add custom connector. URL сервера: https://api.app.blackbox.md/mcp.
Раздел «OAuth client»: ничего не заполняйте (оставьте вариант по умолчанию, без Client ID).
Раздел «Request headers» → Add header: имя x-api-key, значение — ваш токен bbx_pat_… (без слова Bearer), «Required» включено.
Сохраните и подключитесь. Если раньше появлялась ошибка «Couldn't register with BlackBox's sign-in service» — значит токен не был передан; после добавления заголовка она исчезает.

Также принимаются заголовки x-api-token, x-auth-token, api-key и x-access-token. В Claude Code (терминал) и Cursor по-прежнему используйте Authorization: Bearer, как в примере выше.

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

Ассистенту не нужен ни пароль, ни SSH-ключ от вас — только токен: доступ к серверу он получает сам через наше защищённое соединение.

«Покажи мои серверы BLACKBOX и их статус»
«Какой у меня баланс и какие счета не оплачены?»
«Установи nginx на мой сервер»

Доступные инструменты

Каждый инструмент требует соответствующего разрешения токена. Инструмент недоступен, если вы не выдали токену это разрешение.

Инструмент	Что делает	Разрешение	Статус
Список серверов	Все ваши серверы с их статусом	`servers:read`	Доступно
Данные сервера	Статус, IP-адрес, состояние питания	`servers:read`	Доступно
Баланс	Текущий баланс кошелька	`billing:read`	Доступно
Операции	История пополнений и списаний	`billing:read`	Доступно
Заказы	Список ваших заказов	`billing:read`	Доступно
Счета	Список ваших счетов	`billing:read`	Доступно
Управление питанием	Перезагрузка / выключение / включение	`servers:power`	Доступно
Доступы к серверу	Просмотр и сброс пароля root	`servers:credentials`	Доступно
Заказ и оплата	Создание и оплата заказа из баланса	`orders:write`	Доступно
Список SSH-ключей `list_ssh_keys`	Все ваши зарегистрированные SSH-ключи	`ssh_keys:read`	Доступно
Добавить SSH-ключ `add_ssh_key`	Зарегистрировать новый публичный SSH-ключ	`ssh_keys:write`	Доступно
Удалить SSH-ключ `delete_ssh_key`	Удалить один из ваших SSH-ключей	`ssh_keys:write`	Доступно
Добавить ключ на сервер `add_server_ssh_key`	Отправить сохранённый SSH-ключ на уже работающий сервер	`servers:credentials`	Доступно
Вход по паролю `set_server_password_auth`	Включить/отключить SSH-вход по паролю на сервере	`servers:credentials`	Доступно
Ключи на сервере `list_server_ssh_keys`	Список установленных SSH-ключей на сервере	`servers:credentials`	Доступно
Удалить ключ с сервера `remove_server_ssh_key`	Удалить один из установленных SSH-ключей на сервере	`servers:credentials`	Доступно
Доступ SSH `get_server_ssh_access`	Эмитирует SSH-ключ, который мы сами устанавливаем на сервер	`servers:credentials`	Доступно
Выполнить команду `run_server_command`	Запускает команду от root на вашем сервере	`servers:exec`	Доступно

Инструменты управления (питание, доступы, заказы) запускаются поэтапно. Действия, тратящие деньги или меняющие сервер, всегда требуют явного подтверждения в вашем AI-клиенте.

При заказе, если вы прикрепите хотя бы один SSH-ключ, вход по паролю через SSH по умолчанию отключается (config.ssh.password_auth). Пароль для консоли остаётся доступным.

Ваши серверы

AI видит список серверов, их статус и IP-адреса — только те, что принадлежат вам.

Баланс и счета

Спросите о балансе кошелька, истории операций, заказах и неоплаченных счетах.

Доступ под контролем

Токен ограничен выбранными разрешениями и привязан только к вашему аккаунту. Отзыв — в один клик.

Стандарт MCP

Открытый протокол Model Context Protocol — работает с Claude Desktop, Cursor и другими клиентами.

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

Что такое MCP?

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

Может ли AI потратить мои деньги?

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

Кто увидит мои данные?

Только тот AI-клиент и его провайдер, которому вы передали токен. Разрешение «Доступы к серверу» передаёт пароли серверов AI-клиенту — выдавайте его осознанно.

Как отозвать доступ?

Откройте «API-токены» в аккаунте и отзовите нужный токен. Он немедленно перестаёт работать. Вы можете иметь несколько токенов с разными разрешениями.

Какие клиенты поддерживаются?

Любой MCP-совместимый клиент: Claude Desktop, Cursor и другие. Подключение — по адресу сервера и токену в заголовке Authorization.

Создайте токен и подключитесь

Создание токена бесплатно и занимает минуту. Начните с доступа только на чтение и расширяйте разрешения по мере необходимости.

Свяжитесь с нами Смотреть тарифы VPS