Что это
MCP (Model Context Protocol) — открытый стандарт, который позволяет AI-ассистенту работать с внешними сервисами. У магазина Birinchi Shop есть открытый MCP-сервер: вы один раз добавляете его в ассистента как «коннектор», а затем просите товар обычными словами в чате.
- Аккаунт, регистрация и API-ключ не нужны.
- Сервер опубликован в официальном MCP Registry под именем
uz.birinchishop/shop. - Это для покупателей. Для партнёров (вебмастеров) есть отдельный сервер с входом через OAuth — руководство по API и MCP.
Как подключить
Адрес сервера (Streamable HTTP, без аутентификации): https://birinchishop.uz/api/shop/mcp
- Claude (claude.ai, приложения для компьютера и телефона): Settings → Connectors → Add custom connector → вставьте адрес → Add.
- ChatGPT: Settings → Apps & Connectors → Advanced settings → включите Developer mode → Create → вставьте адрес, Authentication: No authentication.
- Claude Code:
claude mcp add --transport http birinchi-shop https://birinchishop.uz/api/shop/mcp - Другие клиенты (Cursor, VS Code и т. д.): добавьте удалённый MCP-сервер с этим адресом.
Названия пунктов меню могут немного отличаться в зависимости от версии приложения.
Что умеет ассистент
| Инструмент | Что делает | Тип |
|---|---|---|
| search_products | Поиск по каталогу по тексту (узбекский, русский или английский), лимиту цены и сортировке | только чтение |
| get_product | Детали товара, фото, варианты (размер/цвет), наличие и итоговая сумма с доставкой | только чтение |
| store_info | Зона, срок и стоимость доставки, способ оплаты, порядок подтверждения, возврат и поддержка | только чтение |
| place_order | Оформляет настоящий заказ. Нужны имя, мобильный номер Узбекистана, регион и явное согласие покупателя (customer_confirmed=true) | запись |
| get_order_status | Статус ранее оформленного заказа (номер заказа + последние 4 цифры телефона) | только чтение |
Примеры: «Найди в Birinchi Shop мужские часы до 300 тысяч сумов», «Сколько будет стоить этот товар с доставкой в Самарканд?», «На каком этапе мой заказ 12345? Номер заканчивается на 4567».
Как оформляется заказ
- Ассистент показывает товар, вариант, цену, 30 000 сум за доставку и итоговую сумму и просит подтвердить.
- Только после вашего явного «да» вызывается
place_order. Онлайн-оплаты нет — с карты ничего не списывается. - Оператор звонит на указанный номер и подтверждает заказ; во время звонка заказ можно и отменить.
- Курьер доставляет в любую область Узбекистана за 1–3 дня. Вы осматриваете товар и платите курьеру наличными или отказываетесь, ничего не платя.
Ограничения для защиты покупателей: с одного номера нельзя заказать один и тот же товар повторно в течение 24 часов и больше 3 разных товаров в день, число заказов с одного подключения тоже ограничено. Доставка только по Узбекистану.
Конфиденциальность
Коннектор не ставит cookie и не требует аккаунта. При поиске передаётся только текст запроса. При заказе передаются только имя, номер телефона, регион и выбранный товар — для подтверждения и доставки заказа. Ваша переписка с ассистентом к нам не попадает. Подробнее: Политика конфиденциальности, раздел 7.
Частые вопросы
Нужен ли аккаунт или API-ключ?
Нет. Коннектор магазина открытый — достаточно добавить адрес в ассистента.
Ассистент спишет деньги с моей карты?
Нет. Онлайн-оплаты нет: вы платите курьеру наличными при получении, а перед этим оператор подтверждает каждый заказ по телефону.
Сколько стоит и сколько идёт доставка?
Доставка стоит 30 000 сум и добавляется к цене товара. Срок — 1–3 дня во все области Узбекистана.
Как отменить заказ?
Скажите оператору, когда он позвонит, откажитесь от товара при доставке или напишите в Telegram @birinchishop_support.
Может ли ассистент оформить заказ без моего согласия?
Нет. Сервер принимает заказ только с отметкой о явном подтверждении покупателя, а затем оператор всё равно звонит и подтверждает его.