Skip to content
CargoIA
All posts

CargoIA in Claude

Connect Claude to your CargoIA account and ask about freight, the market and quotes in plain language — with your own permissions and no API key.

By The CargoIA team3 min read

Claude can query and operate CargoIA for you. Once connected, it quotes freight, reads the spot market, analyzes your freights and saves quotes — all in a conversation, with the same permissions you have on the platform. The connection uses MCP (Model Context Protocol), the open standard for connecting AI agents to other systems, and your own CargoIA sign-in: there is no key to create or copy.

What you need

  • A CargoIA account on the Max or Enterprise plan, and a role that reads freight.
  • A Claude account that can add connectors — on claude.ai, in Claude Desktop, in the mobile app or in Claude Code.

How to connect

On claude.ai, in Claude Desktop and in the mobile app

  1. Open Settings → Connectors.
  2. Look for CargoIA in the list of connectors. If it isn't there, click Add custom connector, name it CargoIA and use the address https://painel.cargoia.com.br/api/mcp.
  3. Click Connect. The browser opens CargoIA: sign in with your e-mail and password or with Google.
  4. Check the authorization screen — the agent, the account it will act in and where you go back to — and click Allow.

If you belong to more than one account, pick the one Claude will act in on the authorization screen itself.

In Claude Code

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

Then run /mcp, pick Authenticate on cargoia and allow it in the browser.

What to ask

  • "How much to haul 37 tonnes of soybeans from Sorriso to Santos on a rodotrem?" — ANTT's minimum rate, the route's tolls, the freight per tonne and the company freight, with its margin and ICMS.
  • "Which loads leave Londrina for Paranaguá today?" — the market's offers, by lane, vehicle and product.
  • "How has freight from Rio Verde to Santos moved over the last months?" — the median per tonne, week by week, beside Conab's.
  • "Where are we paying above the market?" — your freights against the lane's price, worst first.
  • "Save this quote as 'Sorriso–Santos November'." — the quote joins the platform's saved ones.

Security and control

  • Your permissions, in one account. Claude acts as you, in the account you chose when you authorized it: it sees and changes only what your role allows, and what the account's plan includes.
  • Writes with confirmation. Tools that only read run straight away; those that write — recording a freight, saving a quote, changing the margin — are marked as such, and Claude asks you to confirm each one.
  • Disconnect whenever you like. On the platform, Integrations → MCP lists the agents you connected; disconnecting one cuts its access on its next call. Connecting and disconnecting go to the account's audit log.
  • Access that follows you. If you leave the account or change roles, the agent loses or adjusts its access with you, at once.

Privacy and support

What we keep of each connection and what the agent receives are in the Privacy Policy. Questions or problems: write to contato@cargoia.com.br.