איך לחבר עוזר בינה מלאכותית ל-MCP ROOTE?

כדי לחבר עוזר בינה מלאכותית ל-MCP ROOTE, הוסף את השרת המרוחק https://mcp.roote.ai/mcp באפליקציה התומכת ב-MCP Streamable HTTP. השרת מציע כלים לקריאת כתובות, תחבורה ושירותים בסביבה.

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

בדוק תאימות הלקוח

האפליקציה שלך חייבת לקבל שרת MCP מרוחק ב-Streamable HTTP. לקוח שמוגבל לשרתים מקומיים stdio לא יכול להשתמש בכתובת זו כפקודה להרצה. בדוק גם אם החשבון שלך מאפשר הוספת שרתים מותאמים אישית.

אם האפליקציה מציעה טופס, הזן ROOTE בשם ואת כתובת השרת ככתובת. אם היא מקבלת קובץ בפורמט mcpServers, תיעוד ROOTE מציע את ההגדרה המינימלית הבאה:

{
  "mcpServers": {
    "roote": { "url": "https://mcp.roote.ai/mcp" }
  }
}

הגדרת החיבור הרשמית של ROOTE

בחר גישה אנונימית או מאומתת

התיעוד מאפשר גישה אנונימית בלי כותרת Authorization, כפופה לפרויקט Free ולמגבלות הפעילות של ה-API. לגישה מאומתת, השתמש במנגנון המאובטח של הלקוח להעברת הטוקן בכותרת Bearer.

Authorization: Bearer YOUR_API_TOKEN

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

וודא שהכלים זמינים

לאחר החיבור, פתח את רשימת הכלים של השרת בלקוח שלך. תיעוד ROOTE מתאר את הרצף initialize, tools/list ואחר כך tools/call; לקוחות תואמים מבצעים את החליפין האלו אוטומטית. השתמש בגרסה וביכולות שהשרת מציג.

השרת מציג את geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions ו-services_nearby. העדר כלים אלה מעיד על בעיית חיבור, גילוי או שינוי בשירות. תמיד בדוק את הרשימה שמפורסמת על ידי השרת. Journey ו-Departures עדיין אינם מוצגים שם.

בצע חיפוש ראשון שניתן לשחזור

התחל עם כתובת מפורשת: “השתמש ב-ROOTE לחיפוש 10 rue de Rivoli, Paris, France. הצג את המועמדים שנמצאו ואת הקואורדינטות שלהם.” בדוק את תוצאת הכלי, לא רק את התשובה הנוסחתית של המודל.

{
  "name": "geocode",
  "arguments": {
    "q": "10 rue de Rivoli, Paris",
    "language": "fr",
    "country": "FR"
  }
}

בלוק זה ממחיש את השם והארגומנטים של הקריאה; זו אינה בקשת HTTP מלאה. הלקוח שלך עוטף את הקריאה ל-MCP. אם מתקבלים מועמדים רבים, בחר את המתאים לפני חיפוש סביב הנקודה.

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

{
  "name": "transit_nearby",
  "arguments": {
    "lat": 44.8416106,
    "lon": -0.5810938,
    "radius": 600,
    "modes": ["bus", "tram"],
    "limit": 10
  }
}

קרא את התוצאה לפני הסיכום

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

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

פתרון שגיאות חיבור

הבחנה בין תוצאה ריקה לשגיאת API

יצירת עוזר מלא מתוך כתובת

הבנת תפקיד שרת MCP

בקרוב: יציאות הבאות וחישוב מסלול

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

שאלות נפוצות

האם נדרש טוקן?

התיעוד מאפשר גישה אנונימית Free. המגבלות והיכולות שלך נשארות בהתאם לשירות.

מדוע העוזר שלי מציג לוח זמנים לאחר חיפוש תחנה?

חיפוש transit_nearby אינו מספק את היציאות הבאות. בקש מהעוזר לציין את הנתונים שהוחזרו בפועל ולהדגיש היעדרות זו.

האם אפשר לבדוק בלי ליצור אפליקציה?

כן, עם לקוח תואם שמאפשר הוספת שרת מרוחק והרצת הכלים שלו.