MCP eszközök referenciája

Minden eszköz egy content tömböt ad vissza MCP tartalomblokkok formájában. Szöveg eszközök { type: "text", text: "<json-string>" } formát adnak vissza. Kép eszközök { type: "image", data: "<base64>", mimeType: "image/png" } formát adnak vissza. Hiba esetén az isError: true érték kerül beállításra, és a szöveg blokk tartalmazza a hibaüzenetet.

Fájleszközök

`list-files`

Az aktuális felhasználó Flowstep fájljainak listázása. Bemenet

Paraméter	Típus	Alapértelmezett	Leírás
`orderByCreation`	`boolean`	`true`	Rendezés létrehozás dátuma szerint
`limit`	`integer` (1–100)	`20`	Visszaadni kívánt fájlok száma
`offset`	`integer` (≥0)	`0`	Lapozási eltolás

Kimenet — Fájlobjektumok JSON tömbje.

[
  {
    "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",
    "owner": true,
    "url": "https://app.flowstep.ai/file?activeFileId=5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0"
  }
]

`get-file`

Egyetlen fájl beolvasása azonosítóval. A fájl tartalma szándékosan kimarad — a képernyőket a get-screen vagy get-screen-image segítségével vizsgálhatod meg, és a mellékelt irányelveket a get-design-guidelines segítségével kérheted le. Bemenet

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

Kimenet — Fájlobjektum JSON formátumban.

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

`create-file`

Új Flowstep fájl létrehozása. Bemenet

Paraméter	Típus	Leírás
`title`	`string` (min 1)	Fájl neve

Kimenet — Fájlobjektum JSON formátumban az új fájl id értékével.

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

A visszaadott id értéket a fileId paraméterként használd a későbbi eszközfelhasználásokban.

`update-file`

Fájl átnevezése. Bemenet

Paraméter	Típus	Leírás
`id`	`uuid`	Fájl azonosítója
`name`	`string` (min 1)	Új név

Kimenet — Frissített fájlobjektum azonos formátumban, mint a get-file.

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

`delete-file`

Fájl végleges törlése. A megadott name érték ellenőrzésre kerül a fájl tényleges neve ellen a törlés előtt — ha nem egyezik, a törlés leáll. Ez megelőzi a rossz fájl véletlen törlését. Bemenet

Paraméter	Típus	Leírás
`id`	`uuid`	Fájl azonosítója
`name`	`string`	A fájl jelenlegi neve — pontosan meg kell egyeznie, vagy a törlés leáll

Kimenet — "File deleted successfully"

Ez visszavonhatatlan. A fájlban lévő összes képernyő törlésre kerül.

Képernyő-eszközök

`list-screens`

Egy fájl összes generált képernyőjének listázása. A visszaadott screenId értékeket használd a get-screen, get-screen-image, upload-attachment eszközökben, valamint targets paraméterként az edit-design, regenerate-design vagy expand-design eszközökben. Bemenet

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

Kimenet — Képernyő-összegzések JSON tömbje.

[
  {
    "screenId": "3f9e6eb6-5525-4383-9375-67e0bd762dbe",
    "name": "Mobile login screen",
    "fidelity": "ui",
    "prompt": "Generate a simple mobile login screen with email and password fields and a sign in button",
    "createdAt": "2026-04-30T15:02:37.444139+00:00"
  }
]

A name a felhasználó által hozzárendelt képernyő neve, vagy null, ha nincs nev.

`get-screen`

A képernyő JSX kódának lekérése, amely lehetővé teszi a szerkesztést vagy a kód Flowstepen kívüli használatát. Vizuális előnézethez használd a get-screen-image eszközt. Bemenet

Paraméter	Típus	Leírás
`fileId`	`uuid`	Fájl azonosítója
`screenId`	`uuid`	A `list-screens` által visszaadott `screenId`, vagy egy terveszköz által visszaadott `screenIds` tömbből

Kimenet — A képernyő kódként (JSX). Vedd észre az első sor megjegyzését, amely szükséges az add-screen eszköz használatakor.

<!-- screenType: "iphone-x-vertical" width: "375" height: "812" name: "Change to a light theme" colorTheme: "blue" screenId: "c13d3707-0efe-49f5-b6cb-0ca5ac5223d0" -->
<div className="bg-white text-zinc-950 w-full h-fit">
  <div className="flex p-6 flex-col gap-6">
    <div className="flex pt-4 justify-between items-center">
      <ArrowLeft className="size-5 text-[#71717b]" />
      <span className="font-semibold text-zinc-950 text-lg leading-7">
        World Clock
      </span>
      <Plus className="size-5 text-[#2b7fff]" />
    </div>
    <div className="rounded-xl bg-zinc-100 flex p-2 items-center gap-2">
      <Search className="size-4 text-[#71717b] ml-2" />
      <span className="text-[#71717b] text-sm leading-5">Search cities...</span>
    </div>
...
    <div className="flex pt-2 pb-4 justify-center items-center gap-4">
      <Button variant="outline" className="rounded-full px-6 gap-2">
        <Clock className="size-4" />
        <span>Compare</span>
      </Button>
      <Button className="rounded-full bg-[#2b7fff] text-blue-50 px-6 gap-2">
        <Bell className="size-4" />
        <span>Set Alert</span>
      </Button>
    </div>
  </div>
</div>;

`add-screen`

Új képernyő hozzáadása egy Flowstep fájlhoz nyers JSX karakterláncból. Bemenet

Paraméter	Típus	Leírás
`fileId`	`uuid`	Fájl azonosítója
`jsxContent`	`string`	JSX hozzáadása a fájlhoz képernyőként
`screenType`	`string`	Szükséges, ha a képernyő típusa nincs megjegyzésként a JSX elején

Megjegyzés — Az alábbihoz hasonló megjegyzésnek KÖTELEZŐEN jelen kell lennie a JSX első soraként, mivel ez szükséges a képernyő helyes hozzáadásához. A screenType, name és screenId mind opcionálisak — a screenId használatban van (belsőleg), ha jelen van (például amikor a get-screen kimenetéből másolt JSX-et adunk meg), de nem kötelező. A képernyő neve a megjegyzés name mezőjéből kerül ovezetésre (megjelenik “Copy of <name>“-ként), vagy “Untitled”, ha hiányzik.  Kimenet — Az újonnan hozzáadott képernyő azonosítója.

{ "screenId": "3f9e6eb6-5525-4383-9375-67e0bd762dbf" }

`get-screen-image`

Képernyő renderelése PNG-vé és beágyazott képként való visszaadása. Képesnek kell lennie az ügyfélnek a képtartalmi blokkok támogatásában. Bemenet

Paraméter	Típus	Leírás
`fileId`	`uuid`	Fájl azonosítója
`screenId`	`uuid`	A `list-screens` által visszaadott `screenId`, vagy egy terveszköz által visszaadott `screenIds` tömbből

Kimenet — MCP képtartalmi blokk (image/png).

AI eszközök

A regenerate-design, expand-design és edit-design eszközök tervkörnyezetet igényelnek, amely csak a designs tömbvel eredetileg generált képernyőkön van jelen. A tervkörnyezet nélkül generált képernyők hibát adnak vissza. Megoldás: a upload-attachment eszközzel rendereld a képernyőt képként, majd hívd meg a create-new-design eszközt a képpel a attachments mezőben és egy üzenettel, amely leírja a kívánt változtatásokat.

`create-new-design`

Egy vagy több képernyőterv generálása szöveges promptból. A fileId paraméter elhagyásával automatikusan új fájlt hozhatsz létre. Letiltja a generálást, amíg az befejeződik vagy időtúllépés történik (180 másodperc). Bemenet

Paraméter	Típus	Alapértelmezett	Leírás
`fileId`	`uuid`	—	Célfájl — hagyj el az automatikus új fájl létrehozásához
`message`	`string`	—	A generálni kívánt képernyőket leíró prompt
`attachments`	`AttachmentRequestData[]` (max 5)	`[]`	Előre feltöltött mellékletek — képek, PDF-ek vagy kódfájlok. Mindig feltöltés a `upload-attachment` eszközzel; ne ágyazd be a fájltartalmat az üzenetben
`designs`	`DesignRequestData[]`	`[]`	Tervmegjelölések

