MCP-eszközök referenciája

Sikeres futás esetén minden eszköz, kivéve a get-screen-image eszközt, kétszer adja vissza az eredményt: egyszer structuredContent mezőként (a közzétett kimeneti sémával érvényesítve), egyszer pedig ugyanezt az objektumot szövegblokkba sorosítva, { type: "text", text: "<json-string>" } formában. Ez azoknak a klienseknek szól, amelyek nem olvassák a strukturált tartalmat. A get-screen-image csak egy MCP-képblokkot ad vissza: { type: "image", data: "<base64>", mimeType: "image/png" }. Hiba esetén az isError: true érték áll be, a szövegblokk pedig egy rövid hibaüzenetet tartalmaz. A kezelhető hibák, például a törlésnél fellépő névegyezési hiba, az érvénytelen Figma-hivatkozás, az érvénytelen tervezési irányelvek, a mellékletprobléma vagy a generálás időtúllépése, megmondják, mit kell javítani. Más hibák általános üzenetet adnak, például Failed to list files.

Árazás: a három AI-tervezőeszköz, vagyis az ai-design-screens, az ai-generate-screen-variant és az ai-edit-screen-variant, ugyanazt az üzenetkvótát használja, mint a Flowstep-alkalmazás. Minden más eszköz ingyenes. Lásd: Használati korlátok.

Minden eszköz közzéteszi az MCP-annotációit, hogy a kliensed tudja, mit csinál. A delete-file, delete-screen, delete-design-guidelines, replace-screen-jsx, ai-design-screens és ai-edit-screen-variant eszközöket destruktívként jelöljük, mert meglévő tartalmat távolítanak el vagy írnak felül.

Fájleszközök

`list-files`

Listázza a Flowstep-fájljaid metaadatait. Ezt hívd meg először, hogy ellenőrizd, létezik-e már releváns fájl. Képernyőtartalmat nem ad vissza. Ahhoz használd a get-screen-image vagy a get-screen-jsx eszközt. Bemenet

Paraméter	Típus	Alapértelmezett	Leírás
`orderByCreation`	`boolean`	`true`	Rendezés a legújabbtól a `created_at` alapján (`true`), vagy az `updated_at` alapján (`false`). Az `false` értékkel a nemrég szerkesztett fájlokat találod meg
`limit`	`integer` (1–100)	`20`	Visszaadott fájlok maximális száma. Egy teljes oldal azt jelentheti, hogy több fájl is van
`offset`	`integer` (≥0)	`0`	Kihagyandó fájlok száma. A következő oldal `offset + limit`

Kimenet — { 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: true, ha te hoztad létre a fájlt.
shared_with_me: true, ha a fájlt közvetlenül megosztották veled, nem csak a szervezeteden keresztül.
url: megnyitja a fájlt a Flowstep-szerkesztőben.

`get-file`

Egyetlen fájl metaadatait adja vissza. A fájltartalom szándékosan kimarad. A képernyők megtekintéséhez használd a get-screen-image vagy a get-screen-jsx eszközt, a hozzárendelt irányelvekhez pedig a get-design-guidelines eszközt. Ha függőben lévő meghívód van a fájlhoz, a get-file hívása elfogadja azt. Bemenet

Paraméter	Típus	Leírás
`id`	`uuid`	Fájlazonosító

Kimenet — { 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 vagy write.
visibility: private, member vagy public.
user_access_level: a fájlhoz való hozzáférésed: read vagy write.

`create-file`

Üres Flowstep-fájlt hoz létre, képernyők nélkül. Ha egy lépésben szeretnél fájlt létrehozni és képernyőket generálni, hívd az ai-design-screens eszközt fileId nélkül. A create-file eszközt kódközpontú munkafolyamatokhoz használd, utána az add-screen-jsx következik. Bemenet

Paraméter	Típus	Leírás
`name`	`string` (min. 1)	Az új fájl megjelenített neve

Kimenet — { file, user_access_level }, ugyanabban az alakban, mint a get-file. Az owner mindig true, a user_access_level pedig mindig write. A visszaadott file.id értékét használd fileId-ként a további eszközhívásokban.

`update-file`

Fájl átnevezése. Bemenet

Paraméter	Típus	Leírás
`id`	`uuid`	Fájlazonosító
`name`	`string` (min. 1)	Új megjelenített név

Kimenet — { file, user_access_level }, ugyanabban az alakban, mint a get-file.

`delete-file`

Véglegesen törli a fájlt. A megadott name értéket a törlés előtt összeveti a fájl jelenlegi megjelenített nevével. Ha nem egyezik, a törlés megszakad. Így elkerülhető, hogy véletlenül rossz fájlt töröljünk. Az ügynökök utasítást kapnak, hogy előbb erősítesd meg veled. Bemenet

Paraméter	Típus	Leírás
`id`	`uuid`	Fájlazonosító
`name`	`string`	A fájl jelenlegi megjelenített neve. Egyeznie kell, különben a törlés megszakad

Kimenet — { "deleted": true }

Ez visszafordíthatatlan. A fájl összes képernyője törlődik.

Képernyő-eszközök

`list-screens`

Listázza a fájl képernyőit a vászon sorrendjében. Ezt a list-files után hívd meg, hogy lásd, mi van már a fájlban. A visszaadott screenId értékeket használd a többi képernyőeszközzel és az AI-tervezőeszközökkel. Bemenet

Paraméter	Típus	Leírás
`fileId`	`uuid`	Fájlazonosító

Kimenet — { 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: a képernyő utolsó generálási promptja, vagy üres karakterlánc, ha sosem generálták (például ha az add-screen-jsx eszközzel adták hozzá).
fidelity: lofi, hifi vagy ui.

`get-screen-image`

PNG-be rendereli a képernyőt, és beágyazott képként adja vissza. Olyan klienst igényel, amely támogatja a képtartalom-blokkokat. Minden olyan screenId-hez egyszer hívd meg, amelyet egy AI-tervezőeszköz, az add-screen-jsx, a replace-screen-jsx vagy az import-figma adott vissza. Bemenet

Paraméter	Típus	Leírás
`fileId`	`uuid`	Fájlazonosító
`screenId`	`uuid`	A `list-screens` eszköz `screenId` értéke, vagy egy tervezőeszköz által visszaadott `screenIds` tömb eleme

Kimenet — MCP-képtartalom-blokk (image/png). A data a PNG-bájtok szabványos base64 kódolása, nem data URI. Ehhez az eszközhöz nincs structuredContent.

`get-screen-jsx`

Egy képernyőt JSX-ként ad vissza a metaadataival együtt, így a kódbázisodban építhetsz belőle, vagy szerkesztheted, és visszaírhatod a replace-screen-jsx eszközzel. Vizuális előnézethez használd helyette a get-screen-image eszközt. Bemenet

Paraméter	Típus	Alapértelmezett	Leírás
`fileId`	`uuid`	—	Fájlazonosító
`screenId`	`uuid`	—	A `list-screens` eszköz `screenId` értéke, vagy egy tervezőeszköz által visszaadott `screenIds` tömb eleme
`includeIds`	`boolean`	`false`	`data-id` attribútum felvétele a `jsx` elemeire. Akkor használd, ha az elemazonosítókat `elementIds`-ként kell átadnod az `ai-design-screens` eszköznek, akár helyben szerkesztéshez, akár vizuális referenciaként

Kimenet — { 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: csak jelölés. A data-id attribútumok csak akkor szerepelnek benne, ha az includeIds értéke true.
prompt: az utolsó generálási prompt, vagy üres karakterlánc, ha a képernyőt sosem generálták.
fragments: a képernyőn tárolt közös keretelemek, például navigációs sáv, fejléc vagy logó, { purpose, markup } objektumokként. Ha nincs ilyen, üres. A megtartásukhoz vagy frissítésükhöz add vissza őket a replace-screen-jsx eszköznek.

A fidelity, screenType és colorTheme értékeit lásd: Képernyőmezők értékei.

`add-screen-jsx`

Új képernyőt ad a fájlhoz a te írt JSX-edből. Ez a kódközpontú út, és ingyenes. Ha azt szeretnéd, hogy a Flowstep AI tervezze meg a képernyőt, használd az ai-design-screens eszközt. Az add-screen-jsx mindig új képernyőt hoz létre. Ha egy meglévőt szeretnél felülírni, használd a replace-screen-jsx eszközt. Ha egy feltöltött képet szeretnél megjeleníteni, lásd: Képek a JSX-ben. Ha az új képernyő egy meglévőn alapul, a name, fidelity, screenType, colorTheme és jsx mezőkhöz a get-screen-jsx eszköz (includeIds nélkül) kimenetéből indulj ki, majd módosítsd, amit szükséges. Bemenet

Paraméter	Típus	Alapértelmezett	Leírás
`fileId`	`uuid`	—	Fájlazonosító
`name`	`string` (1–100 karakter)	—	Opcionális megjelenített név. Ha kihagyod, a képernyő automatikus neve `Screen N` lesz
`fidelity`	`string`	`"ui"`	A képernyő részletességi szintje
`screenType`	`string`	—	Kötelező: az eszköz vagy nézetablak, amelyre a képernyő készül
`colorTheme`	`string`	`"default"`	Színtéma
`jsx`	`string`	—	Csak JSX-jelölés. A `data-id` attribútumokat a rendszer figyelmen kívül hagyja, az új képernyő új elemazonosítókat kap

Kimenet — { fileId, screenId }. Az eredmény megtekintéséhez hívd meg a get-screen-image eszközt a screenId értékkel.

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

`replace-screen-jsx`

Felülír egy meglévő képernyőt a te írt JSX-eddel. A képernyő megtartja a screenId értékét és a helyzetét a vásznon. A beágyazott elemek új azonosítókat kapnak. Ez a kódközpontú út, és ingyenes. AI-s módosításokhoz használd az ai-design-screens vagy az ai-edit-screen-variant eszközt, új képernyő létrehozásához pedig az add-screen-jsx eszközt. Kezdd a get-screen-jsx eszköz (includeIds nélküli) kimenetével, majd módosítsd, amit szükséges. Egy feltöltött kép megjelenítéséhez lásd: Képek a JSX-ben. Bemenet

Paraméter	Típus	Leírás
`fileId`	`uuid`	Fájlazonosító
`screenId`	`uuid`	A felülírandó képernyő
`jsx`	`string`	Csak JSX-jelölés. A `data-id` attribútumokat a rendszer figyelmen kívül hagyja
`name`	`string` (1–100 karakter)	Opcionális. Ha kihagyod, a jelenlegi név marad
`fidelity`	`string`	Opcionális. Ha kihagyod, a jelenlegi részletességi szint marad
`screenType`	`string`	Opcionális. Ha kihagyod, a jelenlegi képernyőtípus marad
`colorTheme`	`string`	Opcionális. Ha kihagyod, a jelenlegi színtéma marad
`fragments`	`{ purpose, markup }[]`	Opcionális, a `get-screen-jsx` közös keretelemei. Ha kihagyod, a jelenlegi keretelemek maradnak. Ha `[]`-t adsz meg, törlődnek

Kimenet — { fileId, screenId }. Az eredmény megtekintéséhez hívd meg a get-screen-image eszközt a screenId értékkel.

Ez a képernyő tartalmát helyben cseréli le.

`rename-screen`

Átnevezi a képernyő vászoncímkéjét, vagyis azt a nevet, amelyet a list-screens és a szerkesztő mutat. Csak a címkét változtatja meg, a képernyő elrendezését, méretét és tartalmát nem. Ezekhez használd az ai-design-screens eszközt. Bemenet

Paraméter	Típus	Leírás
`fileId`	`uuid`	Fájlazonosító
`screenId`	`uuid`	A `list-screens` eszköz által visszaadott `screenId`
`name`	`string` (1–100 karakter)	Az új képernyőnév. A szóköz az elején és a végén le lesz vágva

Kimenet — { screenId, name }.

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

`delete-screen`

Véglegesen töröl egy képernyőt a fájlból. A megadott name értéket a képernyő jelenlegi megjelenített nevével veti össze. Ha nem egyezik, a törlés megszakad. Az ügynökök utasítást kapnak, hogy előbb erősítesd meg veled. Bemenet

Paraméter	Típus	Leírás
`fileId`	`uuid`	Fájlazonosító
`screenId`	`uuid`	A törlendő képernyő
`name`	`string`	A képernyő jelenlegi megjelenített neve. Egyeznie kell, különben a törlés megszakad

Kimenet — { "deleted": true }

Képek a JSX-ben

Az add-screen-jsx és a replace-screen-jsx elfogad képeket egy img elem src attribútumában, vagy háttérképként a className attribútumban a bg-[url(...)] használatával. Adj meg alt szöveget, és méretezd minden képet a céljához. Saját kép elhelyezéséhez:

Töltsd fel az upload-attachment eszközzel az A módban (mimeType + fileName), és futtasd le a visszaadott uploadCommand parancsot.
Ha a válasz type értéke "image", a visszakapott assetUrl értéket pontosan úgy illeszd be az img src vagy a bg-[url(assetUrl)] helyére.

Minden más képcímet hagyj pontosan úgy, ahogy a get-screen-jsx visszaadta. Ne tegyél path, signedUrl vagy uploadCommand értéket a src attribútumba.

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

Képernyőmezők értékei

A get-screen-jsx ezeket az értékeket adja vissza, az add-screen-jsx és a replace-screen-jsx pedig ezeket fogadja el:

Mező	Értékek
`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`

Tervezési irányelvek eszközei

A tervezési irányelvek a fájlhoz tárolt DESIGN.md szöveg. Ha be vannak állítva, minden AI-generálásba bekerülnek az adott fájlhoz. Lásd: Tervezési irányelvek.

`get-design-guidelines`

Lekéri a fájlhoz csatolt tervezési irányelveket. Bemenet

Paraméter	Típus	Leírás
`fileId`	`uuid`	Fájlazonosító

Kimenet — { guidelines }.

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

A guidelines értéke null, ha nincsenek beállított irányelvek.

`update-design-guidelines`

Beállítja vagy lecseréli a fájl tervezési irányelveit. Az irányelveket sima karakterláncként add meg a Google DESIGN.md formátumában, nem objektumként vagy JSON-ként. Ha fájlból olvasod, add meg annak a fájlnak a szövegét. Bemenet

Paraméter	Típus	Leírás
`fileId`	`uuid`	Fájlazonosító
`designGuidelines`	`string` (min. 1)	Az irányelvek nyers szövege. Sima karakterláncnak kell lennie, nem JSON-kódolásúnak

Érvényesítési szabályok

Az előtagot (frontmatter) helyesen kell megnyitni és lezárni
Az előtag sorainak érvényes, blokkstílusú YAML-nek kell lenniük
A Markdown-törzsben nem szerepelhetnek ismétlődő ## szakaszcímek

Ha az érvényesítés sikertelen, a hívás a Invalid design guidelines: szöveggel kezdődő hibát ad vissza. Kimenet — { updated, warnings? }.

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

A warnings a lágy érvényesítési problémákat sorolja fel, például ismeretlen kulcsokat vagy nem hexadecimális színeket. Ezeket elfogadta a rendszer, de az AI figyelmen kívül hagyhatja őket. Ezeket jelezd a felhasználónak. Ha nincs ilyen, a mező kimarad.

`delete-design-guidelines`

Törli a fájl tervezési irányelveit. Ha nem létező irányelvet törölsz, a művelet nem csinál semmit. Bemenet

Paraméter	Típus	Leírás
`fileId`	`uuid`	Fájlazonosító

Kimenet — { "deleted": true }

Csevegési eszközök

`get-chat-history`

Lekéri a fájlhoz tartozó tervezési beszélgetést, vagyis a fájl Flowstep-csevegését, nem az MCP-kliensed beszélgetését. Használd a fájlon korábban végzett munka folytatásához. Bemenet

Paraméter	Típus	Leírás
`fileId`	`uuid`	Fájlazonosító

Kimenet — { messages }. A messages üres, ha nincs tervezési beszélgetésed a fájlon. Minden üzenetnek van type mezője ("request" vagy "response"), author mezője ("human" vagy "ai") és content_type mezője. A válaszüzenetek "text", "summary" vagy "followup" értéket használnak.

{
  "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" }]
    }
  ]
}

Melléklet-eszközök

`upload-attachment`

Referenciafájlt tölt fel melléklet-ként az ai-design-screens eszközhöz, vagy képet, amelyet a saját JSX-edbe illesztesz az add-screen-jsx vagy a replace-screen-jsx eszközzel. Az ai-generate-screen-variant és az ai-edit-screen-variant nem fogad mellékleteket. A fájl bájtjai nem haladnak át a modellen, és a szerver nem tölt le URL-eket a nevedben. Webes oldalra való hivatkozáshoz az URL-jét az ai-design-screens message mezőjébe írd. Két mód van. Mindig csak az egyiket használd, és ne kombináld őket. A mód: fájlok és képek (mimeType + fileName) Bármely kép, PDF vagy nagyobb szövegfájl esetén kötelező a háromlépéses folyamat:

Hívd meg az upload-attachment eszközt csak a mimeType és a fileName megadásával (például image/png és dog.png). A válasz egy előkészített feltöltés, nem tárolt fájl:

{
  "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": "…"
}

Cseréld le a LOCAL_FILE_PATH értéket az uploadCommand parancsban a fájlod abszolút elérési útjára, majd futtasd ezt a pontos parancsot a shellben. Ennek 0 kóddal kell kilépnie. A signedUrl tokenje csak erre az egyetlen feltöltésre ad jogosultságot. Ennek a lépésnek a kihagyása azt eredményezi, hogy a tárhely üres marad, és a tervezőeszköz az előellenőrzésnél elbukik.
Csak a { id, path, type } értékeket add át az ai-design-screens attachments tömbjének, a signedUrl, uploadCommand vagy nextStep értékeket ne. Ha ehelyett a saját JSX-edbe szeretnél képet tenni, az assetUrl értéket illeszd az add-screen-jsx vagy a replace-screen-jsx eszköznek átadott JSX img src vagy bg-[url(...)] attribútumába. Lásd: Képek a JSX-ben.

