Guia do RouteKit

Otimize rotas de entrega usando linguagem natural com seu assistente de IA favorito. Sem codigo, sem complicacao.

Neste guia

1. O que e o RouteKit?

O RouteKit e uma ferramenta de otimizacao de rotas que funciona dentro do seu assistente de IA (Claude, Cursor, Claude Code CLI). Voce pede em linguagem natural -- "otimize minhas entregas de amanha" -- e a IA calcula rotas reais usando a malha viaria do Brasil. Nao precisa programar, nao precisa abrir outro sistema, nao precisa aprender API nenhuma.

Como funciona na pratica

Voce

Otimize as entregas de amanha para 3 motoristas saindo de Sao Paulo. Tenho 12 entregas espalhadas pela cidade, cada uma leva 15 minutos.

IA chama: optimize_routes

12 tasks, 3 vehicles, service_min: 15 ...

IA responde

Pronto! Rotas otimizadas para os 3 motoristas:

  • Motorista 1: 5 entregas, 23 km, termina as 14:30
  • Motorista 2: 4 entregas, 19 km, termina as 13:45
  • Motorista 3: 3 entregas, 15 km, termina as 12:20

Total: 57 km. Uma rota manual teria ~104 km. Economia de 45%.

Isso e tudo. Voce conversa, a IA faz o trabalho pesado.

2. Como configurar (3 minutos)

1

Pegue sua chave de API

Acesse /signup, preencha seu email e receba sua chave instantaneamente. O plano gratuito ja vem com 50 chamadas/mes -- suficiente para testar a vontade.

Sua chave tera este formato: rk_free_abc123def456
2

Configure no Claude Desktop

Abra as configuracoes do Claude Desktop e adicione o servidor MCP. No arquivo de configuracao:

Windows: %APPDATA%\Claude\claude_desktop_config.json

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "routekit": {
      "type": "url",
      "url": "https://routekit.nexterait.com.br/mcp",
      "headers": {
        "X-API-Key": "SUA_CHAVE_AQUI"
      }
    }
  }
}
3

Configure no Cursor

No Cursor, o arquivo de configuracao fica em outro local, mas o conteudo e o mesmo:

Arquivo: ~/.cursor/mcp.json

{
  "mcpServers": {
    "routekit": {
      "type": "url",
      "url": "https://routekit.nexterait.com.br/mcp",
      "headers": {
        "X-API-Key": "SUA_CHAVE_AQUI"
      }
    }
  }
}
4

Configure no Claude Code (CLI)

No terminal, adicione o servidor com um unico comando:

claude mcp add routekit \
  --transport streamable-http \
  --url https://routekit.nexterait.com.br/mcp \
  --header "X-API-Key: SUA_CHAVE_AQUI"

Pronto! Reinicie o Claude Desktop / Cursor e comece a usar. O RouteKit aparecera como uma ferramenta disponivel automaticamente.

3. O que voce pode fazer

A→B

Calcular rota entre dois pontos

Ferramenta: calculate_route

Voce

Qual a distancia de Sao Paulo ate o Rio de Janeiro de carro?

IA responde

A distancia rodoviaria entre Sao Paulo e Rio de Janeiro e de 435 km, com tempo estimado de 5h37min em condicoes normais de transito.

Use para: estimar distancias, calcular tempo de viagem, planejar deslocamentos.

NxN

Matriz de distancias

Ferramenta: distance_matrix

Voce

Me da a matriz de distancias entre SP, RJ, BH e Curitiba.

IA responde

Aqui esta a matriz de distancias rodoviarias (em km):

SP RJ BH Curitiba
SP-435586408
RJ435-442852
BH586442-1,004
Curitiba4088521,004-

Use para: comparar distancias, encontrar o ponto mais central, planejar cobertura de areas.

VRP

Otimizar rotas de entregas

Ferramenta: optimize_routes

Voce

Tenho 10 entregas para fazer em Sao Paulo com 2 motoristas. Otimize as rotas pra gastar o minimo de km.

IA responde

