MCP-сервер Ozon Seller API
ozon-seller-mcp
MCP-сервер для Ozon Seller API: категории, атрибуты, аналитика, остатки и оборачиваемость через набор типизированных инструментов
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Ключ дает доступ к аналитике и остаткам реального кабинета продавца
- Судя по README сервер не предоставляет инструменты записи, но ключ стоит выдавать только на чтение, если Ozon это позволяет
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/kirillwinter1-ozon-seller-mcpОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Собрано автоматически, проверьте перед установкой.
Выполните в терминале
claude mcp add --transport stdio --env 'OZON_CLIENT_ID=<ваш OZON_CLIENT_ID>' --env 'OZON_API_KEY=<ваш OZON_API_KEY>' ozon -- npx -y ozon-seller-mcpИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"ozon": {
"command": "npx",
"args": [
"-y",
"ozon-seller-mcp"
],
"env": {
"OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
"OZON_API_KEY": "<ваш OZON_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
OZON_CLIENT_IDсекрет, обязательная- Seller Client ID from Ozon
OZON_API_KEYсекрет, обязательная- API Key from Ozon
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"ozon": {
"command": "npx",
"args": [
"-y",
"ozon-seller-mcp"
],
"env": {
"OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
"OZON_API_KEY": "<ваш OZON_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
OZON_CLIENT_IDсекрет, обязательная- Seller Client ID from Ozon
OZON_API_KEYсекрет, обязательная- API Key from Ozon
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
code --add-mcp '{"name":"ozon","type":"stdio","command":"npx","args":["-y","ozon-seller-mcp"],"env":{"OZON_CLIENT_ID":"<ваш OZON_CLIENT_ID>","OZON_API_KEY":"<ваш OZON_API_KEY>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"ozon": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ozon-seller-mcp"
],
"env": {
"OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
"OZON_API_KEY": "<ваш OZON_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
OZON_CLIENT_IDсекрет, обязательная- Seller Client ID from Ozon
OZON_API_KEYсекрет, обязательная- API Key from Ozon
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add ozon --env 'OZON_CLIENT_ID=<ваш OZON_CLIENT_ID>' --env 'OZON_API_KEY=<ваш OZON_API_KEY>' -- npx -y ozon-seller-mcpИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.ozon]
command = "npx"
args = ["-y", "ozon-seller-mcp"]
env = { OZON_CLIENT_ID = "<ваш OZON_CLIENT_ID>", OZON_API_KEY = "<ваш OZON_API_KEY>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
OZON_CLIENT_IDсекрет, обязательная- Seller Client ID from Ozon
OZON_API_KEYсекрет, обязательная- API Key from Ozon
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"ozon": {
"command": "npx",
"args": [
"-y",
"ozon-seller-mcp"
],
"env": {
"OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
"OZON_API_KEY": "<ваш OZON_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
OZON_CLIENT_IDсекрет, обязательная- Seller Client ID from Ozon
OZON_API_KEYсекрет, обязательная- API Key from Ozon
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"ozon": {
"command": "npx",
"args": [
"-y",
"ozon-seller-mcp"
],
"env": {
"OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
"OZON_API_KEY": "<ваш OZON_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
OZON_CLIENT_IDсекрет, обязательная- Seller Client ID from Ozon
OZON_API_KEYсекрет, обязательная- API Key from Ozon
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"ozon": {
"command": "npx",
"args": [
"-y",
"ozon-seller-mcp"
],
"env": {
"OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
"OZON_API_KEY": "<ваш OZON_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
OZON_CLIENT_IDсекрет, обязательная- Seller Client ID from Ozon
OZON_API_KEYсекрет, обязательная- API Key from Ozon
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"ozon": {
"command": "npx",
"args": [
"-y",
"ozon-seller-mcp"
],
"env": {
"OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
"OZON_API_KEY": "<ваш OZON_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
OZON_CLIENT_IDсекрет, обязательная- Seller Client ID from Ozon
OZON_API_KEYсекрет, обязательная- API Key from Ozon
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"ozon": {
"type": "local",
"command": [
"npx",
"-y",
"ozon-seller-mcp"
],
"environment": {
"OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
"OZON_API_KEY": "<ваш OZON_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
OZON_CLIENT_IDсекрет, обязательная- Seller Client ID from Ozon
OZON_API_KEYсекрет, обязательная- API Key from Ozon
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"ozon": {
"command": "npx",
"args": [
"-y",
"ozon-seller-mcp"
],
"env": {
"OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
"OZON_API_KEY": "<ваш OZON_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
OZON_CLIENT_IDсекрет, обязательная- Seller Client ID from Ozon
OZON_API_KEYсекрет, обязательная- API Key from Ozon
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"ozon": {
"command": "npx",
"args": [
"-y",
"ozon-seller-mcp"
],
"env": {
"OZON_CLIENT_ID": "<ваш OZON_CLIENT_ID>",
"OZON_API_KEY": "<ваш OZON_API_KEY>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
OZON_CLIENT_IDсекрет, обязательная- Seller Client ID from Ozon
OZON_API_KEYсекрет, обязательная- API Key from Ozon
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Склонируй https://github.com/kirillwinter1/ozon-seller-mcp, установи зависимости npm install, собери npm run build, добавь сервер в конфигурацию MCP-клиента командой node dist/index.js с переменными окружения ключа и client id Ozon.
Другие способы из описания автора
git clone https://github.com/kirillwinter1/ozon-seller-mcp.git
cd ozon-seller-mcp
npm install
npm run buildВетка по умолчанию feature/ozon-seller-mcp. После сборки сервер запускается командой node dist/index.js.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Node.js MCP-сервер оборачивает Ozon Seller API в инструменты, сгруппированные по разделам: категории и их атрибуты, значения атрибутов, аналитика продаж, остатки на складах и оборачиваемость товаров. Каждый инструмент описан схемой параметров через zod и покрыт собственным тестом. Сервер запускается локально по stdio и требует ключ и client id продавца из переменных окружения.
Для кого. Для продавцов Ozon и разработчиков, которым нужен предсказуемый MCP-сервер аналитики и категорий с покрытием тестами.
Подходит, если
- Нужно свериться с атрибутами категории перед заполнением карточки товара
- Нужна аналитика продаж и оборачиваемости по складам
- Нужен тестируемый MCP-сервер, а не разовый скрипт
Не подходит, если
- Нужны инструменты изменения цен, остатков или заказов, сервер их не предоставляет
- Нужен готовый пакет из реестра npm, публикации пакета нет
Пример запроса к агенту
Покажи обязательные атрибуты для категории детской обуви на Ozon и оборачиваемость по складам за месяцОграничения
Ветка по умолчанию feature/ozon-seller-mcp, а не main: учитывайте это при клонировании. Пакет не опубликован в npm, сервер собирается и запускается из исходников. Нужен ключ Ozon Seller API. README на русском описывает не все инструменты подробно.
Как отключить. Удалите сервер ozon-seller-mcp из конфигурации MCP клиента.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| OZON_CLIENT_ID обязательная, секрет | Client Id продавца из личного кабинета Ozon Seller. |
| OZON_API_KEY обязательная, секрет | API-ключ Ozon Seller API. |
Проверка безопасности
- Ключ дает доступ к аналитике и остаткам реального кабинета продавца
- Судя по README сервер не предоставляет инструменты записи, но ключ стоит выдавать только на чтение, если Ozon это позволяет
Коротко о README
README описывает сервер как MCP-обертку над Ozon Seller API для управления товарами, заказами и аналитикой, перечисляет требования Node.js 18+, переменные окружения ключа и client id, команды сборки и тестирования. Показана структура инструментов по разделам категорий и аналитики. MIT лицензия.
Частые вопросы
Есть ли инструменты для изменения цен и остатков?
Нет, судя по дереву репозитория и README сервер только читает категории, атрибуты, аналитику, остатки и оборачиваемость.
Можно установить через npx?
Пакет не опубликован в npm, нужно собрать сервер из исходников командой npm run build.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма