Model Context Protocol

MCP Server da frete.center

Use a frete.center direto do Claude Code, Claude Desktop, Cursor ou qualquer cliente compatível com MCP. Tools nativas pra cotar, listar pedidos, consultar drivers próximos e mais — sem você escrever código de integração.

Instalar → O que é MCP?

Instalação

Opção A — npx (recomendado, sem instalar)

Adicione ao seu config de cliente MCP. Pra Claude Code (CLI), edite ~/.claude.json ou ~/.config/claude/mcp_servers.json:

{
  "mcpServers": {
    "frete-center": {
      "command": "npx",
      "args": ["-y", "@frete-center/mcp-server@latest"],
      "env": {
        "FRETE_API_BASE": "https://frete.center",
        "FRETE_API_KEY":  "fe_live_xxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Pra Claude Desktop, abra Settings → Developer → Edit Config e adicione o mesmo bloco. Reinicie o app.

Pra Cursor, em Settings → MCP, mesma estrutura.

Opção B — clone + roda local (dev)

git clone https://github.com/frete-center/mcp-server
cd mcp-server
npm install
npm run build
# Aponte para o build no seu config:
# "command": "node",
# "args": ["/caminho/absoluto/dist/index.js"]

Configuração

Variáveis de ambiente reconhecidas:

Variável	Obrigatória	Descrição
`FRETE_API_BASE`	não	URL base. Default: `https://frete.center`
`FRETE_API_KEY`	opcional	API key (server-to-server). Necessária pra tools que precisam de auth.
`FRETE_BEARER`	opcional	Alternativa: JWT user-scoped. Use em vez da API key se quer agir como usuário.

Gere sua API key em /api-keys (login frete.center).

Tools disponíveis

O MCP server expõe estas tools que o Claude pode chamar diretamente:

🚚 `frete_cotar`

Cota frete TURBO/EXPRESS entre dois CEPs. Sem auth.

params: cep_origem, cep_destino, service_type?, tier?

📍 `frete_motoristas_proximos`

Lista motoristas online em raio de N km. Coords com jitter LGPD.

params: cep | (lat,lng), km?

📦 `frete_tracking`

Busca status de um pedido pelo código de tracking público.

params: code

📊 `frete_snapshot`

Métricas agregadas da plataforma (drivers, rotas, blog).

params: nenhum

💼 `frete_meus_pedidos`

Lista pedidos do tenant autenticado (precisa FRETE_BEARER).

params: limit?, status?

💰 `frete_carteira`

Saldo + extrato da carteira do tenant autenticado.

params: nenhum

Exemplos de prompts

Você diz:

"Quanto custa um frete TURBO da Av. Paulista pra Vila Olímpia?"

Claude faz:

frete_cotar(cep_origem=01310000, cep_destino=04543907, tier=turbo)
→ R$ 34,38 · 3.5 km · entrega até 3h

Você diz:

"Tem motorista disponível perto do CEP 04543907?"

Claude faz:

frete_motoristas_proximos(cep=04543907, km=10)
→ 3 motoristas · mais próximo: 0.8 km · ETA 3 min

Build com Claude Code

Como o frete-center MCP server está disponível, você pode pedir ao Claude Code coisas como:

"Implemente um botão 'Calcular frete' nesta página HTML que chama o frete-center"
"Crie um cron Python que verifica meus pedidos abertos a cada 30min e me alerta no Slack quando entrega"
"Bota um middleware no meu Laravel que cota Lalamove em paralelo aos Correios pra cada checkout"

Claude vai usar as tools, ler a OpenAPI spec, e implementar com a API correta.

FAQ

Posso usar sem login na frete.center?

As tools frete_cotar, frete_motoristas_proximos, frete_tracking e frete_snapshot são públicas — não precisam de credencial. Só frete_meus_pedidos e frete_carteira exigem autenticação.

É seguro colar minha API key no config do Claude?

Sim — o config fica local na sua máquina. Mas trate como senha: nunca commit em git (o Claude Code já ignora ~/.claude.json nos commits). Se vazar, revogue em /api-keys e gere outra.

O MCP server faz cobranças?

Não. As tools são read-only por design — só consultam. Pra criar pedidos (que movem dinheiro), use a API REST diretamente — assim você tem controle explícito.

Bug ou sugestão? dev@frete.center ou GitHub Issues.