Referenční příručka nástrojů MCP

Všechny nástroje vrací pole content s bloky obsahu MCP. Textové nástroje vrací { type: "text", text: "<json-string>" }. Obrázkové nástroje vrací { type: "image", data: "<base64>", mimeType: "image/png" }. Při chybě je nastaven isError: true a textový blok obsahuje chybovou zprávu.

Nástroje pro soubory

`list-files`

Vypište soubory Flowstep pro aktuálního uživatele. Vstup

Parametr	Typ	Výchozí	Popis
`orderByCreation`	`boolean`	`true`	Řadit podle data vytvoření
`limit`	`integer` (1–100)	`20`	Počet souborů, které se mají vrátit
`offset`	`integer` (≥0)	`0`	Offset stránkování

Výstup — Pole JSON objektů souborů.

[
  {
    "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`

Získejte jeden soubor podle ID. Obsah souboru je záměrně vynechán — používejte get-screen nebo get-screen-image k prohlídce obrazovek a get-design-guidelines k načtení připojených pokynů. Vstup

Parametr	Typ	Popis
`id`	`uuid`	ID souboru

Výstup — Objekt JSON souboru.

{
  "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`

Vytvořte nový soubor Flowstep. Vstup

Parametr	Typ	Popis
`title`	`string` (min 1)	Název souboru

Výstup — Objekt JSON souboru s id nového souboru.

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

Používejte vrácené id jako fileId v následujících voláních nástrojů.

`update-file`

Přejmenujte soubor. Vstup

Parametr	Typ	Popis
`id`	`uuid`	ID souboru
`name`	`string` (min 1)	Nový název

Výstup — Aktualizovaný objekt souboru v stejné formě jako 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`

Trvale odstraňte soubor. Název, který předáte, je ověřen proti skutečnému názvu souboru před odstraněním — pokud se neshoduje, je odstranění zrušeno. To zabraňuje neúmyslnému odstranění nesprávného souboru. Vstup

Parametr	Typ	Popis
`id`	`uuid`	ID souboru
`name`	`string`	Aktuální název souboru — musí se shodovat přesně, nebo je odstranění zrušeno

Výstup — "Soubor byl úspěšně smazán"

Toto je nevratné. Všechny obrazovky v souboru jsou odstraněny.

Nástroje pro obrazovky

`list-screens`

Vypište všechny vygenerované obrazovky pro soubor. Použijte vrácené hodnoty screenId k odkazování na obrazovky v get-screen, get-screen-image, upload-attachment a jako targets v edit-design, regenerate-design nebo expand-design. Vstup

Parametr	Typ	Popis
`fileId`	`uuid`	ID souboru

Výstup — Pole JSON shrnutí obrazovek.

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

name je uživatelem přiřazený název obrazovky nebo null, pokud je bez názvu.

`get-screen`

Získejte kód JSX pro obrazovku, který vám umožní upravit nebo použít kód mimo Flowstep. Místo toho použijte get-screen-image pro vizuální náhled. Vstup

Parametr	Typ	Popis
`fileId`	`uuid`	ID souboru
`screenId`	`uuid`	Hodnota `screenId` vrácená funkcí `list-screens` nebo z pole `screenIds` vrácené nástrojem pro návrh

Výstup — Obrazovka jako kód (JSX). Všimněte si komentáře na prvním řádku, který je vyžadován při používání nástroje add-screen.

<!-- 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`

Přidá novou obrazovku do souboru Flowstep ze surového řetězce JSX. Vstup

Parametr	Typ	Popis
`fileId`	`uuid`	ID souboru
`jsxContent`	`string`	JSX, který se přidá do souboru jako obrazovka
`screenType`	`string`	Povinné, pokud typ obrazovky není definován jako komentář na začátku JSX

Poznámka - Komentář podobný tomu níže MUSÍ být přítomen jako první řádek JSX, protože se používá k správnému přidání obrazovky. screenType, name a screenId jsou všechny volitelné — screenId se používá (interně) je-li přítomný (například při předávání JSX zkopírovaného z výstupu get-screen), ale není povinný. Název obrazovky je převzat z pole name komentáře (zobrazeno jako “Copy of <name>”), nebo “Untitled” pokud chybí.  Výstup — ID nově přidané obrazovky.

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

`get-screen-image`

Vykreslí obrazovku do formátu PNG a vrátí ji jako vloženou kopii. Vyžaduje klienta, který podporuje bloky obsahu obrázku. Vstup

Parametr	Typ	Popis
`fileId`	`uuid`	ID souboru
`screenId`	`uuid`	Hodnota `screenId` vrácená funkcí `list-screens` nebo z pole `screenIds` vrácené nástrojem pro návrh

Výstup — Blok obsahu obrázku MCP (image/png).

Nástroje AI

regenerate-design, expand-design a edit-design vyžadují kontext návrhu, který existuje pouze na obrazovkách původně vygenerovaných s polem designs. Obrazovky vygenerované bez kontextu návrhu vrátí chybu. Obejití: použijte upload-attachment k vykreslení obrazovky jako obrázku, poté zavolejte create-new-design s obrázkem v attachments a zprávou popisující požadované změny.

`create-new-design`

Vygenerujte jeden nebo více návrhů obrazovky z textového promptu. Vynechejte fileId k automatickému vytvoření nového souboru. Blokuje, dokud se generování nedokončí nebo nevypršel časový limit (180 sekund). Vstup

Parametr	Typ	Výchozí	Popis
`fileId`	`uuid`	—	Cílový soubor — vynechejte pro automatické vytvoření nového souboru
`message`	`string`	—	Prompt popisující obrazovky, které se mají vygenerovat
`attachments`	`AttachmentRequestData[]` (max 5)	`[]`	Dříve nahraná příloha — obrázky, PDF nebo soubory kódu. Vždy nejdřív nahrajte přes `upload-attachment`; nevkládejte obsah souboru do zprávy
`designs`	`DesignRequestData[]`	`[]`	Designové reference

Výstup — { fileId, screenIds }. Předejte každou screenId do get-screen-image k zobrazení výsledků.

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

`regenerate-design`

Znovu vytvořte stávající obrazovky od nuly nebo s variantou stylu. Vyžaduje alespoň jednu screenId v targets. Blokuje, dokud se generování nedokončí nebo nevypršel časový limit (180 sekund). Vstup

Parametr	Typ	Výchozí	Popis
`fileId`	`uuid`	—	Cílový soubor
`message`	`string`	—	Text promptu
`targets`	`uuid[]` (min 1)	—	screenIds obrazovek k regeneraci
`operationVariant`	`"different_layout" \| "different_style" \| "from_scratch"`	—	Volitelná varianta stylu
`designs`	`DesignRequestData[]`	`[]`	Designové reference (vyřešeny automaticky)

Výstup — { fileId, screenIds }. Předejte každou screenId do get-screen-image k zobrazení výsledků.

`expand-design`

Přidejte navazující obrazovky k existujícímu návrhu. Vyžaduje alespoň jednu screenId v targets a povinné operationVariant. Blokuje, dokud se generování nedokončí nebo nevypršel časový limit (180 sekund). Vstup

Parametr	Typ	Výchozí	Popis
`fileId`	`uuid`	—	Cílový soubor
`message`	`string`	—	Text promptu
`targets`	`uuid[]` (min 1)	—	screenIds obrazovek, ze kterých se má rozšířit
`operationVariant`	`"next_screen" \| "error_state" \| "empty_state" \| "web_version" \| "mobile_version" \| "tablet_version" \| "mobile_ios_version" \| "mobile_android_version"`	—	Povinné — typ navazující obrazovky, která se má vygenerovat
`designs`	`DesignRequestData[]`	`[]`	Designové reference (vyřešeny automaticky)

Výstup — { fileId, screenIds }. Předejte každou screenId do get-screen-image k zobrazení výsledků.

`edit-design`

Upravujte stávající obrazovky pomocí promptu. Vyžaduje alespoň jednu screenId v targets. Blokuje, dokud se generování nedokončí nebo nevypršel časový limit (180 sekund). Vstup

Parametr	Typ	Výchozí	Popis
`fileId`	`uuid`	—	Cílový soubor
`message`	`string`	—	Pokyny popisující úpravy, které se mají provést
`targets`	`uuid[]` (min 1)	—	screenIds obrazovek k úpravě
`operationVariant`	`"dark_theme" \| "light_theme" \| "make_pretty"`	—	Volitelná zkratka stylu
`attachments`	`AttachmentRequestData[]` (max 5)	`[]`	Dříve nahrané přílohy. Vždy nejdřív nahrajte přes `upload-attachment`
`designs`	`DesignRequestData[]`	`[]`	Designové reference (vyřešeny automaticky)

Výstup — { fileId, screenIds }. Předejte každou screenId do get-screen-image k zobrazení výsledků.

`upload-attachment`

Nahrajte soubor, který se má používat jako příloha v create-new-design nebo edit-design. Vrací { id, path, type, mimeType } — předejte tento objekt přímo do pole attachments. Dva režimy: Režim 1 — Obrazovka podle ID Předejte screenId a fileId. Server načte stav obrazovky z databáze a vykreslí ji jako obrázek.

Parametr	Typ	Popis
`fileId`	`uuid`	Soubor obsahující obrazovku (povinné)
`screenId`	`uuid`	Obrazovka k vykreslení

Režim 2 — Externí soubor Předejte obsah souboru přímo. Binární soubory musí být kódovány v base64; textové soubory (včetně zdrojového kódu) jsou předávány jako prostý řetězec UTF-8.

Parametr	Typ	Popis
`fileData`	`string`	Obsah souboru — base64 pro binární, řetězec UTF-8 pro text
`fileName`	`string`	Původní název souboru
`mimeType`	`"image/jpeg" \| "image/png" \| "image/webp" \| "application/pdf" \| "text/plain" \| "text/javascript"`	Typ MIME. Použijte `text/javascript` pro soubory `.jsx`, `.tsx`, `.js`, `.ts`

Maximální velikost souboru: 3 MB. Pro velké obrázky preferujte image/jpeg nad image/png. Výstup

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

type je "image" pro nahrávání obrázků/PDF a "document" pro textové/kódové soubory.

Nástroje chatu

`get-chat-history`

Získejte historii chatových zpráv pro soubor. Vstup

Parametr	Typ	Popis
`fileId`	`uuid`	ID souboru

Výstup — Objekt JSON s polem messages. Každá zpráva má type ("request" nebo "response"), author ("human" nebo "ai") a content_type ("text", "summary" nebo "followup").

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

Nástroje pro návrh

`get-design-guidelines`

Získejte designové pokyny uložené pro soubor. Vstup

Parametr	Typ	Výchozí	Popis
`resourceId`	`uuid`	—	ID souboru
`linkedTo`	`"file"`	`"file"`	Typ prostředku

Výstup

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

guidelines je null, pokud nebyly nastaveny žádné pokyny.

`update-design-guidelines`

Nastavte nebo nahraďte designové pokyny pro soubor. Pokyny se předávají jako prostý textový řetězec ve formátu design.md od Google — nepředávejte objekt nebo JSON. Server provádí měkkou validaci a může vrátit část Warnings: v odpovědi s výčtem problémů (neznámé klíče, ne-hexadecimální barvy), které byly přijaty, ale mohou být ignorovány AI. Surfujte tyto chyby uživateli. Vstup

Parametr	Typ	Výchozí	Popis
`resourceId`	`uuid`	—	ID souboru
`designGuidelines`	`string` (min 1)	—	Obsah pokynů v prostém textu. Musí být prostý řetězec — ne kódovaný JSON
`linkedTo`	`"file"`	`"file"`	Typ prostředku

Pravidla ověřování

Předmluva musí být otevřena a uzavřena správně
Řádky předmluvy musí být platný YAML v blokové formě
Tělo Markdown nesmí obsahovat duplicitní nadpisy oddílů ##

Výstup — "Designové pokyny byly úspěšně aktualizovány", volitelně následovány oddílem Warnings:.

`delete-design-guidelines`

Vymažte designové pokyny pro soubor. Vstup

Parametr	Typ	Výchozí	Popis
`resourceId`	`uuid`	—	ID souboru
`linkedTo`	`"file"`	`"file"`	Typ prostředku

Výstup — "Designové pokyny byly úspěšně odstraněny"

Nástroje Figmy

`import-figma`

Importujte rámeček z Figmy do souboru Flowstep jako editovatelné prvky na jeho plátně. Opětovný import stejného rámečku ho aktualizuje na místě. Organizace souboru musí mít nejdřív připojenou Figmu v nastavení Flowstepu. Vstup

Parametr	Typ	Popis
`figmaUrl`	`string`	Odkaz na konkrétní rámeček Figmy. V Figmě klikněte na rámeček pravým tlačítkem a vyberte Copy link to selection. Odkaz na stránku importuje všechny rámečky na nejvyšší úrovni na dané stránce (limitováno na 20 rámečků přes MCP).
`fileId`	`uuid`	Soubor Flowstep, do kterého se má rámeček importovat

Výstup — { fileId, screenId }. screenId je ID importovaného prvku obrazovky — předejte ho na get-screen-image a zobrazte si výsledek. Pokud odkaz na stránku importuje více rámečků, screenId je null a místo toho se vrací frameCount.

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

Nástroje pro fakturaci

`get-plan-details`

Získejte plán aktuálního uživatele, stav předplatného a zbývající kvótu. Nevyžaduje vstup. Výstup

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

Limity se liší podle tarifu. Zavolejte tento nástroj před dávkou generování, abyste zkontrolovali dostupnou kvótu.

Začínáme

Používání Flowstep

Týmy a organizace

Export a integrace

MCP server

Fakturace a tarify

Zabezpečení a soukromí

Referenční příručka nástrojů MCP

Nástroje pro soubory

`list-files`

`get-file`

`create-file`

`update-file`

`delete-file`

Nástroje pro obrazovky

`list-screens`

`get-screen`

`add-screen`

`get-screen-image`

Nástroje AI

`create-new-design`

`regenerate-design`

`expand-design`

`edit-design`

`upload-attachment`

Nástroje chatu

`get-chat-history`

Nástroje pro návrh

`get-design-guidelines`

`update-design-guidelines`

`delete-design-guidelines`

Nástroje Figmy

`import-figma`

Nástroje pro fakturaci

`get-plan-details`

​Nástroje pro soubory

​list-files

​get-file

​create-file

​update-file

​delete-file

​Nástroje pro obrazovky

​list-screens

​get-screen

​add-screen

​get-screen-image

​Nástroje AI

​create-new-design

​regenerate-design

​expand-design

​edit-design

​upload-attachment

​Nástroje chatu

​get-chat-history

​Nástroje pro návrh

​get-design-guidelines

​update-design-guidelines

​delete-design-guidelines

​Nástroje Figmy

​import-figma

​Nástroje pro fakturaci

​get-plan-details

Nástroje pro soubory

`list-files`

`get-file`

`create-file`

`update-file`

`delete-file`

Nástroje pro obrazovky

`list-screens`

`get-screen`

`add-screen`

`get-screen-image`

Nástroje AI

`create-new-design`

`regenerate-design`

`expand-design`

`edit-design`

`upload-attachment`

Nástroje chatu

`get-chat-history`

Nástroje pro návrh

`get-design-guidelines`

`update-design-guidelines`

`delete-design-guidelines`

Nástroje Figmy

`import-figma`

Nástroje pro fakturaci

`get-plan-details`