ozon-mcp-server

ozon-mcp-server — MCP-сервер сообщества (автор — DeviceIngineering). API Ozon Seller и Performance: 156 инструментов с сокращёнными ответами для экономии токенов. Ставится через uvx или через pip. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
DeviceIngineering
Лицензия
MIT
Транспорт
stdio, sse
Авторизация
api_key
ОС
Не указана
Языки
python

Уровень риска: high

Действует с ключами магазинов Ozon: меняет цены, акции, рекламные бюджеты, отменяет заказы и отвечает покупателям. Проверяйте изменения и закрывайте доступ `MCP_AUTH_TOKEN`.

Настройка клиентов

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"ozon\": {\n      \"url\": \"http://localhost:8000/sse\"\n    }\n  }\n}",
    "file": ".cursor/mcp.json",
    "lang": "json",
    "notes": "Дословно из docs/install-cursor.md, для Docker-варианта",
    "verified": "docs"
}

Что умеет

Ozon MCP Server позволяет управлять магазинами на Ozon прямо из чата с ИИ-ассистентом. Сервер даёт 156 инструментов поверх Ozon Seller API (каталог и операции) и Performance API (реклама). Он рассчитан на продавцов с несколькими магазинами: каждый вызов принимает shop_id, а ключи API хранятся в зашифрованном виде на вашем сервере. Автор пишет, что пользуется им ежедневно более пяти месяцев примерно на двадцати аккаунтах продавцов.

  • Акции и скидки (14): акции Ozon (список, кандидаты, участие и выход), собственные акции продавца, заявки покупателей на скидку.
  • Цены (14): установка цен и минимальной цены, индекс цен, автоматические стратегии с отслеживанием конкурентов.
  • Реклама (22): кампании «Трафареты», ставки и бюджеты, оплата за заказ, статистика по товарам и дням.
  • Товары (21): карточки, атрибуты, остатки, импорт и массовое обновление, медиа, архив.
  • Заказы FBS и FBO (17): неотгруженные заказы, сборка, этикетки, отмены, акты передачи.
  • Возвраты и отмены (10), отзывы, вопросы и чаты (13), склады и отчёты (8), финансы (7): баланс, транзакции, начисления, отчёт о реализации.
  • Аналитика (5): аналитика по SKU, остатки и оборачиваемость, позиции товаров в поиске Ozon, топ поисковых запросов.
  • Диагностика: самопроверка доступности API Ozon и детектор деградаций — сервер заранее показывает, какие методы Ozon сломались.

Для Wildberries у автора есть аналогичный сервер wb-mcp-server.

Кому подойдёт

  • Продавцам на Ozon с несколькими магазинами: цены, акции, заказы и отзывы в одном чате.
  • Специалистам по рекламе на маркетплейсе: расходы кампаний, ставки и остановка неэффективных кампаний.
  • Менеджерам по работе с отзывами: ответы на отзывы и вопросы покупателей.

Похожие серверы — в категории бизнес и 1С.

Установка

Самый простой способ — запуск по stdio одной командой:

uvx ozon-mcp-server

Также доступна установка через pip install ozon-mcp-server (команда ozon-mcp). Нужны Client-Id и ключ API продавца. В DATA_DIR укажите любую папку с правом записи: там хранятся магазины, ключи и статистика.

Вариант с Docker поднимает веб-панель на порту 8000: счётчики вызовов, ошибки, управление магазинами и ключами (/shops), диагностику API Ozon и MCP-эндпоинт http://localhost:8000/sse. Если сервер доступен не только вам, задайте MCP_AUTH_TOKEN. Интерфейс панели на русском.

Подключение к клиентам

Конфиг для Claude Desktop приведён дословно из README, команда для Claude Code и конфиг для Cursor — из инструкций в папке docs/ репозитория (они рассчитаны на Docker-вариант с SSE). Общий порядок — в инструкции как подключить MCP.

claude_desktop_config.json
{
  "mcpServers": {
    "ozon": {
      "command": "uvx",
      "args": ["ozon-mcp-server"],
      "env": {
        "OZON_CLIENT_ID": "your Client-Id",
        "OZON_API_KEY": "your API key",
        "DATA_DIR": "~/.ozon-mcp"
      }
    }
  }
}

Если задан MCP_AUTH_TOKEN, клиент должен передавать заголовок Authorization: Bearer с этим токеном.

Проверка

Спросите ассистента: «Покажи подключённые магазины». Он вернёт список с shop_id. В Docker-варианте доступность ключей проверяется кнопкой «Проверить» на странице /shops.

Примеры задач

Какие мои товары Ozon планирует включить в акцию?
Покажи расходы рекламных кампаний за неделю и останови те, что не окупаются.
Ответь благодарностью на все новые отзывы с пятью звёздами.

Риски

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

Как снизить риски: проверяйте предлагаемые изменения цен и бюджетов перед подтверждением, используйте отдельные ключи API с нужными правами, закрывайте доступ к серверу токеном MCP_AUTH_TOKEN. Автор предупреждает, что это его рабочий инструмент и обновляется по мере его потребностей. Лицензия — MIT.

Частые вопросы

Можно ли подключить несколько магазинов?

Да. Каждый магазин получает свой shop_id, и каждый вызов инструмента принимает этот параметр.

Поддерживается ли реклама?

Да. Помимо Seller API сервер работает с Performance API: кампании, ставки, бюджеты и статистика.

Где хранятся ключи API?

На вашем сервере в зашифрованном виде, в папке DATA_DIR.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

Scrapling MCP Server

Веб-скрапинг Scrapling: скрытные HTTP-запросы, настоящие браузеры и CSS-селекторы.

Риск: medium Лицензия: BSD-3-Clause ★ 104 215

World Monitor

Глобальная аналитика в реальном времени: конфликты, рынки, энергетика, торговля, судоходство и кибербезопасность.

Риск: medium Лицензия: AGPL-3.0 ★ 90 905

mcp

Поиск, отчёты и анализ первопричин по метрикам, логам, системам, контейнерам и сетевым соединениям в Netdata.

Риск: medium Лицензия: GPL-3.0 ★ 81 465

Netdata

Мониторинг инфраструктуры Netdata: метрики, логи, алерты и поиск аномалий с ML.

Риск: medium Лицензия: GPL-3.0 ★ 81 465

Источники