MCP vositalari ma’lumotnomasi

Muvaffaqiyatli bo‘lganda, get-screen-image dan tashqari har bir vosita natijasini ikki marta qaytaradi: structuredContent sifatida (vositaning e’lon qilingan chiqish sxemasiga mos holda tekshirilgan) va xuddi shu obyektni matn blokiga, { type: "text", text: "<json-string>" } ko‘rinishida, strukturalangan kontentni o‘qimaydigan mijozlar uchun. get-screen-image faqat MCP rasm blokini qaytaradi: { type: "image", data: "<base64>", mimeType: "image/png" }. Xato bo‘lganda isError: true o‘rnatiladi va matn blokida qisqa xato xabari bo‘ladi. Siz harakat qila oladigan xatolar — o‘chirishda nom mos kelmasligi, noto‘g‘ri Figma havolasi, noto‘g‘ri dizayn yo‘riqnomalari, biriktirma muammosi yoki generatsiya vaqti tugashi — nima tuzatish kerakligini tushuntiradi. Boshqa xatolar Failed to list files kabi umumiy xabarni qaytaradi.

Narxlash: uchta AI dizayn vositasi — ai-design-screens, ai-generate-screen-variant va ai-edit-screen-variant — Flowstep ilovasi bilan bir xil xabar limitidan foydalanadi. Boshqa barcha vositalar bepul. Qarang: Foydalanish limitlari.

Har bir vosita ham MCP annotatsiyalarini e’lon qiladi, shunda mijoz uning nima qilishini biladi. delete-file, delete-screen, delete-design-guidelines, replace-screen-jsx, ai-design-screens va ai-edit-screen-variant mavjud kontentni olib tashlaydi yoki qayta yozadi, shuning uchun ular destructive (xavfli) deb belgilangan.

Fayl vositalari

`list-files`

Flowstep fayllaringiz uchun metama’lumotlar ro‘yxatini qaytaradi. Mos fayl allaqachon mavjudligini tekshirish uchun avval shu vositani chaqiring. U ekran kontentini qaytarmaydi — buning uchun get-screen-image yoki get-screen-jsx dan foydalaning. Kirish

Parametr	Tur	Standart	Tavsif
`orderByCreation`	`boolean`	`true`	Eng yangisini birinchi qilib `created_at` bo‘yicha (`true`) yoki `updated_at` bo‘yicha (`false`) saralash. Yaqinda tahrirlangan fayllarni topish uchun `false` dan foydalaning
`limit`	`integer` (1–100)	`20`	Qaytariladigan fayllarning maksimal soni. To‘liq sahifa ko‘proq fayl borligini anglatishi mumkin
`offset`	`integer` (≥0)	`0`	O‘tkazib yuboriladigan fayllar soni. Keyingi sahifa `offset + limit`

Chiqish — { files }.

{
  "files": [
    {
      "id": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0",
      "name": "Dashboard redesign",
      "created_at": "2026-04-30T15:02:13.120152+00:00",
      "updated_at": "2026-04-30T15:02:13.120152+00:00",
      "organisation_id": "0b7f3c9e-2d4a-4f1b-9a5e-6c8d7e1f2a3b",
      "shared_with_me": false,
      "owner": true,
      "url": "https://app.flowstep.ai/file?activeFileId=5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0"
    }
  ]
}

owner — fayl sizning yaratganingizda true.
shared_with_me — fayl sizga to‘g‘ridan-to‘g‘ri ulashilgan bo‘lsa true, faqat tashkilotingiz orqali emas.
url — faylni Flowstep tahrirlovchisida ochadi.

`get-file`

Bitta fayl uchun metama’lumotlarni oladi. Fayl kontenti ataylab chiqarib tashlangan — ekranlarni tekshirish uchun get-screen-image yoki get-screen-jsx dan, biriktirilgan yo‘riqnomalarni olish uchun esa get-design-guidelines dan foydalaning. Agar faylga kutilayotgan taklifingiz bo‘lsa, get-file ni chaqirish uni qabul qiladi. Kirish

Parametr	Tur	Tavsif
`id`	`uuid`	Fayl ID’si

Chiqish — { file, user_access_level }.

{
  "file": {
    "id": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0",
    "name": "Dashboard redesign",
    "created_at": "2026-04-30T15:02:13.120152+00:00",
    "updated_at": "2026-04-30T15:02:13.120152+00:00",
    "project_id": "81cb84d6-c69f-492c-a895-7421b60d1a6d",
    "access_level": "private",
    "visibility": "private",
    "owner": true,
    "url": "https://app.flowstep.ai/file?activeFileId=5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0"
  },
  "user_access_level": "write"
}

access_level — private, read yoki write.
visibility — private, member yoki public.
user_access_level — fayldagi kirish huquqingiz: read yoki write.

`create-file`

Hech qanday ekransiz bo‘sh Flowstep fayl yaratadi. Faylni yaratib, bir qadamda ekranlarni generatsiya qilish uchun buning o‘rniga fileId siz ai-design-screens ni chaqiring. Kod birinchi ish oqimlari uchun create-file dan foydalaning, so‘ng add-screen-jsx ni chaqiring. Kirish

