התקנה בכל סוכן

המרקטפלייס AviMYB/mybusiness-plugins מציע שתי גרסאות. בחרו גרסה אחת:

גרסה	מזהה	חיבור והרשאות
MyBusiness OAuth	mybusiness-oauth	MCP כלול בחבילה. כניסה לחשבון בדפדפן; הרשאות המשתמש והתפקיד שלו.
MyBusiness App ID וטוקן	mybusiness-implementor	אותם סקילים. App ID וטוקן API מעניקים גישה מלאה למערכת; דרך הזנת הפרטים תלויה בלקוח.

מקור: https://github.com/AviMYB/mybusiness-plugins.git, ענף main. הוספת המרקטפלייס אינה מתקינה את הפלאגין ואינה מאמתת גישה לנתונים.

מדריך התקנה מצולם ב-Codex · מדריך התקנה מצולם ב-Claude Code בדסקטופ

ל-OAuth אין צורך להפיק טוקן API. סעיף הפקת הפרטים הבא מיועד למסלול הטוקן בלבד.

הפקה עצמית, שני הערכים על אותו מסך.

1. ב‑CRM: החץ שליד שם המשתמש (פינה שמאלית עליונה) ← סביבת פיתוח / Development environment. נפתחת לשונית חדשה.
2. בסרגל הצד: Databases ← בסיס הנתונים שלכם (בדרך כלל DB for MyBusiness).
3. לשונית Settings — הכרטיס הראשון הוא Application Id, עם כפתור Copy.
4. מתחתיו טבלת API Keys: + Add Key ← שם ← Save ← רענון המסך ← העתקה.

מה המפתח נותן: כל טבלה וכל רשומה, כולל _User, בלי קשר לתפקידים והרשאות; הפעולות נרשמות בשם Master, לא בשם אדם. התייחסו אליו כמו לסיסמה. היתרון היחיד על Master Key: ביטול נקודתי מיידי בסמל הפח שבעמודת Revoke, בלי לגעת בשום דבר אחר. פירוט: אימות והרשאות.

1. באפליקציית Claude עברו ללשונית Code, בחרו סביבת Local ותיקיית עבודה.
2. פתחו + → Plugins → Browse plugins → Add → Add marketplace → Add from a repository.
3. בחרו AviMYB/mybusiness-plugins ולחצו Sync. אם המרקטפלייס כבר קיים, חזרו לקטלוג.
4. חפשו mybusiness ולחצו Add לצד Mybusiness oauth או Mybusiness implementor. הפעילו גרסה אחת בלבד.
5. ב-OAuth פתחו Connectors → MyBusiness. כאשר Connect פעיל, השלימו כניסה בדפדפן.

זמינות החיבור: בממשק המצולם במדריך, Connect אינו פעיל ולא מופיע טופס App ID וטוקן. התקנת הסקילים אינה משלימה את הגישה לנתונים. פנו לתמיכה לקבלת מסלול שתואם את גרסת Claude; אין להזין סודות בצ׳אט ואין להסתמך על טופס שאינו מוצג.

מדריך התקנה מצולם ב-Codex · מדריך התקנה מצולם ב-Claude Code בדסקטופ

1. פתחו Plugins → Add → Add a marketplace.
2. הזינו את כתובת המאגר בשדה Source, את main בשדה Git ref, והשאירו Sparse paths ריק.
3. בקטלוג Personal התקינו את הגרסה שבחרתם.
4. במסלול OAuth פתחו MCPs → From plugins → MyBusiness → Authenticate והשלימו כניסה בדפדפן.
5. במסלול הטוקן הוסיפו MCP אישי דרך MCPs → Add server, מסוג Streamable HTTP ובכתובת https://mcp.mbapps.co.il/.

Headers: Key	Value
X-Parse-Application-Id	Application ID של המערכת
X-Parse-API-Key	טוקן API

השאירו Bearer token env var ו-Headers from environment variables ריקים ולחצו Save. פרטי החיבור האישיים מוגדרים בלקוח, ולא בקובצי הפלאגין.