Távoli fájl csatolásához először töltsd le egy helyi elérési útra (például curl-lel), majd kövesd ugyanazt a három lépést. Soha ne adj át URL-t az upload-attachment eszköznek.

Paraméter	Típus	Leírás
`mimeType`	enum	A fájl MIME-típusa. Ezek egyike: `image/jpeg`, `image/png`, `image/webp`, `application/pdf`, `text/markdown`, `text/plain`, `text/javascript`. A `.jsx`, `.tsx`, `.js` és `.ts` fájlokhoz használd a `text/javascript` értéket
`fileName`	`string` (min. 1)	Az eredeti fájlnév kiterjesztéssel, például `cat.png` vagy `design.md`

B mód: rövid szöveg (text + mimeType) Olyan szöveg feltöltése, amely már a kontextusban van, shell-parancs nélkül. A válasz azonnal használható:

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

Paraméter	Típus	Leírás
`text`	`string` (legfeljebb 64 000 karakter)	Nyers szövegtartalom. Csak szöveges fájlokhoz. Képekhez vagy PDF-ekhez ne használd. Ha 64 000 karakternél hosszabb, használd az A módot
`mimeType`	enum	Ezek egyike: `text/markdown`, `text/plain`, `text/javascript`

Az eredményül kapott { id, path, type } értékeket add át az ai-design-screens attachments tömbjének. Mindkét módban a maximális fájlméret 3 MB, a PDF-ek pedig legfeljebb 100 oldalt tartalmazhatnak. Kimenet — { id, path, assetUrl, type, mimeType, signedUrl?, uploadCommand?, nextStep? }.

