Перейти к основному содержимому
Открыть Markdown

Персональные токены

Персональный токен (PAT) — bearer-токен для скриптов, CI и MCP-клиентов. Он связан с пользователем и контекстом аккаунта, может иметь срок действия и работает до истечения срока или отзыва.

Создание токена​

  1. Откройте Токены в дашборде.
  2. Нажмите Новый токен.
  3. Введите в поле Название понятное имя и при необходимости выберите Срок действия.
  4. В поле Права выберите Полные или Только чтение.
  5. Нажмите Создать токен и сразу сохраните открытое значение.

Открытое значение возвращается только при создании. Список токенов показывает имя, права, даты и статус, но не секрет.

Выбор прав​

Права Полные используются по умолчанию и разрешают чтение и изменения, доступные клиенту. Они нужны для создания, выполнения, обновления и удаления.

Права Только чтение разрешают 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}. После отзыва замените учетные данные во всех клиентах, где они были настроены.