Ozon MCP

ilyautov/marketplaces-mcp-ru· Проверено 12.11.2026· 62на GitHub

Подключает агента к кабинету продавца Ozon через Seller API и Performance API: продажи, заказы, остатки, цены, финансы, отзывы и реклама. Третий вариант читает витрину без ключей и сравнивает цены.

3 реализации:

Один сервер на Ozon, Wildberries, Яндекс Маркет и Авито: 441 метод Ozon Seller и 45 методов Performance, запись только с подтверждением.

Как подключить

Что сделать до подключения

uv для запуска через uvx; без Python подойдёт npx -y marketplaces-mcp-ru

OZON_CLIENT_ID, OZON_API_KEY

seller.ozon.ru → Настройки → API-ключи

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'OZON_CLIENT_ID=<Client-Id>' --env 'OZON_API_KEY=<Api-Key>' --transport stdio ozon \
  -- uvx marketplaces-mcp-ru

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.ozon]
command = "uvx"
args = ["marketplaces-mcp-ru"]

[mcp_servers.ozon.env]
OZON_CLIENT_ID = "<Client-Id>"
OZON_API_KEY = "<Api-Key>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "ozon": {
      "command": "uvx",
      "args": ["marketplaces-mcp-ru"],
      "env": {
        "OZON_CLIENT_ID": "<Client-Id>",
        "OZON_API_KEY": "<Api-Key>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "ozon": {
      "type": "stdio",
      "command": "uvx",
      "args": ["marketplaces-mcp-ru"],
      "env": {
        "OZON_CLIENT_ID": "<Client-Id>",
        "OZON_API_KEY": "<Api-Key>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "ozon": {
      "command": "uvx",
      "args": ["marketplaces-mcp-ru"],
      "env": {
        "OZON_CLIENT_ID": "<Client-Id>",
        "OZON_API_KEY": "<Api-Key>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "ozon": {
      "command": "uvx",
      "args": ["marketplaces-mcp-ru"],
      "env": {
        "OZON_CLIENT_ID": "<Client-Id>",
        "OZON_API_KEY": "<Api-Key>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "ozon": {
        "type": "local",
        "command": ["uvx", "marketplaces-mcp-ru"],
        "environment": {
          "OZON_CLIENT_ID": "<Client-Id>",
          "OZON_API_KEY": "<Api-Key>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "ozon": {
      "command": "uvx",
      "args": ["marketplaces-mcp-ru"],
      "env": {
        "OZON_CLIENT_ID": "<Client-Id>",
        "OZON_API_KEY": "<Api-Key>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "ozon": {
      "command": "uvx",
      "args": ["marketplaces-mcp-ru"],
      "env": {
        "OZON_CLIENT_ID": "<Client-Id>",
        "OZON_API_KEY": "<Api-Key>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

ozon_check_authпроверяет наличие ключей

ozon_search_methodsищет метод API по-русски

ozon_describe_methodописывает метод и его лимиты

ozon_call_methodвыполняет метод на чтение

ozon_write_methodвносит изменения с подтверждением

ozon_delete_methodудаляет с двойным подтверждением

ozon_get_rawчитает любой путь API

ozon_fetch_allсобирает все страницы ответа

ozon_get_productsвыгружает товары

ozon_get_pricesвыгружает цены

Только Ozon: 15 инструментов поверх 466 методов, 13 готовых сценариев и проверка тарифа подписки до вызова; ставится клонированием репозитория.

Как подключить

Что сделать до подключения

Python 3.12 или 3.13

Копия репозитория: git clone и uv sync

OZON_CLIENT_ID, OZON_API_KEY

Client-Id и Api-Key: seller.ozon.ru/app/settings/api-keys

OZON_PERFORMANCE_CLIENT_ID, OZON_PERFORMANCE_CLIENT_SECRET

нужны только для рекламы через Performance API

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'OZON_CLIENT_ID=<Client-Id>' --env 'OZON_API_KEY=<Api-Key>' --env 'OZON_PERFORMANCE_CLIENT_ID=<Client-Id Performance>' --env 'OZON_PERFORMANCE_CLIENT_SECRET=<секрет Performance>' --transport stdio ozon-mcp \
  -- uv --directory /absolute/path/to/ozon-mcp run ozon-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.ozon-mcp]
command = "uv"
args = ["--directory", "/absolute/path/to/ozon-mcp", "run", "ozon-mcp"]

[mcp_servers.ozon-mcp.env]
OZON_CLIENT_ID = "<Client-Id>"
OZON_API_KEY = "<Api-Key>"
OZON_PERFORMANCE_CLIENT_ID = "<Client-Id Performance>"
OZON_PERFORMANCE_CLIENT_SECRET = "<секрет Performance>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "ozon-mcp": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/ozon-mcp", "run", "ozon-mcp"],
      "env": {
        "OZON_CLIENT_ID": "<Client-Id>",
        "OZON_API_KEY": "<Api-Key>",
        "OZON_PERFORMANCE_CLIENT_ID": "<Client-Id Performance>",
        "OZON_PERFORMANCE_CLIENT_SECRET": "<секрет Performance>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "ozon-mcp": {
      "type": "stdio",
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/ozon-mcp", "run", "ozon-mcp"],
      "env": {
        "OZON_CLIENT_ID": "<Client-Id>",
        "OZON_API_KEY": "<Api-Key>",
        "OZON_PERFORMANCE_CLIENT_ID": "<Client-Id Performance>",
        "OZON_PERFORMANCE_CLIENT_SECRET": "<секрет Performance>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "ozon-mcp": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/ozon-mcp", "run", "ozon-mcp"],
      "env": {
        "OZON_CLIENT_ID": "<Client-Id>",
        "OZON_API_KEY": "<Api-Key>",
        "OZON_PERFORMANCE_CLIENT_ID": "<Client-Id Performance>",
        "OZON_PERFORMANCE_CLIENT_SECRET": "<секрет Performance>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "ozon-mcp": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/ozon-mcp", "run", "ozon-mcp"],
      "env": {
        "OZON_CLIENT_ID": "<Client-Id>",
        "OZON_API_KEY": "<Api-Key>",
        "OZON_PERFORMANCE_CLIENT_ID": "<Client-Id Performance>",
        "OZON_PERFORMANCE_CLIENT_SECRET": "<секрет Performance>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "ozon-mcp": {
        "type": "local",
        "command": ["uv", "--directory", "/absolute/path/to/ozon-mcp", "run", "ozon-mcp"],
        "environment": {
          "OZON_CLIENT_ID": "<Client-Id>",
          "OZON_API_KEY": "<Api-Key>",
          "OZON_PERFORMANCE_CLIENT_ID": "<Client-Id Performance>",
          "OZON_PERFORMANCE_CLIENT_SECRET": "<секрет Performance>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "ozon-mcp": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/ozon-mcp", "run", "ozon-mcp"],
      "env": {
        "OZON_CLIENT_ID": "<Client-Id>",
        "OZON_API_KEY": "<Api-Key>",
        "OZON_PERFORMANCE_CLIENT_ID": "<Client-Id Performance>",
        "OZON_PERFORMANCE_CLIENT_SECRET": "<секрет Performance>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "ozon-mcp": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/ozon-mcp", "run", "ozon-mcp"],
      "env": {
        "OZON_CLIENT_ID": "<Client-Id>",
        "OZON_API_KEY": "<Api-Key>",
        "OZON_PERFORMANCE_CLIENT_ID": "<Client-Id Performance>",
        "OZON_PERFORMANCE_CLIENT_SECRET": "<секрет Performance>"
      }
    }
  }
}

Инструменты сервера

ozon_call_methodвыполняет метод с проверками

ozon_fetch_allсобирает все страницы ответа

ozon_describe_methodпоказывает схему и примеры метода

ozon_search_methodsищет по 466 методам

ozon_list_workflowsперечисляет готовые сценарии

ozon_get_workflowвыдаёт пошаговый план сценария

ozon_get_rate_limitsпоказывает лимиты запросов

ozon_get_subscription_statusпоказывает тариф кабинета

ozon_list_methods_for_subscriptionпоказывает методы тарифа

ozon_get_error_catalogрасшифровывает код ошибки

Показано 10 из 15.

Без ключей и кабинета: читает витрину Ozon (поиск, карточки, отзывы) и сравнивает цены с WB, Маркетом и другими площадками; только чтение.

Как подключить

Что сделать до подключения

Python 3.12 или новее и uv

Chrome, в котором вы вошли на Ozon, — если площадка не пускает запросы напрямую

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio ru-marketplace-mcp \
  -- uv run --directory /путь/к/ru-marketplace-mcp ozon-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.ru-marketplace-mcp]
command = "uv"
args = ["run", "--directory", "/путь/к/ru-marketplace-mcp", "ozon-mcp"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "ru-marketplace-mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/путь/к/ru-marketplace-mcp", "ozon-mcp"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "ru-marketplace-mcp": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "/путь/к/ru-marketplace-mcp", "ozon-mcp"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "ru-marketplace-mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/путь/к/ru-marketplace-mcp", "ozon-mcp"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "ru-marketplace-mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/путь/к/ru-marketplace-mcp", "ozon-mcp"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "ru-marketplace-mcp": {
        "type": "local",
        "command": ["uv", "run", "--directory", "/путь/к/ru-marketplace-mcp", "ozon-mcp"]
      }
    }
  }
}

{
  "mcpServers": {
    "ru-marketplace-mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/путь/к/ru-marketplace-mcp", "ozon-mcp"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "ru-marketplace-mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/путь/к/ru-marketplace-mcp", "ozon-mcp"]
    }
  }
}

