Topsavdo qo‘llanma

Tungi rejim

AI yordamchini do'konga qanday ulayman? ​

Qisqacha javob: my.topsavdo.uz → Sozlamalar → AI yordamchini ulash → «Yangi kalit». Chiqqan kalitni nusxalab, Claude Desktop yoki Claude Code sozlamasiga qo'yasiz. Shundan keyin AI'dan do'koningiz haqida to'g'ridan-to'g'ri so'rashingiz mumkin.

Bu nima beradi ​

Ulangandan keyin siz AI bilan oddiy suhbatda ishlaysiz:

  • «Bugun qancha savdo bo'ldi?»
  • «Shu oy foydam o'tgan oyga nisbatan qanday?»
  • «Qaysi tovar tugab qolgan?»
  • «Kim qancha qarzdor?»
  • «Ikki filialimni solishtir»

AI raqamlarni o'ylab topmaydi — u sizning haqiqiy hisobotlaringizni o'qiydi va shu asosda javob beradi.

Ulanish faqat o'qiydi: AI orqali sotuv qilib, narx o'zgartirib yoki biror narsani o'chirib bo'lmaydi.

Qaysi dasturlar bilan ishlaydi ​

DasturHolati
Claude Desktop (kompyuterga o'rnatiladigan)Ishlaydi
Claude Code (terminal)Ishlaydi
claude.ai (brauzerdagi sayt)Hozircha yo'q
ChatGPT (sayt va ilova)Hozircha yo'q

Sayt versiyalari boshqa turdagi ruxsat so'raydi (dastur sizni Topsavdoga alohida oyna orqali kiritadi). U hali tayyor emas — shuning uchun claude.ai yoki ChatGPT ulanish bo'limiga manzilni kiritsangiz, ulanish amalga oshmaydi. Bu xato emas, hali qo'shilmagan imkoniyat.

Tayyor bo'lganda shu sahifa yangilanadi.

1-qadam. Kalit olish ​

  1. my.topsavdo.uz ga do'kon egasi sifatida kiring;
  2. Sozlamalar → AI yordamchini ulash;
  3. Yangi kalit tugmasini bosing;
  4. Kalitga nom bering — qayerda ishlatishingizni yozing («Ish kompyuterim», «Uydagi noutbuk»). Keyin qaysi kalitni bekor qilishni adashmasdan topasiz;
  5. Kalit ekranga chiqadi. Uni darhol nusxalab oling.

Kalit faqat bir marta ko'rsatiladi

Biz kalitning o'zini saqlamaymiz — bazada faqat uning tekshirish izi turadi. Shuning uchun oyna yopilgach kalitni qayta ko'rsatishning imkoni yo'q. Yo'qotib qo'ysangiz eskisini bekor qilib, yangisini yaratasiz.

Kalit tsk_ bilan boshlanadi. Ro'yxatda uning faqat boshi ko'rinadi (tsk_ab12cd34…) — bu kalitni tanib olish uchun, ulanish uchun emas.

Kalit chiqarilgan oynada ikkala dastur uchun tayyor sozlama namunasi ham turadi, kalit ichiga qo'yilgan holda — qo'lda ko'chirib adashmaslik uchun eng qulay yo'l shu.

2-qadam-a. Claude Code'ga ulash ​

Terminalda bitta buyruq:

bash
claude mcp add --transport http topsavdo https://api.topsavdo.uz/mcp/ \
  --header "Authorization: Bearer BU_YERGA_KALIT"

BU_YERGA_KALIT o'rniga o'zingizning kalitingizni qo'ying.

Tekshirish: Claude Code ichida /mcp deb yozing — ro'yxatda topsavdo ulangan holatda turishi kerak.

2-qadam-b. Claude Desktop'ga ulash ​

  1. Claude Desktop → Settings → Developer → Edit Config;
  2. Ochilgan faylga quyidagini qo'ying (kalitni o'zingiznikiga almashtiring):
json
{
  "mcpServers": {
    "topsavdo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.topsavdo.uz/mcp/",
        "--header",
        "Authorization: Bearer BU_YERGA_KALIT"
      ]
    }
  }
}
  1. Faylni saqlang va Claude Desktop'ni butunlay yopib qayta oching.

Kompyuterda Node.js o'rnatilgan bo'lishi kerak — yuqoridagi npx buyrug'i shundan keladi. O'rnatilmagan bo'lsa nodejs.org dan yuklab oling.

Tekshirish: suhbat oynasining pastidagi asboblar belgisida topsavdo ko'rinadi.

AI nima ko'ra oladi ​

O'ttizdan ortiq ma'lumot manbai ochiladi. Ma'nosi bo'yicha:

  • Savdo — kunlik/davriy savdo yakuni, eng ko'p sotilgan tovarlar, kategoriya, xodim va to'lov turi kesimi, soatlar bo'yicha yuklama;
  • Foyda va pul — foyda-zarar va uning tarkibi, pul oqimi, kassa va hisoblar qoldig'i, xarajatlar, kassadagi pul harakati, smena yakuni, buxgalteriya yozuvlari;
  • Ombor — qoldiqlar, tugab qolgan tovarlar, harakatsiz («o'lik») tovar, tannarxdan arzon ketayotgan pozitsiyalar, kirim-chiqim operatsiyalari, mahsulot qidirish;
  • Hujjatlar — xarid hujjatlari, sotuv hujjatlari, onlayn buyurtmalar;
  • Mijozlar — qarzdorlar ro'yxati, bitta mijozning to'liq kartochkasi, eng ko'p xarid qilganlar, lidlar va sodiqlik dasturi;
  • Do'kon — filiallarni solishtirish, xodimlar ro'yxati, obuna holati;
  • Yordam — Topsavdoning o'zi bo'yicha savollarga javob (shu qo'llanma).

Bir nechta filialingiz bo'lsa, AI avval qaysi do'kon haqida so'rayotganingizni aniqlaydi. Boshqa birovning do'koni hech qanday holatda ochilmaydi — kalit faqat sizning do'konlaringizga bog'langan.

Xavfsizlik ​

Kalit — parol bilan bir xil narsa. U orqali sizning tannarxingiz, foydangiz va mijozlaringizning qarzi ko'rinadi. Shuning uchun:

  • kalitni hech kimga bermang va yozishmada yubormang;
  • har qurilmaga alohida kalit chiqaring — biri yo'qolsa faqat o'shanisini bekor qilasiz, qolganlari ishlayveradi;
  • ishlatmaydigan kalitni bekor qiling.

Kalit faqat do'kon egasida bo'ladi. Xodimga kalit berilmaydi: MCP orqali tannarx va foyda ochiladi, xodimga esa bu raqamlar ataylab yopilgan (Xodim qo'shish va huquqlar).

Kalitni bekor qilish ​

Sozlamalar → AI yordamchini ulash → kalit qatoridagi savat belgisi.

Kalit shu zahoti ishlamay qoladi va u kiritilgan dastur do'koningizni ko'rmay qo'yadi. Yozuv ro'yxatda «Bekor qilingan» holatida qoladi — qachon va qaysi kalitni o'chirganingiz tarixda ko'rinib turadi.

Bekor qilingan kalitni qaytarib bo'lmaydi; kerak bo'lsa yangi kalit yaratasiz.

Ishlamayapti ​

«Kalit noto'g'ri yoki bekor qilingan» — kalit qatorda to'liq ko'chirilmagan bo'lishi mumkin (boshidagi tsk_ ham, oxirigacha hammasi kerak) yoki u bekor qilingan. Ro'yxatda holatini tekshiring.

«Kalit muddati tugagan» — muddatli kalit chiqargan bo'lsangiz. Yangisini yarating.

Claude Desktop ro'yxatda topsavdo ni ko'rsatmayapti — dastur to'liq yopilib qayta ochilganini va Node.js o'rnatilganini tekshiring. Sozlama faylida vergul yoki qavs xatosi bo'lsa ham ro'yxat bo'sh chiqadi.

AI «ruxsat yo'q» deydi — hisobingiz do'kon egasiniki ekanini va obunangiz amal qilayotganini tekshiring (Tarif va obuna).

Keyingi qadam ​