התיעוד למפתחים

התיעוד למפתחים

כל מה שצריך כדי לחבר מערכת חיצונית, דף נחיתה או סוכן AI ל‑MyBusiness CRM — עם דוגמאות קוד שרצות.

התחלה מהירה — 5 דקותטפסים מהאתר (getlead)

base URLsכתובות הבסיסהעתקה

# REST API
https://api.mbapps.co.il/parse

# Cloud Functions (not under /parse)
https://api.mbapps.co.il/functions/{appId}/{fn}

# MCP
https://mcp.mbapps.co.il/

שימו לב ש‑Cloud Functions אינן מתחת ל‑/parse — זו טעות נפוצה שמחזירה 404. הפירוט: פונקציות צד שרת.

שלוש שכבות אינטגרציה — איזו מהן שלכם?

השכבה	כתובת	אימות	מתי משתמשים בה
טפסים מהאתר	/functions/{appId}/getlead	בלי מפתח סודי — ה‑appId שבנתיב הוא מה שקובע (הכותרת X-Parse-Application-Id נהוגה אבל לא נאכפת בשרת)	דף נחיתה, טופס יצירת קשר, טופס הרשמה: כל מקום שבו הקוד רץ בדפדפן של גולש אנונימי
REST API	/parse/classes/{Table}	Master Key / API Key / Session Token	סנכרון והעברת נתונים בין מערכות (ETL), שרת ביניים, אפליקציה פנימית
MCP	https://mcp.mbapps.co.il/	API Key או OAuth 2.1	סוכני AI, עוזרים בשפה חופשית, אוטומציות מבוססות מודל שפה (LLM)

כלל הזהב של האבטחה

ה‑Application Id הוא מזהה ציבורי, ומותר לחשוף אותו ב‑JavaScript בדפדפן. ה‑Master Key וה‑API Key הם סיסמאות לכל בסיס הנתונים: הם עוקפים כל הרשאה, וחייבים להישאר בצד שרת בלבד. טופס בדף נחיתה לעולם לא צריך אותם; בשביל זה קיימות נקודות הקצה getlead ו‑web2table.

מה תמצאו כאן

• /parse/classes/{Table}Master Key · API Key

  REST API

  ה‑API המלא מעל Parse Server: יצירה, קריאה, עדכון ומחיקה של רשומות בכל טבלה, שאילתות ועימוד (pagination), batch, סיכומי נתונים (אגרגציות), סכימות, משתמשים וקבצים.

• /functions/{appId}/getleadApplication Id only

  טפסים מהאתר

  שתי נקודות קצה ייעודיות — getlead ו‑web2table — שנועדו להיקרא ישירות מדף נחיתה, בלי master key ובלי SDK.

• mcp.mbapps.co.il67 tools · OAuth 2.1

  שרת MCP

  67 כלים ברשימה החיה של השרת. איתם Claude, ChatGPT וכל לקוח MCP אחר שואלים, מנתחים ופועלים במערכת — תחת ההרשאות של המשתמש.

• mybusiness-implementor22 skills · Agent Plugins 1.0

  פלאגין לסוכני AI

  mybusiness-implementor — התוסף הרשמי בקוד פתוח שהופך סוכן AI למיישם של המערכת. 22 סקילים, תקן Agent Plugins 1.0.

התחלה לפי משימה

• אני רוצה לחבר טופס בדף נחיתה/forms/getlead/

  getlead — לכידת ליד לטבלת Accounts. קוד מוכן, זיהוי כפילויות אוטומטי, בלי סודות בדפדפן.

• אני רוצה ליצור רשומה בטבלה כלשהי/forms/web2table/

  web2table — יוצר שורה בכל טבלת יעד (הרשמה לקורס, פנייה, הזמנה) ומקשר אותה לאיש קשר.

• אני רוצה למשוך נתונים למערכת אחרת/api/queries/

  שאילתות — סינון, מיון, עימוד שעומד בטבלה שממשיכה להשתנות, ואגרגציות.

• אני רוצה שסוכן AI יעבוד מול המערכת/ai/mcp/

  שרת ה‑MCP הרשמי — חיבור, הרשאות, ושתי קבוצות הכלים: כלי נתונים וכלי פלטפורמה.

לפני הקריאה הראשונה — ארבעה עמודי יסוד

השאלות שחוזרות בכל אינטגרציה, ושעדיף לענות עליהן פעם אחת מראש.

• לאיזו מערכת אני מחובר?/start/environments/

  אפליקציית ה‑CRM מול סביבת הפיתוח, ארבעת הדומיינים, ולמה חיבור אחד = מערכת אחת.

• לאיזו טבלה אני כותב?/start/tables/

  Accounts, Sales, Cases, Tasks, Activities, טבלאות ה‑lookup וטבלאות המערכת — עם השדות שאינטגרציה נוגעת בהם.

• באיזה פורמט לשלוח את השדה?/start/data-types/

  Pointer, Date, File, Array — וטבלת ההמרה בין REST, טפסי web2* ושכבת ה‑MCP. העמוד שמונע את ‘200 אבל השדה ריק’.

• הלקוח אמר ‘פרויקטים’ — איזו טבלה זו?/start/glossary/

  מילון עברית↔אנגלית לכל הישויות והמצבים, ומנגנון התוויות והמינוח שמאחוריו.

שכבת ה‑AI

• כלי הנתונים של MCP/ai/mcp/data/

  שאילתה, ספירה, אגרגציה, יצירה ועדכון של רשומות — ומגבלת ברירת המחדל שמפילה סוכנים (limit 5).

• כלי הפלטפורמה של MCP/ai/mcp/tool-index/

  סכימות, עמודים, תצוגות טבלה, טריגרים, חוקי טופס, משתמשים, תפקידים והרשאות, תפריטים ודוחות — כל כלי בשרת בטבלה אחת.

• הסקילים של הפלאגין/ai/plugin/

  mybusiness-implementor — 22 הסקילים שהופכים סוכן AI למיישם: מה כל סקיל עושה ומתי הוא נטען.