Как подключить Yandex Direct к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Yandex Direct, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Yandex Direct + Gemini

Пусть ваш ИИ анализирует рекламу в Яндекс Директе в режиме только чтения: кампании, группы объявлений, объявления, ключевые фразы и ставки, быстрые ссылки и уточнения, клиенты агентства, справочники, отслеживание изменений и отчёты статистики по дням, кампаниям, объявлениям или поисковым запросам.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

YANDEX_DIRECT_TOKEN

Шаг 1 — Получите учётные данные

Настройка занимает около 10 минут, плюс время, которое Яндексу нужно на одобрение доступа к API (от часа до нескольких рабочих дней). Нужен аккаунт Яндекс Директа хотя бы с одной кампанией и собственное приложение, зарегистрированное на oauth.yandex.ru.

1. Зарегистрируйте приложение на oauth.yandex.ru: платформа веб-сервисы, с правом доступа к Yandex Direct API (direct:api). Запишите его ClientID.
2. В веб-интерфейсе Директа откройте Инструменты → API, подайте заявку на доступ к API для этого ClientID и примите пользовательское соглашение API. Пока Яндекс не одобрит заявку, вызовы завершаются ошибкой 58.
3. Войдя под аккаунтом Директа, откройте https://oauth.yandex.ru/authorize?response_type=token&client_id=<ClientID> со своим ClientID и скопируйте access_token (начинается с y0_) в YANDEX_DIRECT_TOKEN, без Bearer или OAuth в начале. Токен действует около года и продлевается, пока им пользуются.
4. Только для агентств: укажите в YANDEX_DIRECT_CLIENT_LOGIN логин рекламодателя в Яндексе, данные которого нужно читать; список логинов даёт yandex_direct_list_agency_clients. Для собственного аккаунта оставьте поле пустым.
5. Установите коннектор и запустите yandex_direct_get_client: он покажет аккаунт, его логин и валюту.

Что он читает: кампании с типом, статусом, состоянием, датами, средствами и кликами и показами за всё время, а также стратегией показов; группы объявлений с регионами и минус-фразами; объявления с заголовком, текстом и ссылкой; ключевые фразы и автотаргетинг со ставками и продуктивностью; ставки по ключевым фразам со ставками и трафиком, нужными для каждой позиции в поиске; быстрые ссылки, уточнения, общие наборы минус-фраз и условия ретаргетинга; клиентов агентства; справочники, например валюты и регионы; какие кампании изменились с заданного момента; и отчёты статистики по дням, кампаниям, объявлениям или поисковым запросам.

Отчёты: yandex_direct_get_report возвращает текст с разделителями-табуляциями: в первой строке названия столбцов, суммы в виде десятичных чисел. Небольшие отчёты приходят сразу. Крупные формируются в офлайн-режиме: ИИ запрашивает их повторно с теми же параметрами после паузы, которую называет Яндекс. В очереди может быть не больше 5 офлайн-отчётов, а отчёты по поисковым запросам строятся только офлайн и охватывают последние 180 дней.

Суммы и постраничный вывод: ставки, бюджеты и средства приходят целыми числами в микроединицах (2500000 = 2,50 в валюте аккаунта). Списки возвращают по умолчанию до 500 объектов и не больше 10 000, а группы, объявления и ключевые фразы читаются максимум для 10 кампаний за один вызов.

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

Ограничения: каждый вызов расходует баллы API из суточного лимита рекламодателя, а неудачный вызов стоит 20 баллов. ИИ предпочитает один вызов с несколькими ID множеству отдельных и запрашивает только нужные поля. Ошибка 152 означает, что баллы на сегодня закончились; 506 означает слишком много одновременных запросов.

Частые ошибки: 53 означает, что токен недействителен или истёк: получите новый, как в шаге 3. 58 означает, что доступ приложения к API ещё не одобрен. 54, 3000 или 3001 означают, что нет доступа к API или прав, например на логин клиента, который этому токену недоступен. 513 означает, что логин не подключён к Директу. 8000 и с 4000 по 4006 означают неверный параметр, 8800 означает, что объект не найден, а 9300 означает слишком много ID в одном вызове.

Коннектор не создаёт и не редактирует кампании, объявления, ключевые фразы и ставки, не занимается модерацией, бюджетами и платежами и не работает с Песочницей и Wordstat.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Yandex Direct.

Доступные инструменты

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

• «Как отработали мои кампании на прошлой неделе? Покажи показы, клики, CTR, расход и конверсии по каждой кампании.»
• «Какие поисковые запросы за последние 30 дней потратили больше всего, но не дали ни одной конверсии?»
• «Выведи ключевые фразы кампании Зимние шины со ставками и подскажи, какая ставка нужна, чтобы попасть на верхние позиции.»
• «Какие мои объявления сейчас отклонены модерацией или не показываются, и почему?»
• «Мы агентство: выведи список наших клиентов и покажи вчерашний расход клиента romashka-shop.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT