Para conectar um assistente IA ao MCP ROOTE, adicione o servidor remoto https://mcp.roote.ai/mcp em um aplicativo compatível com MCP Streamable HTTP. O servidor disponibiliza ferramentas para leitura de endereços, mobilidade e serviços próximos.
Este tutorial segue a configuração publicada pela ROOTE e uma verificação de conexão ao servidor. Os nomes dos menus mudam conforme o cliente; a URL, o transporte e o esquema das ferramentas são os elementos a verificar. A lista tools/list do servidor pode evoluir antes da documentação: use as capacidades realmente anunciadas.
Verificar a compatibilidade do cliente
Seu aplicativo deve aceitar um servidor MCP remoto via Streamable HTTP. Um cliente limitado a servidores locais stdio não pode usar essa URL como um comando executável. Verifique também se sua conta permite adicionar servidores personalizados.
Se o aplicativo oferecer um formulário, informe ROOTE como nome e a URL do servidor como endereço. Se aceitar um arquivo no formato mcpServers, a documentação ROOTE sugere esta configuração mínima:
{
"mcpServers": {
"roote": { "url": "https://mcp.roote.ai/mcp" }
}
}Configuração oficial de conexão ROOTE
Escolher acesso anônimo ou autenticado
A documentação prevê acesso anônimo sem cabeçalho Authorization, sujeito à projeção Free e aos limites ativos da API. Para acesso autenticado, use o mecanismo seguro do cliente para enviar seu token no cabeçalho Bearer.
Authorization: Bearer YOUR_API_TOKENYOUR_API_TOKEN é um local a ser substituído na configuração segura do cliente. Não cole o token em conversas, URLs públicas ou artigos. Um token inválido ou revogado não é substituído automaticamente por acesso anônimo.
Confirmar que as ferramentas estão disponíveis
Após conectar, abra a lista de ferramentas do servidor no seu cliente. A documentação ROOTE descreve a sequência initialize, tools/list, depois tools/call; clientes compatíveis normalmente fazem essas operações para você. Use a versão e capacidades anunciadas pelo servidor.
O servidor expõe geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions e services_nearby. A ausência dessas ferramentas indica um problema de conexão, descoberta ou uma evolução do serviço. Sempre confira a lista anunciada pelo servidor. Journey e Departures ainda não estão expostos.
Realizar a primeira busca reproduzível
Comece com um endereço explícito: “Use ROOTE para buscar 10 rue de Rivoli, Paris, França. Indique os candidatos encontrados e suas coordenadas.” Analise o resultado da ferramenta, não apenas a resposta gerada pelo modelo.
{
"name": "geocode",
"arguments": {
"q": "10 rue de Rivoli, Paris",
"language": "fr",
"country": "FR"
}
}Este bloco ilustra o nome e os argumentos de uma chamada; não é uma requisição HTTP completa. Seu cliente encapsula a chamada MCP. Se vários candidatos plausíveis retornarem, escolha o correto antes de buscar ao redor do ponto.
Você pode então testar o transporte próximo a um ponto de referência em Bordeaux. As coordenadas abaixo são apenas para teste e não provêm do endereço parisiense anterior.
{
"name": "transit_nearby",
"arguments": {
"lat": 44.8416106,
"lon": -0.5810938,
"radius": 600,
"modes": ["bus", "tram"],
"limit": 10
}
}Ler o resultado antes de concluir
Verifique o status, as entidades retornadas, a cobertura, alertas e limites aplicados. Uma resposta parcial pode conter informações úteis. Uma busca vazia não demonstra ausência física de transportes na cidade.
O resultado esperado do teste é uma resposta estruturada ou um erro explícito, não um número pré-definido de paradas. As fontes e a cobertura podem evoluir. Buscar paradas não retorna seus próximos horários.
Resolver erros de conexão
| Sintoma | Verificação útil |
|---|---|
| Nenhuma ferramenta encontrada | URL exata, transporte remoto e autorização do cliente |
| Erro de argumentos | Tipos, valores permitidos e campos do esquema anunciado |
| Erro de autenticação | Validade do Bearer e configuração dos cabeçalhos |
| Limite alcançado | Limites ativos, tempo para retomar e frequência das chamadas |
| Resultado vazio ou parcial | Coordenadas, filtros, raio, cobertura e alertas |
Distinguir resultado vazio de erro da API
Criar um assistente completo a partir de um endereço
Entender o papel de um servidor MCP
Futuro: próximos horários e cálculo de rotas
A ROOTE planeja expandir seu MCP para incluir próximos Departures e cálculo de trajetos. Essas funcionalidades estão por vir e ainda não fazem parte das ferramentas atualmente expostas pelo servidor MCP. Quando estiverem disponíveis, verifique as ferramentas anunciadas pelo servidor, seus argumentos e as informações efetivamente retornadas antes de anunciar um Passage ou uma Journey.
Perguntas frequentes
É obrigatório usar um token?
A documentação prevê acesso anônimo Free. Os limites e capacidades do seu acesso são os aplicados pelo serviço.
Por que meu assistente informa um horário após buscar uma parada?
Uma busca transit_nearby não fornece os próximos horários. Peça ao assistente para citar os dados realmente retornados e alertar para essa ausência.
Posso testar sem criar um aplicativo?
Sim, com um cliente compatível que permita adicionar um servidor remoto e executar suas ferramentas.