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

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

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

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

> Я хочу проверить статус подключения к Метрике.

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

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

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

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

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

## Что вернёт

Возвращает компактный JSON-ответ исходного API или понятную ошибку MCP-инструмента. Точный состав полей зависит от операции и описан в техническом справочнике.

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

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

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

> Проверить статус подключения к Метрике в Яндекс Метрике. Если не хватает обязательных идентификаторов, сначала уточни их.

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

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

Доступ также зависит от прав токена, квот и ограничений исходного API.

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

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

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

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