MCP rīku atsauce

Veiksmīgas izpildes gadījumā katrs rīks, izņemot get-screen-image, atgriež rezultātu divreiz: kā structuredContent (pārbaudīts pret rīka publicēto izvades shēmu) un kā to pašu objektu, serializētu teksta blokā { type: "text", text: "<json-string>" }, klientiem, kas nelasa strukturētu saturu. get-screen-image atgriež tikai MCP attēla bloku: { type: "image", data: "<base64>", mimeType: "image/png" }. Kļūdas gadījumā tiek iestatīts isError: true, un teksta blokā ir īss kļūdas ziņojums. Kļūdas, ko varat novērst (nesakritība dzēšanas laikā, nederīga Figma saite, nederīgas dizaina vadlīnijas, pielikuma problēma vai ģenerēšanas noilgums), paskaidro, kas jālabo. Citas kļūdas atgriež vispārīgu ziņojumu, piemēram, Failed to list files.

Cenas: trīs AI dizaina rīki — ai-design-screens, ai-generate-screen-variant un ai-edit-screen-variant — izmanto to pašu ziņojumu limitu, kas paredzēts Flowstep lietotnei. Visi pārējie rīki ir bez maksas. Skatiet Lietošanas limiti.

Katrs rīks publicē arī MCP anotācijas, lai jūsu klients zinātu, ko tas dara. delete-file, delete-screen, delete-design-guidelines, replace-screen-jsx, ai-design-screens un ai-edit-screen-variant ir atzīmēti kā destruktīvi, jo tie noņem vai pārraksta esošu saturu.

Failu rīki

`list-files`

Uzskaitiet savus Flowstep failus ar metadatiem. Vispirms izsauciet šo rīku, lai pārbaudītu, vai atbilstošs fails jau pastāv. Tas neatgriež ekrānu saturu. Tam izmantojiet get-screen-image vai get-screen-jsx. Ievade

Parametrs	Tips	Noklusējums	Apraksts
`orderByCreation`	`boolean`	`true`	Kārtot jaunākos pirmos pēc `created_at` (`true`) vai pēc `updated_at` (`false`). Izmantojiet `false`, lai atrastu nesen rediģētus failus
`limit`	`integer` (1–100)	`20`	Maksimālais atgriežamo failu skaits. Pilna lapa var nozīmēt, ka ir vairāk failu
`offset`	`integer` (≥0)	`0`	Izlaižamo failu skaits. Nākamā lapa ir `offset + limit`

