Разрешения токенов (scopes)
Что даёт каждое из 8 разрешений, какие инструменты они открывают и какие сочетания мы рекомендуем.
На этой странице
Разрешения (по-английски scopes) определяют, что AI-ассистент может делать с API-токеном. Вы выбираете их один раз — при создании токена, в карточке «Новый токен» на странице «Токены доступа (API)» (blackbox.md/ru/account/api-tokens, «Мой аккаунт» → «API-токены»).
Доступно: любому клиенту, вошедшему на blackbox.md. Токен действует только в пределах аккаунта, в котором он создан.
Как работают разрешения
- Всего разрешений 8. Первые три дают только чтение и отмечены по умолчанию. Остальные пять выделены красным и по умолчанию не отмечены.
- Ассистент видит только те инструменты, которые разрешены токену. Неразрешённый инструмент скрыт; если ассистент всё же его вызовет, он получит ошибку
missing_scope: this token does not have 'orders:write'(с названием недостающего разрешения). - Два инструмента не требуют разрешений:
whoami(подтверждает аккаунт и показывает выданные и недостающие разрешения) иlist_vm_plans(каталог тарифов VPS с ценами). - Изменить разрешения уже созданного токена нельзя. Чтобы добавить разрешение, создайте новый токен.
- В списке токенов в столбце «Разрешения» показаны коды (например,
servers:read), а не подписи флажков.
Восемь разрешений
| Код | Флажок на странице | Риск | Какие инструменты открывает |
|---|---|---|---|
servers:read |
«Читать список и статус моих серверов» | только чтение, отмечено по умолчанию | list_servers, get_server, get_server_resize_options |
billing:read |
«Читать баланс, счета и заказы» | только чтение, отмечено по умолчанию | get_balance, list_transactions, list_orders, list_invoices |
ssh_keys:read |
«Читать список моих SSH-ключей» | только чтение, отмечено по умолчанию | list_ssh_keys |
servers:power |
«Управлять питанием серверов (перезагрузка/выкл/вкл)» | красное: прерывает работу сервера | power_server |
servers:credentials |
«Просматривать пароли/доступы к серверам» | красное: root-доступ к серверам | reveal_server_credentials, reset_server_password, add_server_ssh_key, set_server_password_auth, list_server_ssh_keys, remove_server_ssh_key, get_server_ssh_access |
orders:write |
«Оформлять и изменять заказы от моего имени» | красное: тратит средства с баланса, может удалить сервер | create_order, pay_order, cancel_order, resize_server |
ssh_keys:write |
«Добавлять и удалять мои SSH-ключи» | красное: меняет ключи в аккаунте | add_ssh_key, delete_ssh_key |
servers:exec |
«Выполнять любые команды от root на моих серверах» | красное, самое опасное: любые команды от root | run_server_command |
Что делает каждый инструмент, описано в статье Список инструментов MCP.
Важно Подписи флажков описывают не всё, что на самом деле позволяют разрешения. «Просматривать пароли/доступы к серверам» (
servers:credentials) позволяет также сбрасывать пароль root, устанавливать и удалять SSH-ключи на сервере, включать и отключать вход по паролю и выдавать ассистенту SSH-ключ для доступа. «Оформлять и изменять заказы от моего имени» (orders:write) позволяет также делать апгрейд сервера (оплата с баланса и перезагрузка сервера) и отменять заказы; отмена заказа с работающим сервером сразу удаляет сервер вместе со всеми данными.
Предупреждения у красных разрешений
Под каждым отмеченным красным разрешением появляется текст «Внимание: с этим разрешением AI-ассистент сможет ДЕЙСТВИЕ. Предоставляйте его только тем клиентам, которым доверяете — токен можно отозвать в любой момент.» Вместо слова ДЕЙСТВИЕ подставляется:
| Разрешение | Действие в предупреждении |
|---|---|
servers:power |
«включать и выключать ваши серверы» |
servers:credentials |
«увидеть пароли и ключи доступа к вашим серверам» |
orders:write |
«тратить деньги и оформлять заказы от вашего имени» |
ssh_keys:write |
«добавлять и удалять SSH-ключи на вашем аккаунте» |
servers:exec |
«выполнять любые команды от root на ваших серверах» |
Как выбрать разрешения при создании токена
- На blackbox.md нажмите «Личный кабинет», затем в меню слева — «API-токены» (на телефоне сначала откройте «Меню аккаунта»).
- В карточке «Новый токен» заполните поле «Название токена».
- В блоке «Разрешения» снимите флажки с тех разрешений на чтение, которые ассистенту не нужны.
- Отмечайте красные разрешения, только если ассистент должен что-то менять. Прочитайте предупреждение, которое появляется под каждым из них.
- Для полного доступа нажмите «AI-администратор — полный доступ»: кнопка отмечает все 8 разрешений и показывает текст «Полный доступ: ассистент сможет выполнять любые команды от root на ваших серверах, видеть пароли и ключи и тратить средства с баланса. Именно то, что нужно AI-администратору — больше ничего давать не нужно, кроме токена.» Чтобы убрать какое-либо разрешение, снимите его флажок отдельно.
- Нажмите «Создать токен». Как скопировать и сохранить токен, описано в статье API-токены: создание, копирование и отзыв.
После создания токена в форме снова отмечены только три разрешения на чтение.
Рекомендуемые сочетания
| Профиль | Разрешения | Ассистент может | Ассистент не может |
|---|---|---|---|
| Мониторинг, только чтение | servers:read, billing:read, ssh_keys:read (флажки по умолчанию) |
видеть серверы и их состояние, варианты апгрейда с ценами, баланс, операции, заказы, счета и ключи в аккаунте | что-либо менять, видеть пароли, тратить деньги |
| Оператор серверов без доступа к деньгам | три разрешения чтения + servers:power + servers:credentials; по желанию servers:exec |
перезагружать, останавливать и запускать серверы, смотреть и сбрасывать пароль root, управлять ключами на сервере; с servers:exec — ещё и выполнять команды от root |
оформлять, оплачивать и отменять заказы, делать апгрейд |
| Агент с полным доступом | все 8 — кнопкой «AI-администратор — полный доступ» | всё, что позволяют инструменты MCP, включая оплату с баланса | пополнять баланс и платить картой |
Если у токена есть красные разрешения, держите в AI-клиенте включённым подтверждение действий. Подробные рекомендации — в статье Безопасность токенов и AI-агентов, примеры задач с нужными разрешениями — в статье Примеры задач для AI-ассистента и нужные разрешения.
Безопасность Считайте
servers:credentialsroot-доступом, даже еслиservers:execне выдано. С этим разрешением ассистент видит пароль root и может получить SSH-ключ для доступа (get_server_ssh_access), а AI-клиент, который умеет выполнять команды на вашем компьютере (например, Claude Code), может сам подключиться к серверу по SSH.
Если ассистенту не хватает разрешения
- Попросите ассистента вызвать
whoami. В ответе будут разрешения токена и список недостающих (missing_scopes). - На странице «Токены доступа (API)» создайте новый токен с недостающим разрешением и с теми, которыми вы уже пользуетесь.
- Замените старый токен в AI-клиенте: Подключение в приложении Claude (пользовательский коннектор) или Подключение из Claude Code, Cursor, VS Code и других клиентов.
- Отзовите старый токен кнопкой «Отозвать».
Частые вопросы
Можно ли добавить разрешение к уже созданному токену? Нет. Создайте новый токен с нужными разрешениями, а старый отзовите.
Ассистент советует пресет «AI agent — full access». Где он? На странице «Токены доступа (API)» эта кнопка называется «AI-администратор — полный доступ». Она отмечает все 8 разрешений.
Может ли ассистент с orders:write заплатить картой или пополнить баланс?
Нет. Он может платить только с уже имеющегося баланса. Подробнее — в статье Заказы, оплата, отмена и апгрейд через AI.
Устанавливает ли ассистент с ssh_keys:write ключи на серверы?
Нет. Это разрешение меняет только ключи, сохранённые в аккаунте. Чтобы установить ключ на сервер или удалить его оттуда, нужно разрешение servers:credentials.
Можно ли создать токен совсем без разрешений?
Да, если снять флажки со всех разрешений. Тогда ассистенту будут доступны только whoami и list_vm_plans.