Skip to main content
Qargo

INTEGRATIONS - Claude: connect to Qargo over MCP - Walkthrough

Connect your Qargo account to Claude, then ask Claude questions about live data. Who sets it up depends on your Claude plan, and Claude Code follows a different route.

Table of contents
  1. Prerequisites
  2. Team and Enterprise: add the connector
  3. Team and Enterprise: connect your account
  4. Free, Pro and Max: add the connector yourself
  5. Claude Code: register the server
  6. Verify the connection
  7. Changing data
  8. Troubleshooting

Prerequisites

  • Qargo Intelligence on your tenant. MCP is part of the Qargo Intelligence add-on. Without it, contact your Account Manager.
  • MCP access set for your user. A Super admin in your organisation sets it in Configuration > Organisation settings > Users. No request to Qargo is needed. See INTEGRATIONS - Connect an AI assistant to Qargo over MCP for the steps.
  • Your usual Qargo sign-in details. There is no separate key or token.
Your setup Who adds the Qargo connector Sections to follow
Claude Desktop or claude.ai, Team or Enterprise An Owner, once for the organisation Team and Enterprise: add the connector, then Team and Enterprise: connect your account
Claude Desktop or claude.ai, Free, Pro or Max You, for yourself Free, Pro and Max: add the connector yourself
Claude Code You, per project Claude Code: register the server

Team and Enterprise: add the connector

On Team and Enterprise plans, only an Owner can add a custom connector. Add it once for the whole organisation. Members then connect their own Qargo accounts.

Requirements

  • Owner or Primary Owner rights in your Claude organisation. Members cannot add custom connectors.
  • MCP access set in Qargo for the users who need it. A Super admin sets it per user in Configuration > Organisation settings > Users. Do this before you add the connector, so members can connect immediately.

Add the connector

  1. NAVIGATE to Organization settings > Connectors.
  2. CLICK Add, then Custom. Choose Web if Claude asks for a connector type.
  3. ENTER Qargo as the name.
  4. ENTER https://mcp.qargo.com/mcp as the remote MCP server URL.
  5. CLICK Continue.
  6. LEAVE Authentication and OAuth client as Claude fills them in. It detects the correct settings for Qargo, so you do not need to open Advanced or enter an OAuth client ID or secret.
  7. CLICK Add.

What adding it does, and does not do

  • Adding the connector grants nobody access to data. It only makes Qargo available to connect to.
  • Each member authenticates separately and receives only their own Qargo permissions.
  • Claude settings cannot widen Qargo access. A member on Read-only cannot change data, whatever your organisation allows. Levels are set per user in Qargo, under Configuration > Organisation settings > Users.

Tell your members to follow the next section.


Team and Enterprise: connect your account

Qargo should already appear in your connector list. If it does not, ask an Owner to add it.

  1. NAVIGATE to Customize > Connectors.
  2. FIND Qargo in the list and click Connect.
  3. SIGN IN with your normal Qargo credentials when the browser opens.
  4. APPROVE the access request. The browser returns to Claude.


Free, Pro and Max: add the connector yourself

On an individual plan there is no Owner to wait for. On Free you can add one custom connector.

  1. NAVIGATE to Customize > Connectors.
  2. CLICK Add at the top right of the Connectors panel, then Add custom connector.
  3. ENTER Qargo as the name and https://mcp.qargo.com/mcp as the remote MCP server URL.
  4. CLICK Continue.
  5. LEAVE Authentication and OAuth client as Claude fills them in. It detects the correct settings for Qargo, so you do not need to open Advanced or enter an OAuth client ID or secret.
  6. CLICK Add, then Connect, and sign in with your Qargo credentials.


Claude Code: register the server

Claude Code uses one terminal command instead of a settings panel. Every user sets this up for themselves, whatever the plan.

Requirements

  • Claude Code installed and working in the project that needs Qargo access.
  • A local browser. Authentication opens one. It cannot complete over a remote shell session.

Register the server

  1. OPEN a terminal in the project that should have access.
  2. RUN claude mcp add —transport http qargo https://mcp.qargo.com/mcp.
  3. RUN claude mcp list. Qargo shows as Needs authentication, which is expected at this point.
  4. TYPE /mcp inside Claude Code.
  5. SELECT qargo, press Enter, then choose Authenticate. A browser window opens.
  6. SIGN IN with your normal Qargo credentials. The terminal then reports the server as authenticated.

Verify the connection

Ask Claude to list your Qargo tenants. A reply naming your tenant confirms the connection works.
Name Qargo in your question when Claude answers from general knowledge instead of your data, for example: ask Qargo which orders are still unplanned for tomorrow.


Changing data

Your first change to production data in a session is stopped, and Claude returns an approval link. Open it, approve, and ask Claude to retry. Full steps are in INTEGRATIONS - Connect an AI assistant to Qargo over MCP.


Troubleshooting

Issue Resolution
Qargo is not in your connector list and the Add menu offers no Add custom connector option You are on Team or Enterprise. Ask an Owner to add the connector.
The Add button is missing from Organization settings You are not an Owner or Primary Owner. Ask one to add the connector.
Members cannot see Qargo in their connector list Confirm the connector was added at organisation level, not in a personal profile.
The browser shows an unknown client error during sign-in Reconnect the connector. On Team or Enterprise, ask an Owner to remove and re-add it. This can happen after a Qargo platform update.
The connector is listed but Claude has no Qargo tools Either your session expired, so connect again, sessions typically last a day, or Qargo is switched off for this conversation. Click the + button in the chat, hover Connectors, and toggle Qargo on.
Claude reports that MCP access is not enabled for your user Your access is still set to Disabled. Ask a Super admin to set it in Configuration > Organisation settings > Users.
Claude can list tenants but every other request fails External API access is not enabled on the tenant. Contact your Account Manager.
A read works but a change is refused You are on Read-only. A Super admin can change your level in Configuration > Organisation settings > Users.
No browser opens during Claude Code authentication You are working over a remote shell. Authenticate on a machine with a browser instead.
/mcp does not list qargo You are in a different project from the one where you registered it. Change directory, or add the server again with —scope user.
The terminal reports an unknown client error Remove the server with claude mcp remove qargo, then add it again. This can happen after a Qargo platform update.