הפניית כלים של MCP

כל הכלים מחזירים מערך content של בלוקי תוכן MCP. כלי טקסט מחזירים { type: "text", text: "<json-string>" }. כלי תמונה מחזירים { type: "image", data: "<base64>", mimeType: "image/png" }. בכשל, isError: true מוגדר וגוש הטקסט מכיל את הודעת השגיאה.

כלי קבצים

`list-files`

רשימה של קבצי Flowstep למשתמש הנוכחי. קלט

פרמטר	סוג	ברירת מחדל	תיאור
`orderByCreation`	`boolean`	`true`	סדר לפי תאריך יצירה
`limit`	`integer` (1–100)	`20`	מספר קבצים להחזר
`offset`	`integer` (≥0)	`0`	היסט דפדוף

פלט — מערך JSON של אובייקטי קבצים.

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

קבל קובץ יחיד לפי מזהה. תוכן הקובץ נשמט בכוונה — השתמש ב-get-screen או get-screen-image כדי לבדוק מסכים, וב-get-design-guidelines כדי לאחזר הנחיות מצורפות. קלט

פרמטר	סוג	תיאור
`id`	`uuid`	מזהה קובץ

פלט — אובייקט קובץ JSON.

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

צור קובץ Flowstep חדש. קלט

פרמטר	סוג	תיאור
`title`	`string` (min 1)	שם קובץ

פלט — אובייקט קובץ JSON עם ה-id של הקובץ החדש.

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

השתמש ב-id המוחזר כ-fileId בקריאות כלים הבאות.

`update-file`

שנה שם של קובץ. קלט

פרמטר	סוג	תיאור
`id`	`uuid`	מזהה קובץ
`name`	`string` (min 1)	שם חדש

פלט — אובייקט קובץ מעודכן באותה צורה כמו 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`

מחק קובץ בצורה קבועה. ה-name שאתה עובר מאומת מול שם בפועל של הקובץ לפני מחיקה — אם הוא לא תואם, המחיקה מבוטלת. זה מונע מחיקה בטעות של הקובץ הלא נכון. קלט

פרמטר	סוג	תיאור
`id`	`uuid`	מזהה קובץ
`name`	`string`	שם נוכחי של הקובץ — חייב להתאים בדיוק או המחיקה מבוטלת

פלט — "File deleted successfully"

זה בלתי הפיך. כל המסכים בקובץ מחוקים.

כלי מסכים

`list-screens`

רשימה של כל המסכים שנוצרו לקובץ. השתמש ב-screenId המוחזר כדי להתייחס למסכים ב-get-screen, get-screen-image, upload-attachment, ו-targets ב-edit-design, regenerate-design, או expand-design. קלט

פרמטר	סוג	תיאור
`fileId`	`uuid`	מזהה קובץ

פלט — מערך JSON של תקצירי מסכים.

[
  {
    "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 הוא שם המסך המוקצה למשתמש, או null אם לא שם.

`get-screen`

קבל את קוד JSX לתרשים המאפשר לך לערוך או להשתמש בקוד מחוץ ל-Flowstep. השתמש ב-get-screen-image לצפייה חזותית במקום זאת. קלט

פרמטר	סוג	תיאור
`fileId`	`uuid`	מזהה קובץ
`screenId`	`uuid`	ה-`screenId` המוחזר על ידי `list-screens` או מערך `screenIds` המוחזר על ידי כלי עיצוב

פלט — המסך כקוד (JSX). שימו לב להערה בשורה הראשונה אשר נדרשת בעת שימוש בכלי 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`

הוסף מסך חדש לקובץ Flowstep מחוט JSX גולמי. קלט

פרמטר	סוג	תיאור
`fileId`	`uuid`	מזהה קובץ
`jsxContent`	`string`	JSX להוסיף לקובץ כמסך
`screenType`	`string`	נדרש אם סוג המסך אינו מוגדר כהערה בתחילת ה-JSX

הערה - הערה דומה לזו למטה חייבת להיות נוכחת כשורה הראשונה של ה-JSX מכיוון שהיא משמשת להוספת המסך בצורה נכונה. screenType, name, ו-screenId הם הכל אופציונלי — screenId משמש (בפנים) אם קיים (למשל בעת העברת JSX המועתק מפלט get-screen) אך אינו חובה. שם המסך נלקח מהשדה name של ההערה (מוצג כ”Copy of <name>”), או “Untitled” אם חסר.  פלט — מזהה המסך החדש שנוסף.

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

`get-screen-image`

עבד מסך ל-PNG והחזר אותו כתמונה בשורה. דורש לקוח התומך בבלוקי תוכן תמונה. קלט

פרמטר	סוג	תיאור
`fileId`	`uuid`	מזהה קובץ
`screenId`	`uuid`	ה-`screenId` המוחזר על ידי `list-screens` או מערך `screenIds` המוחזר על ידי כלי עיצוב

