A CargoIA no Claude

O Claude pode consultar e operar a CargoIA por você. Depois de conectado, ele cota fretes, lê o mercado spot, analisa os seus fretes e guarda cotações — tudo numa conversa, em português, com as mesmas permissões que você tem na plataforma. A conexão usa o MCP (Model Context Protocol), o padrão aberto para ligar agentes de IA a outros sistemas, e o seu próprio login na CargoIA: não é preciso criar nem copiar chave nenhuma.

O que você precisa

Uma conta da CargoIA no plano Max ou Enterprise, e um papel que leia os fretes.
Uma conta do Claude que permita adicionar conectores — no claude.ai, no Claude Desktop, no app do celular ou no Claude Code.

Como conectar

No claude.ai, no Claude Desktop e no app do celular

Abra Configurações → Conectores.
Procure CargoIA na lista de conectores. Se ela não aparecer, clique em Adicionar conector personalizado, dê o nome CargoIA e use o endereço https://painel.cargoia.com.br/api/mcp.
Clique em Conectar. O navegador abre a CargoIA: entre com o seu e-mail e senha ou com o Google.
Confira a tela de autorização — o agente, a conta em que ele vai agir e para onde você volta — e clique em Permitir.

Se você participa de mais de uma conta, escolha na própria tela de autorização em qual delas o Claude vai agir.

No Claude Code

claude mcp add --transport http cargoia https://painel.cargoia.com.br/api/mcp

Depois rode /mcp, escolha Authenticate no cargoia e permita no navegador.

O que perguntar

"Quanto custa levar 37 toneladas de soja de Sorriso a Santos num rodotrem?" — o piso da ANTT, os pedágios da rota, o frete por tonelada e o frete da empresa, com a margem e o ICMS dela.
"Que cargas saem de Londrina para Paranaguá hoje?" — as ofertas do mercado, por trecho, veículo e produto.
"Como está o preço do frete de Rio Verde a Santos nos últimos meses?" — a mediana por tonelada, semana a semana, ao lado da Conab.
"Em quais fretes estamos pagando acima do mercado?" — os seus fretes contra o preço do trecho, do pior para o melhor.
"Guarde esta cotação como 'Sorriso–Santos novembro'." — a cotação fica entre as salvas da plataforma.

Segurança e controle

As suas permissões, numa conta só. O Claude age como você, na conta que você escolheu ao autorizar: vê e altera apenas o que o seu papel permite, e o que o plano da conta inclui.
Escritas com confirmação. As ferramentas que só leem rodam direto; as que gravam — registrar um frete, salvar uma cotação, mudar a margem — são marcadas como tal, e o Claude pede a sua confirmação antes de cada uma.
Desconecte quando quiser. Em Integrações → MCP, na plataforma, aparecem os agentes que você conectou; desconectar um corta o acesso na próxima chamada dele. Conectar e desconectar ficam no registro de auditoria da conta.
Acesso que acompanha você. Se você sai da conta ou muda de papel, o agente perde ou ajusta o acesso junto, na hora.

Privacidade e suporte

O que guardamos de cada conexão e o que o agente recebe estão na Política de Privacidade. Dúvidas ou problemas: escreva para contato@cargoia.com.br.