כלי קבצים

שני כלים ומשאב אחד. הכלים מעלים וקוראים; המשאב הוא הדרך המועדפת לקרוא קובץ שכלי אחר הפנה אליו.

Upload-Public-File

מעלה קובץ ומחזיר URL ציבורי. כל הפרמטרים ארוזים באובייקט file יחיד.

הפרמטר	טיפוס	חובה	המשמעות
file.name	String	✔	שם הקובץ, כולל סיומת — logo.png, contract.pdf, app.js
file.mimeType	String	✔	סוג התוכן — image/png, application/pdf, text/javascript, text/css. חייב להתאים לתוכן (ראו “סוגי קבצים”)
file.data	String	✔	התוכן ב‑base64 חשוף, בלי קידומת
file._id	String		מזהה קובץ קיים (file._id מתשובת העלאה קודמת באותה מערכת) ⇒ עדכון במקום, אותו URL בדיוק (עם אותו name). _id שאינו קיים ⇒ הקריאה נתלית — ראו למטה
file.keepName	Boolean		ברירת מחדל true — השם נשמר כפי שהוא. false — השרת מייחד אותו
file.cacheControl	String		ברירת מחדל max-age=86400; נשלח כ‑cache-control של ה‑URL הציבורי
file.codeFile	Boolean		true מסמן קובץ קוד שניתן לעריכה בעורך הקוד של הפלטפורמה

JSON

{ "file": {
    "name": "logo.png",
    "mimeType": "image/png",
    "data": "iVBORw0KGgoAAAANSUhEUgAAA…",
    "keepName": true } }

התשובה:

JSON

{ "success": true,
  "filePath": "https://static.mbapps.co.il/2026/08/<account>/<site>/logo.png",
  "massage": "",
  "file": { "_id": "6a8adf473cd0a41edaecb05e", "name": "logo.png", "type": "image/png",
            "size": 70, "path": "https://static.mbapps.co.il/…/logo.png",
            "cacheControl": "max-age=86400", "createdAt": "…" } }

ה‑URL הציבורי הוא filePath, על הדומיין static.mbapps.co.il (CDN), לא על api.mbapps.co.il. המזהה לעדכונים עתידיים הוא file._id. כשל עסקי חוזר כ‑{"success":false,"message":"…"} עם HTTP 200, בלי Error:.

סוגי קבצים

הכלי בודק גם את התוכן, לא רק את הסיומת: PNG, PDF אמיתי (מתחיל ב‑%PDF), SVG, .txt, .js ו‑.css עולים; .exe, .bin, .json, PDF שתוכנו טקסט, ו‑PNG שהוכרז כ‑text/plain נדחים עם {"success":false,"message":"File type not supported"}. .html נדחה במערכת ללא חבילה עם "Free sites cannot upload this file" — מגבלת מנוי, לא סוג. base64 לא תקין אינו נדחה: הקובץ נשמר עם תוכן זבל.

ציבורי פירושו ציבורי — בלי אימות, בלי הרשאה

ה‑URL שחוזר נגיש לכל מי שמחזיק בו, בלי התחברות ובלי בדיקת הרשאה. אין ACL ואין תפוגה.

לא מעלים לכאן מסמכים אישיים: תעודות זהות, חוזי לקוח, דוחות פיננסיים, או כל דבר שכתוב בו שם של אדם. לקובץ מוגן: שדה PrivateFile על הרשומה, שהגישה אליו מתווכת דרך ההרשאות שלה. ראו קבצים ב‑REST.

בסוכן: שער אישור על הכלי. “תעלה את הקובץ כדי שאוכל לשלוח אותו” הוא רצף שמסתיים בדליפה.

עדכון במקום — _id וה‑URL היציב

שולחים _id של קובץ קיים, והתוכן מוחלף בלי שה‑URL משתנה:

JSON

{ "file": { "_id": "file0123456789", "name": "app.js",
            "mimeType": "text/javascript",
            "data": "Ly8gdjIKY29uc29sZS5sb2coJ2hlbGxvJyk7",
            "codeFile": true } }

הדפוס המלא לפריסת JS/CSS לדף:

1. Upload-Public-File { codeFile: true, cacheControl: "max-age=60" } → URL + _id   (פעם אחת)
2. Set-Page-Settings  { jsFile / cssFile: URL } → הדף מצביע לקובץ   (פעם אחת)
3. כל שינוי עתידי: Upload-Public-File עם אותו _id (ואותו name)
   → אין נגיעה בדף, אין שינוי URL — אבל ה-CDN מתרענן רק לפי cacheControl

מגבלה ידועה — _id שאינו קיים מתלה את הקריאה ללא תשובה

