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

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

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

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

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

Показывает, есть ли токен доступа, откуда он взят — переменная окружения `YANDEX_MERCHANTS_OAUTH_TOKEN` или сохранённый вход из диалога, — когда истекает сохранённый токен и где лежит файл с сохранёнными данными.

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

Используйте эту возможность, когда инструменты Яндекс Товаров отвечают, что подключение не настроено, или когда нужно понять, каким токеном пользуется сервер. Живую проверку доступа к API выполняет [check_access](./check-access.md).

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

Параметры не нужны.

## Что вернёт

Компактный JSON: `configured` (подключено или нет), `source` (`env` или `stored`), даты получения и истечения сохранённого токена, `canRefresh` и путь к файлу `credentials.json`. Сам токен в ответ не попадает.

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

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

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

> Покажи статус подключения к Яндекс Товарам.

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

Инструмент не проверяет токен живым запросом — токен может числиться подключённым, но быть отозванным в Яндекс ID. Для живой проверки используйте `check_access`.

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

- [Начать подключение Яндекс Товаров](./start-login.md) — `start_login`
- [Отключить Яндекс Товары](./logout.md) — `logout`
- [Проверка токена и доступа](./check-access.md) — `check_access`

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

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