# Claude va ChatGPT'ga ulash

> BILLZ'ni o'z assistentingizga — Claude, ChatGPT, Cursor va boshqalarga — qanday ulash va savdo, qoldiqlar hamda qarzlar haqida savol berish.

BILLZ’ni siz allaqachon foydalanayotgan AI-assistentga ulash mumkin: Claude, ChatGPT, Cursor va boshqalar. Ulangandan so’ng assistent kompaniyangiz haqidagi savollarga BILLZ ma’lumotlari asosida javob beradi:

* «Iyul oyida qancha sotdik va o’rtacha chek qancha bo’ldi?»
* «Omborda qaysi mahsulotlar tugayapti?»
* «Bu oy eng ko’p nima sotilyapti?»
* «Mijozlardan kim bizdan eng ko’p qarzdor?»

Assistent faqat ma’lumotlarni o’qiydi: u BILLZ’da hech narsani o’zgartirmaydi, sotuv o’tkazmaydi va qoldiqlarga tegmaydi.

Bu sahifa kompaniya egalari va xodimlari uchun. Agar siz dasturchi bo’lsangiz va agent BILLZ API uchun kod yozishini istasangiz, sizga [AI agentini sozlash](/uz/agent-setup/) kerak.

## Boshlashdan oldin: integratsiya kaliti

Assistent BILLZ’ga integratsiya kaliti orqali kiradi. Uni BILLZ’da yarating: **Sozlamalar → Kompaniya sozlamalari → Integratsiya kalitlari**. Batafsil — [Integratsiya kaliti](/uz/start/integration-key/) bo’limida.

Assistent uchun integratsiyalaringiz foydalanadigan kalitni emas, alohida kalit oching. Agar kalitni qayta chiqarishga to’g’ri kelsa, faqat assistentning kirishi yopiladi, kassalar, sayt va boshqa ulanishlar ishlashda davom etadi.

Assistent faqat kalitga ruxsat berilgan narsalarni ko’radi: agar kalit rolida hisobotlar yoki mijozlarga kirish bo’lmasa, assistent ularni ham ko’rmaydi.

## Ulanish

Barcha ilovalarda ulanish bir xil tartibda ishlaydi:

1. Ilovaga `https://mcp.billz.io/mcp` manzili qo’shiladi — kalitsiz.
2. Ilova brauzerda BILLZ sahifasini ochadi. Unga integratsiya kalitini kiriting.
3. BILLZ ilova qanday ma’lumotlarni so’rayotganini ko’rsatadi. O’qishga ruxsat beradigan guruhlarni belgilang va «Ruxsat berish» tugmasini bosing.
4. Brauzer sizni ilovaga qaytaradi — savol berishingiz mumkin.

