API и MCP для интеграций

MCP-сервер

Протокол Model Context Protocol, транспорт streamable HTTP, без ключей.

https://5dyuymov.ru/api/mcp/mcp

Claude Code

claude mcp add --transport http 5dyuymov https://5dyuymov.ru/api/mcp/mcp

Claude Desktop, Cursor и другие клиенты

{
  "mcpServers": {
    "5dyuymov": {
      "url": "https://5dyuymov.ru/api/mcp/mcp"
    }
  }
}

Инструменты

• search_productsпоиск по каталогу, понимает Ду/Ру
• get_productкарточка: характеристики, исполнения, цены, артикулы
• find_by_skuисполнения по списку артикулов с ценами
• list_categoriesдерево разделов
• get_recommendationsпохожие товары и обвязка того же диаметра
• parse_specспецификация текстом → позиции каталога с ценами
• build_cartкорзина из исполнений и ссылка для покупателя
• estimate_deliveryсамовывоз, доставка магазином, тарифы ТК по городу
• create_invoice_orderзаказ с оплатой по счёту для юрлица и ссылка на счёт; dry_run — проверка без оформления
• suggest_accessories_for_cartобвязка ко всей корзине: фланцы, приводы, фильтры того же Ду с количеством
• select_actuatorподбор привода по Ду, моменту и фланцу ISO с запасом 30 %
• my_ordersзаказы покупателя: номер, сумма, оплата, отгрузка, счёт (нужен вход по OAuth)
• my_loyaltyбаланс бонусов, статус и доступное списание (нужен вход по OAuth)
• reorderсобрать корзину из позиций прошлого заказа (нужен вход по OAuth)
• get_orderстатус заказа: оплата, отгрузка, состав

REST API

Store API Medusa: JSON, ключ витрины в заголовке x-publishable-api-key, ответы в рублях.

Базовый адрес: https://api.5dyuymov.ru
Ключ витрины:  pk_daabb8b1033eb5ca1058a9ff3800f1cf60b5d560d8d097af6fb2f31966ba4060

curl "https://api.5dyuymov.ru/store/meilisearch/products?query=затвор+ду+50+ру+16&limit=3&fields=id,title,handle,+metadata" \
  -H "x-publishable-api-key: pk_daabb8b1033eb5ca1058a9ff3800f1cf60b5d560d8d097af6fb2f31966ba4060"

Основные маршруты

• GET /store/products?q=&category_id[]=&limit=товары; поля через fields, цены с region_id
• GET /store/products/:idкарточка с исполнениями
• GET /store/meilisearch/products?query=полнотекстовый поиск с опечатками и Ду/Ру
• GET /store/variants-by-sku?sku=a,bисполнения по артикулам
• GET /store/product-categoriesразделы
• GET /store/recommendations/:product_idпохожие и обвязка
• POST /store/carts, /store/carts/:id/line-itemsкорзина
• GET /store/shipping-options?cart_id=способы доставки
• POST /store/carts/:id/completeоформление заказа
• GET /store/orders/:idзаказ по id
• POST /store/quotes (с входом покупателя)запрос коммерческого предложения

Полное описание Store API — в документации Medusa v2. Для ИИ-агентов есть и llms.txt. Адрес бэкенда переедет на постоянный хостинг, страница обновится автоматически.

Вход покупателя по OAuth

Каталог, подбор и сборка корзины работают без входа. Личные инструменты — заказы, бонусы, повтор заказа — открываются после входа: сервер поддерживает OAuth 2.1 с PKCE, динамическую регистрацию клиента и документ метаданных клиента, как требует спецификация протокола.

• /.well-known/oauth-protected-resource — описание ресурса
• /.well-known/oauth-authorization-server — описание сервера авторизации
• Права: каталог, заказы, корзина. Вход — по почте и паролю магазина.

Клиенты вроде Claude и Cursor находят эти адреса сами: достаточно добавить сервер как коннектор.

Страницы в markdown

Карточки товаров и разделы отдаются в markdown, если запросить их с заголовкомAccept: text/markdown. Вместо мегабайта вёрстки приходит 15 килобайт фактов: характеристики, исполнения, артикулы и цены.

curl -H "Accept: text/markdown" \
  "https://5dyuymov.ru/ru/products/<handle>"

Карточка сервера для каталогов ИИ-агентов:/api/mcp/server-card, каталог ресурсов домена — /.well-known/ard.json.