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

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

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

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

Я хочу проверить, подключён ли Яндекс Директ, и понять, откуда взят токен доступа.

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

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

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

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

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

Что вернёт

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

Что изменится в Яндекс Директе

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

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

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

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

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

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

• Начать подключение — start_login
• Завершить подключение — finish_login
• Отключить Директ — logout

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

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