Pentru a conecta un asistent IA la MCP ROOTE, adaugă serverul îndepărtat https://mcp.roote.ai/mcp într-o aplicație compatibilă cu MCP Streamable HTTP. Serverul oferă instrumente de lectură pentru adrese, mobilitate și servicii în apropiere.
Acest tutorial urmează configurarea publicată de ROOTE și verificarea conexiunii la server. Denumirile meniurilor pot varia în funcție de client; URL-ul, transportul și schema instrumentelor sunt elementele de verificat. Lista tools/list a serverului poate evolua înaintea documentației: folosiți capabilitățile efectiv anunțate.
Verifică compatibilitatea clientului
Aplicația ta trebuie să accepte un server MCP îndepărtat prin Streamable HTTP. Un client limitat la servere locale stdio nu poate folosi acest URL ca o comandă executabilă. Verifică de asemenea dacă contul tău permite adăugarea de servere personalizate.
Dacă aplicația oferă un formular, inserează ROOTE ca nume și URL-ul serverului ca adresă. Dacă acceptă un fișier în format mcpServers, documentația ROOTE oferă această configurație minimă:
{
"mcpServers": {
"roote": { "url": "https://mcp.roote.ai/mcp" }
}
}Configurare oficială de conectare ROOTE
Alege acces anonim sau autentificat
Documentația prevede un acces anonim fără antet Authorization, supus planului Free și limitelor active ale API-ului. Pentru acces autentificat, folosește mecanismul securizat al clientului pentru a trimite tokenul tău în antetul Bearer.
Authorization: Bearer YOUR_API_TOKENYOUR_API_TOKEN este un loc rezervat pentru a fi înlocuit în configurația securizată a clientului. Nu lipi tokenul într-o conversație, URL public sau articol. Un token invalid sau revocat nu este înlocuit automat cu acces anonim.
Confirmă disponibilitatea instrumentelor
După conectare, deschide lista de instrumente a serverului în clientul tău. Documentația ROOTE descrie secvența initialize, tools/list apoi tools/call; clienții compatibili efectuează în mod normal aceste schimburi automat. Folosește versiunea și capabilitățile anunțate de server.
Serverul expune geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions și services_nearby. Lipsa acestor instrumente indică o problemă de conexiune, descoperire sau o schimbare a serviciului. Verificați întotdeauna lista anunțată de server. Journey și Departures nu sunt încă expuse.
Realizează o primă căutare reproductibilă
Începe cu o adresă explicită: „Folosește ROOTE pentru a căuta 10 rue de Rivoli, Paris, Franța. Indică candidații găsiți și coordonatele lor.” Examinează rezultatul instrumentului, nu doar răspunsul redactat de model.
{
"name": "geocode",
"arguments": {
"q": "10 rue de Rivoli, Paris",
"language": "fr",
"country": "FR"
}
}Acest bloc ilustrează numele și argumentele unui apel; nu este o cerere HTTP completă. Clientul tău încadrează apelul MCP. Dacă se întorc mai mulți candidați plauzibili, alege-l pe cel corect înainte de a căuta în jurul punctului.
Poți apoi testa transportul în jurul unui punct de referință în Bordeaux. Coordonatele de mai jos sunt pentru test și nu pretind a proveni de la adresa pariziană anterioară.
{
"name": "transit_nearby",
"arguments": {
"lat": 44.8416106,
"lon": -0.5810938,
"radius": 600,
"modes": ["bus", "tram"],
"limit": 10
}
}Citește rezultatul înainte de a concluziona
Verifică starea, entitățile returnate, acoperirea, avertismentele și limitele aplicate. Un răspuns parțial poate conține informații utile. O căutare goală nu demonstrează absența fizică a transporturilor în oraș.
Rezultatul așteptat al testului este un răspuns structurat sau o eroare explicită, nu un număr prestabilit de stații. Sursele și acoperirea pot varia. Căutarea stațiilor nu returnează următoarele plecări ale acestora.
Soluționează erorile de conectare
| Simptom | Verificare utilă |
|---|---|
| Niciun instrument descoperit | URL exact, transport îndepărtat și autorizarea clientului |
| Eroare de argumente | Tipuri, valori permise și câmpuri din schema anunțată |
| Eroare de autentificare | Valabilitatea Bearer și configurarea antetelor |
| Limită atinsă | Limite active, timp de reluare și frecvența apelurilor |
| Rezultat gol sau parțial | Coordonate, filtre, rază, acoperire și avertismente |
Distinge un rezultat gol de o eroare API
Creează un asistent complet pornind de la o adresă
Înțelege rolul unui server MCP
În curând: plecări următoare și calcul rută
ROOTE intenționează să extindă MCP-ul cu Departures și Journey. Aceste funcții sunt viitoare și nu fac încă parte din instrumentele expuse de serverul MCP. La disponibilitate, verificați instrumentele anunțate de server, argumentele și informațiile efectiv returnate înainte de a anunța un pasaj sau un traseu.
Întrebări frecvente
Este obligatoriu un token?
Documentația prevede acces anonim Free. Limitele și capabilitățile accesului tău rămân cele aplicate de serviciu.
De ce asistentul meu anunță un orar după căutarea unei stații?
Căutarea transit_nearby nu oferă plecări următoare. Cere asistentului să redea datele efectiv returnate și să semnaleze această lipsă.
Se poate testa fără să creez o aplicație?
Da, cu un client compatibil care permite adăugarea unui server îndepărtat și executarea instrumentelor acestuia.