Parametr	Tur	Tavsif
`name`	`string` (min 1)	Yangi faylning ko‘rsatiladigan nomi

Chiqish — get-file bilan bir xil shakldagi { file, user_access_level }. owner doim true, user_access_level doim write. Keyingi vosita chaqiruvlarida fileId sifatida qaytarilgan file.id dan foydalaning.

`update-file`

Faylni qayta nomlaydi. Kirish

Parametr	Tur	Tavsif
`id`	`uuid`	Fayl ID’si
`name`	`string` (min 1)	Yangi ko‘rsatiladigan nom

Chiqish — get-file bilan bir xil shakldagi { file, user_access_level }.

`delete-file`

Faylni butunlay o‘chiradi. Siz yuborgan name o‘chirishdan oldin faylning joriy ko‘rsatiladigan nomi bilan tekshiriladi — mos kelmasa, o‘chirish bekor qilinadi. Bu noto‘g‘ri faylni tasodifan o‘chirishning oldini oladi. Agentlarga avval siz bilan tasdiqlash ko‘rsatilgan. Kirish

Parametr	Tur	Tavsif
`id`	`uuid`	Fayl ID’si
`name`	`string`	Faylning joriy ko‘rsatiladigan nomi — mos kelishi shart, aks holda o‘chirish bekor qilinadi

Chiqish — { "deleted": true }

Bu qaytarib bo‘lmaydi. Fayldagi barcha ekranlar o‘chiriladi.

Ekran vositalari

`list-screens`

Faylning ekranlarini kanvas tartibida ro‘yxatlaydi. list-files dan keyin faylda nima borligini ko‘rish uchun shu vositani chaqiring. Qaytarilgan screenId qiymatlaridan boshqa ekran vositalari va AI dizayn vositalari bilan foydalaning. Kirish

Parametr	Tur	Tavsif
`fileId`	`uuid`	Fayl ID’si

Chiqish — { screens }.

{
  "screens": [
    {
      "screenId": "3f9e6eb6-5525-4383-9375-67e0bd762dbe",
      "name": "Mobile login screen",
      "prompt": "Generate a simple mobile login screen with email and password fields and a sign in button",
      "fidelity": "ui"
    }
  ]
}

prompt — ekran uchun oxirgi generatsiya prompt’i, yoki ekran hech qachon generatsiya qilinmagan bo‘lsa bo‘sh qator (masalan, add-screen-jsx bilan qo‘shilgan ekran).
fidelity — lofi, hifi yoki ui.

`get-screen-image`

Ekranni PNG ga renderlaydi va uni ichki rasm sifatida qaytaradi. Rasm kontent bloklarini qo‘llab-quvvatlaydigan mijoz talab qilinadi. AI dizayn vositasi, add-screen-jsx, replace-screen-jsx yoki import-figma tomonidan qaytarilgan har bir screenId uchun bir marta chaqiring. Kirish

Parametr	Tur	Tavsif
`fileId`	`uuid`	Fayl ID’si
`screenId`	`uuid`	`list-screens` dan yoki dizayn vositasi qaytargan `screenIds` massividan olingan `screenId`

Chiqish — MCP rasm kontent bloki (image/png). data — PNG baytlarining standart base64 ko‘rinishi, data URI emas. Bu vosita uchun structuredContent yo‘q.

`get-screen-jsx`

Ekranni JSX sifatida va uning metama’lumotlari bilan qaytaradi — shunda uni kod bazangizda qurishingiz yoki tahrirlab, replace-screen-jsx bilan qaytarishingiz mumkin. Vizual ko‘rinish uchun buning o‘rniga get-screen-image dan foydalaning. Kirish

Parametr	Tur	Standart	Tavsif
`fileId`	`uuid`	—	Fayl ID’si
`screenId`	`uuid`	—	`list-screens` dan yoki dizayn vositasi qaytargan `screenIds` dan `screenId`
`includeIds`	`boolean`	`false`	`jsx` dagi elementlarga `data-id` atributini qo‘shadi. Element id’lari kerak bo‘lganda — `ai-design-screens` ga `elementIds` orqali uzatish uchun (tahrir qilish yoki vizual ma’lumot sifatida) — ulardan foydalaning

Chiqish — { fileId, screenId, name, prompt, fidelity, screenType, colorTheme, jsx, fragments }.

{
  "fileId": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0",
  "screenId": "c13d3707-0efe-49f5-b6cb-0ca5ac5223d0",
  "name": "World clock",
  "prompt": "A world clock screen with a city search and alert button",
  "fidelity": "ui",
  "screenType": "iphone-x-vertical",
  "colorTheme": "blue",
  "jsx": "<div className=\"bg-white text-zinc-950 w-full h-fit\">\n  <div className=\"flex p-6 flex-col gap-6\">\n    …\n  </div>\n</div>",
  "fragments": []
}

