Пропустите установку. Заработает меньше чем за 2 минуты.
Начните бесплатный период на cloud.anythingmcp.com, добавьте Yandex Direct одним кликом и направьте свой ИИ-клиент (Claude, ChatGPT, Copilot или Cursor) на сгенерированный MCP-эндпоинт. Без Docker, без git clone, без опыта разработки.
AnythingMCP есть в каталоге коннекторов Claude: добавьте его в Claude в один клик (откроется в новой вкладке), затем войдите и выберите, какие MCP-серверы может использовать Claude.
Кратко
Пусть ваш ИИ анализирует рекламу в Яндекс Директе в режиме только чтения: кампании, группы объявлений, объявления, ключевые фразы и ставки, быстрые ссылки и уточнения, клиенты агентства, справочники, отслеживание изменений и отчёты статистики по дням, кампаниям, объявлениям или поисковым запросам.
Попробуй спросить
Примеры промптов для Yandex Direct
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Yandex Direct, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
Yandex Direct + Claude
Пусть ваш ИИ анализирует рекламу в Яндекс Директе в режиме только чтения: кампании, группы объявлений, объявления, ключевые фразы и ставки, быстрые ссылки и уточнения, клиенты агентства, справочники, отслеживание изменений и отчёты статистики по дням, кампаниям, объявлениям или поисковым запросам.
Предварительные требования
Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:
YANDEX_DIRECT_TOKEN
Шаг 1 — Получите учётные данные
Настройка занимает около 10 минут, плюс время, которое Яндексу нужно на одобрение доступа к API (от часа до нескольких рабочих дней). Нужен аккаунт Яндекс Директа хотя бы с одной кампанией и собственное приложение, зарегистрированное на oauth.yandex.ru.
- Зарегистрируйте приложение на oauth.yandex.ru: платформа веб-сервисы, с правом доступа к Yandex Direct API (
direct:api). Запишите его ClientID. - В веб-интерфейсе Директа откройте Инструменты → API, подайте заявку на доступ к API для этого ClientID и примите пользовательское соглашение API. Пока Яндекс не одобрит заявку, вызовы завершаются ошибкой 58.
- Войдя под аккаунтом Директа, откройте
https://oauth.yandex.ru/authorize?response_type=token&client_id=<ClientID>со своим ClientID и скопируйтеaccess_token(начинается с y0_) вYANDEX_DIRECT_TOKEN, без Bearer или OAuth в начале. Токен действует около года и продлевается, пока им пользуются. - Только для агентств: укажите в
YANDEX_DIRECT_CLIENT_LOGINлогин рекламодателя в Яндексе, данные которого нужно читать; список логинов даётyandex_direct_list_agency_clients. Для собственного аккаунта оставьте поле пустым. - Установите коннектор и запустите
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 — Добавьте коннектор в Claude
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Рекомендуемый путь: работает в claude.ai web без редактирования конфигурационных файлов.
- Открой в Claude Customize → Connectors.
- Нажми +, затем Add custom connector.
- Введи название, например
Yandex Direct, и URL удалённого MCP-сервераhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, затем нажми Add. - Нажми Connect и войди в AnythingMCP (OAuth), чтобы разрешить доступ.
Все инструменты ниже появятся в чате: начинайте писать промпты.
Доступные инструменты
| Tool | What it does |
|---|---|
yandex_direct_get_client | Read the advertiser account the token acts for (or the Client-Login one): ClientId, Login, ClientInfo (name), Currency, CountryId, Type… |
yandex_direct_list_campaigns | List campaigns: Id, Name, Type (TEXT_CAMPAIGN, UNIFIED_CAMPAIGN, SMART_CAMPAIGN, MOBILE_APP_CAMPAIGN, CPM_BANNER_CAMPAIGN ...), Status… |
yandex_direct_list_ad_groups | List ad groups of up to 10 campaigns (or by id): Id, Name, CampaignId, Type, Status, ServingStatus, RegionIds, NegativeKeywords… |
yandex_direct_list_ads | List ads of up to 10 campaigns, up to 1000 ad groups, or by id: Id, CampaignId, AdGroupId, Type, Status, State, StatusClarification, and… |
yandex_direct_list_keywords | List keywords and autotargeting of up to 10 campaigns, up to 1000 ad groups, or by id: Id, Keyword, State, Status, ServingStatus… |
yandex_direct_list_keyword_bids | Read keyword bids with the auction picture: for each keyword the search and network bid and, on search, the bids and traffic volume needed… |
yandex_direct_list_sitelinks | Read sitelink sets by id (SitelinkSetId from yandex_direct_list_ads): each sitelink's Title, Href and Description |
yandex_direct_list_ad_extensions | List ad extensions (callouts) of the account: Id, Type, Status, Associated and the callout text |
yandex_direct_list_negative_keyword_sets | Read shared negative keyword sets by id (NegativeKeywordSharedSetIds of campaigns and ad groups): Id, Name, NegativeKeywords, Associated |
yandex_direct_list_retargeting_lists | List retargeting and audience lists: Id, Name, Type, Description, Rules (Metrica goals and segments), IsAvailable, Scope |
yandex_direct_list_agency_clients | For agency accounts: list the agency's advertisers with Login, ClientId, ClientInfo, Currency and Archived |
yandex_direct_get_dictionaries | Read reference dictionaries: Currencies (with bid limits), GeoRegions (region ids used in RegionIds), TimeZones, Constants, AdCategories… |
yandex_direct_check_campaign_changes | Which campaigns changed since a moment: for each changed campaign, whether the campaign itself (SELF), its groups, ads or keywords… |
yandex_direct_get_report | Run a statistics report (Reports service) and return it as tab-separated text: a column header row, one row per line, money as decimals in… |
Примеры запросов
- «Как отработали мои кампании на прошлой неделе? Покажи показы, клики, CTR, расход и конверсии по каждой кампании.»
- «Какие поисковые запросы за последние 30 дней потратили больше всего, но не дали ни одной конверсии?»
- «Выведи ключевые фразы кампании Зимние шины со ставками и подскажи, какая ставка нужна, чтобы попасть на верхние позиции.»
- «Какие мои объявления сейчас отклонены модерацией или не показываются, и почему?»
- «Мы агентство: выведи список наших клиентов и покажи вчерашний расход клиента romashka-shop.»
FAQ
Работает ли с Claude Code так же как с Claude Desktop? Да, оба указывайте на https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Следующие шаги
- Страница коннектора
- Подключить к ChatGPT
- Подключить к Cursor
- Подключить к Gemini
- Подключить к Meta Muse
Это руководство помогло?
