Яндекс Директ: Завершить подключение — MCP-инструмент (tool)
MCP-инструмент (tool) для Яндекс Директа: Завершает подключение из диалога — обменивает код подтверждения на токен доступа и сохраняет его на диске только для владельца.
Техническое имя: finish_login
Какую задачу решает
Я хочу завершить вход в Яндекс Директ кодом подтверждения и сразу пользоваться инструментами.
Второй шаг входа: инструмент обменивает код подтверждения из start_login на токен доступа (без секрета приложения — подлинность подтверждает PKCE), сохраняет токен в файл с правами только для владельца (0600) и сразу проверяет подключение живым запросом к Директу.
Когда использовать
Используйте эту возможность сразу после того, как пользователь открыл ссылку из start_login, подтвердил доступ и прислал код подтверждения. Код одноразовый и живёт 10 минут.
Что нужно передать
code— код подтверждения, который Яндекс показал пользователю после входа.
Что вернёт
connected: true, логин подключённого аккаунта (accountLogin), путь к файлу с сохранёнными данными и заметку с советом проверить, что это нужный кабинет. После успеха остальные инструменты работают немедленно — перезапускать клиент не нужно.
Что изменится в Яндекс Директе
В рекламном кабинете ничего не меняется. На локальном диске появляется (или перезаписывается) файл credentials.json с токеном доступа; проверочный запрос только читает данные аккаунта.
Пример запроса
Вот код подтверждения: 1234567. Заверши подключение Яндекс Директа.
Возможные ошибки и ограничения
Если код не принят (истёк или уже использован), вызовите start_login заново и попросите свежий код. Если проверочный запрос показал не тот логин — вход выполнен под другим аккаунтом Яндекса: повторите start_login под нужным. Токен из переменной окружения YANDEX_DIRECT_TOKEN имеет приоритет над сохранённым входом.
Связанные MCP-инструменты
- Начать подключение —
start_login - Статус подключения —
auth_status - Отключить Директ —
logout
Технические сведения
- Воздействие: изменяет данные
- Группа: Подключение
- Источник описания: регистрация
finish_loginвsrc/tools/auth.ts - Полный технический справочник
- Все MCP-возможности