Connecting
Which assistants work with Cargofy?
Claude, ChatGPT, Gemini, Perplexity and Manus, the agent platforms Paperclip, OpenClaw and Hermes, and developer tools such as Claude Code and Cursor. Any other assistant that can add a custom connector by its address works too. There is no ID or secret to copy: you paste one address and confirm access in Cargofy. Setup for each assistant is in Connect an assistant.
Sign-in fails or keeps asking me to authenticate
- “This connection request has expired.”: start the connection again in your assistant.
- “This connection request is not valid.”: the link is incomplete or was changed or the app was removed. Start the connection again.
- “You need an active brand in Cargofy to connect an app.”: you are not a member of the brand that is active in your Cargofy account. Switch to a brand you belong to, or ask its owner to invite you.
- Cargofy opens onboarding or pricing instead of “Connect an app”: finish onboarding or choose a plan first, then start the connection again.
- The assistant keeps asking to sign in: remove Cargofy in the assistant, add it again and click Allow in Cargofy.
- On a company plan of your assistant, an admin may block custom connectors. Ask them to allow
https://api.cargofy.com/mcp.
Do I need an API key?
No, if your assistant opens a browser sign-in: Claude, ChatGPT, Gemini, Perplexity, Claude Code and Cursor do. Use an API key for scripts and tools that cannot open a browser.
Brands and permissions
Which brand does the assistant work in?
Signed in with Cargofy, it works in the brand that is active in your account at the moment of each request. When your active brand changes, the next request of the assistant goes to the new brand. With an API key, it works in the brand that was active when you generated the key.
The assistant is refused an action I can do in Cargofy
Check that the assistant works in the right brand. Your role decides what the assistant can do with records, and some sending actions of integrations need a send permission. If the brand is right, ask your account owner to add the permission to your role.
What can the assistant see?
The records your role opens in the brand it works in, and the actions of your connected integrations. It sees nothing in your other brands.
What can’t the assistant do?
The assistant works only through the tools Cargofy opens to it. It cannot:
- publish a tender or choose its winner;
- book a load on LoadHub or send an offer by email;
- follow a shipper’s tender on the road: trips are open only in a carrier’s brand;
- work with reports, finance, documents, settlements or lanes.
Ask the assistant what it can do in your brand: it lists its tools.
How do I know what the assistant did?
An action made over MCP is saved in the activity log with the app’s name, for example “via Claude”, or “via api-key” for an API key. A change to a record is in that record’s change history under your name.
Access
How do I disconnect an app?
Open MCP & API › MCP, find the app in the list and click Revoke, then confirm. The app stops working immediately, in all your brands. To use it again, connect it and click Allow once more.
The list shows apps connected by sign-in. An API key is not in it: you manage it on the API tab.
When does a connection end by itself?
An app signed in with Cargofy stays connected while you use it. After 30 days without use, it asks you to sign in again.
How do I replace or delete an API key?
Open MCP & API › API. Delete stops the key at once. To get a new key, delete the old one, confirm and click Generate. You have one key in each brand. A key does not expire by itself and also opens the Cargofy API: keep it like a password.
Is there a request limit?
Yes, 300 requests per minute with one key or one sign-in session. Scripts that share one API key share the limit. Above it, Cargofy refuses new requests for the rest of the minute.