jsx — faqat markup. data-id atributlari faqat includeIds true bo‘lganda kiritiladi.
prompt — oxirgi generatsiya prompt’i, yoki ekran hech qachon generatsiya qilinmagan bo‘lsa bo‘sh qator.
fragments — ekranda saqlangan umumiy interfeys qismlari (navigatsiya paneli, sarlavha yoki logotip kabi), { purpose, markup } obyektlari ko‘rinishida. Bo‘lmasa, bo‘sh. Ularni saqlash yoki yangilash uchun replace-screen-jsx ga qaytaring.

fidelity, screenType va colorTheme qiymatlari uchun Ekran maydonlari qiymatlari ga qarang.

`add-screen-jsx`

Siz yozgan JSX dan faylga yangi ekran qo‘shadi. Bu kod birinchi yo‘l va bepul — Flowstep AI ekranni loyihalashini xohlaganingizda ai-design-screens dan foydalaning. add-screen-jsx doim yangi ekran yaratadi: mavjudini qayta yozish uchun replace-screen-jsx dan foydalaning. Yuklagan rasmingizni ko‘rsatish uchun JSX ichidagi rasmlar bo‘limiga qarang. Yangi ekran mavjud ekranga asoslangan bo‘lsa, name, fidelity, screenType, colorTheme va jsx uchun get-screen-jsx (includeIds siz) dan boshlang, so‘ng farq qilishi kerak bo‘lgan narsalarni o‘zgartiring. Kirish

Parametr	Tur	Standart	Tavsif
`fileId`	`uuid`	—	Fayl ID’si
`name`	`string` (1–100 belgi)	—	Ixtiyoriy ko‘rsatiladigan nom. Uni chiqarib tashlasangiz, ekran `Screen N` deb avtomatik nomlanadi
`fidelity`	`string`	`"ui"`	Ekranning aniqlik darajasi
`screenType`	`string`	—	Majburiy — ekran mo‘ljallangan qurilma yoki ko‘rinish maydoni
`colorTheme`	`string`	`"default"`	Rang mavzusi
`jsx`	`string`	—	Faqat JSX markup. Har qanday `data-id` atributlari e’tiborga olinmaydi — yangi ekran yangi element id’larini oladi

Chiqish — { fileId, screenId }. Natijani ko‘rish uchun screenId bilan get-screen-image ni chaqiring.

{
  "fileId": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0",
  "screenId": "3f9e6eb6-5525-4383-9375-67e0bd762dbf"
}

`replace-screen-jsx`

Mavjud ekranni siz yozgan JSX bilan qayta yozadi. Ekran o‘zining screenId va kanvasdagi o‘rnini saqlaydi; ichki elementlar yangi id’lar oladi. Bu kod birinchi yo‘l va bepul — AI o‘zgarishlari uchun ai-design-screens yoki ai-edit-screen-variant dan, yangi ekran yaratish uchun esa add-screen-jsx dan foydalaning. get-screen-jsx (includeIds siz) dan boshlang, so‘ng farq qilishi kerak bo‘lgan narsalarni o‘zgartiring. Yuklagan rasmingizni ko‘rsatish uchun JSX ichidagi rasmlar bo‘limiga qarang. Kirish

Parametr	Tur	Tavsif
`fileId`	`uuid`	Fayl ID’si
`screenId`	`uuid`	Qayta yoziladigan ekran
`jsx`	`string`	Faqat JSX markup. Har qanday `data-id` atributlari e’tiborga olinmaydi
`name`	`string` (1–100 belgi)	Ixtiyoriy. Joriy nomni saqlash uchun chiqarib tashlang
`fidelity`	`string`	Ixtiyoriy. Joriy aniqlik darajasini saqlash uchun chiqarib tashlang
`screenType`	`string`	Ixtiyoriy. Joriy ekran turini saqlash uchun chiqarib tashlang
`colorTheme`	`string`	Ixtiyoriy. Joriy rang mavzusini saqlash uchun chiqarib tashlang
`fragments`	`{ purpose, markup }[]`	Ixtiyoriy. `get-screen-jsx` dan olingan umumiy interfeys qismlari. Joriy qismlarni saqlash uchun chiqarib tashlang, yoki ularni tozalash uchun `[]` yuboring

Chiqish — { fileId, screenId }. Natijani ko‘rish uchun screenId bilan get-screen-image ni chaqiring.

Bu ekran kontentini joyida almashtiradi.

`rename-screen`

Ekranning kanvas yorlig‘ini qayta nomlaydi — list-screens va tahrirlovchida ko‘rsatiladigan nom. Bu faqat yorliqni o‘zgartiradi, ekranning joylashuvi, o‘lchami yoki kontentini emas — ular uchun ai-design-screens dan foydalaning. Kirish

Parametr	Tur	Tavsif
`fileId`	`uuid`	Fayl ID’si
`screenId`	`uuid`	`list-screens` qaytargan `screenId`
`name`	`string` (1–100 belgi)	Yangi ekran nomi. Boshidagi va oxiridagi bo‘shliqlar olib tashlanadi

Chiqish — { screenId, name }.

{ "screenId": "3f9e6eb6-5525-4383-9375-67e0bd762dbe", "name": "Checkout — empty cart" }

`delete-screen`

Ekranni faylidan butunlay o‘chiradi. Siz yuborgan name ekranning joriy ko‘rsatiladigan nomi bilan tekshiriladi — mos kelmasa, o‘chirish bekor qilinadi. Agentlarga avval siz bilan tasdiqlash ko‘rsatilgan. Kirish

