MCP-сервер Ozon API

Ozon API MCP Server

MCP-сервер на 31 инструмент для Ozon Seller API и Performance API: товары, остатки, цены, заказы, финансы, реклама и отзывы

MCP-серверРоссийский стек

antondrpq/ozon-api-mcp-serverАвтор:antondrpq

Установка

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

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

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

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

Собрано автоматически, проверьте перед установкой.

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

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

claude mcp add --transport stdio --env 'OZON_CLIENT_ID=<ваш OZON_CLIENT_ID>' --env 'OZON_API_KEY=<ваш OZON_API_KEY>' ozon-api-mcp-server -- node start

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

{
  "mcpServers": {
    "ozon-api-mcp-server": {
      "command": "node",
      "args": [
        "start"
      ],
      "env": {
        "OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
        "OZON_API_KEY": "<ваш OZON_API_KEY>"
      }
    }
  }
}

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

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

OZON_CLIENT_IDсекрет, обязательная: Client-Id из личного кабинета Ozon Seller
OZON_API_KEYсекрет, обязательная: Api-Key из личного кабинета Ozon Seller
OZON_PERF_CLIENT_IDсекрет, необязательная: Client-Id для Performance API (опционально)
OZON_PERF_CLIENT_SECRETсекрет, необязательная: Client-Secret для Performance API (опционально)
MCP_API_KEYсекрет, необязательная: Опциональный секрет для защиты MCP-эндпоинта

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

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

{
  "mcpServers": {
    "ozon-api-mcp-server": {
      "command": "node",
      "args": [
        "start"
      ],
      "env": {
        "OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
        "OZON_API_KEY": "<ваш OZON_API_KEY>"
      }
    }
  }
}

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

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

OZON_CLIENT_IDсекрет, обязательная: Client-Id из личного кабинета Ozon Seller
OZON_API_KEYсекрет, обязательная: Api-Key из личного кабинета Ozon Seller
OZON_PERF_CLIENT_IDсекрет, необязательная: Client-Id для Performance API (опционально)
OZON_PERF_CLIENT_SECRETсекрет, необязательная: Client-Secret для Performance API (опционально)
MCP_API_KEYсекрет, необязательная: Опциональный секрет для защиты MCP-эндпоинта

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

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

code --add-mcp '{"name":"ozon-api-mcp-server","type":"stdio","command":"node","args":["start"],"env":{"OZON_CLIENT_ID":"<ваш OZON_CLIENT_ID>","OZON_API_KEY":"<ваш OZON_API_KEY>"}}'

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

{
  "servers": {
    "ozon-api-mcp-server": {
      "type": "stdio",
      "command": "node",
      "args": [
        "start"
      ],
      "env": {
        "OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
        "OZON_API_KEY": "<ваш OZON_API_KEY>"
      }
    }
  }
}

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

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

OZON_CLIENT_IDсекрет, обязательная: Client-Id из личного кабинета Ozon Seller
OZON_API_KEYсекрет, обязательная: Api-Key из личного кабинета Ozon Seller
OZON_PERF_CLIENT_IDсекрет, необязательная: Client-Id для Performance API (опционально)
OZON_PERF_CLIENT_SECRETсекрет, необязательная: Client-Secret для Performance API (опционально)
MCP_API_KEYсекрет, необязательная: Опциональный секрет для защиты MCP-эндпоинта

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

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

codex mcp add ozon-api-mcp-server --env 'OZON_CLIENT_ID=<ваш OZON_CLIENT_ID>' --env 'OZON_API_KEY=<ваш OZON_API_KEY>' -- node start

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

[mcp_servers.ozon-api-mcp-server]
command = "node"
args = ["start"]
env = { OZON_CLIENT_ID = "<ваш OZON_CLIENT_ID>", OZON_API_KEY = "<ваш OZON_API_KEY>" }

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

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

OZON_CLIENT_IDсекрет, обязательная: Client-Id из личного кабинета Ozon Seller
OZON_API_KEYсекрет, обязательная: Api-Key из личного кабинета Ozon Seller
OZON_PERF_CLIENT_IDсекрет, необязательная: Client-Id для Performance API (опционально)
OZON_PERF_CLIENT_SECRETсекрет, необязательная: Client-Secret для Performance API (опционально)
MCP_API_KEYсекрет, необязательная: Опциональный секрет для защиты MCP-эндпоинта

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

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

gemini mcp add -s user -e 'OZON_CLIENT_ID=<ваш OZON_CLIENT_ID>' -e 'OZON_API_KEY=<ваш OZON_API_KEY>' ozon-api-mcp-server node start

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

{
  "mcpServers": {
    "ozon-api-mcp-server": {
      "command": "node",
      "args": [
        "start"
      ],
      "env": {
        "OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
        "OZON_API_KEY": "<ваш OZON_API_KEY>"
      }
    }
  }
}

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

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

