---
title: "INTEGRATIONS - Claude: connect to Qargo over MCP - Walkthrough"
description: "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."
url: https://help.qargo.com/en/articles/799799-integrations-claude-connect-to-qargo-over-mcp-walkthrough
locale: en
updated: 2026-11-10
---

# INTEGRATIONS - Claude: connect to Qargo over MCP - Walkthrough

## Prerequisites {#h_93d72c977a}

-   **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](https://help.qargo.com/en/articles/799560-integrations-connect-an-ai-assistant-to-qargo-over-mcp-walkthrough) 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](http://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](http://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_ |

:::callout{tone="note"}
**📚 Use [https://mcp.qargo.com/mcp](https://mcp.qargo.com/mcp).** The Qargo API documentation site offers Connect to Cursor and Connect to VS Code buttons pointing at a different server. That one reads the API reference only and cannot see your data.
:::

## Team and Enterprise: add the connector {#h_fe2a9cc000}

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 {#h_6bcb4ec067}

-   **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 {#h_c295db9f8c}

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](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 {#h_c5962109a9}

-   **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 {#h_ed8c302ab1}

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.

![](https://help.qargo.com/media/ad8398c1eb6d-Screenshot-2026-08-24-at-10_07_43.png)

* * *

## Free, Pro and Max: add the connector yourself {#h_70781fbbbf}

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](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.

![](https://help.qargo.com/media/08ad8b2e1a72-Screenshot-2026-08-24-at-10_06_58.png)

* * *

## Claude Code: register the server {#h_9a1a9db10e}

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

:::callout{tone="note"}
📚 **You might not need this at all.** A connector you have already added on [claude.ai](http://claude.ai) loads automatically in Claude Code when you sign in with the same account. Follow the steps below only if Qargo does not appear.
:::

### Requirements {#h_e8031904df}

-   **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 {#h_bf6ae0c6cb}

1.  **OPEN** a terminal in the project that should have access.
2.  **RUN** claude mcp add --transport http qargo [https://mcp.qargo.com/mcp](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.

:::callout{tone="info"}
📚 **Scope matters.** Registering inside a project limits the server to that project. Add --scope user only if every project should reach your Qargo data.
:::

* * *

## Verify the connection {#h_afd8ac38a9}

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_.

:::callout{tone="info"}
📚**You get your own permissions.** Claude sees exactly what you can see in Qargo. A colleague with wider access sees more through the same connector.
:::

* * *

## Changing data {#h_edbe5b6b04}

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](https://help.qargo.com/en/articles/799560-integrations-connect-an-ai-assistant-to-qargo-over-mcp-walkthrough).

:::callout{tone="warning"}
‼️ **Check what you approve.** Approving a session authorises every further change in it, not only the one requested. Review anything affecting more than one record.
:::

* * *

## Troubleshooting {#h_5a072e2b75}

| **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. |


## Related articles

- [INTEGRATIONS - ChatGPT: connect to Qargo over MCP - Walkthrough](https://help.qargo.com/en/articles/800127-integrations-chatgpt-connect-to-qargo-over-mcp-walkthrough.md)
- [INTEGRATIONS - Qargo API - What, Why & How](https://help.qargo.com/en/articles/865547-integrations-qargo-api-what-why-how.md)
- [INTEGRATIONS - WhatsApp Configuration](https://help.qargo.com/en/articles/355075-integrations-whatsapp-configuration.md)
- [FAQ - Logging into Qargo](https://help.qargo.com/en/articles/374948-faq-logging-into-qargo.md)
- [INTERMODAL - Customs UK HMRC integration](https://help.qargo.com/en/articles/543446-intermodal-customs-uk-hmrc-integration.md)