Parametr	Tur	Tavsif
`fileId`	`uuid`	Fayl ID’si
`screenId`	`uuid`	O‘chiriladigan ekran
`name`	`string`	Ekranning joriy ko‘rsatiladigan nomi — mos kelishi shart, aks holda o‘chirish bekor qilinadi

Chiqish — { "deleted": true }

JSX ichidagi rasmlar

add-screen-jsx va replace-screen-jsx rasmni img src da yoki className ichida bg-[url(...)] bilan fon sifatida qabul qiladi. alt matnini yozing va har bir rasmni o‘z maqsadiga mos o‘lchamda bering. O‘zingizning rasmingizni joylashtirish uchun:

Uni upload-attachment bilan A rejimida (mimeType + fileName) yuklang va qaytgan uploadCommand ni ishga tushiring.
Javobning type qiymati "image" bo‘lsa, uning assetUrl ini qaytarilganidek aynan img src yoki bg-[url(assetUrl)] ga qo‘ying.

Boshqa barcha rasm URL’larini get-screen-jsx qaytargandek qoldiring. path, signedUrl yoki uploadCommand ni src ga qo‘ymang.

<img src="ASSET_URL" alt="Team photo" className="w-full h-48 object-cover rounded-lg" />

Ekran maydonlari qiymatlari

get-screen-jsx qaytaradigan, add-screen-jsx va replace-screen-jsx qabul qiladigan qiymatlar:

Maydon	Qiymatlar
`fidelity`	`lofi`, `hifi`, `ui`
`screenType`	`web`, `desktop`, `desktop-large`, `desktop-medium`, `desktop-small`, `tablet`, `ipad-tablet-horizontal`, `ipad-tablet-vertical`, `android-tablet-horizontal`, `android-tablet-vertical`, `mobile_ios`, `mobile_android`, `iphone-vertical`, `iphone-horizontal`, `iphone-x-vertical`, `iphone-x-horizontal`, `android-vertical`, `android-horizontal`, `android-small-vertical`, `android-small-horizontal`
`colorTheme`	`default`, `defaultDark`, `blue`, `blueDark`, `ice`, `iceDark`, `grayscale`, `grayscaleDark`, `green`, `greenDark`, `orange`, `orangeDark`, `red`, `redDark`, `rose`, `roseDark`, `violet`, `violetDark`, `yellow`, `yellowDark`

Dizayn yo‘riqnomalari vositalari

Dizayn yo‘riqnomalari faylda saqlanadigan DESIGN.md matni. Ular o‘rnatilganda, shu fayl uchun har bir AI generatsiyasiga kiritiladi. Qarang: Dizayn yo‘riqnomalari.

`get-design-guidelines`

Faylga biriktirilgan dizayn yo‘riqnomalarini oladi. Kirish

Parametr	Tur	Tavsif
`fileId`	`uuid`	Fayl ID’si

Chiqish — { guidelines }.

{
  "guidelines": "## Colors\n\nPrimary: #6366F1\nBackground: #FFFFFF\n\n## Typography\n\nFont: Inter"
}

Yo‘riqnomalar o‘rnatilmagan bo‘lsa, guidelines null bo‘ladi.

`update-design-guidelines`

Faylning dizayn yo‘riqnomalarini o‘rnatadi yoki almashtiradi. Yo‘riqnomalarni Google’ning DESIGN.md formati bo‘yicha oddiy satr sifatida uzating — obyekt yoki JSON emas. Agar fayldan o‘qayotgan bo‘lsangiz, o‘sha faylning matnini uzating. Kirish

Parametr	Tur	Tavsif
`fileId`	`uuid`	Fayl ID’si
`designGuidelines`	`string` (min 1)	Yo‘riqnomalarning xom matni. Oddiy satr bo‘lishi shart — JSON kodlanmagan

Tekshiruv qoidalari

Frontmatter to‘g‘ri ochilgan va yopilgan bo‘lishi kerak
Frontmatter qatorlari to‘g‘ri blok uslubidagi YAML bo‘lishi kerak
Markdown asosida takroriy ## bo‘lim sarlavhalari bo‘lmasligi kerak

Tekshiruv muvaffaqiyatsiz bo‘lsa, chaqiruv Invalid design guidelines: bilan boshlanadigan xatoni qaytaradi. Chiqish — { updated, warnings? }.

{ "updated": true, "warnings": ["…"] }

warnings qabul qilingan, lekin AI tomonidan e’tiborga olinmasligi mumkin bo‘lgan yumshoq tekshiruv muammolarini (noma’lum kalitlar, hex bo‘lmagan ranglar) ro‘yxatlaydi. Hech narsa bo‘lmasa, u chiqarib tashlanadi. Bularni foydalanuvchiga ko‘rsating.

`delete-design-guidelines`

Faylning dizayn yo‘riqnomalarini tozalaydi. Mavjud bo‘lmagan yo‘riqnomalarni o‘chirish hech narsani o‘zgartirmaydi. Kirish

