Για να συνδέσετε έναν βοηθό AI στο MCP ROOTE, προσθέστε τον απομακρυσμένο διακομιστή https://mcp.roote.ai/mcp σε μια εφαρμογή συμβατή με MCP Streamable HTTP. Ο διακομιστής παρέχει εργαλεία ανάγνωσης για διευθύνσεις, μεταφορές και υπηρεσίες κοντινής περιοχής.
Αυτό το σεμινάριο ακολουθεί τη ρύθμιση που δημοσίευσε η ROOTE και έναν έλεγχο σύνδεσης με τον διακομιστή. Οι τίτλοι των μενού αλλάζουν ανάλογα με τον πελάτη· το URL, η μεταφορά και το σχήμα των εργαλείων είναι τα στοιχεία προς έλεγχο. Η λίστα tools/list του διακομιστή μπορεί να αλλάξει πριν από την τεκμηρίωση: χρησιμοποιήστε τις πραγματικά ανακοινωμένες δυνατότητες.
Ελέγξτε τη συμβατότητα του πελάτη
Η εφαρμογή σας πρέπει να υποστηρίζει έναν απομακρυσμένο διακομιστή MCP με Streamable HTTP. Ένας πελάτης περιορισμένος σε τοπικούς διακομιστές stdio δεν μπορεί να χρησιμοποιήσει αυτό το URL ως εκτελέσιμη εντολή. Επίσης, ελέγξτε αν ο λογαριασμός σας επιτρέπει την προσθήκη προσαρμοσμένων διακομιστών.
Εάν η εφαρμογή παρέχει μια φόρμα, εισάγετε το ROOTE ως όνομα και το URL του διακομιστή ως διεύθυνση. Αν δέχεται αρχείο στο μορφότυπο mcpServers, η τεκμηρίωση του ROOTE προτείνει αυτή τη βασική ρύθμιση:
{
"mcpServers": {
"roote": { "url": "https://mcp.roote.ai/mcp" }
}
}Επίσημη ρύθμιση σύνδεσης ROOTE
Επιλέξτε ανώνυμη ή πιστοποιημένη πρόσβαση
Η τεκμηρίωση προβλέπει ανώνυμη πρόσβαση χωρίς κεφαλίδα Authorization, υπό την προβολή Free και τα ενεργά όρια του API. Για πιστοποιημένη πρόσβαση, χρησιμοποιήστε τον ασφαλή μηχανισμό του πελάτη για να μεταδώσετε το διακριτικό σας σε κεφαλίδα Bearer.
Authorization: Bearer YOUR_API_TOKENYOUR_API_TOKEN είναι θέση που πρέπει να αντικατασταθεί στη ασφαλή ρύθμιση του πελάτη. Μην επικολλάτε το διακριτικό σε συνομιλία, δημόσιο URL ή άρθρο. Ένα άκυρο ή ανακληθέν διακριτικό δεν αντικαθίσταται αυτόματα από ανώνυμη πρόσβαση.
Επιβεβαιώστε ότι τα εργαλεία είναι διαθέσιμα
Μετά τη σύνδεση, ανοίξτε τη λίστα εργαλείων του διακομιστή στον πελάτη σας. Η τεκμηρίωση 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, Παρίσι, Γαλλία. Δείξε τους υποψήφιους που βρέθηκαν και τις συντεταγμένες τους.» Εξετάστε το αποτέλεσμα του εργαλείου, όχι μόνο την απάντηση που έδωσε το μοντέλο.
{
"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
}
}Διαβάστε το αποτέλεσμα πριν καταλήξετε
Ελέγξτε την κατάσταση, τις επιστρεφόμενες οντότητες, την κάλυψη, τις προειδοποιήσεις και τα επιβαλλόμενα όρια. Μία μερική απάντηση μπορεί να περιέχει χρήσιμες πληροφορίες. Μια κενή αναζήτηση δεν αποδεικνύει φυσική απουσία μεταφορικών μέσων στην πόλη.
Το αναμενόμενο αποτέλεσμα της δοκιμής είναι μια δομημένη απάντηση ή μια σαφής ένδειξη σφάλματος, όχι προκαθορισμένος αριθμός στάσεων. Οι πηγές και η κάλυψη ενδέχεται να αλλάζουν. Η αναζήτηση στάσεων δεν επιστρέφει τα επόμενα δρομολόγιά τους.
Επιλύστε τα σφάλματα σύνδεσης
| Σύμπτωμα | Χρήσιμη επαλήθευση |
|---|---|
| Δεν ανιχνεύτηκε κανένα εργαλείο | Ακριβές URL, απομακρυσμένη μεταφορά και εξουσιοδότηση πελάτη |
| Σφάλμα επιχειρημάτων | Τύποι, επιτρεπτές τιμές και πεδία του ανακοινωθέντος σχήματος |
| Σφάλμα ταυτοποίησης | Ισχύς Bearer και ρύθμιση κεφαλίδων |
| Επιτεύχθηκε όριο | Ενεργά όρια, χρόνος επανεκκίνησης και συχνότητα κλήσεων |
| Κενό ή μερικό αποτέλεσμα | Συντεταγμένες, φίλτρα, ακτίνα, κάλυψη και προειδοποιήσεις |
Διαχωρίστε ένα κενό αποτέλεσμα από ένα σφάλμα API
Δημιουργήστε έναν πλήρη βοηθό από μια διεύθυνση
Κατανοήστε το ρόλο ενός διακομιστή MCP
Επερχόμενο: επόμενα δρομολόγια και υπολογισμός διαδρομής
Η ROOTE σκοπεύει να επεκτείνει το MCP της σε επερχόμενες αναχωρήσεις και υπολογισμό διαδρομής. Αυτές οι δυνατότητες είναι μελλοντικές και δεν ανήκουν ακόμη στα εργαλεία που εκθέτει ο διακομιστής MCP. Κατά τη διαθεσιμότητά τους, ελέγξτε τα εργαλεία που ανακοινώνονται από τον διακομιστή, τα ορίσματα τους και τις επιστρεφόμενες πληροφορίες πριν ανακοινώσετε μια διέλευση ή ένα ταξίδι.
Συχνές ερωτήσεις
Απαιτείται οπωσδήποτε ένα διακριτικό;
Η τεκμηρίωση προβλέπει ανώνυμη πρόσβαση Free. Τα όρια και οι δυνατότητες της πρόσβασής σας παραμένουν εκείνα που εφαρμόζει η υπηρεσία.
Γιατί ο βοηθός μου ανακοινώνει ώρα μετά από αναζήτηση στάσης;
Μια αναζήτηση transit_nearby δεν παρέχει τα επόμενα δρομολόγια. Ζητήστε από τον βοηθό να αναφέρει τα πραγματικά επιστρεφόμενα δεδομένα και να επισημάνει αυτήν την απουσία.
Μπορώ να δοκιμάσω χωρίς να δημιουργήσω εφαρμογή;
Ναι, με έναν συμβατό πελάτη που επιτρέπει την προσθήκη απομακρυσμένου διακομιστή και την εκτέλεση των εργαλείων του.