שרת MCP: חיבור עוזר בינה מלאכותית

שרת ה-MCP של WbizTool מאפשר לעוזר בינה מלאכותית לעבוד עם סביבת העבודה שלכם. אפשר לבקש ממנו דברים כמו "אילו הודעות נכשלו היום, ולמה?", "השהה את התזכורת על שכר הדירה" או "שלח את שעות הפתיחה החדשות שלנו לחמשת הלקוחות האלה", והוא משתמש בחשבון ה-WbizTool שלכם כדי לעשות אותם.

השרת מדבר ב-Model Context Protocol ‏(MCP), שמוכר ל-Claude Code, ל-Cursor, ל-VS Code ולכלי בינה מלאכותית אחרים. מאחורי הקלעים, כל פעולה היא קריאה ל-API v2 שנעשית עם מפתח ה-API v2 שלכם, ולכן המפתח קובע מה העוזר יכול לראות ולעשות.

מה העוזר יכול לעשות#

העוזר רואה רק את הכלים שהמפתח מאפשר (ראו הרשאות):

הוא גם מציע שלוש הנחיות (prompts) מוכנות: סיכום יומי, הודעות שנכשלו וניסוח הכרזה.

הוא לא יכול לחבר מספר חדש (זה נשאר במרכז הבקרה), להעלות קבצים, לנהל Webhooks או לקרוא את תיבת ההודעות שלכם ב-Unibox.

1. יצירת מפתח לעוזר#

1. פתיחת הכרטיס מפתחות API v2

   ב-WbizTool, עברו אל הגדרות ← מפתחות API ומצאו את הכרטיס מפתחות API v2.

2. שימוש בהגדרה המוכנה לעוזר בינה מלאכותית

   לחצו על יצירת מפתח v2, ואז על לעוזר בינה מלאכותית. כך נוצר מפתח קריאה בלבד שיכול לקרוא הודעות ומספרים, ותוקפו פג אחרי 90 יום – דרך בטוחה להתחיל: העוזר יכול להסתכל, אבל לא יכול לשלוח או לשנות שום דבר.

3. הרשאה לשלוח, רק אם אתם רוצים

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

4. העתקת המפתח

   המפתח (wbz_live_…) מוצג פעם אחת. שמרו אותו במשתנה סביבה במחשב שלכם, למשל WBIZTOOL_API_KEY – ואף פעם אל תדביקו אותו בקובץ שאתם משתפים או מעלים ב-commit.

export WBIZTOOL_API_KEY=wbz_live_…

2. הוספת השרת לכלי הבינה המלאכותית שלכם#

claude mcp add --transport http wbiztool https://mcp.wbiztool.com/mcp \
  --header "Authorization: Bearer ${WBIZTOOL_API_KEY}"

{
  "mcpServers": {
    "wbiztool": {
      "type": "http",
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${WBIZTOOL_API_KEY}" }
    }
  }
}

{
  "mcpServers": {
    "wbiztool": {
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${env:WBIZTOOL_API_KEY}" }
    }
  }
}

{
  "inputs": [
    { "type": "promptString", "id": "wbiztool-key", "description": "WbizTool API v2 key (wbz_live_…)", "password": true }
  ],
  "servers": {
    "wbiztool": {
      "type": "http",
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${input:wbiztool-key}" }
    }
  }
}

• Claude Code: הריצו את הפקודה פעם אחת (הוסיפו --scope project כדי לשתף אותה עם פרויקט דרך .mcp.json; הקובץ מכיל את ${WBIZTOOL_API_KEY}, ולא את המפתח עצמו).
• Cursor: שימו את ההגדרה ב-~/.cursor/mcp.json, או ב-.cursor/mcp.json בתוך פרויקט.
• VS Code: שימו את ההגדרה ב-.vscode/mcp.json. ‏VS Code מבקש את המפתח פעם אחת ושומר אותו באחסון הסודות שלו.

אחר כך שאלו את העוזר משהו כמו "מה החשבון שלי ב-WbizTool?" – הוא אמור לענות עם השם והתוכנית של סביבת העבודה שלכם.

3. איך השליחה נשארת בטוחה#

• כל שליחה מוצגת קודם בתצוגה מקדימה. כשאתם מבקשים הודעה, העוזר מקבל קודם תצוגה מקדימה מ-WbizTool – מאיזה מספר היא תצא, למי, הטקסט המדויק, הקובץ אם יש, ומתי – ועדיין לא נשלח כלום. הוא מונחה להציג לכם את התצוגה המקדימה ולחכות לאישור שלכם. רק אז הוא שולח, בדיוק את מה שראיתם.
• ניסיון חוזר אף פעם לא שולח פעמיים. אם העוזר חוזר על שליחה שאושרה (למשל אחרי timeout), ‏WbizTool עונה עם ההודעה שכבר נשלחה.
• המפתח הוא הגבול הקשיח. מפתח קריאה בלבד לא יכול לשלוח בכלל. מפתח בלי שליחת הודעות אפילו לא רואה את כלי השליחה, ומפתח שמוגבל לחלק מהמספרים לא יכול להשתמש באחרים. גם המגבלות של WbizTool עצמה חלות: 60 בקשות בדקה לכל מפתח, ולכל היותר 1,000 הודעות ביום לכל מספר.
• טקסט מאנשים אחרים מסומן כנתונים. הודעות, שמות וקבצים שהגיעו מבחוץ מגיעים לעוזר מסומנים כלא מהימנים, והוא מונחה לעולם לא לבצע הוראות שכתובות בתוכם.
• אין סודות בתשובות. קודי QR וקודי צימוד אף פעם לא מוצגים, ורשימות לא כוללות קישורים לקבצים.
• ביטול תוקף בכל רגע. ביטול התוקף של המפתח בדף הגדרות ← מפתחות API עוצר את העוזר מיד.

פרטיות#

כשאתם מחברים עוזר, מה שהוא קורא מ-WbizTool (הודעות, שמות ומספרים שאתם מאפשרים למפתח לראות) נשלח לספק של העוזר הזה – למשל Anthropic עבור Claude, או OpenAI עבור ChatGPT – ומטופל לפי התנאים שלו. שרת ה-MCP של WbizTool עצמו לא שומר כלום: הוא מעביר כל בקשה ל-API v2 ורושם בלוג באיזה כלי השתמשו, אבל אף פעם לא את טקסט ההודעות או את המפתח שלכם. תנו למפתח רק את הגישה שהעוזר צריך.

פתרון בעיות#

מדריכים קשורים#

• סקירה של API v2
• מפתחות API
• הודעות ב-API v2
• אפליקציות ואינטגרציות