# Como conectar um assistente IA ao MCP ROOTE?

> Conecte um assistente ao MCP ROOTE: URL do servidor, configuração HTTP, primeira busca, leitura dos resultados e solução de erros.

Source: https://www.roote.ai/pt/guides/como-conectar-um-assistente-ia-ao-mcp-roote/
Language: pt
Author: ROOTE

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](https://doc.roote.ai/roote-mcp/connect-roote-mcp)

## 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_TOKEN
```

YOUR_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](https://www.roote.ai/pt/guides/sem-resultados-ou-erro-api-como-diferenciar/)

[Criar um assistente completo a partir de um endereço](https://www.roote.ai/pt/guides/como-criar-um-assistente-que-encontre-mobilidade-ao-redor-de-um-endereco/)

[Entender o papel de um servidor MCP](https://www.roote.ai/pt/guides/o-que-e-um-servidor-mcp-e-para-que-serve/)

## 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.