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