Программа лояльности
Помощь
На главную

Покупки с AI-ассистентом / Shopping with an AI assistant

USmall теперь можно подключить к своему AI-ассистенту — Claude, ChatGPT или любому другому, который поддерживает протокол MCP (Model Context Protocol). 

Ассистент по вашему запросу сможет искать товары в каталоге более чем 150 зарубежных магазинов, собирать корзину и с вашего разрешения даже оформлять заказы. 

Оплата всегда остаётся за вами и происходит только на сайте: ассистент не имеет доступа к платёжным данным — ни к картам, ни к кошелькам.

Быстрый старт без аккаунта

Поиск по каталогу работает без регистрации и авторизации. Для запуска необходимо добавить в своего ассистента коннектор с адресом:

https://api.usmall.ru/api/mcp/catalog/v1

В этом режиме ассистент сможет: 

  • искать товары по свободному запросу, категориям и цене;
  • открывать карточки товаров с вариантами (размеры, цвета), ценами и информацией о наличии;
  • собирать корзину-ссылку: ассистент подберёт товары и предоставит вам ссылку вида usmall.ru/cart/shared/… — откройте её, проверьте состав и одним нажатием импортируйте товары в свою корзину на сайте.
     

Полный режим (доступен с активным аккаунтом USmall)

Подключив ассистента к своему аккаунту на USmall, вы дополнительно получите доступ к личной корзине и избранному, пунктам выдачи и получателям, статусам заказов и оформлению заказа.

Как подключить (на примере Claude):

1. Откройте Settings → Connectors → Add custom connector и укажите адрес:

https://api.usmall.ru/api/mcp/v1

Если USmall уже есть в каталоге коннекторов вашего ассистента, просто включите его там. 

2. Если вы не вошли в аккаунт, сначала зарегистрируйтесь или войдите в него.

Если окно авторизации/согласия не появляется, проверьте, что блокировщики рекламы отключены.

3. На экране согласия выберите, какие действия разрешаете выполнять ассистенту: поиск по каталогу, работу с корзиной и избранным, просмотр профиля и заказов, оформление заказов. Можно разрешить только часть — например, поиск и корзину без оформления заказов. 

Доступ ассистента можно отозвать одним нажатием в разделе «Подключённые приложения» в личном кабинете. 
 

Заказ и оплата

Ассистент может собрать корзину и оформить заказ, но не может его оплатить. Заказ создаётся как неоплаченный, а вы получаете ссылку на страницу заказа и письмо.

Откройте страницу, проверьте состав заказа и оплатите его привычным способом — до оплаты заказ не передаётся в работу.

Если заказ оформлен по ошибке или не вами, просто не оплачивайте его — он не будет обработан.

 

Безопасность и приватность

  • Ассистент никогда не видит платёжные данные. Оплата происходит только на сайте и лично вами.
  • Адреса, телефоны и документы получателей недоступны ассистенту — он видит только обезличенные обозначения.
  • Каждому заказу, оформленному ассистентом, присваивается специальный номер. Именно этот номер будет отображаться в письме и в истории заказов.
  • Все действия ассистента ограничены серверными лимитами; подозрительная активность блокируется автоматически.
  • Мы не храним данные банковских карт и другую платёжную информацию. Будьте осторожны при переходе по ссылкам и всегда проверяйте, что переходите на официальный сайт USmall.

 

Для разработчиков

  • Основной MCP-эндпоинт (OAuth 2.1 + PKCE): POST https://api.usmall.ru/api/mcp/v1
  • Анонимный каталожный эндпоинт: POST https://api.usmall.ru/api/mcp/catalog/v1
  • Машиночитаемый гайд для агентов — схемы тулзов, сценарии, коды отказов и рецепты подключения (Claude, ChatGPT, Grok, Gemini, Cursor, API): agent-guide.json
  • OAuth discovery: /.well-known/oauth-protected-resource/api/mcp/v1 и /.well-known/oauth-authorization-server на api.usmall.ru
  • Ревизии протокола: 2025-03-26, 2025-06-18, 2025-11-25 (legacy), 2026-07-28 (modern) — оба поколения на одном URL
  • Транспорт: один POST — один JSON-ответ; SSE и стриминга нет
  • Уважайте Retry-After при HTTP 429 и отправляйте осмысленный User-Agent

Поддержка

Вопросы и проблемы c подключением: help@usmall.ru
Политика обработки персональных данных 

 

 

English version

USmall can now be connected to your AI assistant — Claude, ChatGPT, or any other assistant that supports the Model Context Protocol (MCP).

On your request, the assistant can search products across a catalog of 150+ international stores, build a cart, and — with your permission — even place orders.

Payment always stays with you and happens only on the website: the assistant has no access to payment data — neither cards nor wallets.

 

Quick start — no account

Catalog search works without registration or sign-in. To get started, add a connector with this URL to your assistant:

https://api.usmall.ru/api/mcp/catalog/v1

In this mode the assistant can:

  • search products by free-text query, category, and price;
  • open product cards with variants (sizes, colors), prices, and stock information;
  • build a shareable cart link: the assistant picks the items and returns a link like usmall.ru/cart/shared/… — open it, review the contents, and import the items into your cart on the website with one click.

 

Full mode — with a USmall account

Connecting the assistant to your USmall account additionally gives it access to your personal cart and favorites, pickup points and recipients, order statuses, and checkout.

How to connect (using Claude as an example):

1. Open Settings → Connectors → Add custom connector and enter the URL 

 https://api.usmall.ru/api/mcp/v1

If USmall is already listed in your assistant's connector directory, just enable it there.

2. If you're not signed in, register or log in first. If the consent window doesn't appear, make sure ad blockers are disabled.

3. On the consent screen, choose which actions you allow the assistant to perform: catalog search, cart and favorites, profile and order view, placing orders. You can grant only part of them — for example, search and cart without checkout.

The assistant's access can be revoked with one click in the Connected apps section of your profile.

 

Orders and payment

The assistant can build a cart and place an order, but cannot pay for it. The order is created as unpaid, and you receive a link to the order page and an email.

Open the page, review the order, and pay the usual way — the order isn't processed until it's paid.

If an order was placed by mistake or not by you, simply don't pay — it won't be processed. You can cancel the order in your profile, and revoke the assistant's access in the Connected apps section.

 

Security and privacy

  • The assistant never sees payment credentials. Payment happens only on the website and only by you.
  • Recipients' addresses, phone numbers, and documents are not exposed to the assistant — it only sees anonymized labels.
  • Every order placed by the assistant is assigned an identifier. This identifier appears in the confirmation email and in your order history.
  • All assistant actions are subject to server-side rate limits; suspicious activity is blocked automatically.
  • We don't store bank card data or other payment information. Be cautious with links and always verify that you're on the official USmall website.

 

For developers

  • Main MCP endpoint (OAuth 2.1 + PKCE): POST https://api.usmall.ru/api/mcp/v1
  • Anonymous catalog endpoint: POST https://api.usmall.ru/api/mcp/catalog/v1
  • Machine-readable agent guide (tool schemas, workflows, refusal codes, connection recipes): agent-guide.json
  • OAuth discovery: /.well-known/oauth-protected-resource/api/mcp/v1 and /.well-known/oauth-authorization-server on api.usmall.ru
  • Protocol revisions: 2025-03-26, 2025-06-18, 2025-11-25 (legacy) and 2026-07-28 (modern) — both generations on the same URL
  • Transport: one POST, one JSON reply; no SSE, no streaming
  • Respect Retry-After on HTTP 429 and send a meaningful User-Agent

Support

Questions and connection issues: help@usmall.ru
Privacy policy