Инструменты сервера

ozon_searchищет товары на Ozon

ozon_cardчитает карточку товара

ozon_reviewsсобирает отзывы

Что попросить агента

«Покажи продажи за неделю на Ozon и сравни с Wildberries»Агент найдёт метод отчёта через ozon_search_methods, проверит его в ozon_describe_method и выгрузит данные ozon_call_method или ozon_fetch_all

«Какие мои товары на Ozon с красным индексом цены?»Агент выгрузит цены через ozon_get_prices и отберёт товары по индексу цены

«Прогони сценарий риска out-of-stock по моему кабинету»В ozon-mcp агент возьмёт план сценария oos_risk_analysis через ozon_get_workflow и пройдёт шаги вызовами ozon_call_method

«Найди товары с низким рейтингом контента и скажи, что дозаполнить»В ozon-mcp агент возьмёт сценарий content_audit через ozon_get_workflow и покажет атрибуты, которые поднимут рейтинг

«Найди на Ozon <товар> и собери отзывы по первой карточке»В ru-marketplace-mcp агент вызовет ozon_search, ozon_card и ozon_reviews

Для каких задач

Показать продажи за неделю на Ozon и сравнить с Wildberries

Найти товары с красным индексом цены

Найти товары, которые скоро закончатся на складах

Проверить контент карточек и подсказать, какие атрибуты дозаполнить

