- Who can: any member of a brand who has finished onboarding.
- Where: your assistant’s settings, then MCP & API in Cargofy
- Time: ≈ 3 minutes
Before you start
- Sign in to Cargofy in the same browser and switch to the brand the assistant should work in. Sign-in connections always work in your active brand.
- Copy the server URL: MCP & API › MCP › “MCP server URL” › Copy. It is
https://api.cargofy.com/mcp. - On a company plan of Claude, ChatGPT or Gemini, an admin may have to add Cargofy first. The steps say where.
Steps
Add Cargofy to your assistant
Pick your assistant and follow its steps up to the Cargofy sign-in.
- In claude.ai, open Customize › Connectors. In the desktop app: Settings › Connectors.
- Click Add › Add custom connector.
- Name it Cargofy, paste the server URL and click Continue.
- Leave Sign in now and Register automatically as detected, then click Add.
- Click Connect on the Cargofy card.
On Claude Team and Enterprise, only an Owner adds a connector: Organization settings › Connectors › Add › Custom › Web. Members then find Cargofy under Customize › Connectors and click Connect.
- Open Settings › Connectors › Advanced settings and switch on Developer mode. On Business and Enterprise, an admin does this.
- Click Create, name it Cargofy, paste the server URL and choose OAuth as authentication.
- Click Save, then Connect.
- Open gemini.google.com › Settings › Connected Apps. If it is missing, open Personal Intelligence first.
- Under Custom apps, click Add a custom app and paste the server URL.
- Click Next.
Custom apps in the Gemini app work on personal Google accounts, in the US and in English first. For Gemini Enterprise Business, an admin adds the server under Manage team › Connected apps › Add MCP Server.
- Open Settings › Connectors and click Add custom connector.
- Name it Cargofy, paste the server URL and keep Streamable HTTP as transport.
- Click Connect.
Manus. Open Connectors › Create › Add MCP by URL. Name it Cargofy, paste the server URL, save and click Connect.
Paperclip. Open Connectors › Connect your own MCP server and paste the server URL. Paperclip opens the Cargofy sign-in by itself. After you click Allow, choose which actions the agents may use: start with the actions that change data turned off.
OpenClaw, Hermes Agent. Add an MCP server with the server URL and OAuth as authentication, then run the platform’s login for that server.
Run in your terminal:
claude mcp add --transport http cargofy https://api.cargofy.com/mcpThen type /mcp in Claude Code, select cargofy and choose to authenticate. The Cargofy sign-in opens in your browser.
Add Cargofy to ~/.cursor/mcp.json:
{
"mcpServers": {
"cargofy": {
"url": "https://api.cargofy.com/mcp"
}
}
}Cursor opens the Cargofy sign-in in your browser the first time it connects to the server.
Use a key for a script or a tool that cannot open a browser sign-in. It needs the “Manage API tokens” permission.
- In Cargofy, open MCP & API › API. If there is no key yet, click Generate. Copy the “API key”: it stays on this tab, and you can copy it again later.
- Send it with every request to the server URL as a header:
Authorization: Bearer <your API key>In Claude Code:
claude mcp add --transport http cargofy https://api.cargofy.com/mcp \
--header "Authorization: Bearer <your API key>"The key works in the brand that was active when you generated it, and it does not expire. It also opens the Cargofy API, so keep it like a password. To replace it, click Delete, confirm and click Generate. With a key, you skip the next step.
Allow access in Cargofy
The assistant opens Cargofy. If you are not signed in, sign in: Cargofy brings you back to this screen. You see “Connect an app”: “Claude wants to access Cargofy on your behalf in the brand …. It will act with your permissions.” Check the brand and click Allow. Deny cancels the connection.
You return to the assistant, and Cargofy shows as connected. If you see “This connection request has expired.”, start the connection again in your assistant.
Turn Cargofy on in a chat
Some assistants keep a connector off in new chats. In Claude, press + › Connectors and switch Cargofy on. In ChatGPT, open the tools menu and pick Cargofy. In Gemini, switch the app on.
Check the connection
Ask the assistant something about your work, for example: “Which of our tenders in Cargofy are in Matching?” The assistant asks to use a Cargofy tool, and the answer comes from your account.
In Cargofy, open MCP & API › MCP: the app is in the list with “Connected” and “Last used”.
Example prompts
- “Create a shipment from Kyiv to Lviv, loading on Monday at 09:00, 20 t, curtainsider.”
- “Here is a spreadsheet with our drivers and trucks. Add them to Cargofy.”
- “Find truck DEMO-FL-001 and show its details.”
- “Show my confirmed carriers and the latest loads on LoadHub.”
- “Create a task to call the consignee about the delivery window, priority high.”
- “Find what we saved in memory about detention charges.”
- “Summarize the trips completed last week by lane.”