OZON_CLIENT_IDсекрет, обязательная: Client-Id из личного кабинета Ozon Seller
OZON_API_KEYсекрет, обязательная: Api-Key из личного кабинета Ozon Seller
OZON_PERF_CLIENT_IDсекрет, необязательная: Client-Id для Performance API (опционально)
OZON_PERF_CLIENT_SECRETсекрет, необязательная: Client-Secret для Performance API (опционально)
MCP_API_KEYсекрет, необязательная: Опциональный секрет для защиты MCP-эндпоинта

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

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

{
  "mcpServers": {
    "ozon-api-mcp-server": {
      "command": "node",
      "args": [
        "start"
      ],
      "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 из личного кабинета Ozon Seller
OZON_API_KEYсекрет, обязательная: Api-Key из личного кабинета Ozon Seller
OZON_PERF_CLIENT_IDсекрет, необязательная: Client-Id для Performance API (опционально)
OZON_PERF_CLIENT_SECRETсекрет, необязательная: Client-Secret для Performance API (опционально)
MCP_API_KEYсекрет, необязательная: Опциональный секрет для защиты MCP-эндпоинта

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

Бывший Windsurf.

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

{
  "mcpServers": {
    "ozon-api-mcp-server": {
      "command": "node",
      "args": [
        "start"
      ],
      "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 из личного кабинета Ozon Seller
OZON_API_KEYсекрет, обязательная: Api-Key из личного кабинета Ozon Seller
OZON_PERF_CLIENT_IDсекрет, необязательная: Client-Id для Performance API (опционально)
OZON_PERF_CLIENT_SECRETсекрет, необязательная: Client-Secret для Performance API (опционально)
MCP_API_KEYсекрет, необязательная: Опциональный секрет для защиты MCP-эндпоинта

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

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

{
  "mcpServers": {
    "ozon-api-mcp-server": {
      "command": "node",
      "args": [
        "start"
      ],
      "env": {
        "OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
        "OZON_API_KEY": "<ваш OZON_API_KEY>"
      }
    }
  }
}

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

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

OZON_CLIENT_IDсекрет, обязательная: Client-Id из личного кабинета Ozon Seller
OZON_API_KEYсекрет, обязательная: Api-Key из личного кабинета Ozon Seller
OZON_PERF_CLIENT_IDсекрет, необязательная: Client-Id для Performance API (опционально)
OZON_PERF_CLIENT_SECRETсекрет, необязательная: Client-Secret для Performance API (опционально)
MCP_API_KEYсекрет, необязательная: Опциональный секрет для защиты MCP-эндпоинта

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

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

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

{
  "mcp": {
    "ozon-api-mcp-server": {
      "type": "local",
      "command": [
        "node",
        "start"
      ],
      "environment": {
        "OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
        "OZON_API_KEY": "<ваш OZON_API_KEY>"
      }
    }
  }
}

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

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

OZON_CLIENT_IDсекрет, обязательная: Client-Id из личного кабинета Ozon Seller
OZON_API_KEYсекрет, обязательная: Api-Key из личного кабинета Ozon Seller
OZON_PERF_CLIENT_IDсекрет, необязательная: Client-Id для Performance API (опционально)
OZON_PERF_CLIENT_SECRETсекрет, необязательная: Client-Secret для Performance API (опционально)
MCP_API_KEYсекрет, необязательная: Опциональный секрет для защиты MCP-эндпоинта

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

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

{
  "context_servers": {
    "ozon-api-mcp-server": {
      "command": "node",
      "args": [
        "start"
      ],
      "env": {
        "OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
        "OZON_API_KEY": "<ваш OZON_API_KEY>"
      }
    }
  }
}

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

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

OZON_CLIENT_IDсекрет, обязательная: Client-Id из личного кабинета Ozon Seller
OZON_API_KEYсекрет, обязательная: Api-Key из личного кабинета Ozon Seller
OZON_PERF_CLIENT_IDсекрет, необязательная: Client-Id для Performance API (опционально)
OZON_PERF_CLIENT_SECRETсекрет, необязательная: Client-Secret для Performance API (опционально)
MCP_API_KEYсекрет, необязательная: Опциональный секрет для защиты MCP-эндпоинта

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

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

{
  "mcpServers": {
    "ozon-api-mcp-server": {
      "command": "node",
      "args": [
        "start"
      ],
      "env": {
        "OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
        "OZON_API_KEY": "<ваш OZON_API_KEY>"
      }
    }
  }
}

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

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

OZON_CLIENT_IDсекрет, обязательная: Client-Id из личного кабинета Ozon Seller
OZON_API_KEYсекрет, обязательная: Api-Key из личного кабинета Ozon Seller
OZON_PERF_CLIENT_IDсекрет, необязательная: Client-Id для Performance API (опционально)
OZON_PERF_CLIENT_SECRETсекрет, необязательная: Client-Secret для Performance API (опционально)
MCP_API_KEYсекрет, необязательная: Опциональный секрет для защиты MCP-эндпоинта

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

Понадобится: Node.js

Сверено с репозиторием 26 сент. 2026, коммит 4167a1e.

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

Склонируй https://github.com/antondrpq/Ozon-API-MCP-Server, установи npm install, скопируй .env.example в .env и заполни OZON_CLIENT_ID и OZON_API_KEY, запусти npm start, подключи MCP-клиент к http://localhost:3000/mcp.

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

npm install
cp .env.example .env
npm start

После заполнения .env ключами Ozon сервер поднимается на порту 3000, MCP-эндпоинт /mcp.

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

Что делает

Node.js сервер поднимает Express-приложение с JSON-RPC 2.0 поверх Streamable HTTP и дает агенту 31 инструмент Ozon Seller API и Performance API: карточки и остатки товаров, изменение цен и остатков, отправления FBS и FBO вплоть до отмены, финансовые транзакции и сводки, аналитику, статистику рекламных кампаний, отзывы с ответами и чат с покупателями. Ozon Seller API вызывается двумя заголовками Client-Id и Api-Key, для Performance API отдельный OAuth2-клиент с кешированием токена. Инструменты записи помечены аннотацией readOnlyHint: false, а отмена отправления еще и destructiveHint: true.

Для кого. Для продавцов Ozon и агентств, которым нужен один сервер для товаров, заказов, финансов, рекламы и общения с покупателями.

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

Нужно менять цены и остатки товаров через агента
Нужно отслеживать и обрабатывать отправления FBS и FBO
Нужны финансовые сводки, статистика рекламы и работа с отзывами и чатом

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

Нужен только режим чтения без риска случайной записи
Нет подписки Premium Plus, а нужны инструменты отзывов
Нужны точные и стабильные пути Performance API без проверки перед продакшном

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

Обнови остатки и цену на этот товар в Ozon и покажи статистику текущей рекламной кампании

Ограничения

Инструменты отзывов работают только с подпиской Premium Plus в кабинете продавца. Композитные инструменты ozon_finance_summary и ozon_perf_ads_summary автор не проверял на боевом аккаунте, только по структуре из документации. Точные пути Performance API документированы Ozon хуже, чем Seller API, и могут меняться. Сервер покрывает основные разделы API, а не все около 460 методов Ozon. Пакет не опубликован в npm, ключи Ozon хранятся только на своем сервере.

Как отключить. Остановите docker-compose или процесс Node.js и удалите сервер из конфигурации MCP клиента.

MCP

Транспорт: http
Авторизация: API-ключ

Переменные окружения
Переменные окружения
OZON_CLIENT_ID обязательная, секрет	Client-Id продавца из настроек Ozon Seller API.
OZON_API_KEY обязательная, секрет	Api-Key продавца Ozon Seller API.
MCP_API_KEY секрет	Опциональный отдельный секрет для защиты самого MCP-эндпоинта.

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

Меняет цены и остатки товаров и может отменить отправление
Может отправлять сообщения покупателям и отвечать на отзывы от имени магазина
Стоит начать с ключа только на чтение, если Ozon дает такую возможность

Коротко о README

README подробно сравнивает Ozon и Wildberries по авторизации, доменам API и пагинации, перечисляет все 31 инструмент по разделам с пометкой записи и деструктивности, дает команды запуска через Node.js и Docker, пример curl-запроса и раздел безопасности: ключи только на сервере, опциональный MCP_API_KEY, непривилегированный пользователь в контейнере. Отдельно перечислены известные ограничения перед продакшном.

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

Сервер может отменить отправление или написать покупателю?

Да, ozon_fbs_posting_cancel и ozon_chat_send_message есть в списке инструментов и помечены как действия с побочным эффектом.

Нужна ли реклама Ozon для работы сервера?

Нет, ключи Performance API опциональны и нужны только для инструментов раздела рекламы.

Salesforce DX MCP Server

Официальный

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

MCP-серверВысокий риск483

Скиллы Яндекс.Кит для управления магазином

kit-skills

Официальный

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

ПлагинВысокий рискРоссийский стекБез VPN28

YouGile MCP от Indalo

YouGile MCP

Выбор редакции

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

MCP-серверВысокий рискРоссийский стекБез VPN

MCP-сервер портала Битрикс24

Официальный

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

MCP-серверВысокий рискРоссийский стекБез VPN

Установка

Что делает

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

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

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

Ограничения

MCP

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

Коротко о README

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

Похожие

Salesforce DX MCP Server

Скиллы Яндекс.Кит для управления магазином

YouGile MCP от Indalo

MCP-сервер портала Битрикс24