type: "image" képfájlok esetén, "document" PDF-ek és szöveges fájlok esetén.
assetUrl: a feltöltött fájl URL-je. Mindkét módban visszajön. JSX-ben csak az add-screen-jsx vagy a replace-screen-jsx eszközhöz használd, és csak akkor, ha a type értéke "image", valamint miután lefutott az A mód uploadCommand parancsa.
signedUrl, uploadCommand, nextStep: csak az A módban vannak beállítva. Ne add át ezeket a tervezőeszközöknek.

Figma-eszközök

`import-figma`

Importál egy Figma-keretet egy Flowstep-fájlba, szerkeszthető elemekként a vásznon. Minden import új képernyőt ad hozzá. Ha ugyanazt a keretet kétszer importálod, két képernyőd lesz. Ha le szeretnéd cserélni, előbb töröld a régit a delete-screen eszközzel. A fájl szervezetének csatlakoztatnia kell a Figmát a Flowstep-beállításokban. Bemenet

Paraméter	Típus	Leírás
`fileId`	`uuid`	A Flowstep-fájl, amelybe a keretet importálod. Nem a `figmaUrl`-ben szereplő Figma-fájlkulcs
`figmaUrl`	`string`	Egy konkrét Figma-keret hivatkozása `node-id` azonosítóval. A Figmában kattints jobb gombbal a keretre, és válaszd a Copy/Paste as → Copy link to selection lehetőséget. Egy oldal hivatkozása az oldal összes legfelső szintű keretét importálja (MCP-n keresztül legfeljebb 20 keret)

