Bu nima
MCP (Model Context Protocol) — AI yordamchiga tashqi xizmat bilan ishlash imkonini beruvchi ochiq standart. Birinchi Shop do'koni uchun ochiq MCP server bor: uni yordamchingizga bir marta "ulagich" (connector) sifatida qo'shasiz, keyin chatda oddiy so'z bilan tovar so'raysiz.
- Akkaunt, ro'yxatdan o'tish yoki API kalit kerak emas.
- Server rasmiy MCP Registry'da
uz.birinchishop/shopnomi bilan e'lon qilingan. - Bu xaridorlar uchun. Reklamachilar (hamkorlar) uchun alohida, OAuth bilan ulanadigan server bor — API va MCP qo'llanmasi.
Qanday ulanadi
Server manzili (Streamable HTTP, autentifikatsiyasiz): https://birinchishop.uz/api/shop/mcp
- Claude (claude.ai, kompyuter va telefon ilovasi): Settings → Connectors → Add custom connector → manzilni qo'ying → Add.
- ChatGPT: Settings → Apps & Connectors → Advanced settings → Developer mode ni yoqing → Create → manzilni qo'ying, Authentication: No authentication.
- Claude Code:
claude mcp add --transport http birinchi-shop https://birinchishop.uz/api/shop/mcp - Boshqa mijozlar (Cursor, VS Code va h.k.): yuqoridagi manzil bilan masofaviy MCP server qo'shing.
Menyu nomlari ilova versiyasiga qarab biroz farq qilishi mumkin.
Yordamchi nimalar qila oladi
| Vosita | Nima qiladi | Turi |
|---|---|---|
| search_products | Katalogdan matn (o'zbek, rus yoki ingliz tilida), narx chegarasi va tartib bo'yicha qidiradi | faqat o'qish |
| get_product | Tovar tafsilotlari, rasmlar, variantlar (o'lcham/rang), zaxira va yetkazish bilan jami summa | faqat o'qish |
| store_info | Yetkazish hududi, muddati va narxi, to'lov usuli, tasdiqlash tartibi, qaytarish va yordam | faqat o'qish |
| place_order | Haqiqiy buyurtma qoldiradi. Ism, O'zbekiston mobil raqami, hudud va xaridorning aniq roziligi (customer_confirmed=true) talab qilinadi | yozish |
| get_order_status | Avval berilgan buyurtma holati (buyurtma raqami + telefonning oxirgi 4 raqami) | faqat o'qish |
Misol: "Birinchi Shop'dan 300 ming so'mgacha erkaklar soatini top", "Shu tovarning Samarqandga yetkazish bilan jami narxi qancha?", "12345-buyurtmam qaysi bosqichda? Raqamim 4567 bilan tugaydi".
Buyurtma qanday rasmiylashtiriladi
- Yordamchi tovar, variant, narx, 30 000 so'm yetkazish haqi va jami summani ko'rsatib, tasdiqlashingizni so'raydi.
- Faqat siz aniq "ha" deganingizdan keyin
place_orderchaqiriladi. Onlayn to'lov yo'q — kartangizdan hech narsa yechilmaydi. - Operator ko'rsatilgan raqamga qo'ng'iroq qilib buyurtmani tasdiqlaydi; shu qo'ng'iroqda bekor qilishingiz ham mumkin.
- Kuryer O'zbekistonning istalgan viloyatiga 1–3 kunda yetkazadi. Tovarni ko'rib, kuryerga naqd to'laysiz yoki to'lamasdan rad etasiz.
Xaridorni himoya qiluvchi cheklovlar: bitta raqamdan bir tovarga 24 soat ichida ikkinchi buyurtma berilmaydi, kuniga 3 tadan ortiq turli tovar buyurtma qilinmaydi, bitta ulanishdan buyurtmalar soni ham cheklangan. Yetkazish faqat O'zbekiston ichida.
Maxfiylik
Ulagich cookie o'rnatmaydi va akkaunt so'ramaydi. Qidiruvda faqat qidiruv matni yuboriladi. Buyurtmada faqat ism, telefon raqami, hudud va tanlangan tovar yuboriladi — ular buyurtmani tasdiqlash va yetkazish uchun ishlatiladi. Yordamchi bilan yozishmangiz bizga kelmaydi. Batafsil: Maxfiylik siyosati, 7-bo'lim.
Ko'p beriladigan savollar
Akkaunt yoki API kalit kerakmi?
Yo'q. Do'kon ulagichi ochiq — manzilni yordamchingizga qo'shish kifoya.
Yordamchi kartamdan pul yechadimi?
Yo'q. Onlayn to'lov yo'q: tovarni olganda kuryerga naqd to'laysiz, undan oldin operator har bir buyurtmani telefon orqali tasdiqlaydi.
Yetkazish qancha turadi va necha kun oladi?
Yetkazish haqi 30 000 so'm, tovar narxiga qo'shiladi. Muddat — O'zbekistonning barcha viloyatlariga 1–3 kun.
Buyurtmani qanday bekor qilaman?
Operator qo'ng'iroq qilganda ayting, yetkazilganda tovardan voz keching yoki Telegram'da @birinchishop_support ga yozing.
Yordamchi mening roziligimsiz buyurtma bera oladimi?
Yo'q. Server buyurtmani faqat xaridor aniq tasdiqlagani belgilangan holda qabul qiladi, keyin operator baribir qo'ng'iroq qilib tasdiqlaydi.