מדריך התקנה מצולם ב-Codex · מדריך התקנה מצולם ב-Claude Code בדסקטופ

לקוח MCP שאינו מתקין תוספים יכול להתחבר לכתובת השרת דרך מסך ההגדרות שלו. תמיכה בכותרות אישיות, OAuth ושמירת סודות תלויה בלקוח. בחיבור טוקן נדרשות שתי הכותרות שפורטו לעיל; בחיבור OAuth יש להשלים כניסה והרשאות.

OAuth והרשאות משתמש

OAuth מחבר את הסוכן לחשבון דרך הדפדפן. החיבור לשרת https://mcp.mbapps.co.il/ אינו דורש כותרות App ID או API Key במסלול הזה. גילוי ההרשאות נעשה דרך /.well-known/oauth-protected-resource ו-/.well-known/oauth-authorization-server; השרת מפרסם PKCE S256 ו-refresh_token.

אם ההתחברות נכשלת לפני פתיחת הדפדפן, פנו לתמיכה עם נוסח השגיאה ושם הלקוח. כשל רישום או callback הוא שלב נפרד מהרשאות MCP של משתמש שכבר התחבר. ב-Claude, כפתור Connect שאינו פעיל אינו חיבור שהושלם.

מדריך התקנה מצולם ב-Codex · מדריך התקנה מצולם ב-Claude Code בדסקטופ

בחיבור OAuth הסוכן פועל בהרשאות המשתמש המחובר, בכפוף לתפקיד ולהרשאות הטבלאות. בממשק האדמין פתחו User Settings → MCP Permissions, אפשרו Read / Create / Update לפי הצורך ולחצו Apply. ההרשאות כפופות גם לחבילת המנוי.

כלים מתקדמים אינם פתוחים כברירת מחדל ב-OAuth. בקשו מ-MyBusiness לפתוח אותם לאדמין. לאחר הפתיחה נדרשים תפקיד Admin והרשאת Edit pages and schema. בחיבור App ID וטוקן API יש גישה מלאה למערכת המחוברת, ואין צורך בשלב הפתיחה הנוסף של OAuth.

סטטוס ירוק אינו הוכחה. השרת עונה ל‑initialize ומחזיר רשימת כלים מלאה (67 כלים) גם בלי אימות; רק tools/call נאכפת, ובלי כותרות היא מחזירה HTTP 403 עם Authorization header is required. לקוח יכול להיראות מחובר, להציג את כל הכלים, ולהיכשל בקריאת הנתונים הראשונה.

#	הקריאה	תשובה תקינה	מה זה מוכיח
1	Usage-Guide	טקסט ההוראות של השרת	התעבורה עובדת ואתם מדברים עם שרת MyBusiness
2	Get-Current-User	המשתמש שהתחבר · או הזהות הסינתטית {"objectId":"Master","username":"Master",…}	האימות עובד — ובאיזה מצב אתם
3	Get-Schema (בלי פרמטרים)	אובייקט שהמפתחות שלו הם שמות הטבלאות	הגעתם לבסיס נתונים אמיתי — הקריאו למשתמש 3–4 שמות טבלה לאישור

Get-Current-User הוא כל המבחן: אובייקט משתמש אמיתי ⇒ מצב התחברות, מודע‑הרשאות; username: "Master" ⇒ Application Id + API Key ברמת master. במצב הזה הכלי מחזיר רשומה סינתטית שה‑objectId שלה הוא המחרוזת Master — אל תשתמשו בה כ‑Pointer ל‑_User.

כתבו רק אחרי שהמשתמש אישר שזה בסיס הנתונים הנכון.

פתחו שיחה חדשה ובקשו, למשל: “תקים לי מודול ניהול ספקים עם דף רשימה ודשבורד”. הסקילים נטענים אוטומטית לפי ניסוח הבקשה. “תחבר אותי למערכת שלי” מפעיל את myb-p-getting-started.

מה אתם רואים	מה זה אומר	התיקון
Authorization header is required (HTTP 403, JSON‑RPC -32000)	הקריאה הגיעה בלי אישורים בכלל — השדות ריקים, או שהתוסף לא נטען מחדש אחרי מילוי. קורה גם ל‑Usage-Guide	בדקו את פרטי החיבור במסך MCP של הלקוח ופתחו שיחה חדשה. ב-Claude השתמשו רק במסלול הגדרה זמין; ראו את המדריך המצולם.
Permission denied for action find on class … על כל טבלה, ו‑Usage-Guide עדיין עובד	פרטי הגישה שגויים: שגיאת הקלדה, מפתח שבוטל, מפתח מבסיס נתונים אחר — או המפתח הנכון תחת שם כותרת שגוי	העתיקו מחדש; ודאו שהכותרת היא X-Parse-API-Key ולא X-Parse-Master-Key; פתיחת שיחה חדשה או הפעלה מחדש של האפליקציה
Failed to get admin session with master key מ‑Get-Current-User, או Error: no user מ‑Get-Schema	אותה סיבה בדיוק — פרטי גישה שגויים, נוסח שונה מכלי לכלי	כנ“ל
Error: Not Found מ‑Get-Triggers בלבד	מגבלה ידועה של חיבור API Key — לא בעיית פרטי גישה	ראו התיבה בשלב 3
invalid_token	קיים token של התחברות אבל הוא נדחה — פג, בוטל, או הונפק למערכת אחרת	מסך הגדרות MCP / Connectors ← השרת ← אימות מחדש
לשונית ההתחברות מסתיימת ב‑403	בקשת ההתחברות נדחתה; יש לבדוק את פרטי השגיאה ולא להסיק שזו בהכרח תקלה ב-callback.	פנו לתמיכה עם השגיאה ושם הלקוח. לחלופת טוקן זמינה ראו מדריך Codex.
אין כלי MyBusiness בכלל	השרתים של התוסף לא נטענו — הותקן באמצע סשן, או שהקונפיגורציה השתנתה	פתיחת שיחה חדשה או הפעלה מחדש של האפליקציה או הפעלה מחדש; ודאו ב‑מסך הגדרות MCP / Connectors שהשרתים מופיעים
Permission denied על טבלה אחת בלבד	החיבור תקין, אבל ההרשאות של אותה טבלה לא כוללות את המשתמש — או שהטבלה נוצרה זה עתה ואין לה הרשאות כלל	ראו ניהול, מינוח ומכירות
שני סטים זהים של כלים	גם השרת של התוסף וגם שרת שרשמתם ידנית מחוברים	כבו את המיותר ב‑מסך הגדרות MCP / Connectors
הכלים עונים — אבל מהמערכת הלא נכונה	יותר מחיבור אחד פעיל, או שהאישורים שייכים לבסיס נתונים אחר	השאירו בדיוק שרת MyBusiness אחד פעיל; Get-Schema ואישור מול המשתמש
תוצאות ריקות במקום שבו יש נתונים	Get-Data מחזיר 5 שורות כברירת מחדל — תשובה קטומה נראית כמו טבלה קטנה	תמיד להעביר limit במפורש

• מפתח אחד לכל לקוח או מטרה; ביטול נקודתי שווה משהו רק אם המפתחות אינם משותפים. התקרה: עד 5 מפתחות לבסיס נתונים.
• בטלו ביציאה של אדם, בחשד, ובלוח זמנים קבוע.
• לעולם אל תדביקו מפתח לצ’אט, לקריאת שירות, למייל או ל‑repository.
• עובדים על מערכת של מישהו אחר? הוא מייצר את המפתח, והוא מבטל אותו בסיום.
• שם הכותרת קובע: שרת ה‑MCP מקבל את המפתח כ‑X-Parse-API-Key. תחת X-Parse-Master-Key הוא נחשב לפרטי גישה שגויים.

• אינדקס 24 הסקילים — מה הותקן לכם עכשיו
• עבודה בטוחה עם סוכן על מערכת חיה — לפני הכתיבה הראשונה לייצור
• שרת ה‑MCP — הפרוטוקול והכלים
• אימות והרשאות