API-токены: создание, копирование и отзыв
Как создать токен для AI-ассистента, скопировать его один раз и отозвать.
На этой странице
На странице «Токены доступа (API)» (blackbox.md/ru/account/api-tokens, «Мой аккаунт» → «API-токены») создаются токены, с которыми AI-ассистент (Claude, Cursor, VS Code и другие) подключается к вашему аккаунту через MCP. На странице написано: «Создайте токен, чтобы подключить AI-ассистента (Claude Desktop, Cursor и т.д.) к вашему аккаунту blackbox.md через MCP. Токен даёт доступ только к тем данным, которые вы явно разрешите ниже.» Управлять токенами можно только здесь: в панели app.blackbox.md такой страницы нет.
Доступно: любому клиенту, вошедшему на blackbox.md. Токен действует от имени вашего аккаунта и только с теми разрешениями, которые вы отметили при создании.
Как создать токен
- Войдите на blackbox.md и нажмите «Личный кабинет» в верхней панели (на телефоне видна только иконка аккаунта).
- В меню слева выберите «API-токены». На телефоне и планшете меню открывается кнопкой «Меню аккаунта». Ссылка «Как это работает — полное руководство →» под заголовком открывает описание AI-интеграции (
blackbox.md/ru/info/mcp). - В карточке «Новый токен» заполните поле «Название токена» — укажите AI-клиент или устройство, например «Claude Desktop (ноутбук)». Название обязательно, длина — от 1 до 80 символов.
- В блоке «Разрешения» отметьте, что разрешено ассистенту. Первые три разрешения (только чтение) уже отмечены. Разрешения, выделенные красным, рискованные: они позволяют что-то менять или видеть пароли серверов. Когда вы отмечаете такое разрешение, под ним появляется предупреждение «Внимание: с этим разрешением AI-ассистент сможет … Предоставляйте его только тем клиентам, которым доверяете — токен можно отозвать в любой момент.»
- Нажмите «Создать токен». Пока токен создаётся, на кнопке написано «Создание…».
- Над формой появится карточка «Ваш новый токен». Сразу скопируйте токен (см. следующий раздел). Форма очищается, а в блоке «Разрешения» снова отмечены три разрешения на чтение.
| Пункт в форме | Код в списке | По умолчанию |
|---|---|---|
| «Читать список и статус моих серверов» | servers:read |
отмечено |
| «Читать баланс, счета и заказы» | billing:read |
отмечено |
| «Читать список моих SSH-ключей» | ssh_keys:read |
отмечено |
| «Управлять питанием серверов (перезагрузка/выкл/вкл)» | servers:power |
красное, не отмечено |
| «Просматривать пароли/доступы к серверам» | servers:credentials |
красное, не отмечено |
| «Оформлять и изменять заказы от моего имени» | orders:write |
красное, не отмечено |
| «Добавлять и удалять мои SSH-ключи» | ssh_keys:write |
красное, не отмечено |
| «Выполнять любые команды от root на моих серверах» | servers:exec |
красное, не отмечено |
Какие инструменты открывает каждое разрешение, описано в статье Разрешения токенов (scopes). Какие разрешения нужны для конкретной задачи — в статье Примеры задач для AI-ассистента и нужные разрешения.
Набор «AI-администратор — полный доступ»
Кнопка «AI-администратор — полный доступ» над списком разрешений отмечает все 8 разрешений. Пока отмечены все, под списком виден текст: «Полный доступ: ассистент сможет выполнять любые команды от root на ваших серверах, видеть пароли и ключи и тратить средства с баланса. Именно то, что нужно AI-администратору — больше ничего давать не нужно, кроме токена.» После нажатия кнопки любое разрешение можно снять до того, как вы нажмёте «Создать токен».
Опасно Разрешение «Выполнять любые команды от root на моих серверах» даёт доступ
rootко всем вашим серверам, а разрешение «Оформлять и изменять заказы от моего имени» позволяет тратить средства с баланса. Любой, у кого есть токен, может пользоваться им откуда угодно, пока вы его не отзовёте. Для задач, где нужно только читать данные, создайте отдельный токен без красных разрешений.
Как скопировать токен
Карточка «Ваш новый токен» показывает токен целиком только один раз.
Прочитайте предупреждение «Скопируйте токен сейчас — он не будет показан снова.»
Нажмите «Копировать». На две секунды на кнопке появится «Скопировано!». Если надпись не изменилась, браузер не разрешает автоматическое копирование: выделите токен мышью и скопируйте вручную.
Вставьте токен в AI-клиент или в менеджер паролей.
Используйте данные из блока «Подключение AI-клиента» («Добавьте это подключение в настройках Claude Desktop / Cursor (или любого MCP-совместимого клиента):»):
Строка Значение «URL сервера» https://api.app.blackbox.md/mcp«Заголовок авторизации» Authorization: Bearer bbx_pat_…(с вашим полным токеном)Нажмите «Готово». Карточка закроется, и показать токен ещё раз будет невозможно. То же самое произойдёт, если вы обновите страницу или уйдёте с неё.
Токен выглядит так: bbx_pat_ и ещё 43 символа (буквы, цифры, - и _). Настройка конкретных клиентов описана в статьях Подключение в приложении Claude (пользовательский коннектор) (там токен указывается в заголовке x-api-key, без «Bearer») и Подключение из Claude Code, Cursor, VS Code и других клиентов.
Важно BLACKBOX не хранит токен в открытом виде — только его криптографический отпечаток. Поэтому даже мы не сможем показать его повторно. Если вы его потеряли, создайте новый токен, а старый отзовите.
Список токенов
Под формой находится таблица всех токенов — сначала самые новые:
| Столбец | Что в нём |
|---|---|
| «Название» | название, указанное при создании |
| «Токен» | только начало и последние 4 символа, например bbx_pat_…a1B2 |
| «Разрешения» | коды разрешений, например servers:read (см. таблицу выше) |
| «Создан» | дата и время создания |
| «Последнее использование» | когда AI-клиент в последний раз пользовался токеном; «никогда», если ещё не пользовался. Обновляется не чаще раза в минуту. |
| без заголовка | кнопка «Отозвать» |
Если токенов нет, на странице написано «У вас пока нет токенов доступа.»
Как отозвать токен
- В таблице нажмите «Отозвать» в строке токена.
- Откроется окно «Отозвать токен?» с текстом «Отозвать этот токен? Любой AI-клиент, использующий его, потеряет доступ немедленно.»
- Нажмите «Отозвать», чтобы подтвердить, или «Отмена», чтобы передумать.
- На кнопке появится «Отзыв…». Затем строка станет серой, а вместо кнопки появится слово «Отозвать» серым курсивом. Если строка не изменилась, отозвать токен не удалось: обновите страницу и повторите.
Отзыв действует сразу: при следующем запросе AI-клиент получит ошибку token not recognised (revoked, expired, or unknown). Отменить отзыв нельзя. Удалить отозванный токен тоже нельзя: он остаётся в списке серым.
Когда токен перестаёт работать
| Ситуация | Что происходит с токенами |
|---|---|
| Вы нажали «Отозвать» | Токен перестаёт работать сразу. |
| Вы сменили пароль аккаунта blackbox.md | Перестают работать все токены, созданные до смены пароля. В списке они остаются без какой-либо пометки — отзовите их. Подробнее — в статье Смена пароля аккаунта. |
| Аккаунт удалён | Токены удаляются вместе с аккаунтом в конце льготного периода. До этого момента они работают. См. Удаление аккаунта. |
| Вы вышли из аккаунта на blackbox.md или нажали «Выйти везде» в панели | Ничего: токены продолжают работать. |
По умолчанию у токенов нет срока действия, и задать его на странице нельзя. Поэтому время от времени заменяйте токены: создайте новый, пропишите его в клиенте, а старый отзовите.
Лимиты и ошибки
| Правило | Значение |
|---|---|
| Создание токенов | не более 10 в час; учитывается каждая попытка, в том числе отклонённая |
| Всего токенов | без ограничений |
| Название | обязательно, от 1 до 80 символов |
| Разрешения | выбираются при создании, изменить их потом нельзя |
| Срок действия | по умолчанию нет; задать нельзя |
| Сообщение | Что означает | Что делать |
|---|---|---|
| «Укажите название токена.» | Поле «Название токена» пустое. | Укажите название. |
| «Too many requests» | За последний час вы создали или пытались создать 10 токенов. | Подождите час и не повторяйте попытки: каждая попытка продлевает ожидание. |
mcp_disabled |
Сервис MCP временно недоступен. Уже созданные токены остаются в списке, и их можно отозвать. | Повторите позже. Если сообщение не исчезает, напишите нам: Как связаться с поддержкой BLACKBOX. |
| «Не удалось создать токен.» или текст на английском, например «Unauthorized» | Другая ошибка — например, истекла сессия. | Обновите страницу, войдите заново и повторите. |
| «Ошибка загрузки.» | Не удалось загрузить список. | Обновите страницу или войдите заново. |
Ошибки, которые AI-клиент получает при подключении, разобраны в статье Лимиты и коды ошибок MCP.
Частые вопросы
Я закрыл карточку, не скопировав токен. Можно его восстановить? Нет. Создайте новый токен, а нескопированный отзовите, чтобы в списке не оставалось неиспользуемых токенов.
Как добавить разрешение к уже созданному токену? Нельзя. Создайте новый токен с нужными разрешениями, замените им старый в AI-клиенте, а старый отзовите.
Приходит ли письмо, когда токен создан или отозван? Нет, писем не отправляется. Регулярно просматривайте список и столбец «Последнее использование» и отзывайте токены, которые не узнаёте.
Почему в «Последнее использование» по-прежнему «никогда»? Первое использование записывается сразу, но страница сама не обновляется — обновите её. Если там всё ещё «никогда», AI-клиент пока не подключался с этим токеном: проверьте адрес и заголовок в настройках клиента.
Можно ли создавать или отзывать токены через AI-ассистента или в панели? Нет. Токены создаются и отзываются только на этой странице аккаунта blackbox.md.
Подойдёт ли токен для другого API?
Нет. Токен принимается только по адресу MCP https://api.app.blackbox.md/mcp.
Сколько токенов создавать? По одному на каждый AI-клиент или устройство, с понятным названием. Если потеряете ноутбук, достаточно отозвать только его токен. Другие советы — в статье Безопасность токенов и AI-агентов.