Kimenet — { fileId, screenIds }. Adja meg az egyes screenId értékeket a get-screen-image eszköznek az eredmények megtekintéséhez.

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

`regenerate-design`

Meglévő képernyőket redo-z nulláról vagy stílusvariációval. Legalább egy screenId szükséges a targets mezőben. Letiltja a generálást, amíg az befejeződik vagy időtúllépés történik (180 másodperc). Bemenet

Paraméter	Típus	Alapértelmezett	Leírás
`fileId`	`uuid`	—	Célfájl
`message`	`string`	—	Promptszöveg
`targets`	`uuid[]` (min 1)	—	Az újragenerálni kívánt képernyők screenId-jai
`operationVariant`	`"different_layout" \| "different_style" \| "from_scratch"`	—	Opcionális stílusvariáció
`designs`	`DesignRequestData[]`	`[]`	Tervmegjelölések (automatikusan feloldott)

Kimenet — { fileId, screenIds }. Adja meg az egyes screenId értékeket a get-screen-image eszköznek az eredmények megtekintéséhez.

`expand-design`

Follow-on képernyők hozzáadása egy meglévő tervhez. Legalább egy screenId szükséges a targets mezőben és egy kötelező operationVariant. Letiltja a generálást, amíg az befejeződik vagy időtúllépés történik (180 másodperc). Bemenet

Paraméter	Típus	Alapértelmezett	Leírás
`fileId`	`uuid`	—	Célfájl
`message`	`string`	—	Promptszöveg
`targets`	`uuid[]` (min 1)	—	A kiterjesztéshez képernyő screenId-jai
`operationVariant`	`"next_screen" \| "error_state" \| "empty_state" \| "web_version" \| "mobile_version" \| "tablet_version" \| "mobile_ios_version" \| "mobile_android_version"`	—	Kötelező — generálni kívánt follow-on képernyő típusa
`designs`	`DesignRequestData[]`	`[]`	Tervmegjelölések (automatikusan feloldott)

Kimenet — { fileId, screenIds }. Adja meg az egyes screenId értékeket a get-screen-image eszköznek az eredmények megtekintéséhez.

`edit-design`

Meglévő képernyők módosítása prompton keresztül. Legalább egy screenId szükséges a targets mezőben. Letiltja a generálást, amíg az befejeződik vagy időtúllépés történik (180 másodperc). Bemenet

Paraméter	Típus	Alapértelmezett	Leírás
`fileId`	`uuid`	—	Célfájl
`message`	`string`	—	Szerkesztésre vonatkozó utasítások
`targets`	`uuid[]` (min 1)	—	Az szerkesztni kívánt képernyők screenId-jai
`operationVariant`	`"dark_theme" \| "light_theme" \| "make_pretty"`	—	Opcionális stílus parancsikon
`attachments`	`AttachmentRequestData[]` (max 5)	`[]`	Előre feltöltött mellékletek. Mindig feltöltés a `upload-attachment` eszközzel
`designs`	`DesignRequestData[]`	`[]`	Tervmegjelölések (automatikusan feloldott)

Kimenet — { fileId, screenIds }. Adja meg az egyes screenId értékeket a get-screen-image eszköznek az eredmények megtekintéséhez.

`upload-attachment`

Fájl feltöltése a create-new-design vagy edit-design mellékletként való használatra. { id, path, type, mimeType } értéket ad vissza — ezt az objektumot közvetlenül adja meg az attachments tömbben. Két mód: 1. mód — Képernyő azonosítóval Adja meg a screenId és fileId értékeket. A szerver lekéri a képernyő állapotát az adatbázisból és képként rendereli.

Paraméter	Típus	Leírás
`fileId`	`uuid`	A képernyőt tartalmazó fájl (kötelező)
`screenId`	`uuid`	A renderelni kívánt képernyő

