Персональные токены
Персональный токен (PAT) — bearer-токен для скриптов, CI и MCP-клиентов. Он связан с пользователем и контекстом аккаунта, может иметь срок действия и работает до истечения срока или отзыва.
Создание токена
- Откройте Токены в дашборде.
- Нажмите Новый токен.
- Введите в поле Название понятное имя и при необходимости выберите Срок действия.
- В поле Права выберите Полные или Только чтение.
- Нажмите Создать токен и сразу сохраните открытое значение.
Открытое значение возвращается только при создании. Список токенов показывает имя, права, даты и статус, но не секрет.
Выбор прав
Права Полные используются по умолчанию и разрешают чтение и изменения, доступные клиенту. Они нужны для создания, выполнения, обновления и удаления.
Права Только чтение разрешают GET, HEAD и OPTIONS на маршрутах под общим
промежуточным обработчиком аутентификации REST; остальные методы там отклоняются. В MCP
управления платформой такой клиент не видит инструменты записи, а их прямой
вызов блокируется.
/v1/storage/* использует отдельный путь аутентификации для учетных данных
песочницы. Сейчас этот путь принимает обычный персональный токен как токен для
чтения и записи без применения общей проверки методов REST. Не полагайтесь на
персональный токен с правами read_only для запрета изменений хранилища; для
клиента хранилища, которому режим только чтения обеспечен технически,
используйте доступ к хранилищу, выданный песочнице, со значением ro.
Права токена являются границей возможностей в охваченных частях REST и MCP, а не только подсказкой в интерфейсе. Передавайте токен только тем программам и людям, которым можно доверить доступное ему чтение.
Использование
Добавляйте заголовок к REST-запросам:
Authorization: Bearer your-personal-access-token
Тот же заголовок с bearer-токеном используется на эндпоинте MCP:
https://your-just-run-host/mcp
Храните персональный токен в менеджере секретов или защищенном окружении
клиента. Не помещайте его в .mcp.json, который хранится в репозитории, в
исходный код, логи, URL и вывод примеров.
Отзыв
В разделе Токены нажмите значок корзины (Отозвать токен) у активного токена
и подтвердите. API-клиенты могут вызвать DELETE /v1/auth/tokens/{id}. После
отзыва замените учетные данные во всех клиентах, где они были настроены.