❄️ freezer-mcp

MCP-сервер для «холодильник.ру» — поиск товаров и оформление заказов через инструменты, которые вызывает ИИ-ассистент.

токен ещё не задан · нужны креды OMS

Что это простыми словами

Представьте интернет-магазин холодильников. Этот сервис даёт ИИ-ассистенту всё для покупки целиком: сначала найти товар в каталоге, а потом оформить и оплатить заказ.

Технически это две части: поиск по товарному фиду (каталог с характеристиками и наличием) и OMS — Order Management System (система управления заказами), которая ведёт заказ от корзины до «доставлено и оплачено».

Как это связано. Всё держится на числовом offerId. Поиск находит товар и отдаёт его offerId → этот же offerId кладётся в корзину и в заказ. В самом OMS-API поиска нет — он приходит из официального товарного фида холодильник.ру.

Важно про цену: цена из фида справочная и может отличаться от цены OMS (проверено на живых данных: фид 35 399 ₽ против 42 990 ₽ в OMS). Источник истины — check_cart: если он сообщит о расхождении, в его же ответе лежит актуальная цена, с которой нужно повторить вызов.

Что умеет — 6 шагов

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

Инструменты (13)

Поиск товаров

Инструмент	Источник	Что делает
`search_products`	`товарный фид`	Поиск по каталогу: запрос + фильтры (бренд, категория, цена от/до, только в наличии, сортировка). Отдаёт offerId, название, бренд, цену и наличие. offerId → в get_product и check_cart / create_order.
`get_product`	`товарный фид`	Полная карточка товара по offerId: все характеристики, описание, картинки, габариты, вес, инструкции и наличие по городам.
`list_catalog_facets`	`товарный фид`	Список брендов и категорий с количеством товаров — чтобы понять, что есть в каталоге, и сузить поиск.

Корзина и цены

Инструмент	Источник	Что делает
`check_cart`	`POST /api/calculate`	Проверить корзину по offerId: в наличии ли товары, актуальная цена, скидки по промокоду/акции, какие доступны доставка и оплата.
`check_checkout`	`POST /api/calculate_checkout`	То же, но под оформление: с адресом и датой доставки считает итоговую стоимость доставки.

Доставка

Инструмент	Источник	Что делает
`get_delivery_options`	`POST /api/delivery`	Стоимость, даты и интервалы доставки для набора товаров на конкретный адрес.

Заказы

Инструмент	Источник	Что делает
`create_order`	`POST /api/orders/create`	Создать заказ: товары + данные покупателя + доставка. Возвращает id, статус и ссылку на оплату.
`get_order`	`GET /api/orders/{id}`	Получить заказ по внутреннему id.
`get_order_status`	`GET /api/orders/{externalId}/status`	Получить заказ и его статус по вашему внешнему id.
`get_order_history`	`GET /api/orders/{externalId}/history`	История смены статусов заказа.

Оплата

Инструмент	Источник	Что делает
`create_payment_link`	`POST /api/orders/{externalId}/payment-link`	Создать или перевыпустить ссылку на оплату заказа.
`invalidate_payment_link`	`POST /api/orders/{externalId}/invalidate-payment-link`	Аннулировать текущую ссылку на оплату.

Тест / стейдж

Инструмент	Источник	Что делает
`test_change_order_status`	`POST /api/orders/{externalId}/status/test`	Тестовая смена статуса заказа (для стейджа): send-to-delivery → delivered → complete.

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

Подключите этот адрес как remote MCP в Claude или любом MCP-клиенте (транспорт Streamable HTTP):

https://freezer-mcp.pay0.ru/mcp

Машиночитаемый JSON со списком инструментов: /info · проверка живости: /health

🔒 Доступ закрыт. Эндпоинт /mcp сейчас открыт (режим локальной разработки).

bearer — заголовок Authorization: Bearer <токен>;
url-token — параметр ?mcp_token=<токен> для клиентов, которые не умеют слать заголовки (только по HTTPS).

Сравнение токена — постоянное по времени; без настроенного токена сервер отвечает 503, а не пускает всех подряд.

Доступ к OMS (это отдельный, «верхний» токен самого магазина). Задаётся переменной OMS_API_TOKEN или заголовком X-OMS-Token на запрос.

Пока OMS-токена нет: поиск по каталогу работает, а корзина/заказы вернут понятную ошибку «token is not configured» — без молчаливых сбоев.