אינטגרציה · MCP

בסיס הידע שלך, זמין לכל דבר שמדבר MCP.

נקודת קצה אחת בפרוטוקול Model Context Protocol. חמישה כלים, כותרת אחת, ואין מזהה אתר להעביר. המפתח קובע איזה אתר הקורא רואה, ולכן אין במה לטעות.

הבעיה

בסיס הידע עונה לאתר שלך ולא לשום דבר אחר.

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

האינטגרציה

הפרוטוקול עצמו, לא עוד ממשק שצריך לעטוף.

לקוח מתחבר לנקודת קצה אחת עם מפתח האתר שלך וקורא ל-tools/list. השרת מחזיר כל כלי, את התיאור שלו ואת ה-JSON-Schema לארגומנטים, כך שהלקוח מגדיר את עצמו. הגילוי הוא חלק מהפרוטוקול, ולכן אין מסמך נפרד שעלול להתיישן בשקט.

  1. query_knowledge_base - תשובה המבוססת על התוכן המאונדקס של האתר, נספרת במכסת השאילתות בדיוק כמו שאלה באתר.
  2. list_documents - מה מאונדקס, עם הסטטוס ומספר הקטעים של כל מסמך. קריאה בלבד ואינו נמדד.
  3. add_knowledge - הוספת זוג שאלה ותשובה ישירות, למקרה שהתשובה נמצאת אצל עובד ולא בעמוד.
  4. ingest_url ו-ingest_sitemap - אינדוקס של עמוד אחד, או של כל העמודים במפת אתר XML. כתובות פרטיות ומקומיות נדחות, ולכן אי אפשר לכוון אף אחד מהם למשאב פנימי.
  5. אף כלי אינו מקבל מזהה אתר. הלקוח והאתר נקבעים מהמפתח בלבד, ולכן אי אפשר להגיע לשוכר אחר על ידי שינוי ארגומנט: אין ארגומנט לשנות.
יישום

ארבעה צעדים, אין מה להתקין.

  1. בממשק הניהול של SLAtech, צרו מפתח לאתר שברצונכם לחשוף.
  2. השאירו את ההרשאה query ללקוח שרק קורא, או הוסיפו ingest אם עליו גם לכתוב.
  3. הפנו את הלקוח לנקודת הקצה ושלחו את המפתח בכותרת X-Api-Key.
  4. קראו ל-tools/list. הלקוח מגלה את כל השאר בעצמו.

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

תאימות

כל לקוח שמדבר בפרוטוקול.

נקודת הקצה מדברת בפרוטוקול Model Context Protocol מעל Streamable HTTP, ולכן היא אינה קשורה ללקוח של ספק אחד. אם נוח לכם לקרוא ישירות, זה JSON-RPC מעל HTTP וכותרת אחת, ואין צורך בספרייה כלל.

  • Any MCP client: התחברות עם כתובת נקודת הקצה ומפתח האתר
  • Direct JSON-RPC: אין צורך בספרייה, POST אחד לכל קריאה
  • Agencies: המפתח בוחר איזה בסיס ידע של לקוח עונה
  • Legacy manifest API: GET /v1/mcp/manifest עדיין עובד עבור אינטגרציות שנבנו עליו
עלות

נמדד במדדים משלו.

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

מוכנים לתת לכלים שלכם לשאול את בסיס הידע?

נקודת קצה אחת, מפתח אחד, ולקוח שמגדיר את עצמו.