Kimenet — { fileId, screenId, frameCount? }. A screenId az importált képernyő. Add át a get-screen-image eszköznek az eredmény megtekintéséhez. Ha egy oldal-URL több keretet importál, a screenId értéke null, és helyette a frameCount érkezik. Ilyenkor hívd meg a list-screens eszközt, majd minden új képernyőhöz a get-screen-image eszközt.

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

Csomag- és számlázási eszközök

`get-plan-details`

Lekéri a szervezeted Flowstep-csomagját, előfizetési állapotát, használatát és hátralévő kvótáját. Nincs bemenete, a szervezetet a bejelentkezett felhasználóból határozza meg a rendszer. Az AI-tervezőeszközök hívása előtt ezzel ellenőrizheted a kvótádat. Kimenet — { plan, subscription, limits, usage, remaining }.

Mező	Leírás
`plan`	`{ name, code, type }`. A `type` értéke `"free"` vagy `"paid"`
`subscription`	`{ isPaid, isTrial, startDate, endDate, trialDaysRemaining }`
`limits`	Funkciónkénti korlátok, a funkció szerint kulcsolva (például `messages`). Mindegyikben van opcionális `daily` és `monthly` objektum `max` és `warn` értékekkel, valamint egy `unlimited` jelző
`usage`	Funkciónkénti eddigi használat, `{ daily, monthly }` formában
`remaining`	Funkciónkénti hátralévő kvóta, `{ daily, monthly }` formában. Korlátlan funkcióknál kimarad

A korlátok csomagonként eltérnek. Lásd: Árazás és Használati korlátok.

AI-tervezőeszközök

Ez a három eszköz leírásból vagy előbeállításból tervez. Soha nem fogad el vagy használ fel újra JSX-et. Minden hívás ugyanabból az üzenetkvótából használ, mint a Flowstep-alkalmazás, és addig blokkol, amíg a generálás be nem fejeződik, vagy időtúllépés nem történik (180 másodperc).

Eszköz	Mire használd
`ai-design-screens`	Új képernyők generálása, meglévők helyben módosítása, vagy mindkettő, szabad formájú leírásból
`ai-generate-screen-variant`	Egy meglévő képernyő következő lépésének, hiba- vagy üres állapotának vagy platformváltozatának hozzáadása
`ai-edit-screen-variant`	Szerkesztési vagy újratervezési előbeállítás alkalmazása egy meglévő, teljes képernyőre

Mindhárom eszköz { status, fileId, screenIds, designGuidelinesUpdated } értéket ad vissza. Az eredmény megtekintéséhez minden screenId-hez egyszer hívd meg a get-screen-image eszközt.

designGuidelinesUpdated: rövid összefoglaló a változásról, ha a fájl DESIGN.md irányelveit az adott körben automatikusan frissítették. Ellenkező esetben null.

`ai-design-screens`

