Как подключить Claude к Яндекс Директу через MCP

Кому это нужно

Я пишу для директолога и performance-маркетолога, который уже ведёт Директ и устал от утреннего ритуала: выгрузить → свести → спросить у коллеги «где съели бюджет».

Типичная боль одна:

• цифры есть в кабинете Директа;
• ответа «что с этим делать сегодня» нет, пока не сделали сводную;
• Claude без доступа к аккаунту отвечает абстрактно — он не видит ваши кампании.

Вывод. Подключение нужно не «ради ИИ», а ради цикла: вопрос → актуальные данные → решение по кампаниям, ключам или CPA — без Excel как обязательного посредника.

Я не обещаю здесь «настроим Директ за вас» как агентство. Разбираю, как устроен безопасный доступ и что проверить после подключения.

Что такое MCP простыми словами

MCP (Model Context Protocol) — открытый протокол, по которому AI-клиент получает набор инструментов: «запросить кампании», «снять статистику», «показать ключи». Модель сама выбирает метод и аргументы, затем формулирует ответ по фактам.

Без MCP:

• вы копируете таблицы в чат;
• или просите AI «посоветовать вообще».

С MCP:

• вы спрашиваете обычным языком;
• клиент вызывает методы на вашем сервере;
• в ответ приходят данные Директа, а не догадки.

Коротко: MCP — это мост между диалогом и API, а не «магический доступ к паролю Яндекса».

Чем это отличается от Excel и BI

Вывод. Excel и BI никуда не исчезают. Меняется первый слой: быстрый разбор «что сейчас с кампаниями» можно сделать в диалоге. Автоматической сквозной сверки Директ↔Метрика «как в BI» нет — это ограничение модели доступа, а не «баг» инструкции.

Что подготовить до подключения

До кликов в кабинете зафиксируйте три вещи.

1. Доступ к логинам Директа. Нужен Яндекс ID с правами на те рекламные логины, которые вы хотите видеть в ответах AI.
2. Сервер и роль программиста. На запуск и сопровождение сервера с MCP обычно нужен программист. Маркетолог потом работает в личном кабинете и задаёт вопросы AI — без ежедневной возни с API.
3. AI-клиент. Claude, ChatGPT или Cursor — тот, которым реально пользуется команда. Один адрес подключения обслуживает включённые источники данных.

Рекомендация. Не начинайте с «какой Skill купить». Сначала доступ и чтение данных. Сценарии вопросов и Skill — отдельная тема; здесь только подключение.

Безопасность: 152-ФЗ и где лежат ключи

Когда AI смотрит рекламную статистику, всплывает вопрос про персональные данные и контроль доступа. В типичной схеме MCP это закрыто так:

• OAuth-токены Яндекс ID хранятся на вашем сервере, в зашифрованном виде;
• AI-клиент получает MCP URL и токен доступа к MCP, не пароль от Яндекса;
• каждый запрос к Direct API фиксируется в журнале.

152-ФЗ здесь не «галочка в баннере», а требование контролировать, где лежат ключи и кто что запрашивал. Вывод: безопаснее отдавать AI адрес MCP на своей инфраструктуре, чем выгружать сырые таблицы в чужой чат без следа.

Write-методы (изменение кампаний, ставок) по умолчанию выключены. AI читает. Менять может только если вы явно включите запись — и это уже отдельное управленческое решение.

Пошаговое подключение (~20 минут)

Ориентир первого подключения — около 20 минут.

1. OAuth Яндекс ID

В настройках авторизуйте аккаунт Яндекс ID с доступом к нужным логинам Директа.

2. Включите MCP-методы

Выберите, какие данные Директа доступны AI. По умолчанию — только чтение.

3. Скопируйте адрес в AI-клиент

Вставьте MCP URL в Claude, ChatGPT или Cursor.

4. Задайте первый вопрос

Например: список кампаний за период или расход и базовые KPI. Если ответ опирается на ваши данные, а не на общие советы — доступ работает.

Какие методы доступны

Для Директа доступны методы только на чтение (RO):

Ограничение. Я не добавляю «ещё методы с vc.ru / GitHub» — у разных MCP-серверов набор разный. Если метода нет в таблице выше, не считайте его частью этого контура подключения.

Несколько логинов Директа

Агентства и in-house команды часто ведут несколько рекламных логинов под одним Яндекс ID.

• Метод list_accounts возвращает доступные логины.
• Один MCP URL работает со всеми логинами, доступными авторизованному ID.
• В вопросе укажите нужный аккаунт — или попросите AI сначала показать список.

