Um servidor MCP é um programa que torna ferramentas e informações acessíveis a uma aplicação de inteligência artificial compatível com o Model Context Protocol. Um assistente pode assim pesquisar um endereço, consultar dados de mobilidade ou ler um recurso externo durante uma conversa.
Para o ROOTE, o interesse é concreto: responder a « Onde encontrar uma bicicleta perto deste endereço? » a partir de uma busca geográfica e das informações retornadas, ao invés de somente com a memória do modelo.
Assistente, cliente e servidor: quem faz o quê?
| Elemento | Papel | Exemplo em mobilidade |
|---|---|---|
| Aplicação host | Gerencia a conversa e as conexões | A aplicação na qual você faz sua pergunta |
| Cliente MCP | Comunica-se com um servidor segundo o protocolo | Descobre as ferramentas ROOTE e envia seus argumentos |
| Servidor MCP | Expõe ferramentas e devolve seus resultados | ROOTE busca locais ou serviços |
| Modelo IA | Interpreta a solicitação e formula a resposta | Explica os resultados e seus limites |
O servidor não substitui o modelo. Ele dá acesso a uma operação definida, com entradas e uma saída estruturadas. A aplicação host decide como usar essas capacidades e pode pedir validação do usuário.
Arquitetura oficial do Model Context Protocol
As ferramentas MCP tornam uma solicitação executável
Uma ferramenta possui um nome, uma descrição e um esquema de argumentos. O assistente deve respeitar esse esquema: uma busca por proximidade precisa de coordenadas e filtros válidos, não de um texto enviado arbitrariamente a qualquer ferramenta.
O protocolo distingue também recursos, que fornecem contexto, e prompts, que oferecem modelos de interação. Cada servidor publica as capacidades que efetivamente suporta; a presença de MCP não significa que todas estão disponíveis.
Exemplo: encontrar uma bicicleta perto de um endereço
O percurso começa pela resolução do endereço. Se várias cidades ou locais correspondem, o assistente pede uma precisão. Depois usa as coordenadas escolhidas para buscar estações ou veículos do modo bicicleta e resume os resultados úteis.
Uma estação situada a 250 metros pode ser apresentada como próxima geograficamente. Essa distância não implica automaticamente um tempo de caminhada. Da mesma forma, um número de bicicletas observado não reserva um veículo para o usuário.
O que o MCP ROOTE oferece
O servidor MCP ROOTE expõe as ferramentas geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions e services_nearby. Elas abrangem pesquisas geográficas, mobilidades compartilhadas, locais de transporte, interrupções e alguns serviços urbanos. A lista tools/list do servidor é a referência para as capacidades disponíveis.
Journey e Departures não fazem parte deste MCP V1. Encontrar um ponto não permite, por si só, anunciar um próximo ônibus. É necessária outra capacidade documentada para obter partidas.
Inventário oficial das ferramentas MCP ROOTE
O que o MCP não garante
O protocolo não garante cobertura mundial completa, nem dados sempre atualizados, nem resposta exata do assistente. Essas propriedades dependem das fontes, do contrato de cada ferramenta e da forma como a aplicação usa os resultados.
Nomes, descrições e links oriundos de um fornecedor permanecem dados externos. Não devem se tornar instruções para o assistente. Este conserva avisos, atribuições e valores desconhecidos ao invés de transformá-los em certezas.
Escolhendo a solução adequada para seu projeto
Conectando um assistente ao MCP ROOTE
Comparando API e MCP para integração de mobilidade
Construindo um assistente de mobilidade confiável
Em breve: partidas próximas e cálculo de rota
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
MCP é um modelo de inteligência artificial?
Não. É um protocolo que permite a uma aplicação IA comunicar-se com servidores que expõem ferramentas ou contexto.
Um servidor MCP substitui uma API?
Ele pode usar uma API para realizar suas operações. API e MCP podem ser duas interfaces complementares de um mesmo serviço.
O servidor MCP ROOTE permite reservar uma bicicleta?
As ferramentas Data MCP ROOTE são somente leitura. Uma disponibilidade retornada não é uma reserva.