Egy vagy több új képernyőt generál, meglévő képernyőket módosít helyben, vagy mindkettőt egy hívásban, szöveges leírásból. Ide tartoznak az új folyamatok, a témázás, a szövegek, az elrendezés és több képernyőre kiterjedő, összehangolt változtatások. Ez ugyanaz a tervezőügynök, mint a Flowstep-szerkesztő csevegésében: a message és az elementIds alapján dönti el, mit építsen és mit módosítson. Hagyd ki a fileId mezőt új fájl kezdéséhez. Add meg a fileId mezőt, ha egy meglévő fájlban szeretnél dolgozni. Ha a kérés egy már meglévő fájlra is vonatkozhat, az ügynöknek előbb ellenőriznie kell a list-files és a list-screens eszközökkel. Egy képernyő következő lépéséhez, hiba- vagy üres állapotához vagy platformváltozatához használd az ai-generate-screen-variant eszközt. Egy képernyő előbeállításos szerkesztéséhez vagy újratervezéséhez használd az ai-edit-screen-variant eszközt. Ha már van JSX-ed, helyette az add-screen-jsx vagy a replace-screen-jsx eszközt használd. Bemenet

Paraméter	Típus	Alapértelmezett	Leírás
`fileId`	`uuid`	—	A célfájl. Ha kihagyod, új fájl jön létre. Kötelező, ha az `elementIds` be van állítva
`message`	`string`	—	A generálandó képernyők és/vagy a végrehajtandó módosítások leírása. Ha `elementIds` értéket adsz meg, jelezd, hogy szerkeszteni akarod-e őket, vagy csak referenciaként használod. Ide írd bele azokat a webes URL-eket is, amelyekre hivatkozni szeretnél
`elementIds`	`uuid[]`	`[]`	Opcionális `screenId` értékek a `list-screens` eszköztől és/vagy elem-`data-id` értékek a `get-screen-jsx` eszköztől (`includeIds` megadásával), mint a kijelölés a szerkesztőben. Helyben szerkeszthetők, vagy vizuális referenciaként használhatók új képernyőkhöz. A `screenId` az egész képernyőt célozza
`attachments`	`{ id, path, type }[]` (legfeljebb 5)	`[]`	Az `upload-attachment` eszköztől kapott fájlok: képek, PDF-ek, kód- vagy szövegfájlok. Ne írd a fájl tartalmát közvetlenül az üzenetbe

Példa: egy képernyő szerkesztése és egy másik hozzáadása egyetlen hívásban:

{
  "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"]
}

