# MCP для аналитика: данные магазина в своём ИИ-клиенте без выгрузок

> Аналитику: как через MCP получать заказы, продажи, прибыльность и остатки Wildberries прямо в своём ИИ-клиенте, что возвращают инструменты и где границы данных.

published: 2026-08-05
updated: 2026-08-05

MCP (Model Context Protocol) — открытый протокол, по которому ИИ-клиент вроде Claude или Cursor получает доступ к внешним данным и действиям через специальный сервер-посредник. Для селлера Wildberries это означает следующее: вместо копирования выгрузок в чат вы один раз подключаете к своему ИИ-клиенту MCP-сервер платформы и дальше спрашиваете про свой магазин прямо там, где работаете. Данные остаются под вашим контролем: токен ограничен правами, а любое изменение в маркетплейсе всё равно проходит через подтверждение человеком.

## Коротко

- MCP — стандартный способ дать ИИ-клиенту доступ к вашим данным без ручных выгрузок и копипаста.
- У платформы есть свой MCP-сервер: подключается за пару минут через [«Токены доступа»](/settings/mcp-tokens).
- Доступны инструменты чтения (продажи, заказы, склад, прибыльность, реклама, отзывы) и подготовки изменений.
- Права выдаются точечно: инструмент вне прав токена не просто запрещён, а вообще не виден клиенту.
- Изменения в маркетплейсе не выполняются напрямую — они попадают в [«Согласования»](/approvals).
- Токен показывается один раз, может иметь срок жизни и отзывается в один клик.
- Место MCP среди прочих способов автоматизации — в статье [«Автоматизация работы с Wildberries»](/docs/avtomatizatsiya-wildberries).

## Что такое MCP простыми словами

<details>
<summary>Подробно: зачем нужен протокол-посредник</summary>

Языковая модель сама по себе не знает ничего про ваш магазин. Есть три способа это исправить, и только третий масштабируется.

Первый — копировать данные в чат руками. Работает один раз, ломается на объёме, устаревает мгновенно.

Второй — писать для каждой модели свою интеграцию. Дорого и живёт ровно до следующего обновления клиента.

Третий — договориться о едином языке между ИИ-клиентами и источниками данных. Это и есть MCP. Источник (у нас — платформа) публикует набор инструментов с описанием: что делает, какие параметры принимает, что возвращает. Клиент (Claude, Cursor и другие) читает этот список и дальше сам решает, какой инструмент вызвать под ваш вопрос. Вам не нужно ни программировать, ни знать названия инструментов — достаточно спросить словами.

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

</details>

## Что доступно через MCP

<details>
<summary>Подробно: инструменты чтения</summary>

- **Сводные показатели продаж за месяц** — выручка, к перечислению, заказы, средний чек, остатки, расход рекламы, ДРР плюс дневная динамика заказов и выручки.
- **Заказы** — список из общего представления Wildberries и Ozon с фильтрами по периоду, площадке, статусу и поиску, с разбивкой по статусам и постраничной выдачей.
- **Товарный учёт** — четыре представления: сводка по складу, оборачиваемость с прибыльностью по товарам, потребность в закупке и неликвиды с суммой замороженного капитала.
- **Обзор прибыльности по товарам** — выручка, маржа, класс товара по вкладу и остаток, отсортированные по марже.
- **Рекламные кампании Wildberries** — статус, тип ставки и оплаты, бюджет и темп его расхода.
- **Отзывы покупателей Wildberries** — честные сводные цифры по всему периоду (средняя оценка, доля негативных, доля без ответа) и выборка отдельных отзывов, отсортированная худшими вперёд.

Тексты, пришедшие от покупателей и из карточек, помечаются как недоверенные данные — это защита от попытки спрятать инструкцию для модели внутри отзыва или названия товара.

</details>

<details>
<summary>Подробно: инструменты подготовки изменений</summary>

Через MCP доступен и второй набор — операции, меняющие что-то в маркетплейсе. Про них важно понять главное: они не меняют ничего сами. Каждый вызов создаёт заявку, которую человек подтверждает в разделе [«Согласования»](/approvals).

Сейчас доступны: смена цены (Wildberries и Ozon), изменение остатка размера для схемы со склада продавца, правка габаритов упаковки, а также полный набор операций с рекламой Wildberries — пауза и запуск кампании, изменение ставки товара, переименование, места размещения, состав карточек кампании, ставка поискового кластера, минус-фразы, создание кампании, завершение, удаление и пополнение бюджета. Отдельно — добавление товара в акцию календаря.

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

</details>

## Как подключить

Подключение занимает несколько минут и не требует программирования.