2. mód — Külső fájl Adja meg közvetlenül a fájltartalmat. A bináris fájlokat base64-kódolásnak kell lennie; a szövegfájlokat (beleértve a forráskódot) egyszerű UTF-8 karakterláncként adja meg.

Paraméter	Típus	Leírás
`fileData`	`string`	Fájltartalom — base64 binárisra, UTF-8 karakterlánc szöveghez
`fileName`	`string`	Eredeti fájlnév
`mimeType`	`"image/jpeg" \| "image/png" \| "image/webp" \| "application/pdf" \| "text/plain" \| "text/javascript"`	MIME típus. Használd a `text/javascript` típust `.jsx`, `.tsx`, `.js`, `.ts` fájlokhoz

Maximális fájlméret: 3 MB. Nagy képek esetén inkább image/jpeg-et használ image/png helyett. Kimenet

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "path": "attachments/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "type": "image",
  "mimeType": "image/jpeg"
}

A type érték "image" a kép/PDF feltöltésekhez és "document" szöveg/kód fájlokhoz.

Chat eszközök

`get-chat-history`

Egy fájl csevegési üzenetköldelmezésének lekérése. Bemenet

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

Kimenet — JSON objektum egy messages tömbvel. Minden üzenetnek type ("request" vagy "response"), author ("human" vagy "ai") és content_type ("text", "summary" vagy "followup") mezője van.

{
  "messages": [
    {
      "id": "453f593d-2380-425b-ba29-127db08d6a8e",
      "chat_id": "146d0f19-497e-450c-ba53-3de15f6bd70b",
      "type": "request",
      "status": "success",
      "content": "Generate a simple mobile login screen with email and password fields",
      "author": "human",
      "content_type": "text",
      "sequence": 1,
      "request_message_id": null,
      "targets": [],
      "attachments": []
    },
    {
      "id": "d860186b-82d5-4bd1-8e8e-8ba5377a14bf",
      "chat_id": "146d0f19-497e-450c-ba53-3de15f6bd70b",
      "type": "response",
      "status": "success",
      "content": "Generated a mobile login screen with email and password input fields, sign in button, remember me checkbox, forgot password link, social login options (Apple/Google), and 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" }],
      "attachments": []
    }
  ]
}

Terveszközök

`get-design-guidelines`

Egy fájl számára tárolt tervezési irányelvek lekérése. Bemenet

Paraméter	Típus	Alapértelmezett	Leírás
`resourceId`	`uuid`	—	Fájl azonosítója
`linkedTo`	`"file"`	`"file"`	Erőforrás típusa

Kimenet

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

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

`update-design-guidelines`

Tervezési irányelvek beállítása vagy cseréje egy fájlhoz. Az irányelveket egyszerű szöveges karakterláncként kell átadni a Google design.md formátumában — nem szabad objektumot vagy JSON-t átadni. A szerver lágyan érvényes és visszaadhat egy Warnings: szakaszt a válaszban, amely az elfogadott, de az AI által figyelmen kívül hagyható problémákat (ismeretlen kulcsok, nem hex-szín) sorolja fel. Tegyük ezt a felhasználó elé. Bemenet

Paraméter	Típus	Alapértelmezett	Leírás
`resourceId`	`uuid`	—	Fájl azonosítója
`designGuidelines`	`string` (min 1)	—	Az irányelvek nyers szöveges tartalma. Csak szöveges karakterláncnak kell lennie — nem JSON-kódolt
`linkedTo`	`"file"`	`"file"`	Erőforrás típusa

Érvényesítési szabályok

A frontmatter helyesen kell megnyitni és zárni
A frontmatter soroknak érvényes blokk-stílusú YAML-nek kell lennie
A Markdown test nem tartalmazhat duplikált ## szakaszcímeket

Kimenet — "Design guidelines updated successfully", opcionálisan ezt követően egy Warnings: szakasz.

`delete-design-guidelines`

Egy fájl tervezési irányelvei törlése. Bemenet

