MCP — ממשק תכנותי

בנוסף ל-REST, ל-GetMyBot יש ממשק MCP (Model Context Protocol) — הוא מיועד לסוכני בינה מלאכותית ולעוזרים שקוראים כלים, לא מפעילים נקודות קצה ידנית. REST נשאר הממשק הראשי; MCP הוא חלופה נוחה לתרחישים של סוכנים. שמות הכלים, המשאבים והפרומפטים להלן תואמים למה שהשרת מפרסם.

כתובת ואימות

MCP זמין בנקודת הקצה /mcp (תחבורה Streamable HTTP, שיטה POST). האימות — אותו טוקן אישי כמו ל-REST: כותרת Authorization: Bearer mbp_…. אין צורך ליצור טוקנים נפרדים — PAT אחד עובד גם ל-REST וגם ל-MCP. כל כלי דורש את אותו scope כמו נקודת הקצה המקבילה ב-REST; טוקן עם scope * מקנה גישה מלאה. אם ה-scope אינו מספיק — הקריאה נדחית (fail-closed), בדומה ל-REST.

חיבור ל-Claude Code / Cursor

הוסיפו את GetMyBot כשרת MCP מרוחק. דוגמת תצורה (mcpServers) — החליפו את הדומיין והטוקן שלכם:

{
  "mcpServers": {
    "mybot": {
      "url": "https://your-domain/mcp",
      "headers": {
        "Authorization": "Bearer mbp_YOUR_TOKEN"
      }
    }
  }
}

Claude Code: הניחו את הבלוק הזה ב-.mcp.json של הפרויקט או הוסיפו שרת עם הפקודה claude mcp add. Cursor: הוסיפו את אותו בלוק להגדרות MCP (Settings → MCP → Add server). לאחר החיבור הלקוח יקבל את רשימת הכלים, המשאבים והפרומפטים אוטומטית.

כלים לפי דומיין

השרת מפרסם 100 כלים — כיסוי מלא של ה-REST הנגיש ב-PAT. להלן — כלי ו-scope נדרש. שמות בפורמט פועל_שם (snake_case).

בוטים (bots)

  • list_bots — bots:read
  • get_bot — bots:read
  • validate_bot_token — bots:write
  • connect_bot — bots:write
  • update_bot — bots:write
  • delete_bot — bots:write
  • sync_bot — bots:write
  • change_bot_token — bots:write
  • transfer_bot — bots:write
  • get_bot_settings — settings:read
  • update_bot_settings — settings:write

ערוצים ותבניות WhatsApp (bots)

תמיכה רב-ערוצית (Telegram + WhatsApp + VK) זמינה גם דרך MCP. ערוצים ותבניות מוגבלים על ידי ה-scopes המשותפים bots:read / bots:write — אין scope נפרד לערוץ.

  • list_channels — bots:read — רשימת ערוצי הבוט (פלטפורמה tg/wa/vk, external_id, שם, enabled, callback_url).
  • connect_channel — bots:write — חיבור ערוץ WhatsApp או VK (platform + פרטי הזדהות).
  • delete_channel — bots:write — ניתוק ערוץ.
  • list_wa_templates — bots:read — קטלוג תבניות WhatsApp של הערוץ (שם, שפה, סטטוס, קטגוריה, גוף).
  • sync_wa_templates — bots:write — סנכרון מחדש של קטלוג התבניות מ-Meta.
  • create_wa_template — bots:write — יצירת תבנית WhatsApp ושליחתה ל-Meta לבדיקה.
  • update_wa_template — bots:write — עריכת תבנית (בסטטוס APPROVED/REJECTED/PAUSED).
  • delete_wa_template — bots:write — מחיקת תבנית.

ערוצי Telegram מחוברים דרך connect_bot, לא דרך connect_channel — האחרון מטפל רק ב-wa וב-vk. קטגוריות תבניות: MARKETING / UTILITY / AUTHENTICATION. create_wa_template שולח מיד את הטיוטה ל-Meta לבדיקה; הסטטוס משתנה באופן אסינכרוני — קראו אותו מחדש דרך list_wa_templates (רעננו את הקטלוג עם sync_wa_templates במידת הצורך).

העלאת כותרת מדיה של תבנית (תמונה/וידאו/מסמך) דרך MCP אינה נתמכת עדיין — השתמשו בממשק הווב או ב-REST דרך POST /api/bots/{botID}/channels/{channelID}/templates/media.

ריאקציות (reactions)

  • list_reactions — reactions:read
  • get_reaction — reactions:read
  • create_reaction — reactions:write
  • update_reaction — reactions:write
  • delete_reaction — reactions:write
  • import_reactions — reactions:write
  • test_formula — reactions:write
  • reorder_reaction — reactions:write
  • get_reaction_links — reactions:read
  • list_reaction_folders — reactions:read
  • create_reaction_folder — reactions:write
  • update_reaction_folder — reactions:write
  • delete_reaction_folder — reactions:write
  • add_reaction_to_folder — reactions:write
  • remove_reaction_from_folder — reactions:write
  • add_reactions_to_folder — reactions:write