_id שאינו קיים — גם מחרוזת שאינה hex וגם hex תקין של 24 תווים — לא מחזיר שום דבר: לא שגיאת כלי, לא שגיאת HTTP; הלקוח נתקע עד ל‑timeout שלו, בעוד קריאות אחרות עונות רגיל. שמרו את ה‑_id יחד עם ה‑URL, והגדירו timeout בצד הלקוח: _id ישן (קובץ שנמחק, או ממערכת אחרת) יתקע את הסוכן בלי רמז.

עדכון ב‑_id שומר על אותו _id ואותו URL, והמקור מתעדכן. _id עם name אחר יוצר URL חדש (הישן ממשיך להגיש את הגרסה הקודמת). keepName: false מייחד את השם — הסיומת נגזרת מה‑MIME, כך ש‑text/javascript מקבל .javascript (הקובץ מוגש עם content-type נכון).

מגבלה ידועה — דריסה (שם זהה או _id) מצליחה, וה‑URL ממשיך להגיש את הגרסה הישנה מה‑CDN

העלאה חוזרת באותו שם בלי _id מחזירה success: true, את אותו filePath, ו‑_id חדש, ודורסת את המקור בשקט. ה‑CDN (CloudFront) ממשיך להחזיר את העותק הישן (x-cache: Hit from cloudfront) עד לפקיעת cacheControl, 24 שעות כברירת מחדל. אותו דבר בעדכון ב‑_id: אין invalidation.

לפריסת קוד: cacheControl קצר כבר בהעלאה הראשונה, או ?v=N בכתובת שבדף בכל פריסה. לקבצים חד‑פעמיים: keepName: false.

Get-File-Content

מחזיר תמונה ששמורה כ‑Parse File, כבלוק image (base64 + mimeType) שהמודל יכול לראות.

הפרמטר	טיפוס	חובה	המשמעות
fileUrl	String	✔	כתובת הקובץ. חייבת להיות על api.mbapps.co.il או siteadmin.mbapps.co.il, ב‑https

JSON

{ "fileUrl": "https://api.mbapps.co.il/parse/files/<APP_ID>/a23e…_photo.png" }

התשובה המוצלחת (על PNG): { "content": [ { "type": "image", "mimeType": "image/png", "data": "iVBORw0…" } ] } — בלי text, ולכן קוד שקורא רק content[0].text יראה תשובה ריקה.

מגבלה ידועה — לא PDF, ולא הקבצים ש‑Upload-Public-File מייצר

PDF באותו דומיין מוחזר עם Error: File type application/pdf is not supported. use the resources template 'get-file' to download the file.; ה‑URL הציבורי שמחזיר Upload-Public-File (על static.mbapps.co.il) — Error: Not Found; כתובת חיצונית (S3, אתר הלקוח, Google Drive) — גם Error: Not Found, לא הודעת דומיין; http:// — Error: Bad Request. הכלי אינו לקוח HTTP כללי, ו“Not Found” אינו אומר שהקובץ לא קיים.

במקום: PDF וכל קובץ שחוזר כ‑resource_link — דרך המשאב get-file (למטה); קובץ ציבורי על static.mbapps.co.il — לקוח HTTP רגיל, בלי אימות; קובץ חיצוני שצריך להיכנס למערכת — Upload-Public-File או Parse Files ב‑REST.

תיאור הכלי עצמו ממליץ להעדיף עליו את המשאב get-file.

המשאב get-file

הפניה לקובץ שמור מגיעה מכלי כפריט MCP מסוג resource_link, עם סכמת URI ייעודית:

file-storage:///api.mbapps.co.il/parse/files/APP_ID/FILE_NAME/TABLE_NAME/OBJECT_ID/PROPERTY_NAME

ה‑URI מקודד את כל השושלת: אפליקציה ← קובץ ← הטבלה, הרשומה והשדה שאליהם הוא מחובר. זה גם המנגנון שמתווך את הגישה לקבצי PrivateFile: הקובץ מוחזק בהקשר של הרשומה, לא כנכס עצמאי.

Get-Data על PriceQuotes אחרי חתימה:

JSON

"SignedPdf": { "type": "resource_link", "name": "price-quote.pdf",
               "uri": "file-storage:///api.mbapps.co.il/parse/files/<APP_ID>/f56f…_price-quote.pdf/PriceQuotes/dWMWAFD9tj/SignedPdf" }

את ה‑URI קוראים דרך תבנית המשאב get-file (מתגלה ב‑resources/templates/list; התבנית: file-storage:///api.mbapps.co.il/parse/files/{APP_ID}/{FILE_NAME}/{TABLE_NAME}/{OBJECT_ID}/{PROPERTY_NAME}). resources/read עם ה‑URI מחזיר contents[0] עם mimeType (application/pdf) ו‑blob — base64 של הקובץ המלא. לקוח MCP שתומך במשאבים פותר אותם ישירות, בלי Get-File-Content; ל‑PDF זו הדרך היחידה.

המצב	מה עושים
כלי החזיר resource_link	פותרים את ה‑URI דרך get-file — הדרך המועדפת, והיחידה ל‑PDF
יש בידכם URL של תמונה ב‑api.mbapps.co.il/parse/files	Get-File-Content
קובץ ציבורי על static.mbapps.co.il, או מחוץ ל‑mbapps	לקוח HTTP משלכם

ה‑URI מכיל את מזהה האפליקציה

file-storage:/// נושא בתוכו את ה‑APP_ID ואת מזהה הרשומה. אל תדביקו אותו לתוך כרטיסי משימה, קריאות תמיכה או מסמכים משותפים — הוא חושף מזהי מערכת של לקוח.

אסימטריית ה-base64

הכלי	מה הוא מצפה לקבל	דוגמה
Upload-Public-File.data	base64 חשוף	iVBORw0KGgoAAA…
Send-WhatsApp-Message.fileBase64	base64 עם קידומת Data‑URI	data:image/png;base64,iVBORw0KGgoAAA…

העלאה → שליחה:   חייבים להוסיף  "data:<mime>;base64,"
שליחה → העלאה:   חייבים להסיר   את אותה קידומת

חסימת ה‑WAF על data:<type>/<subtype>: ‏MCP מוחרג, REST חסום במכוון

כלל ה‑WAF שחוסם גופי בקשה עם התבנית data:<type>/<subtype> חל רק על נקודת ה‑REST (api.mbapps.co.il). ה‑MCP הוא הצרכן הלגיטימי היחיד של Data‑URI (‏fileBase64 שמצפה לתמונה); ב‑REST קבצים עולים ב‑POST /parse/files עם base64 חשוף בגוף ייעודי.

מול mcp.mbapps.co.il גוף עם Data‑URI לא נחסם. ב‑REST: ‏POST עם data:image/png;base64,… בשדה טקסט → 403 HTML; בלי הקידומת → 201. הכלל רגיש לרישיות (data:image/png נחסם, DATA:IMAGE/PNG עבר) ואינו דורש ;base64.

Upload-Public-File.data מצפה ל‑base64 חשוף; קידומת Data‑URI בו היא שגיאת פורמט גם בלי WAF. בסוכן: פונקציית עזר אחת שמנרמלת לשני הכיוונים, ולא העברה ישירה בין הכלים.

מגבלות

המגבלה	הפירוט
אין כלי מחיקה ב‑MCP	אין Delete-File ואין Delete-Data. ב‑REST, DELETE /parse/files/<name> עם Master Key כן מוחק Parse File — אבל לא נמצא מסלול API למחיקת קובץ ציבורי של Upload-Public-File מ‑static.mbapps.co.il. ניקוי אחסון ציבורי הוא משימת אופרציה
גודל קובץ דרך MCP	גוף הבקשה מוגבל לכ‑10MB — אחרי base64 זה כ‑7.5MB קובץ גולמי (7.4MB עובר, 7.6MB ו‑11MB מחזירים HTTP 413 “Payload Too Large” כדף HTML, לא JSON‑RPC). ב‑REST /parse/files התקרה היא 32MB לבקשה (15MB מתקבל, 33MB נדחה ב‑413), ומעליה יש files/signed-url-put/. מדיה כבדה עולה שם, לא מ‑MCP
קליטת טפסים לא מקבלת קבצים	getlead ו‑web2table אינם תומכים בהעלאת קובץ — שדה File בטופס מחזיר 400 ומשאיר רשומות חלקיות. מעלים בנפרד ומקשרים — ראו טפסים מהאתר
העלאה + שיוך הן שתי פעולות	קריסה ביניהן משאירה קובץ יתום שממשיך לתפוס מכסה, ואין שאילתה שמוצאת אותו (Get-Data על Files אינו מחזיר קבצים ציבוריים — הטבלה מיועדת לקבצים שמשויכים לרשומות)

איפה קבצים מופיעים במוצר

המקום	המנגנון
כרטיס רשומה	שדות File / PrivateFile מרונדרים כפקדי העלאה
הצעות מחיר	לוגו מוטמע בתבנית; ה‑PDF שנוצר — כלי הצעות מחיר
WhatsApp	fileBase64 להעלאה מיידית, fileDBName לקובץ ששמור כבר — כלי הודעות
קוד של דפים	Upload-Public-File עם codeFile: true + Set-Page-Settings
מיתוג ומסמכי הנהח“ש	לוגו שמור על הגדרות המערכת, נקרא בעת הפקת מסמך

המשך

• כלי הודעות — שליחת קובץ ללקוח
• כלי הצעות מחיר — הלוגו וה‑PDF
• קבצים ב‑REST — File מול PrivateFile, ושיוך לרשומה
• אינדקס הכלים המלא