Routing24 como servidor MCP
Por Nathan ColeAtualizado
O Routing24 publica um servidor do Model Context Protocol em
https://routing24.ai/mcp. Um assistente que suporta MCP lista as
ferramentas que o Routing24 oferece e as chama. Esta página cobre como uma
chamada é roteada para o seu plano, as 45 ferramentas que o servidor expõe,
o que o app mostra enquanto um assistente conectado trabalha e o que cada
falha significa.
Como uma chamada é roteada para o seu plano
Uma chamada é roteada em três etapas. O trabalho acontece na última:
- O assistente conectado envia a chamada para
https://routing24.ai/mcp. - O servidor a roteia para a sua aba do navegador com sessão iniciada no Routing24.
- A aba executa o trabalho no plano que ela tem aberto e responde.
Três condições decorrem desse roteamento. A maioria das falhas nesta página vem de uma delas:
- Você está com sessão iniciada no Routing24 em um navegador.
- Uma aba
routing24.com/appestá aberta. Qualquer página do app serve. - Você aprovou a conexão uma vez a partir desse navegador. Veja Conectar Claude e ChatGPT.
Um navegador por vez atende a conta. Quando você aprova a conexão em um segundo navegador, o primeiro deixa de responder.
O assistente no app faz o mesmo trabalho pelas mesmas ferramentas. Os dois diferem no que os cerca:
| O assistente no app | Um assistente conectado |
|---|---|
| Abre no app, sem configuração | Conecta-se uma vez com uma URL e uma aprovação |
| Pode acessar o plano, não os seus arquivos ou outros sistemas | Acessa também os seus arquivos, e-mails e outras ferramentas |
| Importa um arquivo que você anexa, salva um conversor, revisa um reparo de endereço | Usa apenas as 45 ferramentas |
| Gasta o orçamento de IA da conta | Gasta o orçamento do seu próprio provedor |
| É executado enquanto o painel está aberto | Precisa de qualquer aba do app aberta, em qualquer página |
O que o Routing24 expõe
Cada ferramenta tem o prefixo routing24_. O vocabulário que um assistente
conectado lê é o vocabulário que o app usa: janelas de horário, capacidades,
turnos, prioridades, etiquetas, pausas, transferências, sequências,
recarregamentos e custos.
Uma ferramenta marcada com read abaixo apenas lê. Ela não pode alterar o plano, e o servidor a declara como tal, que é o critério pelo qual um cliente agrupa suas permissões. Tudo o que não está marcado escreve.
Planos e a conta
| Ferramenta | O que ela faz |
|---|---|
routing24_get_auth_userread | A conta com sessão iniciada à qual um plano salvo pertencerá |
routing24_list_plansread | Os planos salvos: id, nome, carimbos de data e hora, contagens de entidades e qual está carregado |
routing24_load_plan | Carrega um plano salvo pelo id, salvando antes as alterações não salvas do plano substituído |
routing24_new_plan | Inicia um plano vazio novo, substituindo o carregado após salvar suas alterações não salvas |
routing24_save | Persiste o plano e retorna seu link |
routing24_plan_urlread | O link do plano atual |
Leitura do plano de rotas
| Ferramenta | O que ela faz |
|---|---|
routing24_statusread | Progresso mais a visão geral do plano de rotas: totais, custo e estatísticas por rota |
routing24_routeread | As paradas ordenadas de uma rota pelo seu número de rota na tela: ETAs, cargas, esperas e problemas |
routing24_unassignedread | Quais pedidos estão não atribuídos e por quê: ids, diagnósticos e cotações de inserção |
Dados do plano
| Ferramenta | O que ela faz |
|---|---|
routing24_list_stopsread | Lê os pedidos do plano, com paginação e filtros |
routing24_list_vehiclesread | Lê os tipos de veículo do plano |
routing24_list_depotsread | Lê os depósitos do plano |
routing24_list_addressesread | Lê o catálogo de endereços, com contagens de uso |
routing24_upsert_stops | Cria ou atualiza pedidos pelo id |
routing24_upsert_vehicles | Cria ou atualiza tipos de veículo pelo id |
routing24_upsert_depots | Cria ou atualiza depósitos pelo id |
routing24_upsert_addresses | Cria ou atualiza linhas do catálogo de endereços |
routing24_delete_stops | Exclui pedidos pelo id |
routing24_delete_vehicles | Exclui tipos de veículo pelo id |
routing24_delete_depots | Exclui depósitos: os veículos que os referenciam são excluídos junto |
routing24_delete_addresses | Exclui endereços: os pedidos e depósitos localizados neles são excluídos junto |
Edição de rotas
| Ferramenta | O que ela faz |
|---|---|
routing24_edit_move_stops | Move paradas para outra rota ou outra posição, ancoradas ou na posição mais barata |
routing24_edit_unassign_stops | Retira paradas de suas rotas |
routing24_edit_set_route_vehicle | Dá a uma rota um veículo diferente |
routing24_edit_create_route | Adiciona uma rota vazia para um veículo |
routing24_edit_remove_routes | Exclui rotas: as paradas que ainda estão nelas ficam não atribuídas na mesma edição |
routing24_edit_split_route | Divide uma rota em duas após uma parada |
routing24_edit_merge_routes | Move as paradas de outras rotas para uma rota |
routing24_edit_mark_user_assigned | Marca paradas como posicionadas manualmente, com um relatório do que isso quebra |
routing24_edit_clear_user_assigned | Remove essa marca e seu relatório |
routing24_undo | Retrocede pelo histórico de edições compartilhado |
routing24_redo | Avança novamente |
Otimização
| Ferramenta | O que ela faz |
|---|---|
routing24_reoptimize_plan | Otimiza diretamente o plano carregado |
routing24_reoptimize_route | Reordena uma rota, de forma síncrona |
routing24_cancel | Interrompe uma otimização longa, mantendo o melhor plano de rotas até o momento |
Dados e scripts
| Ferramenta | O que ela faz |
|---|---|
routing24_sql_queryread | Lê o plano com SQL sobre oito tabelas ativas, dos pedidos às paradas do plano de rotas |
routing24_sql_update | Atualizações de campos em massa com SQL, validadas e aplicadas atomicamente |
routing24_run_script | Transformações e análises em JavaScript em sandbox sobre um rascunho do plano |
O app e a saída
| Ferramenta | O que ela faz |
|---|---|
routing24_renderread | Navega até a página de otimização para que as rotas sejam desenhadas |
routing24_open_pageread | Abre uma das páginas do app |
routing24_show_on_mapread | Leva o mapa até um pedido, depósito ou endereço |
routing24_export_excelread | Baixa o plano como uma pasta de trabalho do Excel |
routing24_map_imageread | Captura o plano como uma imagem de mapa Retina, com pinos e linhas de rota |
routing24_session_logread | Lê o registro de ações de uma sessão do assistente, para transferências e auditorias |
Abas e sessões
| Ferramenta | O que ela faz |
|---|---|
routing24_list_loaded_plansread | As abas abertas, o plano aberto em cada uma e a sessão do assistente que o edita |
Coordenadas em vez de um endereço
Um pedido ou um depósito precisa de uma localização. Normalmente você informa um endereço, e o Routing24 geolocaliza esse endereço ao salvar a linha.
Quando você já conhece o ponto exato, coloque coordinates na linha, com um
lat e um lng em graus decimais. O Routing24 posiciona a linha nesse
ponto e nunca chama o geolocalizador. Adicione também um address para
manter o seu próprio texto na linha. Sem ele, a linha exibe
25.19882, 55.27939.
Um endereço escrito como dois números decimais faz a mesma coisa. Envie
25.19882, 55.27939 como endereço e a linha é posicionada nesse ponto.
As duas formas funcionam em routing24_upsert_stops e
routing24_upsert_depots, e as duas funcionam com um lote inteiro por vez.
Uma lista de pontos que você já possui entra como uma única chamada, sem
nada que o geolocalizador possa errar.
As coordenadas apenas entram. Nenhuma ferramenta as retorna.
Qual plano uma chamada afeta
Um navegador pode ter vários planos abertos, um por aba. Duas entradas decidem qual plano uma chamada afeta.
plan_id identifica o plano no qual a chamada deve operar. Esse plano
já precisa estar aberto em uma aba. Quando nenhuma aba o tem aberto, a
chamada falha e nomeia os planos que estão abertos.
session_id identifica a sessão de edição do próprio assistente
conectado. O Routing24 gera uma na primeira alteração do assistente em um
plano e a retorna no resultado. Um assistente que fixa esse id em cada
chamada posterior mantém o seu próprio plano, mesmo quando você muda para
outra aba. Chamadas somente leitura nunca geram uma sessão.
routing24_list_loaded_plans informa as abas abertas, o plano que cada uma
tem aberto, se a aba está vazia, focada ou visível, e a sessão do assistente
que o edita. Dois assistentes trabalhando em dois planos a usam para manter
suas chamadas em seus próprios planos.
Sem nenhuma das duas entradas, a chamada opera no plano da própria sessão de quem chama. Sem sessão, ela opera no plano da aba focada, depois em uma aba visível, depois na aba vista mais recentemente. A aba focada muda sempre que você clica em outra.
O que você vê enquanto um assistente conectado trabalha
- O selo no cabeçalho. Nas páginas com escopo de plano, um selo verde
exibe o nome do cliente e há quanto tempo ele chamou, por exemplo
Claude (now)ouChatGPT (3 min ago). Sua dica mostra a última ferramenta pelo seu nome técnico: "Última ação do Claude: routing24_reoptimize_plan. Clique para ver o registro da sessão." O selo desaparece cinco minutos após a última chamada. Pressione-o para abrir o painel do assistente no registro. - O registro da sessão. O painel do assistente lista cada sessão sob
um título como
Session a1b2c3d4 (Claude), depois uma linha por chamada com o horário, a ação em palavras simples e se ela falhou. As linhas de ciclo de vida exibem "iniciou esta sessão", "assumiu esta sessão" e "retomou em outra aba". - A barra de desconexão. Abaixo da caixa de mensagem, uma barra exibe "Claude está conectado à sua conta" com um botão Desconectar. Veja Conectar Claude e ChatGPT.
- O bloqueio. Uma edição coloca o app atrás de uma sobreposição em tela cheia intitulada Controlado pelo agente, com o texto "Um agente de IA está editando este plano. A tela fica bloqueada enquanto ele trabalha; cada alteração entra no histórico de desfazer compartilhado.", com um contador das alterações aplicadas até o momento. Pressione Assumir o controle para retomar o app a qualquer momento.
- O painel. Enquanto um assistente conectado está trabalhando, a caixa de mensagem é substituída por "Claude está trabalhando neste plano" e um botão Assumir o controle.
As exclusões e as alterações de campos em massa de um assistente conectado são aplicadas sem revisão. Os diálogos de revisão pertencem ao assistente no app.
Edição compartilhada
As edições do assistente conectado e as suas próprias edições compartilham um único histórico de desfazer. Continue manualmente exatamente onde o assistente parou. Veja Consultar, editar e exportar um plano com IA.
Quando o plano mudou desde a última leitura do assistente conectado, o Routing24 rejeita a próxima edição desse assistente. Nada é gravado. A rejeição inclui a revisão atual do plano e o último editor. O assistente relê o plano, e a mesma chamada tem sucesso na nova tentativa. O app não mostra nada enquanto isso acontece.
O que os erros significam
Um assistente conectado relata estes erros em sua própria transcrição.
| O que o assistente relata | O que aconteceu |
|---|---|
| Nenhuma aba do navegador do Routing24 está conectada | Nenhum navegador com sessão iniciada está vinculado. Abra o app e inicie a sessão |
| Nenhuma aba do app Routing24 está aberta | O navegador está vinculado, mas nenhuma aba do app está aberta. Abra routing24.com/app |
| A aba fechou durante a execução de uma ferramenta | A aba fechou no meio da chamada. A alteração pode ter sido aplicada ou não |
| A aba não respondeu em 60 s | Uma ferramenta excedeu o limite de 60 segundos. Uma otimização em execução continua na aba |
| Outra aba assumiu enquanto esta chamada estava em execução | Um segundo navegador foi vinculado e substituiu o primeiro |
| O estado do plano divergiu | O plano mudou desde a última leitura do assistente. Ele relê e tenta novamente |
Uma otimização longa sempre excede o limite de 60 segundos. A otimização
continua em execução na aba. O assistente consulta routing24_status para
obter o resultado em vez de repetir a chamada.
Limites
- Oito chamadas simultâneas por sessão.
- 120 solicitações por minuto por conta.
- 60 segundos por chamada.
- Uma imagem de mapa de cerca de 600 KB.
- Uma aba visível para uma imagem de mapa. Uma janela oculta para de renderizar, então a captura atinge o tempo limite.
- Um navegador vinculado por conta. Um assistente conectado trabalha por esse navegador e por nenhum outro lugar: o Routing24 não executa nada por conta própria enquanto todas as abas estão fechadas.
Onde o trabalho é executado
A otimização é executada na sua aba do navegador. A geolocalização e as matrizes de distância são executadas nos servidores do Routing24 sob a sua própria sessão. O endpoint MCP é o único servidor do Routing24 que um assistente conectado acessa, com um token gerado quando você aprova a conexão. Privacidade e tratamento de dados declara o que cada uma dessas chamadas envia e quem recebe os dados que um assistente conectado lê.
Quanto custa
Conectar um assistente está disponível em todos os níveis. Um assistente conectado gasta o orçamento do seu próprio provedor em vez do orçamento de IA da conta. Uma otimização iniciada por ele gasta a mesma cota que o botão Otimizar. Veja Descrever restrições em linguagem simples e Planos, cobrança e limites gratuitos.
A Optimization API é um produto Pro separado para integração entre sistemas, configurado com a equipe. Veja Integrações.
Próximo passo
As ferramentas de escrita definem os mesmos campos que você define manualmente. Adicionar veículos e depósitos abre a referência sobre o significado desses campos.
FAQ
O que preciso para que um assistente conectado funcione?
Um assistente conectado precisa de três coisas: você está com sessão iniciada no Routing24 em um navegador, uma aba routing24.com/app está aberta em qualquer página do app, e você aprovou a conexão uma vez a partir desse navegador. Um navegador por vez atende a conta; aprovar a conexão em um segundo navegador impede o primeiro de responder.
Onde o trabalho de um assistente conectado é realmente executado?
A chamada é roteada para a sua aba do navegador com sessão iniciada, e a aba executa o trabalho no plano que ela tem aberto. A otimização é executada no navegador. A geolocalização e as matrizes de distância são executadas nos servidores do Routing24 sob a sua própria sessão. O endpoint MCP é o único servidor do Routing24 que um assistente conectado acessa.
Qual é a diferença entre um assistente conectado e o assistente no app?
Os dois fazem o mesmo trabalho pelas mesmas ferramentas. O assistente no app abre sem configuração, pode acessar o plano, mas não os seus arquivos ou outros sistemas, e gasta o orçamento de IA da conta. Um assistente conectado se conecta uma vez com uma URL e uma aprovação, acessa também os seus arquivos e outras ferramentas, e gasta o orçamento do seu próprio provedor.
Posso parar um assistente conectado enquanto ele edita?
Sim. Uma edição coloca o app atrás de uma sobreposição em tela cheia intitulada Controlado pelo agente, com um contador das alterações aplicadas até o momento. Pressione Assumir o controle para retomar o app a qualquer momento. Cada alteração entra no histórico de desfazer compartilhado, então você pode continuar manualmente exatamente onde o assistente parou.
Por que uma otimização longa atinge o tempo limite para um assistente conectado?
Cada chamada tem um limite de 60 segundos, e uma otimização longa sempre o excede. A otimização continua em execução na aba; apenas a chamada termina. O assistente consulta a ferramenta de status para obter o resultado em vez de repetir a chamada e lê o plano de rotas quando a execução termina.