MCP-сервер Ozon Seller с полным каталогом методов

ozon-mcp-ru

MCP-сервер для Ozon Seller API с каталогом из 441 метода, классами доступа на чтение и запись и хранением ключей вне репозитория

MCP-сервер

Высокий риск

Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.

Почему такой уровень

  • 240 методов из каталога меняют данные в боевом кабинете
  • 11 методов помечены как необратимые, включая работу с заказами и возвратами
Все причины и проверки
Российский стек

ilyautov/ozon-mcp-ru

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/ozon-mcp-ru

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.

Выполните в терминале

claude mcp add --transport stdio --env 'OZON_CLIENT_ID=<ваш OZON_CLIENT_ID>' --env 'OZON_API_KEY=<ваш OZON_API_KEY>' ozon-mcp-ru -- uvx ozon-mcp-ru==0.6.0

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "ozon-mcp-ru": {
      "command": "uvx",
      "args": [
        "ozon-mcp-ru==0.6.0"
      ],
      "env": {
        "OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
        "OZON_API_KEY": "<ваш OZON_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

OZON_CLIENT_IDсекрет, обязательная
Client-Id из кабинета seller.ozon.ru, Настройки → API-ключи.
OZON_API_KEYсекрет, обязательная
Api-Key из той же пары. Оба уходят в одноимённые заголовки.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "ozon-mcp-ru": {
      "command": "uvx",
      "args": [
        "ozon-mcp-ru==0.6.0"
      ],
      "env": {
        "OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
        "OZON_API_KEY": "<ваш OZON_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

OZON_CLIENT_IDсекрет, обязательная
Client-Id из кабинета seller.ozon.ru, Настройки → API-ключи.
OZON_API_KEYсекрет, обязательная
Api-Key из той же пары. Оба уходят в одноимённые заголовки.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

code --add-mcp '{"name":"ozon-mcp-ru","type":"stdio","command":"uvx","args":["ozon-mcp-ru==0.6.0"],"env":{"OZON_CLIENT_ID":"<ваш OZON_CLIENT_ID>","OZON_API_KEY":"<ваш OZON_API_KEY>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "ozon-mcp-ru": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ozon-mcp-ru==0.6.0"
      ],
      "env": {
        "OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
        "OZON_API_KEY": "<ваш OZON_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

OZON_CLIENT_IDсекрет, обязательная
Client-Id из кабинета seller.ozon.ru, Настройки → API-ключи.
OZON_API_KEYсекрет, обязательная
Api-Key из той же пары. Оба уходят в одноимённые заголовки.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add ozon-mcp-ru --env 'OZON_CLIENT_ID=<ваш OZON_CLIENT_ID>' --env 'OZON_API_KEY=<ваш OZON_API_KEY>' -- uvx ozon-mcp-ru==0.6.0

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.ozon-mcp-ru]
command = "uvx"
args = ["ozon-mcp-ru==0.6.0"]
env = { OZON_CLIENT_ID = "<ваш OZON_CLIENT_ID>", OZON_API_KEY = "<ваш OZON_API_KEY>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

OZON_CLIENT_IDсекрет, обязательная
Client-Id из кабинета seller.ozon.ru, Настройки → API-ключи.
OZON_API_KEYсекрет, обязательная
Api-Key из той же пары. Оба уходят в одноимённые заголовки.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

gemini mcp add -s user -e 'OZON_CLIENT_ID=<ваш OZON_CLIENT_ID>' -e 'OZON_API_KEY=<ваш OZON_API_KEY>' ozon-mcp-ru uvx ozon-mcp-ru==0.6.0

Или добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "ozon-mcp-ru": {
      "command": "uvx",
      "args": [
        "ozon-mcp-ru==0.6.0"
      ],
      "env": {
        "OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
        "OZON_API_KEY": "<ваш OZON_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

OZON_CLIENT_IDсекрет, обязательная
Client-Id из кабинета seller.ozon.ru, Настройки → API-ключи.
OZON_API_KEYсекрет, обязательная
Api-Key из той же пары. Оба уходят в одноимённые заголовки.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "ozon-mcp-ru": {
      "command": "uvx",
      "args": [
        "ozon-mcp-ru==0.6.0"
      ],
      "env": {
        "OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
        "OZON_API_KEY": "<ваш OZON_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

OZON_CLIENT_IDсекрет, обязательная
Client-Id из кабинета seller.ozon.ru, Настройки → API-ключи.
OZON_API_KEYсекрет, обязательная
Api-Key из той же пары. Оба уходят в одноимённые заголовки.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "ozon-mcp-ru": {
      "command": "uvx",
      "args": [
        "ozon-mcp-ru==0.6.0"
      ],
      "env": {
        "OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
        "OZON_API_KEY": "<ваш OZON_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

OZON_CLIENT_IDсекрет, обязательная
Client-Id из кабинета seller.ozon.ru, Настройки → API-ключи.
OZON_API_KEYсекрет, обязательная
Api-Key из той же пары. Оба уходят в одноимённые заголовки.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "ozon-mcp-ru": {
      "command": "uvx",
      "args": [
        "ozon-mcp-ru==0.6.0"
      ],
      "env": {
        "OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
        "OZON_API_KEY": "<ваш OZON_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

OZON_CLIENT_IDсекрет, обязательная
Client-Id из кабинета seller.ozon.ru, Настройки → API-ключи.
OZON_API_KEYсекрет, обязательная
Api-Key из той же пары. Оба уходят в одноимённые заголовки.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "ozon-mcp-ru": {
      "type": "local",
      "command": [
        "uvx",
        "ozon-mcp-ru==0.6.0"
      ],
      "environment": {
        "OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
        "OZON_API_KEY": "<ваш OZON_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

OZON_CLIENT_IDсекрет, обязательная
Client-Id из кабинета seller.ozon.ru, Настройки → API-ключи.
OZON_API_KEYсекрет, обязательная
Api-Key из той же пары. Оба уходят в одноимённые заголовки.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "ozon-mcp-ru": {
      "command": "uvx",
      "args": [
        "ozon-mcp-ru==0.6.0"
      ],
      "env": {
        "OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
        "OZON_API_KEY": "<ваш OZON_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

OZON_CLIENT_IDсекрет, обязательная
Client-Id из кабинета seller.ozon.ru, Настройки → API-ключи.
OZON_API_KEYсекрет, обязательная
Api-Key из той же пары. Оба уходят в одноимённые заголовки.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "ozon-mcp-ru": {
      "command": "uvx",
      "args": [
        "ozon-mcp-ru==0.6.0"
      ],
      "env": {
        "OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
        "OZON_API_KEY": "<ваш OZON_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

OZON_CLIENT_IDсекрет, обязательная
Client-Id из кабинета seller.ozon.ru, Настройки → API-ключи.
OZON_API_KEYсекрет, обязательная
Api-Key из той же пары. Оба уходят в одноимённые заголовки.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: uv

Сверено с репозиторием 25 сент. 2026, коммит 6203eed.

Текст для агента

Установи сервер командой uvx ozon-mcp-ru и добавь его в claude_desktop_config.json с переменными OZON_CLIENT_ID и OZON_API_KEY, либо просто запусти и введи ключи при первом старте: сервер сам спросит их и сохранит.

Другие способы из описания автора
{
  "mcpServers": {
    "ozon": {
      "command": "uvx",
      "args": ["ozon-mcp-ru"],
      "env": { "OZON_CLIENT_ID": "...", "OZON_API_KEY": "..." }
    }
  }
}

Запись из README, пакет ставится с PyPI.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер исполняет каталог методов Ozon Seller API, описанный в файле endpoints.yaml: 441 метод, из них 190 на чтение, 240 на запись и 11 необратимых, сгруппированных по темам вроде заказов FBS, заказов FBO, товаров, кросс-дока FBP, акций, возвратов, отзывов, финансов и аналитики. Поскольку сервер исполняет ровно этот файл, таблица методов не расходится с кодом. Поддерживает несколько кабинетов продавца одновременно с переключением прямо из чата, ключи хранятся в ~/.marketplace-mcp/cabinets.json с правами 600, а не в переменных окружения или репозитории.

Для кого. Для продавцов и агентств, которым нужен широкий охват Ozon Seller API и работа с несколькими кабинетами сразу.

Подходит, если

  • Нужен метод Ozon Seller API, которого нет в более простых серверах: каталог покрывает 441 метод
  • Нужно вести несколько магазинов Ozon и переключаться между ними из диалога
  • Нужно отдельно авторизовать Performance API для рекламы через OAuth2

Не подходит, если

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

Пример запроса к агенту

Переключись на второй магазин Ozon и покажи заказы FBS, ожидающие отгрузки сегодня

Ограничения

Это неофициальный проект сообщества, а не сервер от Ozon. Seller API и Performance API авторизуются разными парами ключей и не взаимозаменяемы. Основной пакет ozon_mcp_ru зависит от общего ядра и каталога из отдельного репозитория marketplaces-mcp-ru того же автора.

Как отключить. Удалите сервер из конфигурации MCP клиента и сотрите нужный кабинет из ~/.marketplace-mcp/cabinets.json.

MCP

Транспорт
stdio
Авторизация
API-ключ
Переменные окружения
Переменные окружения
OZON_CLIENT_ID
обязательная
Client-Id продавца из seller.ozon.ru, Настройки, API-ключи.
OZON_API_KEY
обязательная, секрет
Api-Key продавца из той же пары.

Проверка безопасности

  • 240 методов из каталога меняют данные в боевом кабинете
  • 11 методов помечены как необратимые, включая работу с заказами и возвратами

Коротко о README

README на русском объясняет, что сервер это тонкая обертка над зависимостью marketplaces-mcp-ru, дает три способа установки: uvx с релиза, uvx из ветки main и через npx skills add, таблицу с разбивкой 441 метода по темам и чтению/записи/необратимости, а также инструкцию получения ключей Seller API и отдельно Performance API.

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

Сколько методов доступно?

441 метод Ozon Seller API: 190 на чтение, 240 на запись, 11 необратимых.

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

Да, сервер умеет несколько кабинетов и переключение между ними прямо из чата, ключи хранятся локально с правами 600.

Официальный

Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента

MCP-серверВысокий риск483Звезды репозитория
Официальный

Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex

ПлагинВысокий рискРоссийский стекБез VPN28Звезды репозитория
Выбор редакции

Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию

MCP-серверВысокий рискРоссийский стекБез VPN
Официальный

Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма

MCP-серверВысокий рискРоссийский стекБез VPN
Foxx AIMCP-сервер Ozon Seller с полным каталогом методов

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.