---
title: "INTEGRATIONEN – Claude: Verbindung mit Qargo über MCP – Anleitung"
description: "Das Qargo-Konto mit Claude verbinden und Claude anschließend Fragen zu Live-Daten stellen. Wer die Einrichtung übernimmt, hängt vom Claude-Plan ab; für Claude Code gilt ein anderer Weg."
url: https://help.qargo.com/de/articles/799799-integrationen-claude-verbindung-mit-qargo-ueber-mcp-anleitung
locale: de
updated: 2026-11-10
---

# INTEGRATIONEN – Claude: Verbindung mit Qargo über MCP – Anleitung

## Voraussetzungen {#h_93d72c977a}

-   **Qargo Intelligence auf dem Mandanten.** MCP ist Teil des Add-ons Qargo Intelligence. Ist es nicht vorhanden, den Account Manager kontaktieren.
-   **MCP-Zugriff für den Nutzer eingerichtet.** Ein Super admin der Organisation legt ihn unter **Konfiguration > Organisationseinstellungen > Nutzer** fest. Eine Anfrage an Qargo ist nicht nötig. Die Schritte stehen in [INTEGRATIONEN – KI-Assistenten über MCP mit Qargo verbinden](https://help.qargo.com/de/articles/799560-integrations-connect-an-ai-assistant-to-qargo-over-mcp-walkthrough).
-   **Die üblichen Qargo-Anmeldedaten.** Es gibt keinen separaten Schlüssel und kein separates Token.

| **Einrichtung** | **Wer den Qargo-Konnektor hinzufügt** | **Relevante Abschnitte** |
| --- | --- | --- |
| Claude Desktop oder [claude.ai](http://claude.ai), Team oder Enterprise | Ein Owner, einmal für die Organisation | _Team und Enterprise: Konnektor hinzufügen_, dann _Team und Enterprise: Konto verbinden_ |
| Claude Desktop oder [claude.ai](http://claude.ai), Free, Pro oder Max | Der Nutzer selbst, für sich | _Free, Pro und Max: Konnektor selbst hinzufügen_ |
| Claude Code | Der Nutzer selbst, pro Projekt | _Claude Code: Server registrieren_ |

:::callout{tone="note"}
**📚 [https://mcp.qargo.com/mcp](https://mcp.qargo.com/mcp) verwenden.** Die Website der Qargo-API-Dokumentation bietet die Schaltflächen **Connect to Cursor** und **Connect to VS Code**, die auf einen anderen Server verweisen. Dieser Server liest nur die API-Referenz und hat keinen Zugriff auf die eigenen Daten.
:::

## Team und Enterprise: Konnektor hinzufügen {#h_fe2a9cc000}

Bei Team- und Enterprise-Plänen kann nur ein Owner einen benutzerdefinierten Konnektor hinzufügen. Der Konnektor wird einmal für die gesamte Organisation hinzugefügt. Mitglieder verbinden anschließend ihre eigenen Qargo-Konten.

### Anforderungen {#h_6bcb4ec067}

-   **Owner- oder Primary-Owner-Rechte** in der Claude-Organisation. Mitglieder können keine benutzerdefinierten Konnektoren hinzufügen.
-   **MCP-Zugriff in Qargo eingerichtet** für die Nutzer, die ihn benötigen. Ein Super admin legt ihn pro Nutzer unter **Konfiguration > Organisationseinstellungen > Nutzer** fest. Dies vor dem Hinzufügen des Konnektors erledigen, damit Mitglieder sich sofort verbinden können.

### Konnektor hinzufügen {#h_c295db9f8c}

1.  Zu **Organization settings > Connectors** **navigieren**.
2.  Auf **Add** und anschließend auf **Custom** **klicken**. Wenn Claude nach einem Konnektortyp fragt, **Web** wählen.
3.  Qargo als Namen **eingeben**.
4.  [https://mcp.qargo.com/mcp](https://mcp.qargo.com/mcp) als URL des Remote-MCP-Servers **eingeben**.
5.  Auf **Continue** **klicken**.
6.  **Authentication** und **OAuth client** so **belassen**, wie Claude sie ausfüllt. Claude erkennt die richtigen Einstellungen für Qargo. **Advanced** muss daher nicht geöffnet werden, und weder eine OAuth-Client-ID noch ein Secret muss eingegeben werden.
7.  Auf **Add** **klicken**.

### Was das Hinzufügen bewirkt und was nicht {#h_c5962109a9}

-   **Das Hinzufügen des Konnektors gewährt niemandem Zugriff auf Daten.** Qargo wird damit lediglich für Verbindungen verfügbar gemacht.
-   **Jedes Mitglied authentifiziert sich separat** und erhält nur die eigenen Qargo-Berechtigungen.
-   **Claude-Einstellungen können den Qargo-Zugriff nicht erweitern.** Ein Mitglied mit **Nur lesen** kann keine Daten ändern, unabhängig davon, was die Organisation erlaubt. Die Stufen werden in Qargo pro Nutzer unter **Konfiguration > Organisationseinstellungen > Nutzer** festgelegt.

Die Mitglieder anschließend bitten, den nächsten Abschnitt zu befolgen.

* * *

## Team und Enterprise: Konto verbinden {#h_ed8c302ab1}

Qargo sollte bereits in der Konnektorliste erscheinen. Ist das nicht der Fall, einen Owner bitten, den Konnektor hinzuzufügen.

1.  Zu **Customize > Connectors** **navigieren**.
2.  Qargo in der Liste **suchen** und auf **Connect** klicken.
3.  Wenn sich der Browser öffnet, mit den normalen Qargo-Anmeldedaten **anmelden**.
4.  Die Zugriffsanfrage **genehmigen**. Der Browser kehrt zu Claude zurück.

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

* * *

## Free, Pro und Max: Konnektor selbst hinzufügen {#h_70781fbbbf}

Bei einem Einzelplan muss nicht auf einen Owner gewartet werden. Mit Free kann ein benutzerdefinierter Konnektor hinzugefügt werden.

1.  Zu **Customize > Connectors** **navigieren**.
2.  Oben rechts im Bereich **Connectors** auf **Add** und anschließend auf **Add custom connector** **klicken**.
3.  Qargo als Namen und [https://mcp.qargo.com/mcp](https://mcp.qargo.com/mcp) als URL des Remote-MCP-Servers **eingeben**.
4.  Auf **Continue** **klicken**.
5.  **Authentication** und **OAuth client** so **belassen**, wie Claude sie ausfüllt. Claude erkennt die richtigen Einstellungen für Qargo. **Advanced** muss daher nicht geöffnet werden, und weder eine OAuth-Client-ID noch ein Secret muss eingegeben werden.
6.  Auf **Add** und dann auf **Connect** **klicken** und mit den Qargo-Anmeldedaten anmelden.

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

* * *

## Claude Code: Server registrieren {#h_9a1a9db10e}

Claude Code verwendet statt eines Einstellungsbereichs einen einzigen Terminalbefehl. Jeder Nutzer richtet dies für sich selbst ein, unabhängig vom Plan.

:::callout{tone="note"}
📚 **Möglicherweise ist dieser Schritt gar nicht nötig.** Ein bereits auf [claude.ai](http://claude.ai) hinzugefügter Konnektor wird in Claude Code automatisch geladen, wenn die Anmeldung mit demselben Konto erfolgt. Die folgenden Schritte nur ausführen, wenn Qargo nicht erscheint.
:::

### Anforderungen {#h_e8031904df}

-   **Claude Code installiert** und funktionsfähig in dem Projekt, das Zugriff auf Qargo benötigt.
-   **Ein lokaler Browser.** Die Authentifizierung öffnet einen Browser. Über eine Remote-Shell-Sitzung lässt sie sich nicht abschließen.

### Server registrieren {#h_bf6ae0c6cb}

1.  Ein Terminal in dem Projekt **öffnen**, das Zugriff erhalten soll.
2.  claude mcp add --transport http qargo [https://mcp.qargo.com/mcp](https://mcp.qargo.com/mcp) **ausführen**.
3.  claude mcp list **ausführen**. Qargo wird als **Needs authentication** angezeigt; das ist an dieser Stelle zu erwarten.
4.  In Claude Code /mcp **eingeben**.
5.  qargo **auswählen**, die Eingabetaste drücken und dann **Authenticate** wählen. Ein Browserfenster öffnet sich.
6.  Mit den normalen Qargo-Anmeldedaten **anmelden**. Das Terminal meldet den Server anschließend als authentifiziert.

:::callout{tone="info"}
📚 **Der Geltungsbereich ist wichtig.** Bei einer Registrierung innerhalb eines Projekts ist der Server auf dieses Projekt beschränkt. --scope user nur hinzufügen, wenn jedes Projekt auf die Qargo-Daten zugreifen soll.
:::

* * *

## Verbindung prüfen {#h_afd8ac38a9}

Claude bitten, die Qargo-Mandanten aufzulisten. Nennt die Antwort den eigenen Mandanten, funktioniert die Verbindung.\
Wenn Claude aus allgemeinem Wissen statt mit den eigenen Daten antwortet, Qargo in der Frage nennen, zum Beispiel: _Qargo fragen, welche Aufträge für morgen noch nicht geplant sind_.

:::callout{tone="info"}
📚**Es gelten die eigenen Berechtigungen.** Claude sieht genau das, was der Nutzer in Qargo sehen kann. Personen mit umfassenderem Zugriff sehen über denselben Konnektor mehr.
:::

* * *

## Daten ändern {#h_edbe5b6b04}

Die erste Änderung an Produktionsdaten in einer Sitzung wird angehalten, und Claude gibt einen Genehmigungslink zurück. Den Link öffnen, die Änderung genehmigen und Claude bitten, es erneut zu versuchen. Die vollständigen Schritte stehen in [INTEGRATIONEN – KI-Assistenten über MCP mit Qargo verbinden](https://help.qargo.com/de/articles/799560-integrations-connect-an-ai-assistant-to-qargo-over-mcp-walkthrough).

:::callout{tone="warning"}
‼️ **Vor der Genehmigung prüfen.** Die Genehmigung einer Sitzung autorisiert alle weiteren Änderungen in dieser Sitzung, nicht nur die angefragte. Alles prüfen, was mehr als einen Datensatz betrifft.
:::

* * *

## Fehlerbehebung {#h_5a072e2b75}

| **Problem** | **Lösung** |
| --- | --- |
| Qargo ist nicht in der Konnektorliste, und das Menü **Add** bietet keine Option **Add custom connector** | Es handelt sich um einen Team- oder Enterprise-Plan. Einen Owner bitten, den Konnektor hinzuzufügen. |
| Die Schaltfläche **Add** fehlt unter **Organization settings** | Der Nutzer ist weder Owner noch Primary Owner. Eine Person mit dieser Rolle bitten, den Konnektor hinzuzufügen. |
| Mitglieder sehen Qargo nicht in ihrer Konnektorliste | Prüfen, ob der Konnektor auf Organisationsebene und nicht in einem persönlichen Profil hinzugefügt wurde. |
| Der Browser zeigt bei der Anmeldung einen Fehler wegen eines unbekannten Clients | Den Konnektor erneut verbinden. Bei Team oder Enterprise einen Owner bitten, ihn zu entfernen und erneut hinzuzufügen. Dies kann nach einem Update der Qargo-Plattform auftreten. |
| Der Konnektor ist aufgeführt, aber Claude hat keine Qargo-Tools | Entweder ist die Sitzung abgelaufen (Sitzungen dauern in der Regel einen Tag), dann erneut verbinden, oder Qargo ist für diese Unterhaltung deaktiviert. Im Chat auf die Schaltfläche + klicken, mit der Maus auf **Connectors** zeigen und Qargo aktivieren. |
| Claude meldet, dass der MCP-Zugriff für den Nutzer nicht aktiviert ist | Der Zugriff steht noch auf **Deaktiviert**. Einen Super admin bitten, ihn unter **Konfiguration > Organisationseinstellungen > Nutzer** festzulegen. |
| Claude kann Mandanten auflisten, aber alle anderen Anfragen schlagen fehl | Der externe API-Zugriff ist auf dem Mandanten nicht aktiviert. Den Account Manager kontaktieren. |
| Ein Lesevorgang funktioniert, eine Änderung wird jedoch abgelehnt | Der Zugriff steht auf **Nur lesen**. Ein Super admin kann die Stufe unter **Konfiguration > Organisationseinstellungen > Nutzer** ändern. |
| Bei der Authentifizierung in Claude Code öffnet sich kein Browser | Die Arbeit erfolgt über eine Remote-Shell. Stattdessen auf einem Rechner mit Browser authentifizieren. |
| /mcp listet qargo nicht auf | Das aktuelle Projekt ist nicht das Projekt, in dem der Server registriert wurde. Das Verzeichnis wechseln oder den Server mit --scope user erneut hinzufügen. |
| Das Terminal meldet einen Fehler wegen eines unbekannten Clients | Den Server mit claude mcp remove qargo entfernen und anschließend erneut hinzufügen. Dies kann nach einem Update der Qargo-Plattform auftreten. |


## Verwandte Artikel

- [INTEGRATIONEN – ChatGPT: Verbindung mit Qargo über MCP – Anleitung](https://help.qargo.com/de/articles/800127-integrationen-chatgpt-verbindung-mit-qargo-ueber-mcp-anleitung.md)
- [Integrationen – Qargo API – Was, warum und wie](https://help.qargo.com/de/articles/865547-integrationen-qargo-api-was-warum-und-wie.md)
- [Integrationen – WhatsApp-Konfiguration](https://help.qargo.com/de/articles/355075-integrationen-whatsapp-konfiguration.md)
- [FAQ – Anmeldung bei Qargo](https://help.qargo.com/de/articles/374948-faq-anmeldung-bei-qargo.md)
- [Intermodal: Zollintegration mit UK HMRC](https://help.qargo.com/de/articles/543446-intermodal-zollintegration-mit-uk-hmrc.md)
