Uzum Market API через MCP: документации нет, а спецификация — есть, прямо в личном кабинете

Обзор

У Uzum Market — крупнейшего маркетплейса Узбекистана — нет публичной страницы для разработчиков. Ни developers.uzum.uz, ни раздела «API» в руководстве продавца: инструкция на seller.uzum.uz/manual/ рассказывает про интерфейс личного кабинета, а не про интеграции.

Но сам личный кабинет продавца отдаёт настоящую спецификацию. Встроенный Swagger UI (api-seller.uzum.uz/api/seller-openapi/swagger/...) грузит конфигурацию, а та называет адрес самого OpenAPI-документа — Uzum market seller openapi, версия 1.0.0. Это не пересказ и не зеркало третьей стороны: тот же JSON, который отдаёт сам поставщик за собственным доменом.

Mira подключает Seller API целиком — 38 методов в восьми разделах — и отдаёт его в Claude через MCP.

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

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

Токен — один, и без «Bearer»

Продавец выпускает единственный токен сам, в личном кабинете (seller.uzum.uz → Настройки → API), и вставляет его в форму подключения Mira. Обмена ключей на токен здесь нет — не как у Авито или Ozon Performance, где backend сам меняет пару ключей на рабочий токен. И заголовок авторизации — не привычный Bearer <токен>: спецификация прямо говорит, что префикс отправлять не нужно. С «Bearer» Uzum отвечает 401, неотличимым от неверного токена, — деталь, которую легко упустить, если писать интеграцию по образцу других площадок.

Платного продвижения в этом API нет

В спецификации нет ни кампаний, ни ставок, ни рекламного кабинета — только товары, остатки, цены, поставки, заказы, накладные и финансовые отчёты. Барьер записи покрывает 12 действий (изменение цены, статусов заказа, остатков, накладных), но ни одно из них не списывает деньги напрямую — это решение самого API, а не то, что Mira решила не показывать.

Печать документов — Base64 внутри JSON, а не файл

У большинства площадок печать этикетки или акта — это отдельный HTTP-ответ с файлом. У Uzum печать в основном устроена иначе: JSON-конверт, а внутри поля document — PDF, закодированный в Base64. Полтора мегабайта PDF превращаются в два мегабайта текста прямо в теле ответа. Инструмент Mira эту особенность не передаёт агенту целиком — отдаёт размер и тип, как и с обычным файлом при скачивании. Только печать этикеток товара (barcode_print) отвечает настоящим application/pdf — тут спецификация не разошлась сама с собой.

Баг в самой документации, а не в интеграции

У трёх методов раздела «накладные сборки» путь в спецификации содержит {invoiceId}, а объявленный параметр называется иначе — id у двух методов и не назван вовсе у третьего (при этом то же значение требуется в теле запроса). Это несогласованность самой публикуемой Uzum спецификации, а не повод либо гадать по смыслу, либо переписывать таблицу вызовов под чужую опечатку: адрес и подстановка значения работают по тому, что реально написано в шаблоне пути, и это зафиксировано отдельной проверкой контракта.

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

Какие заказы Uzum ждут подтверждения?

Claude запрашивает список заказов по статусу CREATED, показывает, что нужно собрать в первую очередь.

Обнови остатки по SKU 3001 — на складе осталось 5 штук

Claude вызывает обновление остатков, барьер записи проверяет разрешение источника перед тем, как запрос уйдёт к поставщику.

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

Из 38 методов 12 меняют данные: правка цены; подтверждение, отмена и привязка идентификаторов заказа; передача, подтверждение выдачи и возврат по DBS; обновление остатков; создание, изменение состава, отмена и обновление таймслота накладной. Барьер выведен из той же таблицы, где описан каждый метод, — тем же устройством, что у Авито, Ozon и Ozon Performance в Mira.

Что это даёт на практике

Продавцу. Заказы, остатки и цены одним вопросом — без переключения между личным кабинетом Uzum и таблицами учёта.

Логисту. Жизненный цикл FBS/DBS-заказа — от подтверждения до накладной сборки — доступен в чате, без ручного похода в каждый раздел кабинета.

Разработчику. Готовый клиент вместо самостоятельной охоты за спецификацией через Swagger UI и разбора нестандартного заголовка авторизации.

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

1. Личный кабинет продавца (seller.uzum.uz) → Настройки → API.
2. Создать токен и скопировать его.
3. В Mira: проект → источники → Uzum Market → вставить токен.

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