שני דברים
מפתח גישה
נוצר בממשק הניהול תחת API Keys. המפתח קובע איזה אתר הלקוח רואה, ולכן אין מזהה אתר להעביר ואי אפשר להגיע לנתונים של שוכר אחר.
לקוח שמדבר MCP
כל מימוש של Model Context Protocol. אם נוח לכם לקרוא ישירות, זה JSON-RPC מעל HTTP ואין צורך בספרייה כלל.
ארבעה צעדים
צרו מפתח לאתר
בממשק פתחו API Keys, בחרו לקוח ואתר וצרו את המפתח. העתיקו אותו מיד: הוא מוצג פעם אחת בלבד.
החליטו מה מותר למפתח
השאירו את ההרשאה query אם הלקוח רק קורא. הוסיפו
ingest רק אם עליו גם לכתוב לבסיס הידע, מפני
ש-add_knowledge, ingest_url
ו-ingest_sitemap יסרבו בלעדיה.
אל תשתמשו במפתח של הווידג'ט. הוא נמצא בקוד הגלוי של האתר
שלכם וכל אחד יכול לקרוא אותו, ולכן יש לו במכוון
query בלבד.
הפנו את הלקוח לכתובת
הכתובת היא https://api.slatech.ai/mcp, והמפתח נשלח
בכותרת X-Api-Key. מפתח חסר או שגוי נדחה עם
401 לפני שכלי כלשהו רץ.
שאלו מה הוא יודע לעשות
קראו ל-tools/list. השרת יחזיר כל כלי עם התיאור שלו
ועם JSON-Schema לארגומנטים, כך שהלקוח מגדיר את עצמו. הגילוי הוא
חלק מהפרוטוקול, ולכן אין מסמך נפרד שעלול להתיישן.
הכלים
query_knowledge_base
שאלו שאלה וקבלו תשובה המבוססת על התוכן המאונדקס של האתר. נספר במכסת השאילתות בדיוק כמו שאלה באתר עצמו.
list_documents
הצגת מה שמאונדקס עבור האתר, עם הסטטוס ומספר הקטעים של כל מסמך. קריאה בלבד, ואינו נמדד.
add_knowledge
הוספת זוג שאלה ותשובה ישירות. שימושי כשהתשובה נמצאת אצל עובד ולא בעמוד.
דורש ingest.
ingest_url
הבאה ואינדוקס של עמוד אחד. כתובות פרטיות ומקומיות נדחות, ולכן אי אפשר
לכוון את הכלי למשאב פנימי. דורש ingest.
ingest_sitemap
אינדוקס של כל העמודים שמופיעים במפת אתר XML, כולל מפות אינדקס.
כך מכניסים אתר שלם בקריאה אחת. דורש ingest.
מגבלות ומדידה
מדדים נפרדים
קריאות MCP נספרות בנפרד מתעבורת הצ'אט, כך שרואים כמה עולה האינטגרציה והיא לא מתחבאת בתוך נתוני האתר.
120 קריאות בדקה
לכל מפתח. סוכן עובד בפרצים, ולכן התקרה גבוהה בהרבה מזו שנדרשת ללוח
מחוונים. בחריגה מוחזר 429 עם הכותרת
Retry-After.
מפתח אחד, אתר אחד
אף כלי אינו מקבל מזהה אתר. הלקוח והאתר נקבעים מהמפתח בלבד, ולכן אי אפשר להגיע לנתונים של שוכר אחר על ידי שינוי ארגומנט: אין ארגומנט לשנות.
השתמשתם בממשק המניפסט הישן?
GET /v1/mcp/manifest ונקודת ההרצה שלו עדיין עובדים,
ואינטגרציות שנבנו עליהם ממשיכות לפעול. זהו מבנה HTTP פשוט ולא
הפרוטוקול, והפעולות שלו מקבלות מזהה אתר כארגומנט. עדיף להפנות עבודה חדשה
אל /mcp.