InSales через API и MCP: 195 действий на весь интернет-магазин, без единой строки кода

Обзор

InSales — одна из старейших российских платформ для интернет-магазинов: у каждого магазина свой поддомен вида магазин.myinsales.ru, и там же живёт REST API, документированный на api.insales.ru. Подключиться можно самому — API-ключ и пароль к нему выдаются в личном кабинете без заявок и одобрений.

Mira подключает этот API — 195 действий в 25 разделах — и отдаёт его в Claude через MCP. Ниже — что там есть на самом деле и с чем пришлось разбираться отдельно.

Что доступно

Документации много, а спецификации нет

У Авито, Ozon Performance, Модульбанка и ещё десятка коннекторов Mira сверяет таблицу вызовов с официальной машиночитаемой спецификацией — OpenAPI или Swagger — программой, а не на глаз. У InSales такой спецификации нет вовсе: api.insales.ru отдаёт длинную HTML-страницу с прозой и примерами curl, и парсить в ней нечего.

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

Обёртка тела запроса — это не мелочь

InSales — Rails-приложение, и почти любое создание или изменение ждёт тело не плоским JSON, а обёрнутым: {"product": {...поля...}}, {"order_line": {...}}, {"webhook": {...}}. Забыть обёртку — значит получить отказ поставщика на пустом месте: сервер увидит тело без ожидаемого ключа и не поймёт, что вы имели в виду. Инструмент Mira держит имя обёртки в самой таблице вызовов — рядом с методом и путём, а не как отдельное знание, которое можно забыть при следующей правке.

Почти всё видно покупателю сразу

У InSales нет резкой границы между «внутренней» настройкой и «витринным» изменением: поменяли цену товара — она уже другая в каталоге; поменяли статус заказа — покупатель увидит его в личном кабинете и письме; создали промокод — он уже работает в кассе; добавили JS-тег — он выполнится в браузере каждого посетителя магазина. Барьер записи Mira требует явного разрешения на любое из 117 меняющих действий — независимо от того, выглядит правка внутренней или нет, потому что на витрине интернет-магазина эта граница почти не существует.

Живая проверка

Живых ключей от боевого магазина InSales нет — раздел появится, когда владелец магазина их даст. Сборка адреса, обёртка тела, барьер записи и Basic-заголовок проверены против собственного HTTP-сервера в тестах (перехват на транспорте — тот же приём, что у Авито, Модульбанка и Точки), а не против настоящего myinsales.ru.