Для чего этот сервер?

Этот MCP-сервер нужен, чтобы AI-агенты напрямую управляли магазином на Ozon через API — смотрели товары, анализировали цены, проверяли остатки и запускали отчёты без ручного программирования. Он объединяет сотни методов Ozon в удобные инструменты, автоматически подгружает все страницы и защищает от случайных опасных запросов. Продавцу остаётся только сказать ассистенту, что сделать.

Каталог MCP
PCDCK/ozon-mcp

PCDCK/ozon-mcp

от pcdck

MCP-сервер для подключения AI-агентов к Ozon Seller API. 15 инструментов дают доступ к 466 методам с автоподкачкой и защитой. 13 готовых сценариев для анализа остатков, цен, контента и синхронизаци...

Github Сайт сервера

README

Инструменты и схема сервера

Версии

Установить сервер

ozon-mcp

MCP server for the Ozon Seller & Performance APIs. Connect any AI agent to your Ozon cabinet in minutes.

ozon-mcp is a knowledge-rich MCP server that turns the entire Ozon seller toolkit into 15 high-leverage tools. AI agents (Claude, Cursor, Cline, Continue, Goose, Zed, …) can search the API in Russian or English, drill into any of 466 methods with a fully-resolved JSON Schema, and execute calls with built-in safety guards. Subscription- aware, automatic pagination over all 4 cursor styles, retry/back-off on 429s, and 13 ready-to-use analytical workflows.

Key facts: 466 indexed methods (420 Seller + 46 Performance), 55 sections, 5 subscription tiers modelled, 38 paginated endpoints auto-walked, 43 destructive methods double-gated, 13 curated workflows for typical seller scenarios.

Quick start

Prerequisites

Python 3.12 or 3.13
uv package manager — install with curl -LsSf https://astral.sh/uv/install.sh | sh
Ozon Seller API credentials (Client-Id + Api-Key) — get them at https://seller.ozon.ru/app/settings/api-keys

Часто задаваемые вопросы

У этого сервера пока нет списка инструментов.