פלט — בלוק תוכן תמונה של MCP (image/png).

כלי AI

regenerate-design, expand-design, ו-edit-design דורשים הקשר עיצוב הקיים רק במסכים שנוצרו במקור עם מערך designs. מסכים שנוצרו ללא הקשר עיצוב יחזרו שגיאה. דרך עקיפה: השתמש ב-upload-attachment לעיצוב המסך כתמונה, ואז קרא ל-create-new-design עם התמונה ב-attachments והודעה המתארת את השינויים הרצויים.

`create-new-design`

ייצור עיצובי מסך אחד או יותר מפרומפט טקסט. השמט fileId כדי ליצור קובץ חדש באופן אוטומטי. חוסמות עד שהייצור מסתיים או פוקע בזמן (180 שניות). קלט

פרמטר	סוג	ברירת מחדל	תיאור
`fileId`	`uuid`	—	קובץ יעד — השמט כדי ליצור קובץ חדש באופן אוטומטי
`message`	`string`	—	פרומפט המתאר את המסכים ליצור
`attachments`	`AttachmentRequestData[]` (max 5)	`[]`	הוספות שהועלו מראש — תמונות, קבצי PDF או קבצי קוד. תמיד העלה דרך `upload-attachment` תחילה; אל תעצור תוכן קובץ בתוך ההודעה
`designs`	`DesignRequestData[]`	`[]`	הפניות עיצוב

פלט — { fileId, screenIds }. העבר כל screenId ל-get-screen-image כדי לצפות בתוצאות.

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

`regenerate-design`

עשה מחדש מסכים קיימים מאפס או עם וריאציה של סגנון. דורש לפחות screenId אחד בתוך targets. חוסמות עד שהייצור מסתיים או פוקע בזמן (180 שניות). קלט

פרמטר	סוג	ברירת מחדל	תיאור
`fileId`	`uuid`	—	קובץ יעד
`message`	`string`	—	טקסט פרומפט
`targets`	`uuid[]` (min 1)	—	screenIds של מסכים להחליף
`operationVariant`	`"different_layout" \| "different_style" \| "from_scratch"`	—	וריאציה סגנון אופציונלית
`designs`	`DesignRequestData[]`	`[]`	הפניות עיצוב (מתוקנות באופן אוטומטי)

פלט — { fileId, screenIds }. העבר כל screenId ל-get-screen-image כדי לצפות בתוצאות.

`expand-design`

הוסף מסכים עוקבים לעיצוב קיים. דורש לפחות screenId אחד בתוך targets ו-operationVariant חובה. חוסמות עד שהייצור מסתיים או פוקע בזמן (180 שניות). קלט

פרמטר	סוג	ברירת מחדל	תיאור
`fileId`	`uuid`	—	קובץ יעד
`message`	`string`	—	טקסט פרומפט
`targets`	`uuid[]` (min 1)	—	screenIds של מסכים להרחיב מ
`operationVariant`	`"next_screen" \| "error_state" \| "empty_state" \| "web_version" \| "mobile_version" \| "tablet_version" \| "mobile_ios_version" \| "mobile_android_version"`	—	חובה — סוג מסך עוקב ליצור
`designs`	`DesignRequestData[]`	`[]`	הפניות עיצוב (מתוקנות באופן אוטומטי)

פלט — { fileId, screenIds }. העבר כל screenId ל-get-screen-image כדי לצפות בתוצאות.

`edit-design`

שנה מסכים קיימים דרך פרומפט. דורש לפחות screenId אחד בתוך targets. חוסמות עד שהייצור מסתיים או פוקע בזמן (180 שניות). קלט

פרמטר	סוג	ברירת מחדל	תיאור
`fileId`	`uuid`	—	קובץ יעד
`message`	`string`	—	הוראות המתארות את העריכות להחלה
`targets`	`uuid[]` (min 1)	—	screenIds של מסכים לעריכה
`operationVariant`	`"dark_theme" \| "light_theme" \| "make_pretty"`	—	קיצור סגנון אופציונלי
`attachments`	`AttachmentRequestData[]` (max 5)	`[]`	הוספות שהועלו מראש. תמיד העלה דרך `upload-attachment` תחילה
`designs`	`DesignRequestData[]`	`[]`	הפניות עיצוב (מתוקנות באופן אוטומטי)

פלט — { fileId, screenIds }. העבר כל screenId ל-get-screen-image כדי לצפות בתוצאות.

`upload-attachment`

העלה קובץ לשימוש כהוספה ב-create-new-design או edit-design. מחזיר { id, path, type, mimeType } — העבר אובייקט זה ישירות למערך attachments. שני מצבים: מצב 1 — מסך לפי מזהה העבר screenId ו-fileId. השרת מביא את מצב המסך מהמסד נתונים ועיצוב אותו כתמונה.

