Подключить OTTO MCP к Microsoft Copilot

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

OTTO Sponsored Product Ads + Microsoft Copilot

Sponsored Product Ads на OTTO Market: кампании, рекламируемые SKU (таргеты), ключевые слова и ставки, а также отчётность SPA (KPI по кампаниям и товарам, CSV-отчёты) для рекламодателей на otto.de. OAuth 2.0 client credentials с рекламным scope.

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

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

OTTO_ADS_CLIENT_ID, OTTO_ADS_CLIENT_SECRET

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

Настройка занимает около 5 минут. Нужен партнёрский аккаунт OTTO Market, в котором подключены Sponsored Product Ads, и приложение в OTTO Partner Connect. Входа от имени пользователя нет: коннектор работает с client credentials.

1. В OTTO Partner Connect создайте приложение для своего аккаунта (или откройте то, которое уже используете для Partner API) и включите интерфейсы Sponsored Product Ads.
2. Скопируйте client id и client secret приложения. Secret показывается только один раз, при создании; если его больше нет, перевыпустите его в OTTO Partner Connect.
3. Вставьте client id в OTTO_ADS_CLIENT_ID, а secret в OTTO_ADS_CLIENT_SECRET. AnythingMCP выполняет поток client credentials OTTO со scope advertising-services; токен действует 30 минут и запрашивается заново, когда истекает.
4. Установите коннектор и запустите otto_ads_list_campaigns: он покажет ваши кампании со статусом, типом и бюджетом.

Отдельно от коннектора OTTO Market: у Sponsored Product Ads свой OAuth-scope. Заказы, товары, остатки и возвраты остаются в коннекторе OTTO Market, а благодаря разделению приложение без рекламного интерфейса продолжает там работать.

Что он читает: кампании со статусом, типом (AUTOMATIC или MANUAL), бюджетом, типом бюджета, пейсингом и датами; рекламируемые SKU (таргеты) со ставками; ключевые слова каждого таргета с типом соответствия, признаком позитивное или негативное и ставкой; KPI по кампании и по SKU (показы, клики, расходы, атрибутированные продажи, заказанные SKU, CTR, цена клика и окупаемость рекламных расходов); и CSV-отчёты по кампаниям, по ключевым словам (с поисковым запросом, который покупатель действительно ввёл) и по товарам.

Суммы в евроцентах: бюджеты, ставки и расходы приходят в виде {"amount": 160, "currency": "EUR"}, то есть 1,60 евро. Минимальная ставка и бюджет: 20 (0,20 евро). Столбцы отчётов TOTAL_COSTS и TOTAL_SALES тоже в центах.

Ставки в двух местах: кампании AUTOMATIC делают ставки на таргет (SKU), кампании MANUAL на позитивное ключевое слово. Негативные ключевые слова (без ставки) работают в обоих типах и относятся к одному таргету: чтобы исключить запрос для всей кампании, ИИ добавляет его к каждому таргету.

Отчётность: KPI охватывают не более последних 90 дней и никогда не включают сегодняшний день; без дат OTTO берёт последние 7 дней. OTTO атрибутирует продажи до 14 дней после клика, включая другие товары того же бренда, поэтому данные за последние дни ещё меняются. CSV-отчёт ИИ запрашивает, проверяет через otto_ads_get_report_status, пока он не станет READY, и скачивает через otto_ads_download_report. Файл хранится 24 часа. Запрос отчёта не меняет ни одной кампании.

Спрашивает перед каждым изменением: otto_ads_create_campaign, otto_ads_update_campaign, otto_ads_add_targets, otto_ads_update_target_bids, otto_ads_add_keywords и otto_ads_update_keywords меняют работающую рекламу и тратят деньги. ИИ показывает кампанию, таргет или ключевое слово и сумму в евро, подтверждает её с вами и ждёт вашего согласия. Записи асинхронные: OTTO отвечает запросом на изменение, и ИИ отслеживает его через otto_ads_get_change_request, пока он не станет ACCEPTED или REJECTED (с причиной).

Отключено при установке: otto_ads_delete_keywords. Он удаляет от 1 до 50 ключевых слов таргета, и это нельзя отменить; снизить ставку часто разумнее. Администратор может включить его осознанно.

Ограничения: OTTO разрешает не более 200 отчётов за 24 часа по всем типам отчётов, хотя отчёт ничего не меняет. Для одной кампании одновременно может ожидать только один запрос на изменение. Списки приходят страницами до 1000 записей, по которым ИИ проходит с помощью nextCursor. Проверяя запрос на изменение, ИИ каждый раз ждёт немного дольше (1, 2, 4 секунды), чтобы избежать 429.

Частые ошибки: если токен отклонён, неверны client id или secret либо в приложении не включён интерфейс Sponsored Product Ads: проверьте приложение в OTTO Partner Connect. 409 означает, что другое изменение той же кампании ещё не обработано. Отказ вроде «Invalid status transition PAUSED to PAUSED» означает, что у кампании уже этот статус. 404 «Data not found» в KPI означает, что у кампании не было показов за период; при скачивании 404 означает, что отчёт ещё не готов, а 410, что срок его хранения истёк.

Коннектор не читает заказы, товары, остатки и возвраты (для этого есть коннектор OTTO Market), не показывает данные за сегодня и старше 90 дней и не удаляет кампании и таргеты.

Шаг 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 поддерживает.

1. В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
2. Укажи Server name (например, AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер.
3. В аутентификации выбери API key, установи Type в Header, укажи имя заголовка X-API-Key и нажми Create.
4. В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
5. Проверь в панели Test агента: попроси о том, для чего нужны инструменты OTTO Sponsored Product Ads.
6. Нажми 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 не подойдёт.

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

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

• «Какая из моих кампаний на OTTO дала лучшую окупаемость рекламы за последние 30 дней и сколько стоила каждая в евро?»
• «Поставь на паузу кампанию Gartenmöbel Sommer. Сначала проверь её текущий статус и сообщи, когда OTTO примет изменение.»
• «Подними ставку для SKU BL-4711 в моей автоматической кампании Bettwäsche до 0,80 евро. Покажи старую и новую ставку, прежде чем менять.»
• «Запроси отчёт по ключевым словам за последние 30 дней и перечисли поисковые запросы, которые стоили денег, но ничего не продали, как кандидатов в негативные ключевые слова.»
• «Создай автоматическую кампанию Winterjacken с дневным бюджетом 25 евро и равномерным расходом, со старта в следующий понедельник, и добавь SKU JK-100 и JK-200 со ставкой 0,50 евро для каждого.»

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