Parametr	Tur	Tavsif
`fileId`	`uuid`	Fayl ID’si

Chiqish — { "deleted": true }

Chat vositalari

`get-chat-history`

Faylga bog‘liq dizayn suhbatini oladi — bu faylning Flowstep chati, MCP mijozingizning suhbati emas. Faylda oldingi ishni davom ettirish uchun undan foydalaning. Kirish

Parametr	Tur	Tavsif
`fileId`	`uuid`	Fayl ID’si

Chiqish — { messages }. Faylda dizayn suhbatingiz bo‘lmasa, messages bo‘sh bo‘ladi. Har bir xabarning type ("request" yoki "response"), author ("human" yoki "ai") va content_type bor. Javob xabarlari "text", "summary" yoki "followup" dan foydalanadi.

{
  "messages": [
    {
      "id": "453f593d-2380-425b-ba29-127db08d6a8e",
      "type": "request",
      "status": "success",
      "content": "Generate a simple mobile login screen with email and password fields",
      "author": "human",
      "content_type": "text",
      "sequence": 1,
      "targets": [],
      "attachments": []
    },
    {
      "id": "d860186b-82d5-4bd1-8e8e-8ba5377a14bf",
      "type": "response",
      "status": "success",
      "content": "Generated a mobile login screen with email and password input fields, a sign in button, and a sign up link.",
      "author": "ai",
      "content_type": "summary",
      "sequence": 7,
      "request_message_id": "453f593d-2380-425b-ba29-127db08d6a8e",
      "targets": [{ "target_id": "3f9e6eb6-5525-4383-9375-67e0bd762dbe" }]
    }
  ]
}

Biriktirma vositalari

`upload-attachment`

ai-design-screens da biriktirma sifatida ishlatiladigan yoki add-screen-jsx yoki replace-screen-jsx bilan o‘z JSX ingizga joylashtiriladigan rasm uchun havola fayl yuklaydi. ai-generate-screen-variant va ai-edit-screen-variant biriktirmalarni qabul qilmaydi. Fayl baytlari hech qachon model orqali o‘tmaydi va server siz uchun URL’larni hech qachon olmaydi. Veb-sahifaga havola qilish uchun uning URL’ini ai-design-screens ning message ichiga kiriting. Ikki rejim bor — faqat bittasidan foydalaning, ularni birlashtirmang. A rejimi — fayllar va rasmlar (mimeType + fileName) Har qanday rasm, PDF yoki kattaroq matn fayli uchun talab qilinadigan uch bosqichli oqim:

upload-attachment ni faqat mimeType va fileName bilan chaqiring (masalan, image/png va dog.png). Javob tayyorlangan yuklash bo‘ladi, saqlangan fayl emas:

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "path": "attachments/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "assetUrl": "https://…",
  "type": "image",
  "mimeType": "image/png",
  "signedUrl": "https://…",
  "uploadCommand": "curl -sS -f -X PUT '…' -H 'Content-Type: image/png' -H 'x-metadata: …' --data-binary @LOCAL_FILE_PATH",
  "nextStep": "…"
}

uploadCommand dagi LOCAL_FILE_PATH ni faylingizning mutlaq yo‘li bilan almashtiring va o‘sha aniq buyruqni shellingizda ishga tushiring — u 0 kodi bilan tugashi shart. signedUrl dagi token faqat shu yagona yuklashga ruxsat beradi. Bu qadamni o‘tkazib yuborish saqlashni bo‘sh qoldiradi va dizayn vositasi oldindan tekshiruvdan o‘tmaydi.
ai-design-screens ning attachments massiviga faqat { id, path, type } ni uzating — signedUrl, uploadCommand yoki nextStep ni emas. Buning o‘rniga o‘z JSX ingizga rasm qo‘yish uchun assetUrl ni add-screen-jsx yoki replace-screen-jsx ga uzatadigan JSX ning img src yoki bg-[url(...)] ga qo‘ying. Qarang: JSX ichidagi rasmlar.

Masofadagi faylni biriktirish uchun uni avval o‘zingiz mahalliy yo‘lga yuklab oling (masalan, curl bilan), so‘ng xuddi shu uch qadamni bajaring. upload-attachment ga hech qachon URL uzatmang.

Parametr	Tur	Tavsif
`mimeType`	enum	Fayl MIME turi. Quyidagilardan biri: `image/jpeg`, `image/png`, `image/webp`, `application/pdf`, `text/markdown`, `text/plain`, `text/javascript`. `.jsx`, `.tsx`, `.js`, `.ts` fayllar uchun `text/javascript` dan foydalaning
`fileName`	`string` (min 1)	Kengaytmasi bilan asl fayl nomi, masalan `cat.png` yoki `design.md`

B rejimi — qisqa matn (text + mimeType) Allaqachon kontekstda bo‘lgan matnni yuklang — shell buyrug‘i kerak emas. Javob to‘g‘ridan-to‘g‘ri ishlatishga tayyor bo‘ladi:

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "path": "attachments/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "assetUrl": "https://…",
  "type": "document",
  "mimeType": "text/plain"
}

