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

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

## Создание токена[​](#create-a-token "Прямая ссылка на Создание токена")

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

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

## Выбор прав[​](#choose-a-scope "Прямая ссылка на Выбор прав")

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

Права *Только чтение* разрешают `GET`, `HEAD` и `OPTIONS` на маршрутах под общим промежуточным обработчиком аутентификации REST; остальные методы там отклоняются. В MCP управления платформой такой клиент не видит инструменты записи, а их прямой вызов блокируется.

Исключение для хранилища

`/v1/storage/*` использует отдельный путь аутентификации для учетных данных песочницы. Сейчас этот путь принимает обычный персональный токен как токен для чтения и записи без применения общей проверки методов REST. Не полагайтесь на персональный токен с правами `read_only` для запрета изменений хранилища; для клиента хранилища, которому режим только чтения обеспечен технически, используйте доступ к хранилищу, выданный песочнице, со значением `ro`.

Права токена являются границей возможностей в охваченных частях REST и MCP, а не только подсказкой в интерфейсе. Передавайте токен только тем программам и людям, которым можно доверить доступное ему чтение.

## Использование[​](#use-the-token "Прямая ссылка на Использование")

Добавляйте заголовок к REST-запросам:

```
Authorization: Bearer your-personal-access-token
```

Тот же заголовок с bearer-токеном используется на эндпоинте MCP:

```
https://your-just-run-host/mcp
```

Храните персональный токен в менеджере секретов или защищенном окружении клиента. Не помещайте его в `.mcp.json`, который хранится в репозитории, в исходный код, логи, URL и вывод примеров.

## Отзыв[​](#revoke-a-token "Прямая ссылка на Отзыв")

В разделе *Токены* нажмите значок корзины (*Отозвать токен*) у активного токена и подтвердите. API-клиенты могут вызвать `DELETE /v1/auth/tokens/{id}`. После отзыва замените учетные данные во всех клиентах, где они были настроены.

## См. также[​](#related "Прямая ссылка на См. также")

* [Основы работы с API](/developers/api-fundamentals.md)
* [Быстрый старт с API](/getting-started/api.md)
* [Быстрый старт для AI-агента](/getting-started/ai-agent.md)
* [Контекст аккаунта](/accounts/account-context)