Собрать отзывы ниже 4 звёзд за неделю и сгруппировать жалобы по товару

Сравнить цену товара на Ozon, Wildberries и Яндекс Маркете

Ограничения

marketplaces-mcp-ru в статусе alpha: вживую выверено ядро (продажи, остатки, цены, финансы, отзывы), у остальных методов HTTP-глагол бывает неверным

Отзывы через Seller API требуют подписки Premium Plus; ozon-mcp заранее отказывает в методах выше вашего тарифа

Ozon отсекает трафик из дата-центров, поэтому ru-marketplace-mcp ходит через ваш Chrome; условия площадок обычно запрещают такой сбор со страниц

На витрине отзывы общие для всего семейства карточек и часто написаны про другой товар: их нужно фильтровать по item_id

Если не работает

Необъяснимый 401 или ошибка «Client-Id should be positive integer»

Активный кабинет в ~/.marketplace-mcp/cabinets.json главнее переменных окружения: проверьте ключи в этом файле.

Метод отвечает 404

Ozon меняет версии методов (list v3, attributes v4, prices v5): проверьте, что вызывается нужная версия.

Метод из каталога отвечает 405

У методов, импортированных из спецификаций, HTTP-глагол бывает неверным. Сверьте глагол и тело с документацией Ozon или вызовите метод через ozon_get_raw.

ozon-mcp возвращает subscription_gate: Endpoint requires PREMIUM_PRO, cabinet has PREMIUM_PLUS

Метод доступен на более высоком тарифе, и сервер не стал его вызывать. Какие методы открыты на вашем тарифе, покажет ozon_list_methods_for_subscription.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
marketplaces-mcp-ru	Илья Утов	62	локально	токен	10	11 ноября 2026
ozon-mcp	PCDCK	26	локально	токен	15	17 апреля 2026
ru-marketplace-mcp	Vladimir-Human	187	локально	не нужен	3	11 ноября 2026

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

Где взять Client-Id и Api-Key?

В кабинете продавца: seller.ozon.ru → Настройки → API-ключи. Для рекламы в ozon-mcp нужны отдельные Client-Id и секрет Performance API.

Агент не поменяет цены без спроса?

В marketplaces-mcp-ru и ozon-mcp каждый метод размечен как read, write или destructive. Запись требует confirm_write=true, удаление — ещё и i_understand_this_modifies_data=true.

Какой вариант выбрать?

marketplaces-mcp-ru удобен, если вы торгуете на нескольких площадках, и ставится через uvx или npx. ozon-mcp сосредоточен на Ozon: готовые сценарии вроде oos_risk_analysis и content_audit, учёт тарифа подписки. ru-marketplace-mcp нужен для изучения чужих товаров на витрине без кабинета.

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

В marketplaces-mcp-ru да: кабинеты добавляются и переключаются прямо из чата инструментами ozon_add_cabinet и ozon_use_cabinet, ключи хранятся в ~/.marketplace-mcp/cabinets.json.

Работает ли сервер из России?

Все три сервера запускаются на вашем компьютере, ключи Seller API выдаются в кабинете Ozon; с российского домашнего IP витрина обычно читается и без браузера.

Ozon MCP

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

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

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