# Яндекс Аудитории: Статус подключения к Аудиториям — MCP-инструмент (tool)

**MCP-инструмент (tool) для Яндекс Аудиторий:** Показывает, подключены ли Яндекс Аудитории: есть ли токен, откуда он взят (переменная окружения YANDEX_AUDIENCE_TOKEN или сохранённый вход), когда истекает и где лежит файл с сохранёнными данными.

Техническое имя: `auth_status`

## Какую задачу решает

> Я хочу проверить, подключены ли Яндекс Аудитории.

Показывает, подключены ли Яндекс Аудитории: есть ли токен, откуда он взят (переменная окружения YANDEX_AUDIENCE_TOKEN или сохранённый вход из диалога), когда истекает и где лежит файл с сохранёнными данными.

## Когда использовать

Используйте эту возможность, когда инструменты Аудиторий отвечают, что подключение не настроено, или когда нужно понять, под каким источником токена работает сервер, прежде чем менять конфигурацию или переподключаться.

## Что нужно передать

Параметров нет — инструмент вызывается без входных данных.

## Что вернёт

Объект статуса: `configured` (подключены ли Аудитории), `source` (`env` — переменная окружения, `stored` — сохранённый вход из диалога), `expiresAt` и `obtainedAt` (для сохранённого входа), `canRefresh` (есть ли refresh-токен для автоматического продления) и `path` (где лежит файл с сохранёнными данными). Сам токен в ответе не показывается.

## Что изменится в Яндекс Аудиториях

Инструмент только читает данные или состояние подключения и не изменяет их. Ничего не отправляет в сеть.

## Пример запроса

> Проверь, подключены ли Яндекс Аудитории, и покажи, откуда взят токен.

## Возможные ошибки и ограничения

Инструмент не проверяет токен живым запросом к API: он показывает только локальное состояние. Токен со снятыми правами будет выглядеть подключённым до первого вызова инструмента данных.

## Связанные MCP-инструменты

- [Начать подключение Аудиторий](./start-login.md) — `start_login`
- [Завершить подключение Аудиторий](./finish-login.md) — `finish_login`
- [Отключить Аудитории](./logout.md) — `logout`

## Технические сведения

- **Воздействие:** только чтение
- **Группа:** Подключение
- **Источник описания:** регистрация `auth_status` в `src/tools/auth.ts`
- [Полный технический справочник](../TOOLS.md)
- [Все MCP-возможности](./index.md)