שרת MCP (סוכני AI)
Joryio הוא שרת MCP. עוזר AI מתחבר אליו עם כניסה, ואז עובד עם סביבת העבודה שלכם: מציג קמפיינים ומסעות, קורא את התוצאות ואת ממצאי בדיקת השיגור, שואל על אירועים, בודק איזה תוכן עובד - וכשאתם מאשרים, יוצר טיוטות קמפיין וסגמנטים שאדם יבדוק.
אין מה להתקין ואין מפתח להעתיק. הסוכן מדבר עם אותו REST API ציבורי המתועד תחת API Reference; כל כלי הוא נקודת קצה אחת מתועדת.
הרשאות - גישה של מי מקבל הסוכן?
שלכם. כשאתם מחברים לקוח AI, Joryio שולח אתכם למסך אישור בלוח הבקרה שבו אתם נכנסים בתור עצמכם ומסמנים מה הסוכן רשאי לעשות. מאותו רגע הסוכן פועל בשמכם, מוגבל למה שסימנתם:
- הוא לעולם לא יכול יותר מכם. מסך האישור מציע רק הרשאות שיש לכם, וכל בקשה בודקת גם את ההרשאות שלכם וגם את ההיקפים שסומנו.
- אבדתם הרשאה - כל סוכן שחיברתם מאבד אותה בבקשה הבאה שלו. ניתקתם סוכן תחת הגדרות > כללי - האסימונים שלו מפסיקים לעבוד מיד.
- כל חיבור קשור לסביבת העבודה שבה הייתם כשאישרתם אותו.
- פעולות שהסוכן מבצע נרשמות בשמכם. חברו בתפקיד שאתם מתכוונים אליו: עמית שמחבר את Claude בשמו מעניק את הגישה שלו, לא שלכם.
אין "משתמש סוכן" נפרד ואין מפתח API לנהל. ארגונים שמעדיפים מפתחות עדיין יכולים להשתמש ב-REST API ישירות.
נתוני אנשי קשר כבויים כברירת מחדל
נתוני אנשים הם החלק הרגיש בסביבת עבודה שיווקית, ולכן סוכן AI לא מקבל אותם אלא אם שני דברים מתקיימים:
- מנהל הפעיל את אפשר לסוכני AI לקרוא נתוני אנשי קשר תחת הגדרות > כללי בארגון. עד אז מסך האישור לא מציע את כלי אנשי הקשר כלל.
- האדם שמחבר את הסוכן מחזיק בהרשאה סוכני AI: נתוני אנשי קשר (
agents:contacts, הרשאה ברמת מנהל) ומסמן אותה במסך האישור.
גם אז, שדות שסביבת העבודה מסמנת כמידע אישי חוזרים מוסתרים אלא אם לאותו אדם יש הרשאת PII - אותו כלל שלוח הבקרה וה-REST API מיישמים. מפתח API יכול לשאת את ההרשאה agents:contacts תחת אותו מתג ארגוני.
חיבור לקוח
כתובת המחבר שלכם מוצגת תחת הגדרות > כללי > סוכני AI עם כפתור העתקה. קחו אותה משם במקום להקליד: לכל אזור של Joryio יש כתובת משלו, והכרטיס תמיד מציג את זו של האזור שבו נמצאת סביבת העבודה שלכם. באזור אירופה היא:
https://api-eu1.joryio.com/api/mcp
- Claude (claude.ai, Claude Desktop, Claude Code): הוסיפו מחבר מותאם עם הכתובת, או
claude mcp add --transport http joryio https://api-eu1.joryio.com/api/mcp. - ChatGPT: הוסיפו את הכתובת כמחבר בהגדרות המחברים של האפליקציה.
- Grok (xAI): ראו Grok בהמשך - grok.com וה-CLI של Grok Build מתחברים עם כניסה; ה-API של xAI לא.
- Cursor ולקוחות אחרים שתומכים בשרתי MCP מרוחקים (Streamable HTTP) עם OAuth: הוסיפו את הכתובת; הלקוח רושם את עצמו ופותח את מסך האישור בדפדפן.
- לקוחות שמריצים רק שרתים מקומיים: השתמשו בגשר הקהילתי
npx -y mcp-remote https://api-eu1.joryio.com/api/mcp.
השרת משתמש ב-OAuth 2.1 עם רישום לקוח דינמי ו-PKCE; הגילוי נמצא ב-https://api-eu1.joryio.com/.well-known/oauth-authorization-server. אסימוני גישה תקפים לשעה ומתרעננים בשקט למשך שלושים יום או עד שתנתקו.
Grok (xAI)
- grok.com: פתחו את grok.com/connectors, בחרו New Connector ואז Custom, והדביקו את כתובת המחבר שלכם. Grok מעביר אתכם למסך האישור של Joryio כדי להיכנס ולסמן מה מותר לו לעשות. ב-Grok Business וב-Enterprise מנהל הצוות מגדיר קודם את המחבר בקונסולה של xAI, ואז חברי הצוות מוצאים אותו ברשימת המחברים שלהם.
- Grok Build (ה-CLI
grok):grok mcp add --transport http joryio https://api-eu1.joryio.com/api/mcp. הכניסה נפתחת בדפדפן בפעם הראשונה ש-Grok משתמש בשרת; אפשר גם להתחיל אותה מלשונית ה-MCP תחת/mcps. - ה-API של xAI (כלי MCP מרוחקים בבקשת Responses): לא נתמך. הדרך הזו שולחת אסימון קבוע בכותרת
Authorizationולא יכולה להשלים כניסה, ונקודת הקצה של MCP ב-Joryio מקבלת רק אסימונים שהכניסה שלה מנפיקה - מפתח API נדחה. כדי לגשת ל-Joryio מהקוד שלכם דרך ה-API של xAI, קראו ל-REST API עם מפתח API מתוך כלי פונקציה (function tools) משלכם.
מה מסך האישור מציע
| קבוצה | היקפים | מה הסוכן יכול לעשות |
|---|---|---|
| קריאה | campaigns:read canvas:read segments:read events:read analytics:read | להציג ולקרוא קמפיינים, מסעות, סגמנטים, אירועים, דוחות והקטלוג |
| יצירת טיוטות | campaigns:write segments:write events:track | ליצור טיוטות קמפיין וסגמנטים לבדיקה שלכם; לרשום אירועים |
| נתוני אנשי קשר | users:read users:write agents:contacts | לחפש ולקרוא אנשים, לעדכן מאפיינים - רק כשהמתג הארגוני פעיל |
מסומן כברירת מחדל: מה שהלקוח ביקש, או קבוצת הקריאה.
כלים
| כלי | מה הוא מחזיר | נקודת קצה |
|---|---|---|
list_campaigns | קמפיינים לפי סטטוס, ערוץ או שם | GET /campaigns |
get_campaign | קמפיין אחד עם הגרסאות והטירגוט שלו | GET /campaigns/:id |
get_campaign_stats | נשלחו, נמסרו, נפתחו, הוקלקו, המרות | GET /campaigns/:id/stats |
get_campaign_failure_reasons | כשלי מסירה לפי קוד ספק | GET /campaigns/:id/failure-reasons |
get_campaign_launch_review | חוסמים והמלצות | GET /campaigns/:id/launch-review |
get_campaign_performance | קמפיינים מדורגים לפי המרות תוספתיות, כל אחד לפי יעד ההמרה שלו | GET /campaigns/performance |
get_journey | מסע אחד במלואו: טריגר, צמתים עם ההודעות שלהם, קשתות | GET /journeys/:id |
list_journeys, get_journey_stats, get_journey_launch_review | אותו דבר למסעות | GET /journeys… |
list_segments, get_segment_size | קהלים שמורים וגודלם | GET /segments… |
list_contact_imports | ייבואי אנשי קשר לפי שם קובץ ותאריך, למסנן סגמנט "הגיע מייבוא" (דורש users:read, לא agents:contacts) | GET /users/import/sources |
query_events, list_recent_events, get_event_trend | אירועים בטווח, חוקר האירועים, מגמה | GET /events/query, GET /analytics/events, POST /analytics/events/trend |
get_active_users_now, get_content_performance | ספירה חיה, איזה תוכן עובד | GET /analytics/… |
list_products, get_catalog_stats | הקטלוג ובריאותו | GET /catalog/… |
create_campaign_draft | יוצר קמפיין כטיוטה - תמיד טיוטה, לא משנה מה הסוכן מבקש | POST /campaigns |
create_segment | יוצר סגמנט שמור | POST /segments |
track_event | רושם אירוע לאדם | POST /users/track |
search_contacts, get_contact, update_contact | אנשים (קבוצת נתוני אנשי קשר בלבד) | GET /users/search, GET /users/:id, PUT /users/by-user-id/:id |
כלי מופיע רק כשהחיבור נושא את ההיקף שלו.
מה הסוכן לעולם לא יכול לעשות
אין כלי ששולח, מתזמן, מפעיל, מאשר, שולח מחדש, מייצא או מוחק משהו, ואין כלי שמנהל מפתחות API או חברי צוות - לא משנה מה סימנתם. טיוטה שהסוכן יוצר ממתינה בלוח הבקרה לאדם שיבדוק, יריץ בדיקת שיגור וישלח.
ניהול חיבורים
הגדרות > כללי > סוכני AI מציג את הסוכנים המחוברים בשמכם, עם ההיקפים של כל אחד ומתי השתמשו בו לאחרונה. נתק מבטל אותו מיד. מנהלים מוצאים את מתג נתוני אנשי הקשר הארגוני באותו כרטיס.
מגבלות
הבקשות נספרות מול מגבלות הקצב הרגילות של ה-API בסביבת העבודה; הסוכן מתבקש להמתין כשהוא נתקל באחת. כל קריאת כלי פגה אחרי 30 שניות. רשימות מחולקות לעמודים עם אותם פרמטרים limit ו-page / offset כמו ב-REST API.