Как подключить OTTO Sponsored Product Ads к Gemini через MCP

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

OTTO Sponsored Product Ads + Gemini

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 — Добавьте коннектор в 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 теперь может вызывать инструменты OTTO Sponsored Product Ads.

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

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

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

FAQ

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

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

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