Parametr	Tur	Tavsif
`text`	`string` (maksimal 64,000 belgi)	Xom matn kontenti. Faqat matn fayllari uchun — rasm yoki PDF uchun ishlatmang. 64,000 belgidan uzunmi? Buning o‘rniga A rejimidan foydalaning
`mimeType`	enum	Quyidagilardan biri: `text/markdown`, `text/plain`, `text/javascript`

Olingan { id, path, type } ni ai-design-screens ning attachments massiviga uzating. Ikkala rejimda ham maksimal fayl hajmi 3 MB, PDF lar esa 100 sahifa bilan cheklangan. Chiqish — { id, path, assetUrl, type, mimeType, signedUrl?, uploadCommand?, nextStep? }.

type — rasm fayllari uchun "image", PDF va matn fayllari uchun "document".
assetUrl — yuklangan faylning URL’i, ikkala rejimda ham qaytariladi. add-screen-jsx yoki replace-screen-jsx uchun JSX da faqat type "image" bo‘lganda va A rejimidagi uploadCommand ishga tushirilgandan keyin ishlating.
signedUrl, uploadCommand, nextStep — faqat A rejimida qo‘yiladi. Ularni dizayn vositalariga uzatmang.

Figma vositalari

`import-figma`

Figma freymini Flowstep fayliga uning kanvasida tahrirlanadigan elementlar sifatida import qiladi. Har bir import yangi ekran qo‘shadi — bir xil freymni ikki marta import qilsangiz, ikkita ekran hosil bo‘ladi, shuning uchun eskisini almashtirmoqchi bo‘lsangiz, uni delete-screen bilan o‘chiring. Faylning tashkiloti Flowstep sozlamalarida Figma ulangan bo‘lishi kerak. Kirish

Parametr	Tur	Tavsif
`fileId`	`uuid`	Freym import qilinadigan Flowstep fayli. Bu `figmaUrl` dagi Figma fayl kaliti emas
`figmaUrl`	`string`	`node-id` bilan aniq Figma freymiga havola. Figma’da freymni o‘ng tugma bilan bosing va Copy/Paste as → Copy link to selection ni tanlang. Sahifaga havola o‘sha sahifadagi barcha yuqori darajadagi freymlarni import qiladi (MCP orqali 20 ta freym bilan cheklangan)

Chiqish — { fileId, screenId, frameCount? }. screenId — import qilingan ekran; natijani ko‘rish uchun uni get-screen-image ga uzating. Sahifa URL’i bir nechta freymni import qilganda, screenId null bo‘ladi va o‘rniga frameCount qaytariladi; list-screens ni, so‘ng har bir yangi ekran uchun get-screen-image ni chaqiring.

{
  "fileId": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0",
  "screenId": "3f9e6eb6-5525-4383-9375-67e0bd762dbe"
}

Tarif va to‘lov vositalari

`get-plan-details`

Tashkilotingizning Flowstep tarifi, obuna holati, foydalanishi va qolgan kvotasini oladi. Kiritish talab qilinmaydi — tashkilot tizimga kirgan foydalanuvchidan aniqlanadi. AI dizayn vositalarini chaqirishdan oldin limitingizni tekshirish uchun undan foydalaning. Chiqish — { plan, subscription, limits, usage, remaining }.

Maydon	Tavsif
`plan`	`{ name, code, type }`. `type` — `"free"` yoki `"paid"`
`subscription`	`{ isPaid, isTrial, startDate, endDate, trialDaysRemaining }`
`limits`	Funksiya bo‘yicha limitlar, funksiya nomi bo‘yicha kalitlangan (masalan, `messages`). Har birida `max` va `warn` qiymatlari bilan ixtiyoriy `daily` va `monthly` obyektlari, shuningdek `unlimited` bayrog‘i bor
`usage`	Hozirgacha funksiya bo‘yicha foydalanish, `{ daily, monthly }` ko‘rinishida
`remaining`	Funksiya bo‘yicha qolgan kvota, `{ daily, monthly }` ko‘rinishida. Cheklanmagan funksiyalar uchun chiqarib tashlanadi

Limitlar tarifga qarab farqlanadi — Narxlar va Foydalanish limitlari ga qarang.

AI dizayn vositalari

Bu uchta vosita tavsif yoki tayyor sozlama asosida dizayn yaratadi — ular hech qachon JSX qabul qilmaydi va qayta ishlatmaydi. Har bir chaqiruv Flowstep ilovasi bilan bir xil xabar limitidan foydalanadi va generatsiya tugagunicha yoki vaqt tugaguncha (180 soniya) to‘sib turadi.

Vosita	Nima uchun ishlatiladi
`ai-design-screens`	Erkin tavsif asosida yangi ekranlar yaratish, mavjud ekranlarni joyida o‘zgartirish yoki ikkalasini birga bajarish
`ai-generate-screen-variant`	Bitta mavjud ekranning keyingi qadami, xato yoki bo‘sh holati, yoki platforma variantini qo‘shish
`ai-edit-screen-variant`	Bitta butun mavjud ekranga tahrir yoki qayta loyihalash tayyor sozlamasini qo‘llash

