MCP-сервер Ozon Seller с полным каталогом методов
ozon-mcp-ru
MCP-сервер для Ozon Seller API с каталогом из 441 метода, классами доступа на чтение и запись и хранением ключей вне репозитория
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- 240 методов из каталога меняют данные в боевом кабинете
- 11 методов помечены как необратимые, включая работу с заказами и возвратами
Установка
В терминале, через 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 из той же пары. Оба уходят в одноимённые заголовки.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Установи сервер командой 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 из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма