דוגמה — חיבור לקוח MCP

שרת ה-MCP חושף כלים לסוכני AI. בחרו OAuth באמצעות חשבון משתמש, או חיבור App ID וטוקן עם כתובת שרת ושתי כותרות. קובץ קונפיגורציה אינו נדרש כאשר הלקוח מציע מסך הגדרות.

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

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

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

Claude Code בדסקטופ

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 בדסקטופ

Codex בדסקטופ

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/.

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

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

חיבור 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.

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

שלוש קריאות, בסדר הזה:

Get-Current-User הוא כל המבחן: אובייקט משתמש אמיתי ⇒ מצב התחברות, מודע‑הרשאות. Master (או User name not found) ⇒ מצב Application Id + API Key ברמת master, כלומר שום דבר לא מגן על הנתונים חוץ מכם.

הפרמטרים כאן מגיעים מסכימת הכלים החיה של השרת (tools/list). הסכימה גוברת על כל מקור אחר, כולל על העמוד הזה. המפתחות של where ו‑data הם שמות השדות עצמם, ו‑{"IsAccount":true} עובר. הלקוח מטמין את הסכימה בפתיחת החיבור; אם היא נראית לא מסונכרנת, הפעילו אותו מחדש.

Instructions for using MyBusiness MCP tools. LLM should start with this prompt!!

בלי פרמטרים. הקריאה הראשונה של סוכן בכל סשן: מחזירה את מפת טבלאות המערכת, כללי מודל הדפים, מבני התנאים ותחביר ה‑placeholders.

Get information about the current authenticated user

בלי פרמטרים.

Count records in a table matching the specified conditions

Retrieve records from a table

Get the schema of the database. If a class name is provided, returns the schema of the class. If no class name is provided, returns the schema of all classes.

לקוח MCP הוא JSON‑RPC 2.0 מעל HTTP. הרצת הקריאה ידנית מפרידה בין “הלקוח לא מוגדר נכון” ל“האישורים לא תקפים”:

curl -sS -X POST https://mcp.mbapps.co.il/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "X-Parse-Application-Id: $MB_APP_ID" \
  -H "X-Parse-API-Key: $MB_API_KEY" \
  -d '{
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {
          "name": "Count-Data",
          "arguments": { "table": "Accounts", "where": { "IsAccount": true } }
        }
      }'

התשובה של קריאת כלי ב‑MCP היא תמיד תוכן טקסטואלי בתוך result:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": { "content": [ { "type": "text", "text": "{\"count\":24}" } ] }
}

הטקסט הוא JSON קטן, {"count":N}, ולא מספר חשוף.

• במסלול הטוקן בלבד: ה‑API Key מופיע עם Created Date אחרי רענון, וה‑Name שלו נשמר (אחרי Save)
• המפתח הודבק תחת X-Parse-API-Key (ולא תחת X-Parse-Master-Key)
• הלקוח נטען מחדש אחרי שינוי ההגדרה
• Usage-Guide מחזיר טקסט
• Get-Current-User מחזיר משתמש, ואתם יודעים אם אתם ב‑Master או בזהות אישית
• Count-Data על טבלה אמיתית שה‑CLP שלה סגור מחזיר מספר
• המשתמש אישר שזהו בסיס הנתונים הנכון — לפני הכתיבה הראשונה
• במסלול הטוקן בלבד: קובץ שמכיל את המפתח אינו בתוך repository
• יש בדיוק חיבור MyBusiness אחד פעיל

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