---
title: "INTEGRATIES - Claude: via MCP verbinden met Qargo - stappenplan"
description: "Het Qargo-account met Claude verbinden en Claude daarna vragen stellen over live gegevens. Wie de koppeling instelt, hangt af van het Claude-abonnement; Claude Code volgt een andere route."
url: https://help.qargo.com/nl/articles/799799-integraties-claude-via-mcp-verbinden-met-qargo-stappenplan
locale: nl
updated: 2026-11-10
---

# INTEGRATIES - Claude: via MCP verbinden met Qargo - stappenplan

## Vereisten {#h_93d72c977a}

-   **Qargo Intelligence op de tenant.** MCP maakt deel uit van de add-on Qargo Intelligence. Zonder deze add-on contact opnemen met de accountmanager.
-   **MCP-toegang ingesteld voor de gebruiker.** Een super admin van de organisatie stelt dit in via **Configuratie > Instellingen organisatie > Gebruikers**. Een aanvraag bij Qargo is niet nodig. Zie [INTEGRATIES - Een AI-assistent via MCP verbinden met Qargo](https://help.qargo.com/nl/articles/799560-integrations-connect-an-ai-assistant-to-qargo-over-mcp-walkthrough) voor de stappen.
-   **De gebruikelijke inloggegevens voor Qargo.** Er is geen aparte sleutel of token.

| **Situatie** | **Wie voegt de Qargo-connector toe** | **Te volgen secties** |
| --- | --- | --- |
| Claude Desktop of [claude.ai](http://claude.ai), Team of Enterprise | Een Owner, eenmalig voor de organisatie | _Team en Enterprise: de connector toevoegen_, daarna _Team en Enterprise: het account verbinden_ |
| Claude Desktop of [claude.ai](http://claude.ai), Free, Pro of Max | De gebruiker zelf | _Free, Pro en Max: de connector zelf toevoegen_ |
| Claude Code | De gebruiker zelf, per project | _Claude Code: de server registreren_ |

:::callout{tone="note"}
**📚 [https://mcp.qargo.com/mcp](https://mcp.qargo.com/mcp) is het juiste adres.** De site met de Qargo API-documentatie biedt de knoppen Connect to Cursor en Connect to VS Code, die naar een andere server verwijzen. Die server leest alleen de API-referentie en kan de gegevens van de gebruiker niet zien.
:::

## Team en Enterprise: de connector toevoegen {#h_fe2a9cc000}

Bij Team- en Enterprise-abonnementen kan alleen een Owner een aangepaste connector toevoegen. De connector wordt eenmalig voor de hele organisatie toegevoegd. Leden verbinden daarna elk hun eigen Qargo-account.

### Vereisten {#h_6bcb4ec067}

-   **Owner- of Primary Owner-rechten** in de Claude-organisatie. Leden kunnen geen aangepaste connectors toevoegen.
-   **MCP-toegang ingesteld in Qargo** voor de gebruikers die die toegang nodig hebben. Een super admin stelt dit per gebruiker in via **Configuratie > Instellingen organisatie > Gebruikers**. Dit vóór het toevoegen van de connector doen, zodat leden meteen verbinding kunnen maken.

### De connector toevoegen {#h_c295db9f8c}

1.  **Navigeren** naar **Organization settings > Connectors**.
2.  **Klikken** op **Add** en daarna op **Custom**. **Web** kiezen als Claude om een connectortype vraagt.
3.  Qargo als naam **invoeren**.
4.  [https://mcp.qargo.com/mcp](https://mcp.qargo.com/mcp) als URL van de externe MCP-server **invoeren**.
5.  **Klikken** op **Continue**.
6.  **Authentication** en **OAuth client** **laten staan** zoals Claude ze invult. Claude detecteert de juiste instellingen voor Qargo, dus **Advanced** openen of een OAuth-client-ID of -secret invoeren is niet nodig.
7.  **Klikken** op **Add**.

### Wat het toevoegen wel en niet doet {#h_c5962109a9}

-   **Het toevoegen van de connector geeft niemand toegang tot gegevens.** Het maakt Qargo alleen beschikbaar om verbinding mee te maken.
-   **Elk lid verifieert zich afzonderlijk** en krijgt alleen de eigen Qargo-rechten.
-   **Claude-instellingen kunnen de toegang tot Qargo niet uitbreiden.** Een lid met het niveau Alleen lezen kan geen gegevens wijzigen, ongeacht wat de organisatie toestaat. Niveaus worden per gebruiker ingesteld in Qargo, via **Configuratie > Instellingen organisatie > Gebruikers**.

De leden vragen om de volgende sectie te volgen.

* * *

## Team en Enterprise: het account verbinden {#h_ed8c302ab1}

Qargo staat normaal al in de lijst met connectors. Als dat niet zo is, een Owner vragen om de connector toe te voegen.

1.  **Navigeren** naar **Customize > Connectors**.
2.  Qargo in de lijst **zoeken** en op **Connect** klikken.
3.  **Inloggen** met de gewone Qargo-inloggegevens wanneer de browser opent.
4.  Het toegangsverzoek **goedkeuren**. De browser keert terug naar Claude.

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

* * *

## Free, Pro en Max: de connector zelf toevoegen {#h_70781fbbbf}

Bij een individueel abonnement hoeft niet op een Owner gewacht te worden. Met Free kan één aangepaste connector worden toegevoegd.

1.  **Navigeren** naar **Customize > Connectors**.
2.  **Klikken** op **Add** rechtsboven in het paneel Connectors en daarna op **Add custom connector**.
3.  Qargo als naam en [https://mcp.qargo.com/mcp](https://mcp.qargo.com/mcp) als URL van de externe MCP-server **invoeren**.
4.  **Klikken** op **Continue**.
5.  **Authentication** en **OAuth client** **laten staan** zoals Claude ze invult. Claude detecteert de juiste instellingen voor Qargo, dus **Advanced** openen of een OAuth-client-ID of -secret invoeren is niet nodig.
6.  **Klikken** op **Add**, daarna op **Connect**, en inloggen met de Qargo-inloggegevens.

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

* * *

## Claude Code: de server registreren {#h_9a1a9db10e}

Claude Code gebruikt één terminalcommando in plaats van een instellingenpaneel. Elke gebruiker stelt dit zelf in, ongeacht het abonnement.

:::callout{tone="note"}
📚 **Misschien is dit helemaal niet nodig.** Een connector die al op [claude.ai](http://claude.ai) is toegevoegd, wordt automatisch geladen in Claude Code bij het inloggen met hetzelfde account. De onderstaande stappen alleen volgen als Qargo niet verschijnt.
:::

### Vereisten {#h_e8031904df}

-   **Claude Code geïnstalleerd** en werkend in het project dat toegang tot Qargo nodig heeft.
-   **Een lokale browser.** De verificatie opent een browser. Ze kan niet via een externe shellsessie worden voltooid.

### De server registreren {#h_bf6ae0c6cb}

1.  Een terminal **openen** in het project dat toegang moet krijgen.
2.  claude mcp add --transport http qargo [https://mcp.qargo.com/mcp](https://mcp.qargo.com/mcp) **uitvoeren**.
3.  claude mcp list **uitvoeren**. Qargo wordt weergegeven als **Needs authentication**; dat is op dit moment normaal.
4.  /mcp **typen** in Claude Code.
5.  qargo **selecteren**, op Enter drukken en daarna **Authenticate** kiezen. Er opent een browservenster.
6.  **Inloggen** met de gewone Qargo-inloggegevens. De terminal meldt daarna dat de server geverifieerd is.

:::callout{tone="info"}
📚 **Het bereik is belangrijk.** Registreren binnen een project beperkt de server tot dat project. --scope user alleen toevoegen als elk project toegang moet hebben tot de Qargo-gegevens.
:::

* * *

## De verbinding controleren {#h_afd8ac38a9}

Claude vragen om de Qargo-tenants op te sommen. Een antwoord met de naam van de tenant bevestigt dat de verbinding werkt.\
Qargo in de vraag vermelden wanneer Claude antwoordt op basis van algemene kennis in plaats van de eigen gegevens, bijvoorbeeld: _vraag Qargo welke orders voor morgen nog niet gepland zijn_.

:::callout{tone="info"}
📚**Elke gebruiker krijgt de eigen rechten.** Claude ziet precies wat de gebruiker in Qargo kan zien. Een collega met ruimere toegang ziet meer via dezelfde connector.
:::

* * *

## Gegevens wijzigen {#h_edbe5b6b04}

De eerste wijziging aan productiegegevens in een sessie wordt tegengehouden en Claude geeft een goedkeuringslink terug. De link openen, goedkeuren en Claude vragen om het opnieuw te proberen. De volledige stappen staan in [INTEGRATIES - Een AI-assistent via MCP verbinden met Qargo](https://help.qargo.com/nl/articles/799560-integrations-connect-an-ai-assistant-to-qargo-over-mcp-walkthrough).

:::callout{tone="warning"}
‼️ **Controleren wat wordt goedgekeurd.** Het goedkeuren van een sessie autoriseert elke verdere wijziging in die sessie, niet alleen de gevraagde. Alles wat meer dan één record beïnvloedt, nakijken.
:::

* * *

## Problemen oplossen {#h_5a072e2b75}

| **Probleem** | **Oplossing** |
| --- | --- |
| Qargo staat niet in de lijst met connectors en het menu **Add** biedt geen optie **Add custom connector** | Het gaat om een Team- of Enterprise-abonnement. Een Owner vragen om de connector toe te voegen. |
| De knop **Add** ontbreekt in **Organization settings** | De gebruiker is geen Owner of Primary Owner. Een van hen vragen om de connector toe te voegen. |
| Leden zien Qargo niet in hun lijst met connectors | Controleren of de connector op organisatieniveau is toegevoegd en niet in een persoonlijk profiel. |
| De browser toont tijdens het inloggen een foutmelding over een onbekende client | De connector opnieuw verbinden. Bij Team of Enterprise een Owner vragen om de connector te verwijderen en opnieuw toe te voegen. Dit kan gebeuren na een update van het Qargo-platform. |
| De connector staat in de lijst, maar Claude heeft geen Qargo-tools | Ofwel is de sessie verlopen (sessies duren doorgaans een dag); dan opnieuw verbinding maken. Ofwel is Qargo uitgeschakeld voor dit gesprek. Op de knop + in de chat klikken, de muis over **Connectors** bewegen en de toggle voor Qargo inschakelen. |
| Claude meldt dat MCP-toegang niet is ingeschakeld voor de gebruiker | De toegang staat nog op Uitgeschakeld. Een super admin vragen om die in te stellen via **Configuratie > Instellingen organisatie > Gebruikers**. |
| Claude kan tenants opsommen, maar elk ander verzoek mislukt | Externe API-toegang is niet ingeschakeld op de tenant. Contact opnemen met de accountmanager. |
| Lezen werkt, maar een wijziging wordt geweigerd | De toegang staat op Alleen lezen. Een super admin kan het niveau wijzigen via **Configuratie > Instellingen organisatie > Gebruikers**. |
| Er opent geen browser tijdens de verificatie in Claude Code | Er wordt gewerkt via een externe shell. In plaats daarvan verifiëren op een computer met een browser. |
| /mcp toont qargo niet | Het huidige project is niet het project waarin de server is geregistreerd. Van map wisselen of de server opnieuw toevoegen met --scope user. |
| De terminal meldt een fout over een onbekende client | De server verwijderen met claude mcp remove qargo en daarna opnieuw toevoegen. Dit kan gebeuren na een update van het Qargo-platform. |


## Gerelateerde artikelen

- [INTEGRATIES - ChatGPT: via MCP verbinden met Qargo - Stappenplan](https://help.qargo.com/nl/articles/800127-integraties-chatgpt-via-mcp-verbinden-met-qargo-stappenplan.md)
- [INTEGRATIES - Qargo API - wat, waarom en hoe](https://help.qargo.com/nl/articles/865547-integraties-qargo-api-wat-waarom-en-hoe.md)
- [Integraties – WhatsApp-configuratie](https://help.qargo.com/nl/articles/355075-integraties-whatsapp-configuratie.md)
- [FAQ: inloggen bij Qargo](https://help.qargo.com/nl/articles/374948-faq-inloggen-bij-qargo.md)
- [Intermodaal: integratie met UK HMRC voor douane](https://help.qargo.com/nl/articles/543446-intermodaal-integratie-met-uk-hmrc-voor-douane.md)