Uchalasi ham { status, fileId, screenIds, designGuidelinesUpdated } qaytaradi. Natijani ko‘rish uchun har bir screenId uchun get-screen-image ni bir marta chaqiring.

designGuidelinesUpdated — bu chaqiruv davomida faylning DESIGN.md yo‘riqnomalari avtomatik yangilangan bo‘lsa, o‘zgarishning qisqa xulosasi; aks holda null.

`ai-design-screens`

Matnli tavsif asosida bitta chaqiruvda bir yoki bir nechta yangi ekran yarating, mavjud ekranlarni joyida o‘zgartiring yoki ikkalasini birga bajaring — yangi oqimlar, mavzulash, matn, joylashuv yoki bir nechta ekran bo‘ylab muvofiqlashtirilgan o‘zgarishlar. Bu Flowstep tahrirlovchisidagi chat bilan bir xil dizayn agenti: u message va elementIds asosida nimani qurish va nimani o‘zgartirishni hal qiladi. Yangi fayl boshlash uchun fileId ni chiqarib tashlang; mavjud faylda ishlash uchun fileId ni uzating. Agar so‘rov allaqachon mavjud faylga tegishli bo‘lishi mumkin bo‘lsa, agentingiz avval list-files va list-screens ni tekshirishi kerak. Bitta ekranning keyingi qadami, xato yoki bo‘sh holati, yoki platforma varianti uchun ai-generate-screen-variant dan foydalaning. Bitta ekranga tayyor tahrir yoki qayta loyihalash uchun ai-edit-screen-variant dan foydalaning. JSX allaqachon bo‘lsa, buning o‘rniga add-screen-jsx yoki replace-screen-jsx dan foydalaning. Kirish

Parametr	Tur	Standart	Tavsif
`fileId`	`uuid`	—	Maqsadli fayl. Yangi fayl yaratish uchun chiqarib tashlang. `elementIds` berilganda majburiy
`message`	`string`	—	Yaratiladigan ekranlar va/yoki kiritiladigan o‘zgarishlar tavsifi. `elementIds` uzatganingizda, ularni tahrirlashni yoki vizual ma’lumot sifatida ishlatishni ayting. Flowstep ma’lumot sifatida foydalanishini xohlagan veb-sahifa URL’larini shu yerga kiriting
`elementIds`	`uuid[]`	`[]`	Ixtiyoriy. `list-screens` dagi `screenId` lar va/yoki `get-screen-jsx` (`includeIds` bilan) dagi element `data-id` lari, redaktordagi tanlov kabi. Ularni joyida tahrirlash yoki yangi ekranlar uchun vizual ma’lumot sifatida ishlatish mumkin. `screenId` butun ekranni nishonga oladi
`attachments`	`{ id, path, type }[]` (maksimal 5)	`[]`	`upload-attachment` dan olingan fayllar — rasmlar, PDF lar, yoki kod va matn fayllari. Fayl kontentini xabarga joylashtirmang

Misol — bitta chaqiruvda bir ekranni tahrirlash va boshqasini qo‘shish:

{
  "fileId": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0",
  "message": "Switch this sign-in screen to dark mode, then add a matching forgot-password screen.",
  "elementIds": ["3f9e6eb6-5525-4383-9375-67e0bd762dbe"]
}

Chiqish — { status, fileId, screenIds, designGuidelinesUpdated, reply? }.

{
  "status": "generated",
  "fileId": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0",
  "screenIds": [
    "3f9e6eb6-5525-4383-9375-67e0bd762dbe",
    "c13d3707-0efe-49f5-b6cb-0ca5ac5223d0"
  ],
  "designGuidelinesUpdated": null
}

status — ekranlar qurilgan yoki o‘zgartirilgan bo‘lsa "generated". Flowstep ekran qurmasdan javob bergan bo‘lsa "chat"; bunda javob reply da bo‘ladi va screenIds bo‘sh bo‘ladi. Agar topshiriq noaniq bo‘lsa, agentingiz sizdan aniqlashtirishni so‘rab, vositani qayta chaqirishi kerak.
screenIds — chaqiruv davomida qurilgan yoki o‘zgartirilgan har bir ekran, joyida tahrirlangan ekranlar ham kiritilgan holda. Agar chaqiruv ba’zi ekranlar qurilgandan keyin vaqt tugasa, xato o‘rniga o‘sha ekranlarni qaytaradi.

Tahrirlash uchun so‘ralgan ekranlar joyida qayta yoziladi.

`ai-generate-screen-variant`

Aniq bitta mavjud ekrandan olingan yangi ekran qo‘shadi — oqimdagi keyingi qadam, xato yoki bo‘sh holat, yoki boshqa platforma uchun versiya. Asl ekran o‘zgarishsiz qoladi. Mavjud ekranning varianti bo‘lmagan ekranni (masalan, sozlamalar ekranini) qo‘shish uchun fileId bilan ai-design-screens dan foydalaning. Kirish

Parametr	Tur	Tavsif
`fileId`	`uuid`	Maqsadli fayl
`screenId`	`uuid`	Asos qilib olinadigan mavjud ekran
`operationVariant`	enum	Majburiy — yangi ekran mavjud ekran bilan qanday bog‘lanishi