1. Откройте страницу [«Токены доступа»](/settings/mcp-tokens).
2. Создайте токен: выберите права и, при желании, срок действия. Сам токен показывается **один раз** — сохраните его сразу, потом в интерфейсе останутся только метаданные.
3. На той же странице скопируйте адрес MCP-эндпоинта и готовый пример конфигурации.
4. Вставьте конфигурацию в настройки своего ИИ-клиента — поддерживаются клиенты, работающие по MCP: Claude Code, Cursor, Codex и другие.
5. Токен передаётся в заголовке авторизации; в примере конфигурации остаётся только подставить его вместо плейсхолдера.

После подключения список доступных инструментов клиент получит сам — он будет ровно таким, какие права вы выдали токену.

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

<details>
<summary>Подробно: пять слоёв ограничений</summary>

**1. Права токена.** Их пять: читать аналитику, читать остатки, читать заказы, предлагать смену цен, предлагать смену остатков. Отмечаются при создании токена по отдельности.

**2. Невидимость вместо запрета.** Инструмент, не покрытый правами токена, не просто отклоняется при вызове — он вообще не появляется в списке доступных. Клиент не знает о его существовании, а значит, не может его вызвать по ошибке или по подсказке из недоверенного текста.

**3. Роль.** Права на изменение доступны только повышенной роли. Токен действует в рамках роли того, кто его выпустил: сотрудник с доступом на чтение не может выдать себе токен с правом менять цены.

**4. Согласование.** Даже с правом на изменение внешний агент создаёт заявку, а не изменение. Источник заявки виден в списке отдельной пометкой — вы всегда отличите действие внешнего агента от действия из интерфейса.

**5. Отзыв и срок.** Токен можно отозвать в один клик, задать ему срок жизни, а на странице видно, когда он использовался последний раз. Дополнительно действуют ограничения частоты запросов.

Ко всему этому добавляются числовые предохранители на странице [«Предохранители цены»](/settings/guardrails) — минимальная цена, максимальное снижение за одно действие, лимиты трат на рекламу. Они применяются одинаково к любому источнику: интерфейсу, встроенному ассистенту и внешнему агенту.

</details>

## Когда MCP лучше встроенного ассистента

Встроенный [ИИ-ассистент](/docs/ii-agent-dlya-marketpleysov) удобнее для повседневной работы: он видит контекст открытой страницы, рисует графики и знает больше инструментов. MCP выигрывает в другом: когда у вас уже есть свой ИИ-рабочий процесс и вы хотите, чтобы данные магазина были доступны прямо в нём — вместе с вашими файлами, таблицами и другими источниками. Это же путь для агентств и разработчиков, строящих собственные сценарии поверх данных клиентов.

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

**Что такое MCP простыми словами?**
Это стандартный способ дать ИИ-клиенту доступ к внешним данным и действиям. Источник публикует список инструментов, клиент их читает и вызывает нужный под ваш вопрос.

**Можно ли подключить ChatGPT или Claude к Wildberries?**
Напрямую к кабинету — нет. Через MCP-сервер платформы ваш ИИ-клиент получает доступ к уже собранным данным магазина и к операциям, которые проходят через подтверждение.

**Есть ли MCP-сервер для Wildberries?**
Да, он встроен в платформу: токен выпускается на странице «Токены доступа», конфигурация копируется оттуда же.

**Безопасно ли давать ИИ доступ к данным магазина через MCP?**
Токен ограничен правами и ролью, недоступные инструменты не видны клиенту вовсе, изменения проходят через согласование, а токен можно отозвать в любой момент.

**Может ли внешний ИИ-агент изменить цену на Wildberries?**
Сам — нет. Он может только создать заявку, которую подтверждает человек, и только если токену выдано соответствующее право.

**Что будет, если токен утёк?**
Отзовите его на странице токенов. Права токена ограничены, изменения без подтверждения невозможны, а последнее использование видно в списке.

**Нужны ли навыки программирования?**
Нет. Требуется вставить готовый фрагмент конфигурации в настройки своего ИИ-клиента.

## Коротко

- MCP отдаёт не сырьё маркетплейса, а уже собранные и сведённые показатели — те же, что в разделах платформы.
- Доступны продажи, заказы, склад в четырёх представлениях, прибыльность по товарам, рекламные кампании и отзывы.
- Период задаётся пресетом или диапазоном дат; списки выдаются постранично.
- Сводные цифры считаются по всему периоду, а выборка строк обрезана лимитом — это разные вещи.
- Тексты покупателей и карточек помечены как недоверенные, чтобы инструкция внутри отзыва не влияла на модель.

## Что именно приходит в ответ

<details>
<summary>Подробно: инструменты и их разрезы</summary>

