Мегамаркет через MCP: заказы, остатки, цены и возвраты одним токеном

Обзор

У Мегамаркета (бывший СберМегаМаркет) партнёрский API устроен иначе, чем у Ozon или Wildberries: вместо привычного REST — конверт {"meta": {...}, "data": {...}}, а токен едет не заголовком, а полем внутри самого запроса. Доступ выдаётся самообслуживанием: в личном кабинете продавца (partner.megamarket.ru) один клик — и в разделе «Настройки → Интеграция API» готов авторизационный токен. Пары ключей, обмена и одобрения заявки не нужно.

Mira подключает эту часть API — заказы, остатки, цены, покупательские возвраты — и отдаёт её в Claude через MCP.

Что доступно продавцу

Устройство, которое стоит знать заранее

Одна форма запроса на все методы

Каждый вызов — это POST с телом {"meta": {}, "data": {"token": "...", ...поля}}. Ответ при успехе — {"success": 1, "data": {...}}, при отказе — {"success": 0, "error": {"message": "...", "code": ...}}. Отдельно есть отказ ещё до входа в саму операцию — неверный или просроченный токен отвечает кодом 401 и другим конвертом: {"errors": [{"code": "unauthorized", "message": "..."}]}. В Mira оба случая разбираются одинаково понятно: причина приходит от поставщика, а не теряется в разнице форматов.

У «новых заказов» нет отдельного метода

По смыслу названий кажется, что должен быть метод вроде order/new. У Мегамаркета его нет — новые заказы получают тем же методом, что и любой список отправлений, с фильтром по статусу. Экономит один метод в голове, но ломает интуицию, если сравнивать с другими площадками.

Документация закрыта JS-защитой — проверено вживую, а не по памяти

Портал документации Мегамаркета отвечает JS-проверкой на любой прямой запрос, а открытого зеркала спецификации (как у Ozon Performance) для него нет. Таблицу методов Mira собирала не «по смыслу названий» — а перебором прямых запросов к самому API: несуществующий путь отвечает пустым 403 от nginx, а настоящий — содержательным JSON-отказом авторизации. Так подтверждён список из девяти действий, и так же исключены методы, которые упоминались в сторонних инструкциях, но не существуют на самом деле.

Не весь состав полей документирован в открытых источниках

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

Возвраты — с дедлайном и точной суммой

Мегамаркет ждёт оповещение о покупательском возврате не позднее конца следующего дня после того, как товар получил продавец — иначе не пересчитаются выплаты по бонусным программам. Сумма возврата по каждому лоту должна совпасть с финальной ценой из заказа: не «примерно», а ровно.

Как это выглядит через MCP

Какие новые заказы пришли на Мегамаркете за сегодня?

Claude запрашивает список отправлений с фильтром по статусу и возвращает их структурированно — без похода в кабинет.

Подтверди заказ 65453546 и отметь его собранным

Claude подтверждает заказ, затем подтверждает сборку — оба шага требуют разрешения на запись у источника.

Что защищено от случайного действия

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

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

1. Личный кабинет продавца (partner.megamarket.ru) → Настройки → Интеграция API.
2. Скопировать авторизационный токен продуктовой среды (не тестовой — они разные).
3. В Mira: проект → источники → Мегамаркет → вставить токен.

Дальше Мегамаркет доступен и в чате Mira, и через MCP-сервер в Claude, Cursor или другом клиенте с поддержкой протокола.