Paraméter	Típus	Alapértelmezett	Leírás
`resourceId`	`uuid`	—	Fájl azonosítója
`linkedTo`	`"file"`	`"file"`	Erőforrás típusa

Kimenet — "Design guidelines deleted successfully"

Figma eszközök

`import-figma`

Figma keretet importálás egy Flowstep fájlba szerkeszthető elemekként a vásznon. Az azonos keret újbóli importálása frissíti azt helyben. A fájl szervezetének csatlakoztatott Figmával kell rendelkeznie a Flowstep beállításaiban. Bemenet

Paraméter	Típus	Leírás
`figmaUrl`	`string`	Egy adott Figma keret linkje. A Figmában kattints jobb gombbal a keretre, és válassza a Copy link to selection lehetőséget. Az oldal linkje az oldal összes felső szintű keretét importálja (max 20 keret az MCP-n keresztül).
`fileId`	`uuid`	Az a Flowstep fájl, amelybe importálni kívánod a keretet

Kimenet — { fileId, screenId }. A screenId az importált képernyőelem azonosítója — adja meg a get-screen-image eszköznek az eredmény megtekintéséhez. Amikor egy oldal URL-je több keretet importál, a screenId érték null és a frameCount helyett kerül visszaadásra.

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

Számlázási eszközök

`get-plan-details`

Az aktuális felhasználó csomagja, előfizetési állapota és fennmaradó kvótájának lekérése. Nem igényel bemenetet. Kimenet

{
  "plan": {
    "name": "Starter",
    "code": "starter",
    "type": "paid"
  },
  "subscription": {
    "isPaid": true,
    "isTrial": false,
    "startDate": "2025-01-01T00:00:00Z",
    "endDate": null,
    "trialDaysRemaining": null
  },
  "limits": {
    "messages": {
      "daily": { "max": 50, "warn": 40 },
      "monthly": { "max": 500, "warn": 400 },
      "unlimited": false
    }
  },
  "usage": {
    "messages": { "daily": 12, "monthly": 87 }
  },
  "remaining": {
    "messages": { "daily": 38, "monthly": 413 }
  }
}

A korlátok csomagenként eltérőek. Hívd meg ezt az eszközt a generálások kötegének elindítása előtt az elérhető kvóta ellenőrzéséhez.

Első lépések

A Flowstep használata

Csapatok és szervezetek

Exportálás és integrációk

MCP-szerver

Számlázás és csomagok

Biztonság és adatvédelem

MCP eszközök referenciája

Fájleszközök

`list-files`

`get-file`

`create-file`

`update-file`

`delete-file`

Képernyő-eszközök

`list-screens`

`get-screen`

`add-screen`

`get-screen-image`

AI eszközök

`create-new-design`

`regenerate-design`

`expand-design`

`edit-design`

`upload-attachment`

Chat eszközök

`get-chat-history`

Terveszközök

`get-design-guidelines`

`update-design-guidelines`

`delete-design-guidelines`

Figma eszközök

`import-figma`

Számlázási eszközök

`get-plan-details`

​Fájleszközök

​list-files

​get-file

​create-file

​update-file

​delete-file

​Képernyő-eszközök

​list-screens

​get-screen

​add-screen

​get-screen-image

​AI eszközök

​create-new-design

​regenerate-design

​expand-design

​edit-design

​upload-attachment

​Chat eszközök

​get-chat-history

​Terveszközök

​get-design-guidelines

​update-design-guidelines

​delete-design-guidelines

​Figma eszközök

​import-figma

​Számlázási eszközök

​get-plan-details

Fájleszközök

`list-files`

`get-file`

`create-file`

`update-file`

`delete-file`

Képernyő-eszközök

`list-screens`

`get-screen`

`add-screen`

`get-screen-image`

AI eszközök

`create-new-design`

`regenerate-design`

`expand-design`

`edit-design`

`upload-attachment`

Chat eszközök

`get-chat-history`

Terveszközök

`get-design-guidelines`

`update-design-guidelines`

`delete-design-guidelines`

Figma eszközök

`import-figma`

Számlázási eszközök

`get-plan-details`