ייבוא דרך import_reactions יוצר ריאקציות אך מדלג על מדיה: בהקשר MCP אין בדיקת פרמיום ומקלט Telegram לקבצים. אם בחבילת SamBot יש תמונות/וידאו/מסמכים — השתמשו בייבוא REST המלא (POST /api/bots/{botID}/reactions/import), הוא מעביר גם מדיה.

שידורים (broadcasts)

  • start_broadcast — broadcasts:write (אופציונלי: paid, אופציונלי: פלח לפי תגיות)
  • get_broadcast — broadcasts:write
  • pause_broadcast — broadcasts:write
  • resume_broadcast — broadcasts:write
  • cancel_broadcast — broadcasts:write

תגיות (labels)

  • list_labels — labels:read
  • create_label — labels:write
  • delete_label — labels:write
  • set_label_favorite — labels:write

קולקציות ורשומות (collections)

  • list_collections — collections:read
  • create_collection — collections:write
  • update_collection — collections:write
  • delete_collection — collections:write
  • list_records — collections:read
  • create_record — collections:write
  • update_record — collections:write
  • delete_record — collections:write

תרחישים (flows)

  • list_flows — flows:read
  • get_flow — flows:read
  • create_flow — flows:write
  • update_flow — flows:write
  • delete_flow — flows:write

אינטגרציות, חיבורים, גישות (integrations)

  • list_integrations — integrations:read
  • get_integration_sheets — integrations:read
  • get_integration_status — integrations:read
  • create_integration — integrations:write
  • update_integration — integrations:write
  • delete_integration — integrations:write
  • rotate_integration_token — integrations:write
  • list_connections — integrations:read
  • create_connection — integrations:write
  • test_connection — integrations:write
  • update_connection — integrations:write
  • delete_connection — integrations:write
  • list_credentials — integrations:read
  • create_credential — integrations:write
  • update_credential — integrations:write
  • delete_credential — integrations:write

מדיה (media)

  • upload_media — media:write
  • get_media — media:write

תבניות (templates)

  • list_templates — templates:read
  • delete_template — templates:write
  • create_template_from_bot — templates:write
  • apply_template — templates:write

מנויים, צ'אטים, דיאלוגים — קריאה (subscribers)

  • list_subscribers — subscribers:read (עימוד offset/limit, מסננים לפי תגיות)
  • list_chats — subscribers:read
  • list_dialogs — subscribers:read
  • read_dialog — subscribers:read
  • send_dialog_message — subscribers:write
  • send_dialog_reaction — subscribers:write
  • transcribe_dialog_message — subscribers:write

סטטיסטיקות ואנליטיקות (stats)

  • get_stats — stats:read
  • get_stats_summary — stats:read
  • get_stats_recent — stats:read
  • get_stats_log — stats:read
  • get_reaction_health — stats:read
  • get_analytics — stats:read
  • get_analytics_chats — stats:read
  • get_funnel — stats:read

חיוב — קריאה (billing)

  • get_balance — billing:read
  • list_tariffs — billing:read
  • get_transactions — billing:read

שליחת הודעות

  • send_message — broadcasts:write — שליחת הודעה בשם הבוט; צריכת היתרה מחושבת אוטומטית לפי בעל הטוקן.

משאבים

מלבד כלים, השרת מחזיר משאבים — ניתן לקרוא אותם כדי לא לנחש מבנים:

  • mybot://openapi.yaml — מפרט OpenAPI מלא (אותו המוחזר ב-/openapi.yaml).
  • mybot://reference — עזר קומפקטי: רשימת כלים עם ה-scope שלהם ומוסכמות (כתובת בסיס, עימוד, פורמט שגיאות, מגבלות).
  • mybot://schemas/reaction, mybot://schemas/trigger, mybot://schemas/action, mybot://schemas/flow, mybot://schemas/collection — סכמות JSON של תצורות. הכי שימושי לייצור נכון של ריאקציות (trigger, תנאים, צ'אטים, פעולות), תרחישים וקולקציות.
  • mybot://bots — רשימה דינמית של הבוטים שלכם (הקשר מהיר ללא קריאת כלי).

פרומפטים

תרחישים מוכנים (פקודות slash בלקוח MCP):

  • setup_autoresponder — הרכבת בוט מגיב אוטומטי (ארגומנטים: בוט, נושא/קבוצת שאלות).
  • segment_broadcast — שידור לפלח תגיות (ארגומנטים: בוט, תגיות, ריאקציה/טקסט).
  • diagnose_reaction — להבין מדוע ריאקציה לא מופעלת (קורא ריאקציה, reaction-health וסדר).
  • import_from_sambot — ביצוע ייבוא חבילת SamBot ואימות התוצאה.
  • weekly_report — סיכום סטטיסטיקות/אנליטיקות הבוט לתקופה.

מתי לבחור MCP ומתי REST

  • כותבים אינטגרציה, סנכרון, סקריפט או לוח בקרה משלכם — קחו REST.
  • מחברים את GetMyBot לעוזר בינה מלאכותית או סוכן שתומך ב-MCP — קחו /mcp.

שני הממשקים עובדים תחת אותו טוקן וכפופים לאותן הרשאות הבעלים. אם לא מצאתם כלי למשימה — נקודת הקצה המקבילה ב-REST תמיד נמצאת בעזר האינטראקטיבי.

המשך