Кратко
Пусть ваш ИИ анализирует рекламу в Яндекс Директе в режиме только чтения: кампании, группы объявлений, объявления, ключевые фразы и ставки, быстрые ссылки и уточнения, клиенты агентства, справочники, отслеживание изменений и отчёты статистики по дням, кампаниям, объявлениям или поисковым запросам.
Пошаговая настройка
Подключи Yandex Direct к Microsoft Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Yandex Direct в пошаговой настройке и добавь свой MCP URL в Microsoft Copilot. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для Yandex Direct
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Yandex Direct, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
Yandex Direct + Microsoft Copilot
Пусть ваш ИИ анализирует рекламу в Яндекс Директе в режиме только чтения: кампании, группы объявлений, объявления, ключевые фразы и ставки, быстрые ссылки и уточнения, клиенты агентства, справочники, отслеживание изменений и отчёты статистики по дням, кампаниям, объявлениям или поисковым запросам.
Предварительные требования
Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:
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 — Добавьте коннектор в Microsoft Copilot
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Microsoft Copilot использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь AnythingMCP в агента как инструмент, а затем публикуешь агента в Microsoft 365 Copilot и Teams. Copilot Studio подключается из облака Microsoft по Streamable HTTP, который AnythingMCP поддерживает.
- В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
- Укажи Server name (например,
AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер. - В аутентификации выбери API key, установи Type в Header, укажи имя заголовка
X-API-Keyи нажми Create. - В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
- Проверь в панели Test агента: попроси о том, для чего нужны инструменты
Yandex Direct. - Нажми Publish, затем Channels → Microsoft 365 and Microsoft Teams, оставь включённым Make agent available in Microsoft Copilot и нажми Add channel. See agent in Teams установит агента для тебя; в Microsoft 365 Copilot введи @ и выбери агента.
Хочешь, чтобы каждый входил под своей учётной записью? Вместо API-ключа выбери OAuth 2.0 → Dynamic discovery: каждый пользователь войдёт в AnythingMCP при первом вызове агентом.
Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Copilot Studio подключается из облака Microsoft, поэтому localhost не подойдёт.
Доступные инструменты
| 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
Для какого Copilot это руководство? Для Microsoft 365 Copilot на работе — через агентов Copilot Studio. В приложении Microsoft Copilot для личных аккаунтов добавить свой MCP-сервер нельзя.
Что нужно? Рабочий аккаунт с доступом к Copilot Studio (лицензия или пробная версия), чтобы создать агента. Тем, кто будет пользоваться им в Microsoft 365 Copilot или Teams, нужен доступ к агенту: поделись им или попроси администратора опубликовать его для организации. Если в организации действуют политики данных для коннекторов Power Platform, они распространяются и на MCP-серверы.
Агент не вызывает инструменты. Проверь, что имя заголовка — ровно X-API-Key, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.
Следующие шаги
- Страница коннектора
- Подключить к Claude
- Подключить к ChatGPT
- Подключить к Cursor
- Подключить к Gemini
- Подключить к Meta Muse
Это руководство помогло?