Вывод. Не плодите «по одному подключению на каждый логин», если доступ уже есть у одного Яндекс ID. Сначала list_accounts, потом точечные вопросы.

Как проверить, что подключение работает

После вставки URL сделайте короткий smoke-тест — не «стратегию на квартал», а проверку доступа.

Примеры вопросов (иллюстрация сценария, не KPI кейса):

• Покажи список кампаний и статусы.
• Какой расход и CTR по кампаниям за последние 7 дней?
• Какие ключи дают клики при слабой конверсии за период?
• Покажи объявления с худшей эффективностью в группе X.

Если AI отвечает таблицей/цифрами из вашего Директа — чтение работает. Если просит «пришлите выгрузку» — клиент не видит MCP или методы не включены.

Важно. Это статья про подключение. Отдельная идея «ИИ-аналитика Директа + Skill» (что спрашивать системно, какой Skill нужен) — другой материал. Здесь специально не разворачиваю методику аналитика.

Когда рядом Метрика и Roistat

Коротко по смыслу для директолога:

• Метрика не обязательна для базовых отчётов Директа (кампании, расход, ключи, объявления).
• Для разбора CPA по целям сайта удобно смотреть оба источника: Директ — расходы и клики, Метрика — достижения целей.
• Автоматической сквозной сверки «Директ ↔ Метрика как в BI» нет: AI сравнивает внутри каждого источника.

Roistat закрывает другую плоскость — сделки, ROI, коллтрекинг. Если боль именно в сквозной аналитике, см. соседнюю статью: Roistat MCP: как дать Claude доступ к сквозной аналитике.

В этой статье достаточно знать: Директ можно подключить без Roistat и без обязательной Метрики.

Ограничения: чего не ждать от подключения

1. Не BI под ключ. Нет обещания автоматической сверки расходов Директа с целями Метрики «как в дашборде».
2. Не агент, который сам крутит ставки. Запись выключена, пока вы сами её не включите.
3. Не замена директолога. AI ускоряет доступ к фактам; решение по бюджету и офферу остаётся за человеком.
4. Не «настроим Директ за вас». Я не продаю в этой статье агентское ведение кампаний.
5. Не полный каталог чужих MCP на GitHub. Ориентир — методы чтения в таблице выше.

Вывод. Подключение решает доступ. Качество решений зависит от ваших процессов, целей и дисциплины вопросов.

FAQ

Что такое MCP Яндекс Директ?

MCP-коннектор, который даёт Claude, ChatGPT или Cursor доступ на чтение к кампаниям, ставкам и отчётам Директа через ваш сервер — без обязательных выгрузок в Excel.

Как подключить Яндекс Директ к Claude или ChatGPT?

Авторизуйте Яндекс ID с доступом к Директу, включите MCP-методы (по умолчанию чтение), скопируйте MCP URL в AI-клиент. Ориентир первого подключения — около 20 минут.

AI может менять ставки и кампании?

По умолчанию нет — только чтение. Write-методы включаются явно, если это нужно вам осознанно.

Нужна ли Метрика для работы с Директом?

Нет для базовых отчётов. Для анализа CPA по целям сайта удобно смотреть оба источника. Автосверки «как в BI» нет.

Можно ли подключить несколько аккаунтов Директа?

Да. list_accounts показывает логины, доступные авторизованному Яндекс ID. Один MCP URL обслуживает все доступные логины — укажите нужный в вопросе.

Где хранятся OAuth-токены Яндекс ID?

На вашем сервере, в зашифрованном виде. AI получает MCP URL и доступ к MCP, не пароль от Яндекса.

Кто отвечает за сервер?

Программист — за запуск и сопровождение. Маркетологи работают с вопросами к AI и настройками доступа в кабинете.

Чем это отличается от Skill для анализа Директа?

Подключение = доступ к данным. Skill / сценарии вопросов = методика «что спрашивать и в каком порядке». Это разные статьи; здесь только инструкция по подключению.

Что делать дальше

Если цель — понять, нужен ли вам вообще контур AI + реклама + аналитика и где узкое место в маркетинге, маршрут такой (актуально на cheremisina.online/uslugi, проверка 15.09.2026):

1. Бесплатная 20-минутная Zoom-диагностика — зафиксируем задачу и зрелость процессов.
2. Если запрос уже ясный — стратегическая консультация, 25 000 ₽ (1 час, разбор и план).
3. Если непонятно, где теряются деньги и с чего чинить систему — полный аудит маркетинга, 100 000 ₽ / 14 рабочих дней.

Если вы уже подключены и хотите системно разобрать «что спрашивать агента» — это следующий материал, отдельно от инструкции по подключению.