Skip to main content
Glama
Ozon Seller MCP
by pdr086

Ozon Seller MCP

Открытый навык и MCP-сервер для аналитики магазина Ozon. Вы запускаете сервер на своём Linux VPS, вводите ключ своего магазина и подключаете сервер в ChatGPT через Secure MCP Tunnel. Один экземпляр обслуживает один магазин.

Пять инструментов проверяют подключение, показывают заказы по дням, остатки FBO и FBS, причины возвратов и текущую цену по артикулу. Все инструменты работают на чтение.

1. Подготовьте VPS и ключ Ozon

На VPS понадобятся Git, Docker и доступ по HTTPS к Seller API и OpenAI. Для установки через Secure MCP Tunnel достаточно исходящих соединений. Отдельный домен и публичный HTTP-порт для MCP не нужны.

В Ozon Seller откройте Настройки → Seller API и создайте ключ на чтение с доступом к товарам, аналитике и возвратам. Запишите Client ID и ключ. Новые ключи действуют три месяца. Авторизация Seller API · Срок действия ключей

Проверьте доступность Добавить собственный MCP-сервер в веб-версии ChatGPT до настройки. OpenAI документирует чтение для Pro и доступ для Business и Enterprise/Edu с соответствующими разрешениями. Подключение произвольного MCP на Plus по этой инструкции не подтверждено. Тарифы и разрешения

Related MCP server: marketplaces-mcp-ru

2. Запустите свой MCP

Выполните на VPS:

git clone https://github.com/pdr086/ozon-seller-mcp.git
cd ozon-seller-mcp
docker build -t ozon-seller-mcp:0.1.0 .
install -d -m 700 data

Введите свои данные в интерактивном терминале:

docker run --rm -it --user "$(id -u):$(id -g)" \
  --mount "type=bind,source=$PWD/data,target=/data" \
  ozon-seller-mcp:0.1.0 configure

Команда скрывает ввод, проверяет ключ в Ozon и сохраняет его в data/credentials.json с правами 0600. Запустите сервер с этим каталогом на чтение:

docker run -d --name ozon-seller-mcp --restart unless-stopped \
  --user "$(id -u):$(id -g)" \
  --publish 127.0.0.1:8765:8765 \
  --mount "type=bind,source=$PWD/data,target=/data,readonly" \
  ozon-seller-mcp:0.1.0

docker exec ozon-seller-mcp python -m ozon_seller check

Ожидаемый результат — «Подключение к Ozon проверено». MCP доступен на самом VPS по http://127.0.0.1:8765/mcp. Для смены ключа повторите configure. Для другого часового пояса добавьте в команду запуска контейнера --env OZON_TIMEZONE=Asia/Yekaterinburg. По умолчанию используется Europe/Moscow.

3. Соедините VPS с ChatGPT

  1. В OpenAI Platform → Tunnels создайте туннель, сопоставьте его с тем же аккаунтом или рабочим пространством ChatGPT и получите отдельный runtime-ключ с правом использования туннеля.

  2. Скачайте официальный tunnel-client для архитектуры VPS. На VPS подготовьте профиль. Вместо tunnel_... укажите идентификатор своего туннеля.

    tunnel-client init --sample sample_mcp_remote_no_auth \
      --profile ozon-seller --tunnel-id tunnel_... \
      --mcp-server-url http://127.0.0.1:8765/mcp
    
    read -r -s -p "OpenAI Tunnel runtime key: " CONTROL_PLANE_API_KEY
    printf '\n'
    export CONTROL_PLANE_API_KEY
    tunnel-client doctor --profile ozon-seller --explain
    tunnel-client run --profile ozon-seller

    Оставьте процесс запущенным для проверки. Для постоянной работы запускайте tunnel-client с этим профилем под диспетчером служб, используя закрытые настройки окружения. Руководство OpenAI по туннелю

  3. В веб-версии ChatGPT → Плагины выберите Добавить → Добавить собственный MCP-сервер → Tunnel. Укажите свой туннель. Если форма спрашивает тип авторизации, выберите No authentication для этого приватного туннеля. Создайте личный плагин и проверьте, что ChatGPT обнаружил пять инструментов. Ключ Ozon уже хранится на VPS.

  4. Откройте новый обычный Чат на телефоне под тем же аккаунтом. Выберите установленный плагин через @ и спросите «Проверь подключение к Ozon». Затем запросите данные магазина и сравните один результат с кабинетом продавца.

Что спросить

Пример

Что покажет сервер

«Покажи продажи за неделю»

Заказанные штуки и сумму заказов за семь полных дней. Начисления и выплаты показываются в других отчётах Ozon.

«Что заканчивается на FBS? Порог 3 штуки»

Остаток за вычетом резерва. Результат отмечает неполный охват каталога.

«Проанализируй возвраты за неделю»

Количество записей и штук, типы, частые причины и артикулы по дате возврата в логистике.

«Какая сейчас цена у артикула X?»

Цену продавца и валюту, которую вернул Ozon.

Права и тариф Seller API могут ограничивать доступ к отдельным отчётам. Плагин сообщает об ошибке вместо пустого отчёта. API-ключ передаётся только официальному Seller API. ChatGPT получает выбранные поля и агрегаты.

Где находится навык

SKILL.md содержит правила вызова инструментов и объясняет значения показателей. Сервер передаёт этот текст при инициализации MCP. Для установки через туннель достаточно настроить свой MCP и создать личный плагин. Для клиента с отдельной поддержкой Agent Skills можно скачать репозиторий и взять весь каталог skills/ozon-seller.

plugin.json описывает пакет навыка. mcp.json.example показывает адрес MCP для клиента на том же VPS. Код сервера находится в ozon_seller, инструкция по методам поддерживается в документации Seller API.

Лицензия MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      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/ba
      15
      26
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects AI assistants to Wildberries and Ozon seller accounts for real-time access to sales, stocks, prices, finances, and reviews through official APIs.
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      MCP server for the Ozon Seller and Performance API: 151 tools for prices, promotions, ads, orders, returns, finance and analytics. Multi-store, encrypted keys, web dashboard and self-diagnostics; Docker with SSE or stdio.
      156
      147 PyPI
      11
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables read-only analytics and product search for a Wildberries seller account, covering items, advertising, sales, stock, reviews, finances, and tariffs through MCP clients like ChatGPT or Cursor.
      12
      MIT