> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowstep.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP misollari

> Flowstep MCP ning odatiy vazifalari uchun boshdan-oxirigacha ish jarayonlari.

## 1. Ekranni yaratish va oldindan ko‘rish

Eng keng tarqalgan ish jarayoni: ekranni yaratish (fayl ham shu qadamda yaratiladi), so‘ng natijani ko‘rish.

```
1. list-files         {}
                      → { "files": [ ... ] }          // avval mavjud faylni tekshiring

2. ai-design-screens  { "message": "Mobile sign-in screen for a developer tool.
                                    Email/password fields, Google SSO button, dark theme." }
                      → { "status": "generated", "fileId": "FILE_ID", "screenIds": ["SCREEN_ID"] }

3. get-screen-image   { "fileId": "FILE_ID", "screenId": "SCREEN_ID" }
                      → [inline PNG]
```

`fileId` ni qoldirsangiz, yangi fayl avtomatik yaratiladi. Ekranlarni o‘sha faylga qo‘shish uchun mavjud `fileId` ni uzating.

**AI yordamchingizga so‘rov:**

> Flowstep dizayni yarating: dasturchi vositasi uchun mobil kirish ekrani, elektron pochta/parol maydonlari va Google SSO tugmasi bilan, qorong‘i mavzuda, so‘ng tasvirni ko‘rsating.

***

## 2. React komponentini vizuallashtirish

`.jsx` yoki `.tsx` faylni biriktirma sifatida yuklang va Flowstepdan unga mos dizayn yaratishni so‘rang. Flowstep manba kodni o‘qiydi va ekran yaratadi — ilovani ishga tushirish shart emas.

```
1. upload-attachment  { "text": "<UTF-8 contents of ApiKeys.tsx>",
                        "mimeType": "text/javascript" }
                      → { "id": "ATT_ID", "path": "...", "assetUrl": "...", "type": "document",
                          "mimeType": "text/javascript" }

2. ai-design-screens  { "message": "Generate a desktop screen that matches this React component.",
                        "attachments": [{ "id": "ATT_ID", "path": "...", "type": "document" }] }
                      → { "status": "generated", "fileId": "FILE_ID", "screenIds": ["SCREEN_ID"], ... }

3. get-screen-image   { "fileId": "FILE_ID", "screenId": "SCREEN_ID" }
                      → [inline PNG]
```