![Bosqichma-bosqich ulanish: ilovada https://mcp.billz.io/mcp manzili, BILLZ sahifasida integratsiya kaliti, ma’lumotlarni tanlash va «Ruxsat berish» tugmasi, assistentga savol](/_astro/flow-uz.DfvHauk2_Z20SKC6.webp)

Quyida har bir ilovada manzilni qayerga qo’shish ko’rsatilgan.

### Claude Desktop va claude.ai

1. **Customize → Connectors** (Sozlash → Konnektorlar) bo’limini oching va **Add custom connector** (O’z konnektoringizni qo’shish) tugmasini bosing.
2. Nomi — `BILLZ`, manzil — `https://mcp.billz.io/mcp`. Agar Claude kirish usulini so’rasa, **Sign in now** ni, OAuth mijozi uchun esa **Register automatically** (avtomatik ro’yxatdan o’tkazish) ni tanlang. **Add** tugmasini bosing.
3. Yangi konnektor yonidagi **Connect** tugmasini bosing va BILLZ sahifasida kirishni bajaring.

claude.ai yoki Claude Desktop’da qo’shilgan konnektor Claude mobil ilovasida ham ishlaydi. Bepul tarifda bitta o’z konnektoringizni qo’shish mumkin. Team va Enterprise tariflarida o’z konnektorini tashkilot egasi qo’shadi: **Organization settings → Connectors** (Tashkilot sozlamalari → Konnektorlar) → **Add** → **Custom** → **Web**. Shundan so’ng har bir xodim BILLZ’ni **Customize → Connectors** bo’limida topadi va **Connect** tugmasini bosadi.

### ChatGPT

1. ChatGPT’ni brauzerda oching va **Plugins** (Plaginlar) bo’limiga o’ting — manzil `chatgpt.com/plugins`. **+** tugmasini bosing va **Add custom MCP server** ni tanlang.
2. Nomi — `BILLZ`, server manzili (Server URL) — `https://mcp.billz.io/mcp`, kirish (Authentication) — **OAuth**. Agar ChatGPT mijozni ro’yxatdan o’tkazish usulini tanlashni taklif qilsa, DCR (Dynamic Client Registration) ni tanlang.
3. Ogohlantirishni tasdiqlang (**I understand and want to continue**) va **Create as a plugin** tugmasini bosing.
4. Yaratilgan plaginni o’rnating va ChatGPT BILLZ sahifasini ochganda kirishni bajaring. Yangi chatda `@` ni kiriting va BILLZ’ni tanlang.

O’z MCP serverlarini faqat ChatGPT’ning veb-versiyasida ulash mumkin, bu imkoniyat tarif va ish maydoni sozlamalariga bog’liq: agar **Add custom MCP server** bandi bo’lmasa, ish maydoni administratoridan so’rang.

### Cursor

1. `~/.cursor/mcp.json` faylini oching (barcha loyihalar uchun serverlar) yoki loyiha papkasida `.cursor/mcp.json` faylini yarating.

2. Serverni qo’shing:

   ```json
   {
     "mcpServers": {
       "billz": { "url": "https://mcp.billz.io/mcp" }
     }
   }
   ```

3. Faylni saqlang va Cursor’ni qayta ishga tushiring. **Customize → MCPs** bo’limini oching, `billz` ni toping va kirishni bajaring: Cursor BILLZ sahifasini ochadi.

### VS Code

1. **MCP: Open User Configuration** buyrug’ini bajaring — server barcha loyihalarda mavjud bo’ladi. Yoki loyihada `.vscode/mcp.json` faylini yarating.

2. Serverni qo’shing:

   ```json
   {
     "servers": {
       "billz": { "type": "http", "url": "https://mcp.billz.io/mcp" }
     }
   }
   ```

3. Fayldagi server ustidagi **Start** tugmasini bosing (yoki **MCP: List Servers** → `billz` → **Start** buyrug’ini bajaring) va kirishni tasdiqlang: VS Code BILLZ sahifasini ochadi. Savollar Copilot chatida beriladi.

### Claude Code

```bash
claude mcp add --transport http billz https://mcp.billz.io/mcp
```

So’ng Claude Code’da `/mcp` buyrug’ini bajaring, `billz` ni tanlang va brauzerda kirishni bajaring. Buni terminaldan ham qilish mumkin: `claude mcp login billz`.

### Codex

```bash
codex mcp add billz --url https://mcp.billz.io/mcp
codex mcp login billz
```

### Gemini CLI

Serverni `~/.gemini/settings.json` fayliga qo’shing:

```json
{
  "mcpServers": {
    "billz": { "httpUrl": "https://mcp.billz.io/mcp" }
  }
}
```

So’ng Gemini CLI’da `/mcp auth billz` buyrug’ini bajaring.

## Assistent qanday ma’lumotlarni ko’radi

Ulanishda BILLZ nimaga ruxsat berishni so’raydi. Barcha guruhlarni belgilash shart emas: assistent belgilanmagan guruhlar ma’lumotlarini ko’rmaydi va kirish yo’qligini ochiq aytadi.

| Guruh                                         | Assistent nimalarni o’qiy oladi                                                                     |
| --------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| Savdo va moliya                               | tushum, cheklar, foyda, to’lovlar; eng yaxshi mahsulotlar, marja va aylanma                         |
| Mahsulotlar va qoldiqlar                      | mahsulotlar, narxlar, qoldiqlar; nomi, artikuli va shtrix-kodi bo’yicha qidiruv, sanadagi qoldiqlar |
| Mijozlar va qarzlar — **shaxsiy ma’lumotlar** | mijozlarning ismlari, telefonlari, xaridlari va qarzlari                                            |

Doim mavjud: do’konlar va to’lov usullari ro’yxati, kalit kompaniyasining nomi.

Assistent BILLZ’da hech narsani o’zgartirmaydi: faqat o’qish. Kompaniya kalit orqali aniqlanadi — assistent boshqa kompaniya ma’lumotlarini o’qiy olmaydi. Guruhlar to’plamini o’zgartirish uchun ilovada BILLZ’ni o’chiring va qaytadan ulang.

## Kirishni qanday bekor qilish mumkin

* **Ilovada BILLZ’ni o’chiring**: sozlamalarda konnektor yoki serverni o’chirib tashlang. Faqat shu ulanish yopiladi.
* **BILLZ’da kalitni qayta chiqaring**: Sozlamalar → Kompaniya sozlamalari → Integratsiya kalitlari. Shu kalit bilan qilingan barcha ulanishlar yopiladi — barcha ilovalarda birdaniga. Kirishni qaytarish uchun yangi kalit bilan qaytadan ulaning.

## Agar ishlamasa

| Nimani ko’ryapsiz                                  | Nima qilish kerak                                                                                        |
| -------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| «Kalit mos kelmadi»                                | Kalitni bo’sh joylarsiz, to’liq nusxalang. Agar kalit qayta chiqarilgan bo’lsa, yangisini oling.         |
| «Havolaning muddati o’tgan»                        | Kirish sahifasi 10 daqiqa amal qiladi. Ilovada ulanishni qaytadan boshlang.                              |
| «Urinishlar juda ko’p»                             | Bir necha daqiqa kutib, qayta urinib ko’ring.                                                            |
| Ilova brauzerni ochmayapti                         | Standart brauzer tanlanganini tekshiring. Claude Code’da kirish havolasini terminaldan nusxalash mumkin. |
| Assistent ma’lumotlarga kirish yo’qligini yozmoqda | Kalit rolining ruxsatlarini va ulanishda belgilangan guruhlarni tekshiring.                              |
| Ilova yana kirishni so’rayapti                     | Kalit qayta chiqarilgan yoki ulanishdan 30 kun foydalanilmagan. Qaytadan ulaning.                        |

### OAuth orqali kira olmaydigan ilovalar

Agar ilova OAuth orqali kira olmasa yoki ulanish skript uchun kerak bo’lsa, kalit `X-Billz-Token` sarlavhasida uzatiladi. Masalan, Claude Code’da:

```bash
claude mcp add --transport http billz \
  --header "X-Billz-Token: <INTEGRATSIYA KALITI>" \
  https://mcp.billz.io/mcp
```

Serverlarni faqat buyruq orqali ulaydigan ilovalar uchun `mcp-remote` ko’prigi mos keladi. Boshqa usullar — [server tavsifida](https://github.com/billz-2/billz_public_api/tree/main/mcp) (rus tilida).

Sarlavhadagi kalit assistentga barcha ma’lumot guruhlarini beradi. Kalit yozilgan sozlamalar fayllarini e’lon qilmang: agar kalit begonalar qo’liga tushgan bo’lsa, uni qayta chiqaring.

## Xavfsizlik

* Integratsiya kaliti faqat BILLZ sahifasida kiritiladi va BILLZ serverida shifrlangan holda saqlanadi. Kalit assistent ilovasiga uzatilmaydi: ilova bekor qilinishi mumkin bo’lgan o’z kirish huquqini oladi.
* Kirish 30 kun amal qiladi va assistentdan foydalanilayotgan ekan, uzaytiriladi.
* Kompaniya kalit orqali aniqlanadi: assistent faqat kalit berilgan kompaniyaning do’konlari va ma’lumotlarini ko’radi.
* Faqat o’qish: assistent sotuv yarata olmaydi, narx yoki qoldiqni o’zgartira olmaydi.