Para conectar un asistente IA al MCP ROOTE, añade el servidor remoto https://mcp.roote.ai/mcp en una aplicación compatible con MCP Streamable HTTP. El servidor expone herramientas para la lectura de direcciones, movilidades y servicios cercanos.
Este tutorial sigue la configuración publicada por ROOTE y una verificación de conexión al servidor. Los nombres de los menús cambian según el cliente; la URL, el transporte y el esquema de las herramientas son los elementos a verificar. La lista tools/list del servidor puede evolucionar antes que la documentación: use las capacidades realmente anunciadas.
Verificar la compatibilidad del cliente
Tu aplicación debe aceptar un servidor MCP remoto mediante Streamable HTTP. Un cliente limitado a servidores locales stdio no podrá usar esta URL como un comando ejecutable. También verifica si tu cuenta permite añadir servidores personalizados.
Si la aplicación ofrece un formulario, introduce ROOTE como nombre y la URL del servidor como dirección. Si acepta un archivo en formato mcpServers, la documentación ROOTE ofrece esta configuración mínima:
{
"mcpServers": {
"roote": { "url": "https://mcp.roote.ai/mcp" }
}
}Configuración oficial de conexión ROOTE
Elegir acceso anónimo o autenticado
La documentación prevé un acceso anónimo sin cabecera Authorization, sujeto a la proyección Free y a los límites activos de la API. Para un acceso autenticado, usa el mecanismo seguro del cliente para enviar tu token en un encabezado Bearer.
Authorization: Bearer YOUR_API_TOKENYOUR_API_TOKEN es un marcador para reemplazar en la configuración segura del cliente. No pegues el token en una conversación, URL pública o artículo. Un token inválido o revocado no se reemplaza automáticamente por acceso anónimo.
Confirmar que las herramientas están disponibles
Después de la conexión, abre la lista de herramientas del servidor en tu cliente. La documentación ROOTE describe la secuencia initialize, tools/list y luego tools/call; los clientes compatibles normalmente realizan estos intercambios por ti. Usa la versión y capacidades anunciadas por el servidor.
El servidor expone geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions y services_nearby. La ausencia de estas herramientas indica un problema de conexión, de descubrimiento o una evolución del servicio. Controle siempre la lista anunciada por el servidor. Journey y Departures aún no están expuestos.
Realizar una primera búsqueda reproducible
Comienza con una dirección explícita: “Usa ROOTE para buscar 10 rue de Rivoli, París, Francia. Indica los candidatos encontrados y sus coordenadas.” Examina el resultado de la herramienta, no solo la respuesta redactada por el modelo.
{
"name": "geocode",
"arguments": {
"q": "10 rue de Rivoli, Paris",
"language": "fr",
"country": "FR"
}
}Este bloque ilustra el nombre y los argumentos de una llamada; no es una solicitud HTTP completa. Tu cliente encapsula la llamada MCP. Si vuelven varios candidatos plausibles, escoge el correcto antes de buscar alrededor del punto.
Luego puedes probar el transporte alrededor de un punto de referencia en Burdeos. Las coordenadas abajo sirven para la prueba y no pretenden provenir de la dirección parisina anterior.
{
"name": "transit_nearby",
"arguments": {
"lat": 44.8416106,
"lon": -0.5810938,
"radius": 600,
"modes": ["bus", "tram"],
"limit": 10
}
}Leer el resultado antes de concluir
Verifica el estado, las entidades devueltas, la cobertura, advertencias y límites aplicados. Una respuesta parcial puede contener información útil. Una búsqueda vacía no demuestra la ausencia física de transportes en la ciudad.
El resultado esperado del test es una respuesta estructurada o un error explícito, no un número predefinido de paradas. Las fuentes y la cobertura pueden evolucionar. La búsqueda de paradas no devuelve sus próximos salidas.
Resolver errores de conexión
| Síntoma | Verificación útil |
|---|---|
| No se descubren herramientas | URL exacta, transporte remoto y autorización del cliente |
| Error de argumentos | Tipos, valores permitidos y campos del esquema anunciado |
| Error de autenticación | Validez del Bearer y configuración de encabezados |
| Límite alcanzado | Límites activos, tiempo de recuperación y frecuencia de llamadas |
| Resultado vacío o parcial | Coordenadas, filtros, radio, cobertura y advertencias |
Diferenciar resultado vacío de error API
Crear un asistente completo a partir de una dirección
Comprender el rol de un servidor MCP
Próximamente: próximas salidas y cálculo de ruta
ROOTE planea ampliar su MCP a los próximos Departures y al cálculo de rutas. Estas funcionalidades están por venir y aún no forman parte de las herramientas actualmente expuestas por el servidor MCP. Al estar disponibles, verifique las herramientas anunciadas por el servidor, sus argumentos y la información efectivamente devuelta antes de anunciar un paso o un Journey.
Preguntas frecuentes
¿Se necesita necesariamente un token?
La documentación prevé un acceso anónimo Free. Los límites y capacidades de tu acceso son los aplicados por el servicio.
¿Por qué mi asistente anuncia un horario tras buscar una parada?
Una búsqueda transit_nearby no ofrece próximas salidas. Pide al asistente nombrar los datos realmente devueltos y señalar esta ausencia.
¿Se puede probar sin crear una aplicación?
Sí, con un cliente compatible que permita añadir un servidor remoto y ejecutar sus herramientas.