MCP-сервер для Ozon Seller API

mcp-server-ozon-seller

MCP-сервер, CLI-утилита и Pydantic-модели для полного Ozon Seller API: 111 действий по товарам, отправлениям, финансам и отзывам через поиск и выполнение

MCP-сервер

Высокий риск

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

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

  • Может создавать и обновлять товары, менять цены и остатки
  • Может отменять отправления FBS и выполнять другие изменяющие действия каталога из 111
Все причины и проверки
Российский стек

dontsovcmc/mcp-server-ozon-seller

Установка

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

npx skillfoxx add mcp/mcp-server-ozon-seller

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

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

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

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

claude mcp add --transport stdio --env 'OZON_CLIENT_ID=<ваш OZON_CLIENT_ID>' --env 'OZON_API_KEY=<ваш OZON_API_KEY>' ozon-seller -- uvx mcp-server-ozon-seller==0.3.1

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

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

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

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

OZON_CLIENT_IDсекрет, обязательная
OZON_API_KEYсекрет, обязательная

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

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

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

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

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

OZON_CLIENT_IDсекрет, обязательная
OZON_API_KEYсекрет, обязательная

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

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

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

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

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

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

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

OZON_CLIENT_IDсекрет, обязательная
OZON_API_KEYсекрет, обязательная

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

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

codex mcp add ozon-seller --env 'OZON_CLIENT_ID=<ваш OZON_CLIENT_ID>' --env 'OZON_API_KEY=<ваш OZON_API_KEY>' -- uvx mcp-server-ozon-seller==0.3.1

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

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

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

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

OZON_CLIENT_IDсекрет, обязательная
OZON_API_KEYсекрет, обязательная

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

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

gemini mcp add -s user -e 'OZON_CLIENT_ID=<ваш OZON_CLIENT_ID>' -e 'OZON_API_KEY=<ваш OZON_API_KEY>' ozon-seller uvx mcp-server-ozon-seller==0.3.1

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

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

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

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

OZON_CLIENT_IDсекрет, обязательная
OZON_API_KEYсекрет, обязательная

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

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

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

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

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

OZON_CLIENT_IDсекрет, обязательная
OZON_API_KEYсекрет, обязательная

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

Бывший Windsurf.

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

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

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

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

OZON_CLIENT_IDсекрет, обязательная
OZON_API_KEYсекрет, обязательная

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

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

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

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

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

OZON_CLIENT_IDсекрет, обязательная
OZON_API_KEYсекрет, обязательная

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

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

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

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

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

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

OZON_CLIENT_IDсекрет, обязательная
OZON_API_KEYсекрет, обязательная

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

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

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

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

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

OZON_CLIENT_IDсекрет, обязательная
OZON_API_KEYсекрет, обязательная

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

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

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

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

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

OZON_CLIENT_IDсекрет, обязательная
OZON_API_KEYсекрет, обязательная

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

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

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

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

Получи Client-Id и Api-Key в Ozon Seller (Настройки → API-ключи), затем выполни claude mcp add ozon-seller -e OZON_CLIENT_ID=... -e OZON_API_KEY=... -- uvx mcp-server-ozon-seller.

Другие способы из описания автора
claude mcp add ozon-seller -e OZON_CLIENT_ID=ваш_client_id -e OZON_API_KEY=ваш_api_key -- uvx mcp-server-ozon-seller

Способ через uvx, не требует установки пакета.

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

Что делает

Вместо 111 отдельных MCP-инструментов сервер дает три: ozon_search находит нужное действие по описанию на естественном языке, ozon_execute выполняет его по ID с параметрами, ozon_execute_file делает то же самое со скачиванием файла (например акт приемки). Покрыты домены products, fbs, fbo, categories, finance, analytics, warehouses, returns, chats, promos, strategies, rating, reports, reviews, questions, cancellations, certificates, barcodes и brands, в том числе действия на изменение: создание и обновление товаров, цен, остатков, отмена отправлений. Тот же пакет работает как CLI ozon-seller-cli и как библиотека типизированных Pydantic-моделей API.

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

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

  • Нужен доступ ко всем разделам Seller API, а не к их части
  • Нужно управлять ценами, остатками, карточками или отправлениями FBS/FBO из агента
  • Нужен тот же функционал еще и как CLI для скриптов

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

  • Нужен доступ только на чтение без риска случайных изменений
  • Нет ключа Ozon Seller с нужными правами
  • Не нравится паттерн поиск+выполнение вместо отдельных именованных инструментов

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

Отмени отправление FBS 12345678-0001-1 и покажи финансовые транзакции за апрель

Ограничения

Все данные и ключи остаются на компьютере пользователя, сервер их никуда не пересылает. Нужен ключ Ozon Seller (Client-Id и Api-Key) с правами на нужные действия, часть из 111 действий изменяет данные в кабинете. Паттерн поиск+выполнение требует от агента сначала найти ID действия, а не вызвать его напрямую по имени.

Как отключить. Выполните claude mcp remove ozon-seller или удалите сервер из конфигурации вашего MCP-клиента.

MCP

Транспорт
stdio
Авторизация
API-ключ
Переменные окружения
Переменные окружения
OZON_CLIENT_ID
обязательная, секрет
Client-Id из личного кабинета Ozon Seller
OZON_API_KEY
обязательная, секрет
Api-Key из личного кабинета Ozon Seller

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

  • Может создавать и обновлять товары, менять цены и остатки
  • Может отменять отправления FBS и выполнять другие изменяющие действия каталога из 111

Коротко о README

README перечисляет 111 действий по 19 доменам со ссылками на подробные docs/*.md, показывает подключение к Claude Code и Claude Desktop через uvx или pip, примеры CLI-команд по товарам, FBS, FBO, финансам и возвратам, а также пример использования Pydantic-моделей в своем Python-коде.

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

Почему всего три инструмента вместо 111?

Сервер использует паттерн search + execute: ozon_search находит нужное действие, ozon_execute его выполняет, это компактнее для агента, чем 111 отдельных вызовов.

Можно ли использовать без MCP-клиента?

Да, тот же пакет работает как CLI ozon-seller-cli с теми же командами и JSON на выходе.

Официальный

Официальный 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 API

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