Kimenet — { 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: "generated", ha képernyők készültek vagy változtak. "chat", ha a Flowstep építés nélkül válaszolt. Ebben az esetben a reply tartalmazza a választ, a screenIds pedig üres. Ha a kérésed nem egyértelmű, az ügynöknek kérdéssel kell tisztáznia azt, és újra kell hívnia az eszközt.
screenIds: minden olyan képernyő, amelyet a hívás során építettek vagy módosítottak, beleértve a helyben szerkesztetteket is. Ha a hívás néhány képernyő elkészülte után időtúllépést szenved, ezeket a képernyőket adja vissza hiba helyett.

A szerkesztésre kért képernyők helyben felülíródnak.

`ai-generate-screen-variant`

Új képernyőt ad hozzá, amely pontosan egy meglévő képernyőből származik: a folyamat következő lépése, egy hiba- vagy üres állapot, vagy egy másik platformra készült változat. Az eredeti képernyő nem változik. Ha olyan képernyőt szeretnél hozzáadni, amely nem egy meglévő változata (például egy beállítási képernyő), használd az ai-design-screens eszközt a fileId megadásával. Bemenet

Paraméter	Típus	Leírás
`fileId`	`uuid`	Célfájl
`screenId`	`uuid`	A meglévő képernyő, amelyből származtatni szeretnél
`operationVariant`	enum	Kötelező: az új képernyő és a meglévő kapcsolata

`operationVariant`	Hozzáad
`next_screen`	A felhasználói folyamat következő képernyőjét
`error_state`	A képernyő egy hibaállapotát
`empty_state`	A képernyő egy üres állapotát
`web_version`	Egy webes változatot
`mobile_version`	Egy mobil változatot
`tablet_version`	Egy tablet-változatot
`mobile_ios_version`	Egy iOS-változatot
`mobile_android_version`	Egy Android-változatot

Kimenet — { status, fileId, screenIds, designGuidelinesUpdated }. A status értéke mindig "generated".

`ai-edit-screen-variant`

Pontosan egy meglévő képernyőt módosít helyben egy előbeállítás segítségével: témázza vagy csiszolja, más elrendezést vagy vizuális stílust próbál ki, vagy teljesen újratervezi. Új képernyőkhöz, szabad formájú utasításokhoz vagy egyes elemek pontos szerkesztéséhez használd az ai-design-screens eszközt. Bemenet

Paraméter	Típus	Leírás
`fileId`	`uuid`	Célfájl
`screenId`	`uuid`	A módosítandó meglévő képernyő
`operationVariant`	enum	Kötelező: az alkalmazandó szerkesztési vagy újratervezési előbeállítás

`operationVariant`	Típus	Hatás
`dark_theme`	Szerkesztés	A képernyő sötét témára váltása
`light_theme`	Szerkesztés	A képernyő világos témára váltása
`make_pretty`	Szerkesztés	A képernyő vizuális kidolgozása
`different_layout`	Újratervezés	Másik elrendezés kipróbálása
`different_style`	Újratervezés	Másik vizuális stílus kipróbálása
`from_scratch`	Újratervezés	A képernyő újratervezése a nulláról

Kimenet — { status, fileId, screenIds, designGuidelinesUpdated }. A status értéke mindig "generated".

Ez a képernyő tartalmát helyben írja felül.

Átnevezett eszközök

Az eszköznevek 2026 szeptemberében és októberében változtak. Ha olyan promptjaid, szkriptjeid vagy ügynök-utasításaid vannak, amelyek a régi neveket használják, frissítsd őket:

Régi név	Új név
`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` (szabad formájú utasításokkal)	`ai-design-screens`
`edit-design` (`operationVariant` előbeállítással)	`ai-edit-screen-variant`
`regenerate-design`	`ai-edit-screen-variant`
`expand-design`	`ai-generate-screen-variant`

A bemenetek is változtak: az AI-tervezőeszközök a targets helyett elementIds mezőt fogadnak el (a variánseszközök pedig egyetlen screenId-t), az add-screen-jsx a jsxContent helyett külön metaadatmezőkkel és jsx mezővel dolgozik, a create-file a title helyett name mezőt vár, a tervezési irányelvek eszközei pedig a resourceId és linkedTo helyett fileId mezőt.

​Fájleszközök

​list-files

​get-file

​create-file

​update-file

​delete-file

​Képernyő-eszközök

​list-screens

​get-screen-image

​get-screen-jsx

​add-screen-jsx

​replace-screen-jsx

​rename-screen

​delete-screen

​Képek a JSX-ben

​Képernyőmezők értékei

​Tervezési irányelvek eszközei

​get-design-guidelines

​update-design-guidelines

​delete-design-guidelines

​Csevegési eszközök

​get-chat-history

​Melléklet-eszközök

​upload-attachment

​Figma-eszközök

​import-figma

​Csomag- és számlázási eszközök

​get-plan-details

​AI-tervezőeszközök

​ai-design-screens

​ai-generate-screen-variant

​ai-edit-screen-variant

​Átnevezett eszközök

Fájleszközök

`list-files`

`get-file`

`create-file`

`update-file`

`delete-file`

Képernyő-eszközök

`list-screens`

`get-screen-image`

`get-screen-jsx`

`add-screen-jsx`

`replace-screen-jsx`

`rename-screen`

`delete-screen`

Képek a JSX-ben

Képernyőmezők értékei

Tervezési irányelvek eszközei

`get-design-guidelines`

`update-design-guidelines`

`delete-design-guidelines`

Csevegési eszközök

`get-chat-history`

Melléklet-eszközök

`upload-attachment`

Figma-eszközök

`import-figma`

Csomag- és számlázási eszközök

`get-plan-details`

AI-tervezőeszközök

`ai-design-screens`

`ai-generate-screen-variant`

`ai-edit-screen-variant`

Átnevezett eszközök