Izvade: { 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, ja fails ir jūsu izveidots.
shared_with_me: true, ja fails jums ir kopīgots tieši, nevis tikai caur organizāciju.
url: atver failu Flowstep redaktorā.

`get-file`

Iegūstiet viena faila metadatus. Faila saturs tīši nav iekļauts. Lai apskatītu ekrānus, izmantojiet get-screen-image vai get-screen-jsx, un lai iegūtu pievienotās vadlīnijas, izmantojiet get-design-guidelines. Ja jums ir gaidošs uzaicinājums uz failu, get-file izsaukums to pieņem. Ievade

Parametrs	Tips	Apraksts
`id`	`uuid`	Faila ID

Izvade: { 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 vai write.
visibility: private, member vai public.
user_access_level: jūsu piekļuve failam, read vai write.

`create-file`

Izveidojiet tukšu Flowstep failu bez ekrāniem. Lai izveidotu failu un vienā solī ģenerētu ekrānus, izsauciet ai-design-screens bez fileId. Izmantojiet create-file darbplūsmām, kas balstās uz pirmkodu, un pēc tam add-screen-jsx. Ievade

Parametrs	Tips	Apraksts
`name`	`string` (min 1)	Jaunā faila parādāmais nosaukums

Izvade: { file, user_access_level }, tādā pašā struktūrā kā get-file. owner vienmēr ir true, un user_access_level vienmēr ir write. Izmantojiet atgriezto file.id kā fileId turpmākajos rīku izsaukumos.

`update-file`

Pārdēvējiet failu. Ievade

Parametrs	Tips	Apraksts
`id`	`uuid`	Faila ID
`name`	`string` (min 1)	Jaunais parādāmais nosaukums

Izvade: { file, user_access_level }, tādā pašā struktūrā kā get-file.

`delete-file`

Neatgriezeniski dzēsiet failu. Nodotais name tiek salīdzināts ar faila pašreizējo parādāmo nosaukumu pirms dzēšanas. Ja tas nesakrīt, dzēšana tiek pārtraukta. Tas novērš nejaušu nepareizā faila dzēšanu. Aģenti tiek instruēti vispirms apstiprināt ar jums. Ievade

Parametrs	Tips	Apraksts
`id`	`uuid`	Faila ID
`name`	`string`	Faila pašreizējais parādāmais nosaukums. Jāsakrīt, citādi dzēšana tiek pārtraukta

Izvade: { "deleted": true }

Šo darbību nevar atsaukt. Visi faila ekrāni tiek dzēsti.

Ekrānu rīki

`list-screens`

Uzskaitiet faila ekrānus audekla secībā. Izsauciet to pēc list-files, lai redzētu, kas jau ir failā. Izmantojiet atgrieztās screenId vērtības ar pārējiem ekrānu rīkiem un AI dizaina rīkiem. Ievade

Parametrs	Tips	Apraksts
`fileId`	`uuid`	Faila ID

Izvade: { 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: pēdējā ekrāna ģenerēšanas uzvedne vai tukša virkne, ja ekrāns nekad nav ģenerēts (piemēram, ekrāns, kas pievienots ar add-screen-jsx).
fidelity: lofi, hifi vai ui.

`get-screen-image`

Renderējiet ekrānu PNG formātā un atgriezniet to kā iekļautu attēlu. Nepieciešams klients, kas atbalsta attēlu satura blokus. Izsauciet to vienreiz katram screenId, ko atgriezis AI dizaina rīks, add-screen-jsx, replace-screen-jsx vai import-figma. Ievade

Parametrs	Tips	Apraksts
`fileId`	`uuid`	Faila ID
`screenId`	`uuid`	`screenId` no `list-screens` vai no `screenIds` masīva, ko atgriezis dizaina rīks

Izvade: MCP attēla satura bloks (image/png). data ir standarta base64 PNG baitiem, nevis data URI. Šim rīkam nav structuredContent.

`get-screen-jsx`

Iegūstiet ekrānu kā JSX un tā metadatus, lai veidotu no tā savā kodu bāzē vai rediģētu un nosūtītu atpakaļ ar replace-screen-jsx. Vizuālam priekšskatījumam izmantojiet get-screen-image. Ievade

Parametrs	Tips	Noklusējums	Apraksts
`fileId`	`uuid`	—	Faila ID
`screenId`	`uuid`	—	`screenId` no `list-screens` vai no `screenIds` masīva, ko atgriezis dizaina rīks
`includeIds`	`boolean`	`false`	Iekļaut `data-id` atribūtu elementiem `jsx`. Izmantojiet to, kad vajadzīgi elementu ID, ko nodot kā `elementIds` uz `ai-design-screens`, vai nu lai rediģētu vietā, vai kā vizuālu atsauci

Izvade: { 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: tikai marķējums. data-id atribūti tiek iekļauti tikai tad, ja includeIds ir true.
prompt: pēdējā ģenerēšanas uzvedne vai tukša virkne, ja ekrāns nekad nav ģenerēts.
fragments: kopīgs ekrānā saglabāts “chrome”, piemēram, navigācijas josla, galvene vai logotips, kā { purpose, markup } objekti. Ja nav neviena, tukšs. Nododiet tos atpakaļ replace-screen-jsx, lai tos saglabātu vai atjauninātu.

Skatiet Ekrāna lauku vērtības par fidelity, screenType un colorTheme vērtībām.

`add-screen-jsx`

Pievienojiet failam jaunu ekrānu no JSX, ko esat uzrakstījis. Šis ir ceļš, kas balstās uz pirmkodu, un tas ir bez maksas. Izmantojiet ai-design-screens, ja vēlaties, lai Flowstep AI izstrādā ekrānu. add-screen-jsx vienmēr izveido jaunu ekrānu. Lai pārrakstītu esošu, izmantojiet replace-screen-jsx. Lai parādītu jūsu augšupielādētu attēlu, skatiet Attēli JSX. Ja jaunais ekrāns ir balstīts uz esošu, sāciet no get-screen-jsx (bez includeIds) laukiem name, fidelity, screenType, colorTheme un jsx, pēc tam mainiet to, kas jāatšķiras. Ievade

Parametrs	Tips	Noklusējums	Apraksts
`fileId`	`uuid`	—	Faila ID
`name`	`string` (1–100 rakstzīmes)	—	Neobligāts parādāmais nosaukums. Izlaidiet, lai ekrānu automātiski nosauktu `Screen N`
`fidelity`	`string`	`"ui"`	Ekrāna precizitāte
`screenType`	`string`	—	Obligāts: ierīce vai skata logs, kuram ekrāns ir paredzēts
`colorTheme`	`string`	`"default"`	Krāsu motīvs
`jsx`	`string`	—	Tikai JSX marķējums. Visi `data-id` atribūti tiek ignorēti, un jaunajam ekrānam tiek piešķirti jauni elementu ID

Izvade: { fileId, screenId }. Izsauciet get-screen-image ar screenId, lai apskatītu rezultātu.

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

`replace-screen-jsx`

Pārrakstiet esošu ekrānu ar JSX, ko esat uzrakstījis. Ekrāns saglabā savu screenId un pozīciju audeklā, un iekļautajiem elementiem tiek piešķirti jauni ID. Šis ir ceļš, kas balstās uz pirmkodu, un tas ir bez maksas. AI izmaiņām izmantojiet ai-design-screens vai ai-edit-screen-variant, bet, lai tā vietā izveidotu jaunu ekrānu, izmantojiet add-screen-jsx. Sāciet no get-screen-jsx (bez includeIds), pēc tam mainiet to, kas jāatšķiras. Lai parādītu jūsu augšupielādētu attēlu, skatiet Attēli JSX. Ievade

Parametrs	Tips	Apraksts
`fileId`	`uuid`	Faila ID
`screenId`	`uuid`	Ekrāns, ko pārrakstīt
`jsx`	`string`	Tikai JSX marķējums. Visi `data-id` atribūti tiek ignorēti
`name`	`string` (1–100 rakstzīmes)	Neobligāts. Izlaidiet, lai saglabātu pašreizējo nosaukumu
`fidelity`	`string`	Neobligāts. Izlaidiet, lai saglabātu pašreizējo precizitāti
`screenType`	`string`	Neobligāts. Izlaidiet, lai saglabātu pašreizējo ekrāna tipu
`colorTheme`	`string`	Neobligāts. Izlaidiet, lai saglabātu pašreizējo krāsu motīvu
`fragments`	`{ purpose, markup }[]`	Neobligāts kopīgs “chrome” no `get-screen-jsx`. Izlaidiet, lai saglabātu pašreizējos fragmentus, vai nododiet `[]`, lai tos notīrītu

Izvade: { fileId, screenId }. Izsauciet get-screen-image ar screenId, lai apskatītu rezultātu.

Šis aizstāj ekrāna saturu vietā.

`rename-screen`

Pārdēvējiet ekrāna audekla etiķeti, tas ir, nosaukumu, ko rāda list-screens un redaktorā. Tas maina tikai etiķeti, nevis ekrāna izkārtojumu, izmēru vai saturu. Tiem izmantojiet ai-design-screens. Ievade

Parametrs	Tips	Apraksts
`fileId`	`uuid`	Faila ID
`screenId`	`uuid`	`screenId`, ko atgriezis `list-screens`
`name`	`string` (1–100 rakstzīmes)	Jaunais ekrāna nosaukums. Vadošās un beigu atstarpes tiek apgrieztas

Izvade: { screenId, name }.

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

`delete-screen`

Neatgriezeniski dzēsiet ekrānu no faila. Nodotais name tiek salīdzināts ar ekrāna pašreizējo parādāmo nosaukumu. Ja tas nesakrīt, dzēšana tiek pārtraukta. Aģenti tiek instruēti vispirms apstiprināt ar jums. Ievade

Parametrs	Tips	Apraksts
`fileId`	`uuid`	Faila ID
`screenId`	`uuid`	Ekrāns, ko dzēst
`name`	`string`	Ekrāna pašreizējais parādāmais nosaukums. Jāsakrīt, citādi dzēšana tiek pārtraukta

Izvade: { "deleted": true }

Attēli JSX

add-screen-jsx un replace-screen-jsx pieņem attēlus img src atribūtā vai kā fonu className ar bg-[url(...)]. Uzrakstiet alt tekstu un pielāgojiet katra attēla izmēru tā mērķim. Lai ievietotu savu attēlu:

Augšupielādējiet to ar upload-attachment A režīmā (mimeType + fileName) un izpildiet atgriezto uploadCommand.
Ja atbildes type ir "image", ievietojiet tās assetUrl tieši tā, kā tas atgriezts, img src vai bg-[url(assetUrl)].

Visus citus attēlu URL atstājiet tieši tādus, kādus atgrieza get-screen-jsx. Nelieciet path, signedUrl vai uploadCommand src.

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

Ekrāna lauku vērtības

get-screen-jsx atgriež, un add-screen-jsx un replace-screen-jsx pieņem šīs vērtības:

Lauks	Vērtības
`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`

Dizaina vadlīniju rīki

Dizaina vadlīnijas ir DESIGN.md teksts, kas saglabāts failā. Kad tās ir iestatītas, tās tiek ievadītas katrā šī faila AI ģenerācijā. Skatiet Dizaina vadlīnijas.

`get-design-guidelines`

Iegūstiet dizaina vadlīnijas, kas pievienotas failam. Ievade

Parametrs	Tips	Apraksts
`fileId`	`uuid`	Faila ID

Izvade: { guidelines }.

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

guidelines ir null, ja vadlīnijas nav iestatītas.

`update-design-guidelines`

Iestatiet vai aizstājiet faila dizaina vadlīnijas. Nododiet vadlīnijas kā vienkāršu virkni Google DESIGN.md formātā, nevis kā objektu vai JSON. Ja lasāt no faila, nododiet šī faila tekstu. Ievade

Parametrs	Tips	Apraksts
`fileId`	`uuid`	Faila ID
`designGuidelines`	`string` (min 1)	Vadlīniju neapstrādātais teksts. Jābūt vienkāršai virknei, nevis JSON kodētai

Validācijas noteikumi

Priekšvārds (frontmatter) jāatver un jāaizver pareizi
Priekšvārda rindām jābūt derīgam YAML ar bloku stilu
Markdown saturā nedrīkst būt dublēti ## sadaļu virsraksti

Ja validācija neizdodas, izsaukums atgriež kļūdu, kas sākas ar Invalid design guidelines:. Izvade: { updated, warnings? }.

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

warnings uzskaita mīkstās validācijas problēmas (nezināmas atslēgas, krāsas, kas nav heksadecimālas), kas tika pieņemtas, bet AI tās var ignorēt. Lauks netiek iekļauts, ja problēmu nav. Parādiet šos brīdinājumus lietotājam.

`delete-design-guidelines`

Notīriet faila dizaina vadlīnijas. Tādu vadlīniju dzēšana, kas neeksistē, nedara neko. Ievade

Parametrs	Tips	Apraksts
`fileId`	`uuid`	Faila ID

Izvade: { "deleted": true }

Tērzēšanas rīki

`get-chat-history`

Iegūstiet dizaina sarunu, kas saistīta ar failu. Tā ir faila Flowstep tērzēšana, nevis jūsu MCP klienta saruna. Izmantojiet to, lai turpinātu iepriekšējo darbu pie faila. Ievade

Parametrs	Tips	Apraksts
`fileId`	`uuid`	Faila ID

Izvade: { messages }. messages ir tukšs, ja jums šajā failā nav dizaina sarunas. Katram ziņojumam ir type ("request" vai "response"), author ("human" vai "ai") un content_type. Atbilžu ziņojumos izmanto "text", "summary" vai "followup".

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

Pielikumu rīki

`upload-attachment`

Augšupielādējiet atsauces failu, ko izmantot kā pielikumu ai-design-screens, vai attēlu, ko ievietot savā JSX ar add-screen-jsx vai replace-screen-jsx. ai-generate-screen-variant un ai-edit-screen-variant pielikumus nepieņem. Failu baiti nekad neiziet cauri modelim, un serveris nekad neielādē URL jūsu vietā. Lai atsauktos uz tīmekļa lapu, iekļaujiet tās URL ai-design-screens message. Ir divi režīmi. Izmantojiet tieši vienu un nekombinējiet tos. A režīms — faili un attēli (mimeType + fileName) Obligāta trīs soļu plūsma jebkuram attēlam, PDF vai lielākam teksta failam:

Izsauciet upload-attachment tikai ar mimeType un fileName (piemēram, image/png un dog.png). Atbilde ir sagatavota augšupielāde, nevis saglabāts fails:

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

Aizstājiet LOCAL_FILE_PATH uploadCommand ar absolūto ceļu uz savu failu un izpildiet šo precīzo komandu savā terminālī. Tai jāatgriež 0. signedUrl pilnvara autorizē tikai šo vienu augšupielādi. Ja šo soli izlaižat, krātuve paliek tukša un dizaina rīka priekšpārbaude neizdodas.
Nododiet tikai { id, path, type } ai-design-screens attachments masīvā, nevis signedUrl, uploadCommand vai nextStep. Lai tā vietā ievietotu attēlu savā JSX, ievietojiet assetUrl JSX, ko nododat add-screen-jsx vai replace-screen-jsx, img src vai bg-[url(...)]. Skatiet Attēli JSX.

Lai pievienotu attālu failu, vispirms lejupielādējiet to lokālā ceļā (piemēram, ar curl) un pēc tam izpildiet tos pašus trīs soļus. Nekad nenododiet URL upload-attachment.

Parametrs	Tips	Apraksts
`mimeType`	enum	Faila MIME tips. Viens no: `image/jpeg`, `image/png`, `image/webp`, `application/pdf`, `text/markdown`, `text/plain`, `text/javascript`. Izmantojiet `text/javascript` failiem `.jsx`, `.tsx`, `.js` un `.ts`
`fileName`	`string` (min 1)	Sākotnējais faila nosaukums ar paplašinājumu, piemēram, `cat.png` vai `design.md`

B režīms — īss teksts (text + mimeType) Augšupielādējiet tekstu, kas jau ir kontekstā. Čaulas komanda nav vajadzīga. Atbilde ir tieši lietojama:

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

Parametrs	Tips	Apraksts
`text`	`string` (maks. 64 000 rakstzīmes)	Neapstrādāts teksta saturs. Tikai teksta failiem. Neizmantojiet attēliem vai PDF. Ja teksts ir garāks par 64 000 rakstzīmēm, izmantojiet A režīmu
`mimeType`	enum	Viens no: `text/markdown`, `text/plain`, `text/javascript`

Nododiet iegūto { id, path, type } ai-design-screens attachments masīvā. Maksimālais faila izmērs ir 3 MB abos režīmos, un PDF ir ierobežoti līdz 100 lappusēm. Izvade: { id, path, assetUrl, type, mimeType, signedUrl?, uploadCommand?, nextStep? }.

type: "image" attēlu failiem un "document" PDF un teksta failiem.
assetUrl: augšupielādētā faila URL, kas tiek atgriezts abos režīmos. Lietojiet to JSX add-screen-jsx vai replace-screen-jsx tikai tad, ja type ir "image" un pēc tam, kad ir izpildīta A režīma uploadCommand.
signedUrl, uploadCommand, nextStep: iestatīti tikai A režīmā. Nenododiet tos dizaina rīkiem.

Figma rīki

`import-figma`

Importējiet Figma rāmi Flowstep failā kā rediģējamus elementus tā audeklā. Katrs imports pievieno jaunu ekrānu. Ja importējat to pašu rāmi divreiz, iegūsiet divus ekrānus, tāpēc, ja vēlējāties to aizstāt, izdzēsiet veco ar delete-screen. Faila organizācijai Flowstep iestatījumos jābūt savienotai ar Figma. Ievade

Parametrs	Tips	Apraksts
`fileId`	`uuid`	Flowstep fails, kurā importēt rāmi. Tas nav Figma faila atslēga `figmaUrl`
`figmaUrl`	`string`	Saite uz konkrētu Figma rāmi ar `node-id`. Figma ar peles labo pogu noklikšķiniet uz rāmja un izvēlieties Copy/Paste as → Copy link to selection. Lapas saite importē visus augstākā līmeņa rāmjus šajā lapā (MCP ierobežojums: 20 rāmji)

Izvade: { fileId, screenId, frameCount? }. screenId ir importētais ekrāns. Nododiet to get-screen-image, lai apskatītu rezultātu. Kad lapas URL importē vairākus rāmjus, screenId ir null, un tā vietā tiek atgriezts frameCount. Izsauciet list-screens un pēc tam get-screen-image katram jaunajam ekrānam.

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

Plāna un norēķinu rīki

`get-plan-details`

Iegūstiet savas organizācijas Flowstep plānu, abonementa statusu, lietojumu un atlikušo kvotu. Ievades nav. Organizācija tiek noteikta no pierakstītā lietotāja. Izmantojiet to, lai pārbaudītu savu limitu, pirms izsaucat AI dizaina rīkus. Izvade: { plan, subscription, limits, usage, remaining }.

Lauks	Apraksts
`plan`	`{ name, code, type }`. `type` ir `"free"` vai `"paid"`
`subscription`	`{ isPaid, isTrial, startDate, endDate, trialDaysRemaining }`
`limits`	Katras funkcijas limiti, pēc funkcijas (piemēram, `messages`). Katram ir neobligāti `daily` un `monthly` objekti ar `max` un `warn` vērtībām, kā arī `unlimited` karodziņš
`usage`	Katras funkcijas lietojums līdz šim, kā `{ daily, monthly }`
`remaining`	Katras funkcijas atlikusī kvota, kā `{ daily, monthly }`. Neierobežotām funkcijām izlaists

Limiti atšķiras atkarībā no plāna. Skatiet Cenas un Lietošanas limiti.

AI dizaina rīki

Šie trīs rīki veido dizainu pēc apraksta vai priekšiestatījuma. Tie nekad nepieņem un nepārizmanto JSX. Katrs izsaukums izmanto to pašu ziņojumu limitu, kas paredzēts Flowstep lietotnei, un bloķējas, līdz ģenerēšana pabeidzas vai noilgst (180 sekundes).

Rīks	Izmantojiet to, lai
`ai-design-screens`	Ģenerētu jaunus ekrānus, mainītu esošus ekrānus vietā vai abus, pēc brīva apraksta
`ai-generate-screen-variant`	Pievienotu vienam esošam ekrānam nākamo soli, kļūdas vai tukša stāvokļa vai platformas variantu
`ai-edit-screen-variant`	Pielietotu rediģēšanas vai pārprojektēšanas priekšiestatījumu vienam veselam esošam ekrānam

Visi trīs atgriež { status, fileId, screenIds, designGuidelinesUpdated }. Izsauciet get-screen-image vienreiz katram screenId, lai apskatītu rezultātu.

designGuidelinesUpdated: īss izmaiņu kopsavilkums, ja faila DESIGN.md vadlīnijas šī pagrieziena laikā tika automātiski atjauninātas. Citādi null.

`ai-design-screens`

Ģenerējiet vienu vai vairākus jaunus ekrānus, mainiet esošus ekrānus vietā vai abus vienā izsaukumā pēc teksta apraksta: jaunas plūsmas, motīvus, tekstu, izkārtojumu vai koordinētas izmaiņas vairākos ekrānos. Šis ir tas pats dizaina aģents, kas ir tērzēšana Flowstep redaktorā: no jūsu message un elementIds tas izlemj, ko veidot un ko mainīt. Izlaidiet fileId, lai sāktu jaunu failu. Nododiet fileId, lai strādātu esošā failā. Ja pieprasījums varētu attiekties uz jau esošu failu, jūsu aģentam vispirms jāpārbauda list-files un list-screens. Ja vēlaties variantu vienam ekrānam (nākamo soli, kļūdas vai tukša stāvokļa ekrānu vai platformas versiju), izmantojiet ai-generate-screen-variant. Preseta rediģēšanai vai pārprojektēšanai vienam ekrānam izmantojiet ai-edit-screen-variant. Ja jums jau ir JSX, izmantojiet add-screen-jsx vai replace-screen-jsx. Ievade

Parametrs	Tips	Noklusējums	Apraksts
`fileId`	`uuid`	—	Mērķa fails. Izlaidiet, lai izveidotu jaunu failu. Nepieciešams, ja iestatīts `elementIds`
`message`	`string`	—	Ģenerējamo ekrānu un/vai veicamo izmaiņu apraksts. Ja nododat `elementIds`, norādiet, vai tos rediģēt vai izmantot kā atsauci. Iekļaujiet šeit visas tīmekļa lapu URL, uz kurām vēlaties, lai Flowstep atsaucas
`elementIds`	`uuid[]`	`[]`	Neobligāti `screenId` no `list-screens` un/vai elementu `data-id` no `get-screen-jsx` (ar `includeIds`), līdzīgi kā atlasei redaktorā. Tos var rediģēt vietā vai izmantot kā vizuālu atsauci jauniem ekrāniem. `screenId` mērķē uz visu ekrānu
`attachments`	`{ id, path, type }[]` (maks. 5)	`[]`	Faili no `upload-attachment`: attēli, PDF vai koda un teksta faili. Neiekļaujiet failu saturu ziņojumā tieši

Piemērs: rediģējiet vienu ekrānu un pievienojiet citu vienā izsaukumā:

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

Izvade: { 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", kad ekrāni ir izveidoti vai mainīti. "chat", kad Flowstep atbildēja, neko neveidojot. Tādā gadījumā reply satur tā atbildi, un screenIds ir tukšs. Ja jūsu uzdevums ir neskaidrs, jūsu aģentam jālūdz jums precizēt un jāizsauc rīks atkārtoti.
screenIds: katrs ekrāns, kas izveidots vai mainīts izsaukuma laikā, ieskaitot ekrānus, kas rediģēti vietā. Ja izsaukums noilgst pēc tam, kad daži ekrāni ir izveidoti, tas atgriež šos ekrānus kļūdas vietā.

Ekrāni, ko lūdzat tam rediģēt, tiek pārrakstīti vietā.

`ai-generate-screen-variant`

Pievienojiet jaunu ekrānu, kas iegūts tieši no viena esoša ekrāna: nākamais solis plūsmā, kļūdas vai tukša stāvokļa ekrāns vai versija citai platformai. Sākotnējais ekrāns paliek nemainīts. Lai pievienotu ekrānu, kas nav esoša ekrāna variants (piemēram, iestatījumu ekrānu), izmantojiet ai-design-screens ar fileId. Ievade

Parametrs	Tips	Apraksts
`fileId`	`uuid`	Mērķa fails
`screenId`	`uuid`	Esošais ekrāns, no kura veidot
`operationVariant`	enum	Obligāts: kā jaunais ekrāns attiecas uz esošo

`operationVariant`	Pievieno
`next_screen`	Nākamo ekrānu lietotāja plūsmā
`error_state`	Ekrāna kļūdas stāvokli
`empty_state`	Ekrāna tukšo stāvokli
`web_version`	Tīmekļa versiju
`mobile_version`	Mobilo versiju
`tablet_version`	Planšetdatora versiju
`mobile_ios_version`	iOS versiju
`mobile_android_version`	Android versiju

Izvade: { status, fileId, screenIds, designGuidelinesUpdated }. status vienmēr ir "generated".

`ai-edit-screen-variant`

Mainiet tieši vienu esošu ekrānu vietā, izmantojot priekšiestatījumu. Varat uzlabot vai pielāgot tā motīvu, izmēģināt citu izkārtojumu vai vizuālo stilu, vai pārprojektēt to no jauna. Brīviem norādījumiem vai precīzai izmaiņai atsevišķos elementos izmantojiet ai-design-screens. Ievade

Parametrs	Tips	Apraksts
`fileId`	`uuid`	Mērķa fails
`screenId`	`uuid`	Esošais ekrāns, ko mainīt
`operationVariant`	enum	Obligāts: rediģēšanas vai pārprojektēšanas priekšiestatījums, ko pielietot

`operationVariant`	Veids	Efekts
`dark_theme`	Rediģēšana	Pārslēgt ekrānu uz tumšu motīvu
`light_theme`	Rediģēšana	Pārslēgt ekrānu uz gaišu motīvu
`make_pretty`	Rediģēšana	Uzlabot ekrāna vizuālo dizainu
`different_layout`	Pārprojektēšana	Izmēģināt citu izkārtojumu
`different_style`	Pārprojektēšana	Izmēģināt citu vizuālo stilu
`from_scratch`	Pārprojektēšana	Pārprojektēt ekrānu no jauna

Izvade: { status, fileId, screenIds, designGuidelinesUpdated }. status vienmēr ir "generated".

Šis pārraksta ekrāna saturu vietā.

Pārdēvētie rīki

Rīku nosaukumi tika mainīti 2026. gada septembrī un oktobrī. Ja jums ir uzvednes, skripti vai aģentu norādījumi, kas izmanto vecos nosaukumus, atjauniniet tos:

Vecais nosaukums	Jaunais nosaukums
`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` (brīvas formas norādījumi)	`ai-design-screens`
`edit-design` (ar `operationVariant` priekšiestatījumu)	`ai-edit-screen-variant`
`regenerate-design`	`ai-edit-screen-variant`
`expand-design`	`ai-generate-screen-variant`

Ievades arī mainījās. AI dizaina rīki pieņem elementIds (vai vienu screenId variantu rīkiem) targets vietā. add-screen-jsx pieņem jsx un skaidros metadatu laukus jsxContent vietā ar metadatu komentāru. create-file pieņem name title vietā, un dizaina vadlīniju rīki pieņem fileId resourceId un linkedTo vietā.

​Failu rīki

​list-files

​get-file

​create-file

​update-file

​delete-file

​Ekrānu rīki

​list-screens

​get-screen-image

​get-screen-jsx

​add-screen-jsx

​replace-screen-jsx

​rename-screen

​delete-screen

​Attēli JSX

​Ekrāna lauku vērtības

​Dizaina vadlīniju rīki

​get-design-guidelines

​update-design-guidelines

​delete-design-guidelines

​Tērzēšanas rīki

​get-chat-history

​Pielikumu rīki

​upload-attachment

​Figma rīki

​import-figma

​Plāna un norēķinu rīki

​get-plan-details

​AI dizaina rīki

​ai-design-screens

​ai-generate-screen-variant

​ai-edit-screen-variant

​Pārdēvētie rīki

Failu rīki

`list-files`

`get-file`

`create-file`

`update-file`

`delete-file`

Ekrānu rīki

`list-screens`

`get-screen-image`

`get-screen-jsx`

`add-screen-jsx`

`replace-screen-jsx`

`rename-screen`

`delete-screen`

Attēli JSX

Ekrāna lauku vērtības

Dizaina vadlīniju rīki

`get-design-guidelines`

`update-design-guidelines`

`delete-design-guidelines`

Tērzēšanas rīki

`get-chat-history`

Pielikumu rīki

`upload-attachment`

Figma rīki

`import-figma`

Plāna un norēķinu rīki

`get-plan-details`

AI dizaina rīki

`ai-design-screens`

`ai-generate-screen-variant`

`ai-edit-screen-variant`

Pārdēvētie rīki