Выберите клиент, чтобы установить PCDCK/ozon-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "pcdck-ozon-mcp-thz2tgie7g": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/ozon-mcp",
        "run",
        "ozon-mcp"
      ],
      "env": {
        "OZON_CLIENT_ID": "your-seller-client-id",
        "OZON_API_KEY": "your-seller-api-key",
        "OZON_PERFORMANCE_CLIENT_ID": "your-perf-client-id",
        "OZON_PERFORMANCE_CLIENT_SECRET": "your-perf-secret"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "pcdck-ozon-mcp-thz2tgie7g": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/ozon-mcp",
        "run",
        "ozon-mcp"
      ],
      "env": {
        "OZON_CLIENT_ID": "your-seller-client-id",
        "OZON_API_KEY": "your-seller-api-key",
        "OZON_PERFORMANCE_CLIENT_ID": "your-perf-client-id",
        "OZON_PERFORMANCE_CLIENT_SECRET": "your-perf-secret"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "pcdck-ozon-mcp-thz2tgie7g": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/ozon-mcp",
        "run",
        "ozon-mcp"
      ],
      "env": {
        "OZON_CLIENT_ID": "your-seller-client-id",
        "OZON_API_KEY": "your-seller-api-key",
        "OZON_PERFORMANCE_CLIENT_ID": "your-perf-client-id",
        "OZON_PERFORMANCE_CLIENT_SECRET": "your-perf-secret"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"pcdck-ozon-mcp-thz2tgie7g\",\"type\":\"stdio\",\"command\":\"uv\",\"args\":[\"--directory\",\"/absolute/path/to/ozon-mcp\",\"run\",\"ozon-mcp\"],\"env\":{\"OZON_CLIENT_ID\":\"your-seller-client-id\",\"OZON_API_KEY\":\"your-seller-api-key\",\"OZON_PERFORMANCE_CLIENT_ID\":\"your-perf-client-id\",\"OZON_PERFORMANCE_CLIENT_SECRET\":\"your-perf-secret\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "pcdck-ozon-mcp-thz2tgie7g": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/ozon-mcp",
        "run",
        "ozon-mcp"
      ],
      "env": {
        "OZON_CLIENT_ID": "your-seller-client-id",
        "OZON_API_KEY": "your-seller-api-key",
        "OZON_PERFORMANCE_CLIENT_ID": "your-perf-client-id",
        "OZON_PERFORMANCE_CLIENT_SECRET": "your-perf-secret"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add pcdck-ozon-mcp-thz2tgie7g --env OZON_CLIENT_ID=your-seller-client-id --env OZON_API_KEY=your-seller-api-key --env OZON_PERFORMANCE_CLIENT_ID=your-perf-client-id --env OZON_PERFORMANCE_CLIENT_SECRET=your-perf-secret -- uv --directory /absolute/path/to/ozon-mcp run ozon-mcp

Либо через JSON-конфиг:

claude mcp add-json pcdck-ozon-mcp-thz2tgie7g "{\"command\":\"uv\",\"args\":[\"--directory\",\"/absolute/path/to/ozon-mcp\",\"run\",\"ozon-mcp\"],\"env\":{\"OZON_CLIENT_ID\":\"your-seller-client-id\",\"OZON_API_KEY\":\"your-seller-api-key\",\"OZON_PERFORMANCE_CLIENT_ID\":\"your-perf-client-id\",\"OZON_PERFORMANCE_CLIENT_SECRET\":\"your-perf-secret\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add pcdck-ozon-mcp-thz2tgie7g --env OZON_CLIENT_ID=your-seller-client-id --env OZON_API_KEY=your-seller-api-key --env OZON_PERFORMANCE_CLIENT_ID=your-perf-client-id --env OZON_PERFORMANCE_CLIENT_SECRET=your-perf-secret -- uv --directory /absolute/path/to/ozon-mcp run ozon-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.pcdck-ozon-mcp-thz2tgie7g]
command = "uv"
args = ["--directory", "/absolute/path/to/ozon-mcp", "run", "ozon-mcp"]

[mcp_servers.pcdck-ozon-mcp-thz2tgie7g.env]
OZON_CLIENT_ID = "your-seller-client-id"
OZON_API_KEY = "your-seller-api-key"
OZON_PERFORMANCE_CLIENT_ID = "your-perf-client-id"
OZON_PERFORMANCE_CLIENT_SECRET = "your-perf-secret"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите PCDCK/ozon-mcp, а в поле команды запуска — строку ниже:

uv --directory /absolute/path/to/ozon-mcp run ozon-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "pcdck-ozon-mcp-thz2tgie7g": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/ozon-mcp",
        "run",
        "ozon-mcp"
      ],
      "env": {
        "OZON_CLIENT_ID": "your-seller-client-id",
        "OZON_API_KEY": "your-seller-api-key",
        "OZON_PERFORMANCE_CLIENT_ID": "your-perf-client-id",
        "OZON_PERFORMANCE_CLIENT_SECRET": "your-perf-secret"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "pcdck-ozon-mcp-thz2tgie7g": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/ozon-mcp",
        "run",
        "ozon-mcp"
      ],
      "env": {
        "OZON_CLIENT_ID": "your-seller-client-id",
        "OZON_API_KEY": "your-seller-api-key",
        "OZON_PERFORMANCE_CLIENT_ID": "your-perf-client-id",
        "OZON_PERFORMANCE_CLIENT_SECRET": "your-perf-secret"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например pcdck-ozon-mcp-thz2tgie7g.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: pcdck-ozon-mcp-thz2tgie7g
    command: uv
    args:
      - "--directory"
      - "/absolute/path/to/ozon-mcp"
      - "run"
      - "ozon-mcp"
    env:
      OZON_CLIENT_ID: your-seller-client-id
      OZON_API_KEY: your-seller-api-key
      OZON_PERFORMANCE_CLIENT_ID: your-perf-client-id
      OZON_PERFORMANCE_CLIENT_SECRET: your-perf-secret

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "pcdck-ozon-mcp-thz2tgie7g": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/ozon-mcp",
        "run",
        "ozon-mcp"
      ],
      "env": {
        "OZON_CLIENT_ID": "your-seller-client-id",
        "OZON_API_KEY": "your-seller-api-key",
        "OZON_PERFORMANCE_CLIENT_ID": "your-perf-client-id",
        "OZON_PERFORMANCE_CLIENT_SECRET": "your-perf-secret"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "uv",
  "args": [
    "--directory",
    "/absolute/path/to/ozon-mcp",
    "run",
    "ozon-mcp"
  ],
  "env": {
    "OZON_CLIENT_ID": "your-seller-client-id",
    "OZON_API_KEY": "your-seller-api-key",
    "OZON_PERFORMANCE_CLIENT_ID": "your-perf-client-id",
    "OZON_PERFORMANCE_CLIENT_SECRET": "your-perf-secret"
  }
}