Per connettere un assistente IA al MCP ROOTE, aggiungi il server remoto https://mcp.roote.ai/mcp in un'applicazione compatibile con MCP Streamable HTTP. Il server espone strumenti per la lettura di indirizzi, mobilità e servizi nelle vicinanze.
Questo tutorial segue la configurazione pubblicata da ROOTE e una verifica di connessione al server. Le denominazioni dei menu cambiano a seconda del client; URL, il trasporto e lo schema degli strumenti sono gli elementi da verificare. La lista tools/list del server può evolvere prima della documentazione: usate le capacità effettivamente annunciate.
Verificare la compatibilità del client
La tua applicazione deve supportare un server MCP remoto in Streamable HTTP. Un client limitato ai server locali stdio non può usare questo URL come comando eseguibile. Verifica anche se il tuo account consente l’aggiunta di server personalizzati.
Se l’applicazione offre un modulo, inserisci ROOTE come nome e l’URL del server come indirizzo. Se accetta un file nel formato mcpServers, la documentazione ROOTE propone questa configurazione minima:
{
"mcpServers": {
"roote": { "url": "https://mcp.roote.ai/mcp" }
}
}Configurazione ufficiale di connessione ROOTE
Scegliere accesso anonimo o autenticato
La documentazione prevede un accesso anonimo senza intestazione Authorization, soggetto alla proiezione Free e ai limiti attivi dell’API. Per un accesso autenticato, usa il meccanismo sicuro del client per trasmettere il tuo token in un’intestazione Bearer.
Authorization: Bearer YOUR_API_TOKENYOUR_API_TOKEN è un segnaposto da sostituire nella configurazione sicura del client. Non incollare il token in una conversazione, URL pubblica o articolo. Un token non valido o revocato non viene sostituito automaticamente da un accesso anonimo.
Confermare la disponibilità degli strumenti
Dopo la connessione, apri la lista degli strumenti del server nel tuo client. La documentazione ROOTE descrive la sequenza initialize, tools/list quindi tools/call; i client compatibili effettuano normalmente questi scambi per te. Usa la versione e le capacità annunciate dal server.
Il server espone geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions e services_nearby. La mancanza di questi strumenti indica un problema di connessione, di scoperta o un’evoluzione del servizio. Controllate sempre la lista annunciata dal server. Journey e Departures non sono ancora esposti lì.
Effettuare una prima ricerca riproducibile
Inizia con un indirizzo esplicito: “Usa ROOTE per cercare 10 rue de Rivoli, Paris, France. Indica i candidati trovati e le loro coordinate.” Esamina il risultato dello strumento, non solo la risposta redatta dal modello.
{
"name": "geocode",
"arguments": {
"q": "10 rue de Rivoli, Paris",
"language": "fr",
"country": "FR"
}
}Questo blocco illustra nome e argomenti di una chiamata; non è una richiesta HTTP completa. Il tuo client incapsula la chiamata MCP. Se tornano più candidati plausibili, scegli quello giusto prima di cercare attorno al punto.
Puoi quindi testare il trasporto attorno a un punto di riferimento a Bordeaux. Le coordinate sotto servono per il test e non pretendono di provenire dall’indirizzo parigino precedente.
{
"name": "transit_nearby",
"arguments": {
"lat": 44.8416106,
"lon": -0.5810938,
"radius": 600,
"modes": ["bus", "tram"],
"limit": 10
}
}Leggi il risultato prima di concludere
Verifica lo stato, le entità restituite, la copertura, gli avvertimenti e i limiti applicati. Una risposta parziale può contenere informazioni utili. Una ricerca vuota non dimostra l’assenza fisica di trasporti in città.
Il risultato atteso dal test è una risposta strutturata o un errore esplicito, non un numero predefinito di fermate. Le fonti e la copertura possono evolvere. La ricerca di fermate non restituisce le loro prossime partenze.
Risoluzione degli errori di connessione
| Sintomo | Verifica utile |
|---|---|
| Nessuno strumento scoperto | URL esatta, trasporto remoto e autorizzazione del client |
| Errore negli argomenti | Tipi, valori consentiti e campi dello schema annunciato |
| Errore di autenticazione | Validità del Bearer e configurazione delle intestazioni |
| Limite raggiunto | Limiti attivi, tempo di riposo e frequenza delle chiamate |
| Risultato vuoto o parziale | Coordinate, filtri, raggio, copertura e avvertimenti |
Distinguere un risultato vuoto da un errore API
Creare un assistente completo a partire da un indirizzo
Comprendere il ruolo di un server MCP
In arrivo: prossime partenze e calcolo percorso
ROOTE prevede di estendere il suo MCP alle prossime partenze e al calcolo del percorso. Queste funzionalità sono in arrivo e non fanno ancora parte degli strumenti attualmente esposti dal server MCP. Al momento della loro disponibilità, verificate gli strumenti annunciati dal server, i loro argomenti e le informazioni effettivamente restituite prima di annunciare una corsa o un viaggio.
Domande frequenti
È obbligatorio un token?
La documentazione prevede un accesso anonimo Free. Limiti e capacità del tuo accesso restano quelli applicati dal servizio.
Perché il mio assistente annuncia un orario dopo una ricerca di fermata?
Una ricerca transit_nearby non fornisce le prossime partenze. Chiedi all’assistente di indicare i dati effettivamente restituiti e segnalare questa assenza.
Si può testare senza creare un’applicazione?
Sì, con un client compatibile che permette di aggiungere un server remoto ed eseguire i suoi strumenti.