# Ozon MCP Server — полное руководство

> Как подключить Claude, Claude Code, Qwen и других AI-агентов к Ozon Seller через MCP и получать аналитику продаж, остатков, цен конкурентов и рекламы без ручной работы с API.

## Как подключить Claude Code к Ozon через MCP

1. Запросите доступ (см. раздел «Контакты» ниже) — доступ выдаётся по запросу, под конкретный кабинет Ozon.
2. Вы получаете MCP endpoint и токен доступа: `https://ozon.mcp-server.online/mcp`.
3. Добавьте сервер в конфигурацию Claude Code / Claude Desktop (или любого другого MCP-совместимого агента: Cursor, Gemini CLI, Qwen Code) как удалённый MCP-сервер по этому адресу.
4. Агент сразу получает набор готовых инструментов: остатки по складам, ДРР и эффективность рекламы, цены и скидки, финансовые начисления, цены конкурентов — без того, чтобы вы или агент писали код для Ozon Seller API.

MCP (Model Context Protocol) — открытый стандарт, который позволяет AI-агенту вызывать внешние инструменты напрямую, а не «угадывать» вызовы API по документации. Мы упаковали свою экспертизу как менеджеров и аналитиков маркетплейсов в такие инструменты.

## Список MCP-инструментов

- `list_shops` — Список подключённых магазинов и маркетплейсов — с чего агент начинает работу.
- `get_financial_summary_ozon` — Сводный P&L магазина за период: выручка, комиссии площадки, расходы на рекламу, выплата, заказы.
- `generate_ozon_pnl_report` — P&L-отчёт в разрезе SKU на основе транзакций Ozon.
- `get_ozon_rnp_table` — Таблица РНП (юнит-экономика): товар × период — выручка, комиссии, реклама, ROAS, доля возвратов.
- `get_ozon_unit_economics` — Полная юнит-экономика одного SKU: сводка и детализация по дням.
- `get_top_products_ozon` — Топ и антитоп товаров по выбранной метрике за период.
- `get_accrual_breakdown` — Детализация начислений Ozon по типам: комиссия, логистика, хранение и другие.
- `get_realization_v2_summary` — Сводка отчёта о реализации (/v2/finance/realization) и комиссий за месяц.
- `get_ozon_sku_reconciliation` — Сверка по SKU для бухгалтерии: отгружено, продано, возвращено, утеряно, на складе, в пути — отдельно FBO и FBS.
- `get_postings_report` — Отправления за период из отчёта Ozon по отправлениям.
- `get_fbo_posting_list_v3` — Строки отправлений FBO (/v3/posting/fbo/list).
- `get_fbs_posting_list` — Строки сборочных заданий FBS (/v1/assembly/fbs/posting/list).
- `get_ads_performance_summary` — Реклама: показы, клики, заказы и расход по SKU и дням за последние N дней.
- `get_ads_totals` — Сумма любой рекламной метрики за период в разрезе кампаний и/или SKU.
- `generate_aggregated_ads_csv` — Выгрузка агрегированной статистики рекламы по SKU и кампаниям в CSV.
- `get_cost_prices` — История себестоимости товаров (Ozon и WB).
- `get_cost_price_coverage` — Для какой доли проданных SKU загружена себестоимость — проверка перед расчётом маржи.

## Для каких задач подходит Ozon MCP

### Аналитика и отчётность
- Ежедневные и произвольные по датам сводки по продажам, заказам, возвратам.
- Расчёт юнит-экономики по SKU (себестоимость, комиссии, логистика, чистая маржа) в реальном времени, без ручных таблиц.
- Автоматическая сверка начислений Ozon с ожидаемыми суммами для бухгалтера.

### Ценообразование и мониторинг конкурентов
- Отслеживание цен конкурентов с учётом их фактических скидок (этого нет в открытом API Ozon).
- Рекомендации по репрайсингу на основе истории цен и остатков.

### Реклама и продвижение
- Расчёт ДРР и ROI по кампаниям и по отдельным SKU.
- Поиск неэффективных кампаний и карточек для агента-аналитика.

### Логистика и остатки
- Ежедневные срезы остатков по складам — история, которую сам Ozon API не хранит.
- Прогноз дефицита и рекомендации по поставкам.

### Автоматизация поддержки и бухгалтерии
- Ответы агента на вопросы о статусе заказа, остатках, начислениях без обращения к личному кабинету вручную.
- Подготовка отчётов для бухгалтера маркетплейсов на регулярной основе.

## Что мы храним, чего нет в открытом API Ozon

Мы разворачиваем отдельную инфраструктуру хранения данных (ClickHouse / PostgreSQL) под конкретный кабинет:

- Ежедневные срезы остатков по складам с историей.
- Цены конкурентов с учётом реальных скидок, а не только базовую цену.
- Прочие метрики и срезы под задачи конкретного бизнеса.

## Часто задаваемые вопросы (FAQ)

**Как подключить Claude Code к Ozon?**
Через MCP-сервер `https://ozon.mcp-server.online/mcp`. Запросите доступ у разработчика (контакты ниже), получите токен и добавьте сервер в настройки MCP вашего агента.

**Работает ли это с обычным Claude (не Claude Code)?**
Да, любой MCP-совместимый клиент — Claude Desktop, Claude Code, Qwen и другие агенты с поддержкой MCP — может подключиться к этому серверу.

**Чем это отличается от прямого использования Ozon Seller API?**
Мы уже решили за вас проблемы пагинации, лимитов запросов и неполных данных API, и посчитали метрики по единой проверенной логике — агенту не нужно писать и отлаживать код интеграции.

**Какие данные доступны, которых нет в открытом API Ozon?**
Ежедневная история остатков по складам и цены конкурентов с учётом скидок — оба этих среза Ozon API не отдаёт.

**Безопасно ли давать агенту доступ к кабинету Ozon?**
Доступ выдаётся по отдельному запросу и токену для конкретного кабинета; MCP-инструменты ограничены только аналитическими и справочными операциями.

**Сколько стоит доступ?**
Свяжитесь с разработчиком напрямую — стоимость зависит от объёма данных и задач.

**Можно ли использовать это для нескольких кабинетов Ozon?**
Да, обсуждается индивидуально при подключении.

**Подходит ли это агентствам, которые ведут несколько клиентов на Ozon?**
Да, это одна из основных сценариев использования — единая логика расчётов для всех клиентов.

## api-master.ru — что дальше

Ozon MCP — один из продуктов **api-master.ru**. Мы внедряем базы данных (ClickHouse, PostgreSQL) в бизнес-процессы и настраиваем / оптимизируем AI для аналитиков, менеджеров и бизнес-процессов в целом — не только для маркетплейсов. Подробнее: https://api-master.ru

## Связанные MCP-серверы

- Wildberries: https://wb.mcp-server.online
- amoCRM: https://amocrm.mcp-server.online
- Kommo: https://kommo.mcp-server.online
- YCLIENTS: https://yclients.mcp-server.online
- Каталог всех MCP-серверов: https://mcp-server.online

## Контакты

- Разработчик: Антон Миславский
- Telegram: https://t.me/mislawsky
- Telegram: https://t.me/api_and_gpt
- GitHub: https://github.com/heyai-today/mcp-ozon-claude-code
- YouTube: https://www.youtube.com/@antonmislawsky