Ozon Performance MCP: подключить к Cursor

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

Ozon Performance (Ads) + Cursor

Ozon Performance API для рекламного кабинета продавца: кампании с оплатой за клик и за заказ и баннерные кампании, их товары и ставки, конкурентные ставки и лимиты ставок, дневная статистика и статистика расходов, подробные отчёты по кампаниям. Остановка кампаний и изменение ставок. Один client ID и client secret сервисного аккаунта.

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

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

OZON_PERFORMANCE_CLIENT_ID, OZON_PERFORMANCE_CLIENT_SECRET

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

Настройка занимает около 3 минут. Нужен аккаунт продавца Ozon с рекламным кабинетом (Ozon Performance), в котором вы создаёте сервисный аккаунт и ключ к нему.

1. В личном кабинете продавца Ozon откройте Настройки → API-ключи → Performance API (seller.ozon.ru/app/settings/api-keys?currentTab=performanceApi).
2. Если сервисного аккаунта ещё нет, создайте его. Нажмите на название сервисного аккаунта и добавьте новый ключ.
3. Скопируйте client ID в OZON_PERFORMANCE_CLIENT_ID: он заканчивается на @advertising.performance.ozon.ru, поэтому вставляйте его целиком. Client secret, который показывается вместе с client ID при добавлении ключа, скопируйте в OZON_PERFORMANCE_CLIENT_SECRET. Если secret потерян, добавьте новый ключ.
4. Установите коннектор и проверьте подключение через ozon_performance_list_campaigns (без аргументов): он выводит ваши кампании с id, которые нужны всем остальным инструментам.

Отдельно от коннектора Ozon Seller: этот коннектор работает только с рекламным кабинетом и использует собственные учётные данные, ключ Seller API здесь не нужен. Для заказов, товаров, остатков и цен используйте коннектор Ozon Seller.

Cloud и self-hosting работают одинаково: вы вводите те же два значения, а Redirect URL настраивать не нужно.

Токены обновляются сами: коннектор обменивает client ID и secret через POST /api/client/token (grant type client_credentials) на bearer-токен, который действует 30 минут, и получает новый до истечения срока или после ответа 401. 401 при получении токена означает, что client ID или secret неверны либо ключ удалён: скопируйте оба значения заново или добавьте сервисному аккаунту новый ключ. 403 означает, что у сервисного аккаунта нет доступа к этому методу или кампании.

Типы кампаний: SKU — оплата за клик, SEARCH_PROMO — оплата за заказ, а также BANNER и VIDEO_BANNER. Товары кампании с оплатой за клик и их ставки отдаёт ozon_performance_list_campaign_products, товары в продвижении с оплатой за заказ — ozon_performance_list_cpo_products.

Быстрая статистика: ozon_performance_get_daily_statistics, ozon_performance_get_expense_statistics и ozon_performance_get_cpc_campaign_statistics сразу отвечают строками JSON. Без дат они охватывают последние 7 дней. Даты указываются днями (2026-10-01), Ozon группирует их по московскому времени. ozon_performance_get_cpc_campaign_statistics не расходует лимиты на отчёты.

Подробные отчёты формируются асинхронно: ozon_performance_request_campaign_report заказывает отчёт по товарам максимум для 10 кампаний за период не больше 62 дней с группировкой по дням, неделям или месяцам и возвращает UUID. ИИ каждые несколько секунд проверяет ozon_performance_get_report_status, пока state не станет OK (или ERROR), а затем забирает отчёт через ozon_performance_download_report: CSV-текст (разделитель точка с запятой, названия столбцов на русском) для одной кампании, ZIP-файл с отдельным CSV на каждую кампанию для нескольких. В одном аккаунте одновременно формируется только один отчёт, и не больше 2000 в день; ozon_performance_list_api_reports находит заказанные ранее отчёты. ozon_performance_request_search_phrases_report работает так же для поисковых фраз вывода в топ; Ozon помечает этот метод как тестируемый.

Деньги и id: бюджеты кампаний указываются в миллионных долях рубля (1000000 = 1 рубль); лимиты ставок из ozon_performance_get_bid_limits — в рублях; ставки с оплатой за заказ — в процентах от цены товара. Id — строки из цифр.

Изменение ставок: ozon_performance_update_campaign_bids меняет ставки товаров, которые уже есть в кампании с оплатой за клик, и Ozon заменяет стоп-слова и ставки по фразам кампании тем, что отправлено. ozon_performance_add_campaign_products добавляет не больше 500 товаров в кампанию; в кампанию с автоматической стратегией — только товары её категории автопилота. Ставка за клик действует только при стратегии средней стоимости клика и указывается в тех же единицах, что и текущие ставки, которые читает коннектор; без неё Ozon ставит конкурентную ставку.

Лимиты запросов: не больше 100 000 запросов в день на аккаунт, плюс лимиты на изменения кампаний (например, 500 изменений бюджета или стратегии на кампанию в день) и на отчёты. При ответе 429 подождите и повторите позже.

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

Отключено при установке: ozon_performance_activate_campaign и ozon_performance_remove_campaign_products. Первый запускает кампанию, после чего она показывает рекламу и тратит бюджет; второй убирает товары из кампании с оплатой за клик, и их ставки теряются. Включайте на странице коннектора только нужные; перед каждым изменением ИИ спрашивает ваше подтверждение. ozon_performance_deactivate_campaign, ozon_performance_add_campaign_products и ozon_performance_update_campaign_bids включены: они останавливают кампанию, добавляют товары в кампанию с оплатой за клик и меняют её ставки, а значит, и расходы, всегда после того, как ИИ точно показал вам, что изменится.

Не поддерживается: создание и копирование кампаний, бюджеты и стратегии, изменение ставок с оплатой за заказ, статистика баннеров и видео, отчёты по атрибуции заказов и аналитика внешнего трафика.

Шаг 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 — Добавьте коннектор в Cursor

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

Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начинай общаться: агент теперь может вызывать инструменты Ozon Performance (Ads).

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

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

• «Какие из моих рекламных кампаний на Ozon сейчас запущены и какой у них дневной бюджет?»
• «Сколько каждая кампания тратила в день на прошлой неделе и сколько из этого оплачено бонусами?»
• «Сравните текущие ставки в моей кампании с оплатой за клик с конкурентными ставками на те же SKU.»
• «Закажите подробный отчёт по товарам для моих кампаний с оплатой за клик за октябрь с группировкой по неделям и кратко изложите его.»
• «У каких товаров в продвижении с оплатой за заказ самая высокая ставка в процентах от цены и сколько показов у них было на этой неделе?»

FAQ

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да — MCP доступен на тарифах Hobby, Pro и Business.

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

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