**Сводные показатели продаж.** Выручка, к перечислению, заказы, средний чек, остатки, расход рекламы, ДРР за месяц плюс дневной ряд заказов и выручки. Это готовая база для тренда, без ручного агрегирования.

**Заказы.** Список из общего представления обеих площадок с фильтрами по периоду, площадке, статусу и поисковой строке, с разбивкой по статусам. Выдача постраничная, поэтому большой период разбирается итеративно, а не одним гигантским ответом.

**Товарный учёт.** Четыре разных представления одним инструментом: сводка по складу; оборачиваемость вместе с прибыльностью по товарам; потребность в закупке с признаком «пора заказывать»; неликвиды с суммой замороженного капитала.

**Обзор прибыльности по товарам.** Выручка, маржа, класс товара по вкладу в результат и остаток, отсортированные по марже. Важно понимать, что это обзор всего ассортимента из витрины товарооборота, а не подробный P&L одного товара по датам реализации — это два разных среза, и смешивать их нельзя.

**Рекламные кампании.** Статус, тип ставки и оплаты, бюджет и темп его расхода — сколько дней хватит при текущей скорости. Завершённые и отклонённые кампании в выдачу не попадают.

**Отзывы.** Здесь возвращаются две разные вещи одновременно: сводка по всем отзывам периода (средняя оценка, доля негативных, доля без ответа, общее число) и выборка отдельных отзывов, отсортированная худшими вперёд и обрезанная лимитом. Для оценки картины годится только первая часть.

</details>

## Методические тонкости

<details>
<summary>Подробно: что не сломает выводы, если помнить</summary>

**Деньги.** Денежные величины передаются в копейках целым числом. Это сделано специально: округления в промежуточных вычислениях — главный источник расхождений при сверке.

**Остатки.** Это снимок на дату, а не показатель за период. При построении временных рядов остаток нельзя суммировать по дням как выручку.

**Площадки.** Показатели заказов и продаж сведены по обеим площадкам, а реклама собирается только по Wildberries. В строках Ozon рекламные колонки — отсутствие данных, а не ноль.

**Себестоимость.** Маржа без заполненной себестоимости считается до себестоимости. Сумма замороженного капитала в неликвидах при незаполненной себестоимости честно равна нулю, а не оценочной величине.

**Недоверенные тексты.** Названия товаров, имена брендов и тексты отзывов оборачиваются как данные, а не как указания. Это важно при построении собственных агентов: попытка внедрить инструкцию через текст отзыва не превратится в команду.

</details>

## Как это встраивается в аналитический процесс

Типичный сценарий: у вас есть собственные материалы — планы закупок, себестоимость от поставщика, прошлые отчёты — и вы хотите сопоставить их с фактом. Через MCP факт приходит в тот же контекст, где лежат ваши файлы, и сопоставление делается в одном месте, без промежуточных выгрузок и без риска перепутать версию файла.

Второй сценарий — регулярная отчётность. Один и тот же набор вопросов задаётся с фиксированными границами периода, и результат воспроизводится: цифры берутся из того же источника, что и разделы платформы, поэтому расхождения между отчётом и интерфейсом не возникает.

Для глубоких аналитических разрезов — декомпозиция падения продаж, корреляции с лагами, воронка, поисковая семантика, история цены и остатка — сейчас богаче встроенный [ИИ-ассистент](/docs/ii-agent-dlya-marketpleysov): у него инструментов заметно больше. Набор MCP покрывает базовые срезы и постепенно расширяется.

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

**Чем данные из MCP отличаются от API Wildberries?**
Через MCP приходят уже собранные, очищенные и сведённые показатели, включая общий вид для Wildberries и Ozon. Из API маркетплейса пришло бы сырьё, которое нужно нормализовать самому.

**Можно ли получить произвольный период?**
Да, период задаётся либо пресетом в днях, либо диапазоном дат.

**Как работать с большим объёмом заказов?**
Выдача постраничная — забирайте страницами, а для сводных величин используйте агрегаты, а не пересчёт списка.

**Совпадут ли цифры с разделами платформы?**
Да, источник один и тот же, поэтому расхождения быть не должно.

**Есть ли ограничения по частоте запросов?**
Да, действуют ограничения частоты — их стоит учитывать при массовых обходах.

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

**Почему обзор прибыльности и P&L одного товара расходятся?**
Это разные срезы: обзор строится по витрине товарооборота за период, а подробный P&L товара привязан к датам реализации. Сравнивать их напрямую нельзя.

**Как обрабатывать денежные величины?**
Они приходят целыми числами в копейках — переводите в рубли только на выводе, чтобы не накапливать ошибку округления.