`operationVariant`	Qo‘shadi
`next_screen`	Foydalanuvchi oqimidagi keyingi ekran
`error_state`	Ekranning xato holati
`empty_state`	Ekranning bo‘sh holati
`web_version`	Veb versiya
`mobile_version`	Mobil versiya
`tablet_version`	Planshet versiyasi
`mobile_ios_version`	iOS versiyasi
`mobile_android_version`	Android versiyasi

Chiqish — { status, fileId, screenIds, designGuidelinesUpdated }. status doim "generated".

`ai-edit-screen-variant`

Tayyor sozlamadan foydalanib, aniq bitta mavjud ekranni joyida o‘zgartiring — mavzusini o‘zgartiring yoki silliqlang, boshqa joylashuv yoki vizual uslubni sinab ko‘ring, yoki butunlay qayta loyihalang. Yangi ekranlar, erkin ko‘rsatmalar yoki alohida elementlarga aniq tahrir uchun ai-design-screens dan foydalaning. Kirish

Parametr	Tur	Tavsif
`fileId`	`uuid`	Maqsadli fayl
`screenId`	`uuid`	O‘zgartiriladigan mavjud ekran
`operationVariant`	enum	Majburiy — qo‘llaniladigan tahrir yoki qayta loyihalash sozlamasi

`operationVariant`	Turi	Ta’siri
`dark_theme`	Tahrir	Ekranni qorong‘i mavzuga o‘tkazish
`light_theme`	Tahrir	Ekranni yorug‘ mavzuga o‘tkazish
`make_pretty`	Tahrir	Ekranning vizual dizaynini silliqlash
`different_layout`	Qayta loyihalash	Boshqa joylashuvni sinab ko‘rish
`different_style`	Qayta loyihalash	Boshqa vizual uslubni sinab ko‘rish
`from_scratch`	Qayta loyihalash	Ekranni noldan qayta loyihalash

Chiqish — { status, fileId, screenIds, designGuidelinesUpdated }. status doim "generated".

Bu ekran kontentini joyida qayta yozadi.

Qayta nomlangan vositalar

Vosita nomlari 2026-yil sentyabr va oktyabrda o‘zgartirilgan. Agar sizda eski nomlarni ishlatadigan promptlar, skriptlar yoki agent ko‘rsatmalari bo‘lsa, ularni yangilang:

Eski nom	Yangi nom
`get-screen`	`get-screen-jsx`
`add-screen`	`add-screen-jsx`
`replace-screen`	`replace-screen-jsx`
`ai-generate-screens`	`ai-design-screens`
`ai-edit-screens`	`ai-design-screens`
`create-new-design`	`ai-design-screens`
`edit-design` (erkin ko‘rsatmalar)	`ai-design-screens`
`edit-design` (`operationVariant` tayyor sozlamasi bilan)	`ai-edit-screen-variant`
`regenerate-design`	`ai-edit-screen-variant`
`expand-design`	`ai-generate-screen-variant`

Kiritishlar ham o‘zgargan: AI dizayn vositalari targets o‘rniga elementIds (yoki variant vositalari uchun bitta screenId) ni qabul qiladi, add-screen-jsx metama’lumot izohi bilan jsxContent o‘rniga jsx va aniq metama’lumot maydonlarini qabul qiladi, create-file title o‘rniga name ni qabul qiladi, dizayn yo‘riqnomalari vositalari esa resourceId va linkedTo o‘rniga fileId ni qabul qiladi.

​Fayl vositalari

​list-files

​get-file

​create-file

​update-file

​delete-file

​Ekran vositalari

​list-screens

​get-screen-image

​get-screen-jsx

​add-screen-jsx

​replace-screen-jsx

​rename-screen

​delete-screen

​JSX ichidagi rasmlar

​Ekran maydonlari qiymatlari

​Dizayn yo‘riqnomalari vositalari

​get-design-guidelines

​update-design-guidelines

​delete-design-guidelines

​Chat vositalari

​get-chat-history

​Biriktirma vositalari

​upload-attachment

​Figma vositalari

​import-figma

​Tarif va to‘lov vositalari

​get-plan-details

​AI dizayn vositalari

​ai-design-screens

​ai-generate-screen-variant

​ai-edit-screen-variant

​Qayta nomlangan vositalar

Fayl vositalari

`list-files`

`get-file`

`create-file`

`update-file`

`delete-file`

Ekran vositalari

`list-screens`

`get-screen-image`

`get-screen-jsx`

`add-screen-jsx`

`replace-screen-jsx`

`rename-screen`

`delete-screen`

JSX ichidagi rasmlar

Ekran maydonlari qiymatlari

Dizayn yo‘riqnomalari vositalari

`get-design-guidelines`

`update-design-guidelines`

`delete-design-guidelines`

Chat vositalari

`get-chat-history`

Biriktirma vositalari

`upload-attachment`

Figma vositalari

`import-figma`

Tarif va to‘lov vositalari

`get-plan-details`

AI dizayn vositalari

`ai-design-screens`

`ai-generate-screen-variant`

`ai-edit-screen-variant`

Qayta nomlangan vositalar