Rotas otimizadas para os 2 motoristas:

  • Motorista 1: 6 entregas, 28 km total -- Zona Sul e Centro
  • Motorista 2: 4 entregas, 19 km total -- Zona Leste

Total: 47 km. Uma distribuicao manual estimaria ~87 km. Economia de 46%.

Use para: logistica de entregas, rotas de manutencao em campo, planejamento de visitas comerciais.

4. Dicas para melhores resultados

1

Forneca coordenadas quando possivel

Nomes de cidades funcionam, mas coordenadas (latitude/longitude) dao resultados exatos. Se voce tem uma planilha com enderecos, peca para a IA converter em coordenadas primeiro.

Bom: "Otimize as entregas nestes enderecos: Av Paulista 1000, Rua Augusta 500..."
Melhor: "Otimize as entregas nestas coordenadas: -23.5631,-46.6543 / -23.5534,-46.6622 ..."
2

Especifique restricoes

Quanto mais detalhes voce der, melhor o resultado. A IA sabe traduzir suas restricoes para parametros tecnicos.

"O motorista 1 so trabalha ate as 17h"

"Cada entrega leva 15 minutos na porta do cliente"

"O caminhao tem capacidade para 500 kg"

"A entrega 3 precisa ser feita entre 9h e 12h"

3

Para muitas entregas, envie dados estruturados

Se voce tem mais de 5 entregas, cole os dados como JSON ou CSV. A IA vai interpretar automaticamente.

Otimize estas entregas para 3 motoristas:

id,lat,lon,servico_min
1,-23.5505,-46.6333,15
2,-23.5631,-46.6543,20
3,-23.5874,-46.6324,10
4,-23.5201,-46.6879,15
5,-23.5943,-46.6505,25
...
4

A IA vai perguntar se precisar de mais detalhes

Se voce disser "otimize minhas entregas" sem mais contexto, a IA vai pedir as informacoes que faltam: quantas entregas, quantos motoristas, de onde saem, etc. Nao se preocupe em acertar tudo de primeira.

5. Limites e planos

Free

R$ 0

/mes

50

chamadas/mes

Popular

Starter

R$ 500

/mes

1.000

chamadas/mes

Professional

R$ 3.000

/mes

10.000

chamadas/mes

Como funciona a contagem?

Cada chamada de ferramenta = 1 chamada de API. Por exemplo: uma chamada optimize_routes com 100 entregas e 5 motoristas conta como 1 chamada. O que importa e quantas vezes a ferramenta e acionada, nao quantos dados voce envia.

6. Perguntas frequentes

"Funciona fora do Brasil?"

Por enquanto nao. A cobertura rodoviaria do RouteKit e exclusiva para o Brasil. Rotas entre cidades brasileiras e locais fora do pais nao sao suportadas.

"Preciso saber programar?"

Nao. A IA faz todo o trabalho tecnico. Voce descreve o que precisa em linguagem natural -- "tenho 8 entregas, 2 motoristas, otimize" -- e a IA traduz isso em chamadas de API, interpreta os resultados e te apresenta de forma clara.

"Os dados sao seguros?"

Sim. Toda comunicacao usa HTTPS. Nenhum dado de rota e armazenado apos o calculo -- processamos e devolvemos. A autenticacao e feita por chave de API individual.

"Posso usar com ChatGPT / GPT?"

O protocolo MCP e suportado atualmente pelo Claude (Desktop e Code) e pelo Cursor. O suporte ao ChatGPT/GPT esta previsto para breve, assim que a OpenAI implementar o protocolo MCP.

"Qual a precisao das distancias?"

As distancias sao calculadas usando a malha viaria real do Brasil (dados OpenStreetMap via OSRM). A precisao e equivalente a do Google Maps / Waze para distancias rodoviarias.

"O que acontece se eu estourar meu limite mensal?"

As chamadas serao recusadas com uma mensagem clara. Voce pode acompanhar seu consumo no dashboard e fazer upgrade a qualquer momento.

Pronto para comecar?

Pegue sua chave de API em 30 segundos. Sem cartao de credito.

Criar conta gratuita