MCP — חיבור סוכן AI חיצוני ל-Omniscol
Premiumה-Model Context Protocol (MCP) הוא תקן פתוח המאפשר לעוזר AI התומך ב-MCP להשתמש בכלים עסקיים שחושף שירות חיצוני. Omniscol חושף חלק גדול מה-API שלו כשרת MCP: סוכן AI יכול לשאול את החשבון שלכם באמצעות נקודות הקצה או ההרשאות המותרים של ה-API, לאחר שהזדהה — באמצעות OAuth2, שיטת ההזדהות הרגילה של MCP, או באמצעות טוקן.
מה הסוכן יכול לעשות
סוכן MCP מתאים מאוד לשאלות עיון שבהן המידע נמצא ב-Omniscol:
- "תן לי את שיעור התפוסה של כיתות הלימוד ביחס לשעות הפעילות השבוע."
- "מצא לי כיתת לימוד פנויה בשלושה ימי שני באוקטובר באותה משבצת זמן של שעתיים."
- "כמה שעות הוראה העביר יוסי מזרחי בשנת הלימודים הנוכחית?"
- "מהם כל שיעורי המתמטיקה של היום?"
- "הצג את המורים שהעבירו פחות מ-70% מהיקף ההוראה שלהם ברבעון הזה."
שאילתות כאלה משלבות בדרך כלל כמה כלים: מערכת השעות, לוחות מחוונים סטטיסטיים, זמינות מחושבת, כרטיסי מורים. הסוכן מתזמר את הקריאות ומנסח את התשובה בשפה טבעית.
הכלים החשופים
שרת ה-MCP בונה את הכלים שלו מנתיבי ה-API של Omniscol שהותרו ל-MCP. נתיבים שהוחרגו במפורש, וכן מודולים טכניים מסוימים (למשל אלה הקשורים להזדהות המשתמשים), אינם הופכים לכלים. הרשימה משקפת אפוא את ה-API החשוף ל-MCP, ולא את כל הנתיבים הפנימיים של היישום. עם זאת, זהו חלק גדול מאוד. יתרה מזו, קיימים כמה נתיבים ייעודיים ל-MCP שאינם בשימוש של Omniscol עצמו. כך הם כלי החיפוש המתקדם שבזכותם טקסט חופשי שמציין ישות ("המורה יוסי מזרחי", "הכיתה ו׳1") מאותר על ידי Omniscol יחד עם המזהה הטכני שלו, ואז משמש לשאילתה מדויקת של הנתונים. כך גם כלים מורכבים שאין להם ב-Omniscol ממשק גרפי, כי הם מתאימים יותר לשיחה עם הסוכן: חיפוש תפוסה וזמינות של ישות, למשל ("מצא לי כיתת לימוד פנויה לשעתיים אחר הצהריים בשלושה ימי שני רצופים", "האם מורה למתמטיקה פנוי בשבוע של 14 באוקטובר לשלוש שעות?").
הכלים מכסים בין היתר:
- המודול ניהול (משתמשים, מקצועות, שנות לימודים, פרמטרים),
- המודול ניהול מערכות שעות (תצורה, אתרים, כיתות לימוד, כיתות, קורסים),
- המודול מערכת שעות (תצוגת תכנון, לוחות מחוונים, חיפושים),
- המודול ניהול היעדרויות (הצהרה, סטטיסטיקות),
- חיפוש גלובלי.
נתיבי הקריאה מתאימים ביותר לשימוש סוכני. ייתכן שבקטלוג יופיעו גם פעולות כתיבה, בהתאם להרשאות הטוקן ול-API הזמין, אך יש להשאיר אותן תחת פיקוח: בקשה ששינתה כמה אובייקטים עסקיים צריכה להיבדק בידי משתמש לפני שמסתמכים עליה.
הפעלת שרת ה-MCP
שרת ה-MCP קיים בחשבונות פרימיום. הכול מתחיל במסך MCP, הנפתח מהמודול ניהול באמצעות הכפתור הגדר: הוא מציג את כתובת השרת ומספק, מוכנים להעתקה, את רכיבי התצורה של הלקוח שלכם.
שיטת ההזדהות הרגילה של MCP היא OAuth2. לקוח תואם (כמו Claude) מתחבר פשוט לכתובת השרת, מגלה בה את תצורת ה-OAuth2 של החשבון, והמשתמש מאשר את הגישה במסך הסכמה: אין צורך לספק דבר מלבד הכתובת. ההיקף שמוענק נגזר מהרשאות החשבון ומהגבלות הנראות שלו. שרת ה-OAuth2 של Omniscol, מסך ניהול הלקוחות שלו ופרטי ההסכמה מתוארים בדף OAuth2 / OIDC (ספק).
ללקוח שאינו תומך ב-OAuth2, אותו מסך מפיק טוקן
(מפתח API, היקף גלובלי או מוגבל למודול, תפוגה,
משתמש משויך לא חובה, הרשאות כתיבה לסימון) ואז מציע, מוכנים להדבקה, את הפורמטים הנחוצים לפי המקרה:
כותרת Authorization: Bearer, בלוק תצורה של
Claude Desktop (הגרסה החינמית) ופקודת פרוקסי מקומי. הטוקן
נשען על מערכת המפתחות המתוארת בדף Omniscol API.
שיטות עבודה מומלצות לאבטחה
- הזדהות OAuth2 — נוחה יותר ועדיפה כשהסוכן שלכם תומך בה (Claude בגרסה בתשלום).
- טוקן ייעודי ל-AI — צרו טוקן עם תווית
משמעותית (
סוכן AI — Claude desktop) שתוכלו לבטל בעת הצורך. - היקף מינימלי — בטוקן API, בחרו רק את נקודות הקצה של ה-API הנחוצות. בטוקן OAuth, הגבילו את ה-scopes לצורך האמיתי.
- יומני פעילות (logs) — קריאה מופיעה ביומנים המשויכים לטוקן כאשר הנתיב הנקרא מתועד ביומן. היומנים מתעדים את הקריאה; הם אינם שומרים לא את פרטי הנתונים שהוחזרו ולא את תוכן הבקשה הניתן לשחזור.
- הגבלות נראות — הסוכן רואה את מה ש-Omniscol מחזיר לו. אם הגדרתם הגבלות נראות מחמירות לתפקיד של הטוקן, הן חלות.
מדריך
חיבור Claude ל-Omniscol
הדרך המומלצת היא הזדהות OAuth2: מחברים את Claude לשרת ה-MCP לפי כתובתו, בלי לטפל בטוקן.
-
הפעילו את שרת ה-MCP בחשבון ה-Premium שלכם והעתיקו את כתובתו (בדרך כלל
https://votre-ecole.omniscol.com/mcp). מסך ה-MCP (המודול ניהול, הכפתור הגדר) מציג אותה, עם כפתור העתקה. -
הוסיפו את Omniscol כמחבר ב-Claude. בהגדרות המחברים של Claude, הוסיפו מחבר מותאם אישית והדביקו את כתובת שרת ה-MCP של Omniscol.
-
אשרו את הגישה. Claude מפנה אתכם למסך ההסכמה של Omniscol: התחברו ואשרו את הגישה. ההיקף שמוענק נגזר מהרשאות החשבון שלכם ומהגבלות הנראות, אם יש.
-
הכלים מופיעים ב-Claude, שקורא להם כשהבקשה שלכם מתאימה לכך.
-
בדיקה ראשונה: "כמה שעות הוראה העביר יוסי מזרחי השנה?" — Claude משלב את הנתונים הנגישים ועונה בשפה טבעית.
שיטה חלופית באמצעות טוקן. ללקוח MCP שאינו תומך
ב-OAuth2, הפיקו טוקן ייעודי ממסך ה-MCP (תווית משמעותית,
נקודות קצה מוגבלות לצורך האמיתי, הרשאות כתיבה מסומנות
במפורש) והעבירו אותו בכותרת Authorization: Bearer.
מסך ה-MCP מספק את בלוק התצורה המתאים. העדיפו
OAuth2 ברגע שהלקוח שלכם תומך בו.