פרמטר	סוג	תיאור
`fileId`	`uuid`	קובץ המכיל את המסך (חובה)
`screenId`	`uuid`	מסך לעיצוב

מצב 2 — קובץ חיצוני העבר תוכן קובץ ישירות. קבצים בינאריים חייבים להיות מקודדים base64; קבצי טקסט (כולל קוד מקור) מועברים כמחרוזות UTF-8 פשוטות.

פרמטר	סוג	תיאור
`fileData`	`string`	תוכן קובץ — base64 לבינארי, מחרוזת UTF-8 לטקסט
`fileName`	`string`	שם קובץ מקורי
`mimeType`	`"image/jpeg" \| "image/png" \| "image/webp" \| "application/pdf" \| "text/plain" \| "text/javascript"`	סוג MIME. השתמש ב-`text/javascript` לקובצי `.jsx`, `.tsx`, `.js`, `.ts`

גודל קובץ מקסימלי: 3 MB. לתמונות גדולות, העדף image/jpeg על image/png. פלט

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

type הוא "image" לאחסונים של תמונה/PDF ו-"document" לקבצי טקסט/קוד.

כלי צ’אט

`get-chat-history`

קבל את היסטוריית הודעות הצ’אט לקובץ. קלט

פרמטר	סוג	תיאור
`fileId`	`uuid`	מזהה קובץ

פלט — אובייקט JSON עם מערך messages. לכל הודעה יש type ("request" או "response"), author ("human" או "ai"), ו-content_type ("text", "summary", או "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": []
    }
  ]
}

כלי עיצוב

`get-design-guidelines`

קבל את הנחיות העיצוב המאוחסנות לקובץ. קלט

פרמטר	סוג	ברירת מחדל	תיאור
`resourceId`	`uuid`	—	מזהה קובץ
`linkedTo`	`"file"`	`"file"`	סוג משאב

פלט

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

guidelines הוא null אם לא הוגדרו הנחיות.

`update-design-guidelines`

קבע או החלף את הנחיות העיצוב לקובץ. הנחיות מועברות כמחרוזת טקסט פשוטה בפורמט design.md של Google — אל תעצור אובייקט או JSON. השרת מבצע אימות רך ועשוי להחזיר חלק Warnings: בתגובה המפרטת בעיות (מפתחות בלתי מוכרים, צבעים שאינם hex) שהתקבלו אך עלולים להיות מתעלמים על ידי ה-AI. הציג אלה למשתמש. קלט

פרמטר	סוג	ברירת מחדל	תיאור
`resourceId`	`uuid`	—	מזהה קובץ
`designGuidelines`	`string` (min 1)	—	תוכן טקסט גולמי של ההנחיות. חייב להיות מחרוזת פשוטה — לא JSON-encoded
`linkedTo`	`"file"`	`"file"`	סוג משאב

כללי אימות

Frontmatter חייבת להיות פתוחה וסגורה בצורה נכונה
שורות Frontmatter חייבות להיות YAML תקף בסגנון בלוק
גוף ה-Markdown אינו יכול להכיל כותרות סעיף ## כפולות

פלט — "Design guidelines updated successfully", ואולי לאחריו חלק Warnings:.

`delete-design-guidelines`

נקה את הנחיות העיצוב לקובץ. קלט

פרמטר	סוג	ברירת מחדל	תיאור
`resourceId`	`uuid`	—	מזהה קובץ
`linkedTo`	`"file"`	`"file"`	סוג משאב

פלט — "Design guidelines deleted successfully"

כלי חיוב

`get-plan-details`

קבל את התוכנית הנוכחית של המשתמש, סטטוס המנוי והקצאה שנותרה. לא לוקח קלט. פלט

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

הגבולות משתנים לפי תוכנית. קרא לכלי זה לפני קבוצה של ייצורים כדי לבדוק הקצאה זמינה.

​כלי קבצים

​list-files

​get-file

​create-file

​update-file

​delete-file

​כלי מסכים

​list-screens

​get-screen

​add-screen

​get-screen-image

​כלי AI

​create-new-design

​regenerate-design

​expand-design

​edit-design

​upload-attachment

​כלי צ’אט

​get-chat-history

​כלי עיצוב

​get-design-guidelines

​update-design-guidelines

​delete-design-guidelines

​כלי חיוב

​get-plan-details

כלי קבצים

`list-files`

`get-file`

`create-file`

`update-file`

`delete-file`

כלי מסכים

`list-screens`

`get-screen`

`add-screen`

`get-screen-image`

כלי AI

`create-new-design`

`regenerate-design`

`expand-design`

`edit-design`

`upload-attachment`

כלי צ’אט

`get-chat-history`

כלי עיצוב

`get-design-guidelines`

`update-design-guidelines`

`delete-design-guidelines`

כלי חיוב

`get-plan-details`