64 000 belgidan uzunroq manba fayllar uchun, buning o‘rniga `mimeType` va `fileName` bilan `upload-attachment` dan foydalaning va qaytgan `uploadCommand` ni ishga tushiring. Qarang: [`upload-attachment`](https://docs.flowstep.ai/uz/mcp/tools#upload-attachment).

**AI yordamchingizga so‘rov:**

> `src/components/settings/ApiKeys.tsx` faylini o‘qing, uni biriktirma sifatida yuklang va komponent maketiga mos Flowstep ekranini yarating. Render qilingan tasvirni ko‘rsating.

***

## 3. Ekranni takomillashtirish

Mavjud ekranni erkin ko‘rinishdagi ko‘rsatmalar bilan joyida o‘zgartiring — va xuddi shu chaqiruvda unga mos yangi ekran qo‘shing.

```
1. list-screens       { "fileId": "FILE_ID" }
                      → { "screens": [{ "screenId": "SCREEN_ID", "name": "Sign-in", ... }] }

2. ai-design-screens  { "fileId": "FILE_ID",
                        "message": "Edit this sign-in screen: switch it to dark mode and add a
                                    'Remember me' checkbox below the password field. Then add a
                                    matching forgot-password screen.",
                        "elementIds": ["SCREEN_ID"] }
                      → { "status": "generated", "fileId": "FILE_ID",
                          "screenIds": ["SCREEN_ID", "NEW_SCREEN_ID"], ... }

3. get-screen-image   { "fileId": "FILE_ID", "screenId": "SCREEN_ID" }
                      → [inline PNG]
   get-screen-image   { "fileId": "FILE_ID", "screenId": "NEW_SCREEN_ID" }
                      → [inline PNG]
```

`screenIds` chaqiruv yaratgan yoki o‘zgartirgan har bir ekranni ro‘yxatlaydi, shuning uchun har biri uchun `get-screen-image` ni bir marta chaqiring. Faqat mavjud ekranni tahrirlash uchun xabarning oxirgi jumlasini qoldirmang.

Ekranning faqat bir qismini o‘zgartirish uchun avval `"includeIds": true` bilan `get-screen-jsx` ni chaqiring va o‘zgartirmoqchi bo‘lgan elementning `data-id` ini `elementIds` ga uzating.

Butun ekran uchun bir bosishli tayyor sozlama uchun uning o‘rniga `ai-edit-screen-variant` ni chaqiring — masalan, `"operationVariant": "light_theme"` yoki `"different_layout"`.

**AI yordamchingizga so‘rov:**

> Mening "Login oqimi" Flowstep faylimda kirish ekranini qorong‘i rejimga o‘tkazing, parol maydonidan pastda "Remember me" belgisini qo‘shing va unga mos parolni unutish ekranini qo‘shing. Natijalarni ko‘rsating.

***

## 4. Ekranni to‘liq oqimga kengaytirish

Mavjud dizaynga keyingi ekranlarni qo‘shing.

```
1. list-screens                { "fileId": "FILE_ID" }
                               → { "screens": [{ "screenId": "BASE_SCREEN_ID", "prompt": "Sign-in screen", ... }] }

2. ai-generate-screen-variant  { "fileId": "FILE_ID",
                                 "screenId": "BASE_SCREEN_ID",
                                 "operationVariant": "next_screen" }
                               → { "status": "generated", "fileId": "FILE_ID", "screenIds": ["NEXT_SCREEN_ID"], ... }

3. get-screen-image            { "fileId": "FILE_ID", "screenId": "NEXT_SCREEN_ID" }
                               → [inline PNG]
```

Chetki holat ekranlarini qo‘shish uchun 2-qadamni `operationVariant: "error_state"` yoki `"empty_state"` bilan takrorlang, boshqa platformalar uchun esa `"web_version"` / `"tablet_version"` dan foydalaning.

> [!NOTE]
>
> `ai-generate-screen-variant` uchun `operationVariant` majburiy va vosita aniq bitta `screenId` qabul qiladi. Mavjud ekranning varianti bo‘lmagan ekranni qo‘shish uchun `fileId` bilan `ai-design-screens` dan foydalaning.

***

## 5. Ekranni kod bazangizga topshirish, so‘ng o‘zgarishlarni qaytarib yozish

Ekranni JSX sifatida o‘qing, undan foydalanib qurish va tahrirlangan JSX ni kanvasga qaytarib yuklang — buning uchun xabarlardan foydalanilmaydi.

```
1. get-screen-jsx      { "fileId": "FILE_ID", "screenId": "SCREEN_ID" }
                       → { "name": "Settings", "fidelity": "ui", "screenType": "web",
                           "colorTheme": "default", "jsx": "<div ...>...</div>", "fragments": [] }

2. replace-screen-jsx  { "fileId": "FILE_ID", "screenId": "SCREEN_ID",
                         "jsx": "<div ...>...edited...</div>" }
                       → { "fileId": "FILE_ID", "screenId": "SCREEN_ID" }

3. get-screen-image    { "fileId": "FILE_ID", "screenId": "SCREEN_ID" }
                       → [inline PNG]
```

Ko‘rsatilmagan maydonlar (`name`, `fidelity`, `screenType`, `colorTheme`, `fragments`) joriy qiymatlarini saqlab qoladi. Asl nusxani saqlab, uning yoniga o‘z versiyangizni qo‘shish uchun `replace-screen-jsx` o‘rniga `screenType` va `jsx` bilan `add-screen-jsx` ni chaqiring.

O‘z tasviringizni ekranda ko‘rsatish uchun uni `upload-attachment` bilan yuklang va qaytgan `assetUrl` ni JSX’ingizdagi `img src` ga qo‘ying. Qarang: [JSX’dagi tasvirlar](https://docs.flowstep.ai/uz/mcp/tools.md#images-in-jsx).

***

## 6. Partiya ishini boshlashdan oldin limitingizni tekshiring

Bir nechta generatsiyani boshlashdan oldin qolgan imkoniyatni tekshiring. `get-plan-details` ni chaqirish bepul.

```
get-plan-details {}
→ { "plan": { ... }, "subscription": { ... }, "limits": { ... }, "usage": { ... },
    "remaining": { "messages": { "daily": ..., "monthly": ... } } }
```

Agar `remaining.messages.daily` kam bo‘lsa, partiyani limit qayta tiklanadigan 00:00 UTC dan keyinga rejalashtiring.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.