INTEGRATIONEN – ChatGPT: Verbindung mit Qargo über MCP – Anleitung
Das Qargo-Konto mit ChatGPT verbinden und ChatGPT anschließend Fragen zu Live-Daten stellen. In den Plänen Business, Enterprise und Education veröffentlicht zuerst ein Workspace-Inhaber die Qargo-App. In Plus und Pro fügt der Nutzer sie selbst hinzu.
Inhaltsverzeichnis
Voraussetzungen
- Qargo Intelligence auf dem Mandanten. MCP ist Teil des Add-ons Qargo Intelligence. Fehlt es, den zuständigen Account Manager kontaktieren.
- MCP-Zugriff für den Nutzer festgelegt. Ein Super admin der Organisation legt ihn unter Konfiguration > Organisationseinstellungen > Nutzer fest. Eine Anfrage an Qargo ist nicht nötig. Die einzelnen Schritte stehen in INTEGRATIONEN – Einen KI-Assistenten über MCP mit Qargo verbinden.
- Die üblichen Qargo-Anmeldedaten. Ein separater Schlüssel oder Token ist nicht erforderlich.
- ChatGPT im Web. Benutzerdefinierte MCP-Apps funktionieren nicht in den mobilen ChatGPT-Apps.
| Plan | Wer die Qargo-App hinzufügt | Möglichkeiten |
|---|---|---|
| Business, Enterprise oder Education | Ein Admin oder Inhaber, einmalig für den Workspace | Daten lesen und ändern, abhängig von der Qargo-MCP-Zugriffsstufe des Nutzers |
| Plus oder Pro | Der Nutzer selbst, für sich | Nur Daten lesen. OpenAI beschränkt benutzerdefinierte Connectoren in Einzelplänen auf Lesen und Abrufen |
| Free | Niemand. Benutzerdefinierte Connectoren erfordern einen kostenpflichtigen Plan. | Nichts |
Business, Enterprise und Education: App veröffentlichen
Ein Admin oder Inhaber fügt die Qargo-App einmalig hinzu. Die Mitglieder authentifizieren sich anschließend einzeln.
Anforderungen
- Admin- oder Inhaberrechte. Nur Admins und Inhaber können den Entwicklermodus aktivieren und eine App veröffentlichen. Ein Admin kann den Entwicklermodus nicht im Namen eines Mitglieds aktivieren.
- MCP-Zugriff in Qargo festgelegt für die Nutzer, die ihn benötigen. Ein Super admin legt ihn pro Nutzer unter Konfiguration > Organisationseinstellungen > Nutzer fest. Dies vor dem Veröffentlichen erledigen, damit sich die Mitglieder sofort authentifizieren können.
Entwicklermodus aktivieren
Benutzerdefinierte MCP-Apps sind nur im Entwicklermodus verfügbar, und jeder Admin aktiviert ihn für sich selbst.
- Business. Einstellungen > Apps > Erweiterte Einstellungen öffnen und den Entwicklermodus einschalten. Er lässt sich auch beim Erstellen der App aktivieren.
- Enterprise und Education. Ein Admin gewährt zuerst den Zugriff unter Workspace-Einstellungen > Berechtigungen und Rollen > Verbundene Daten. Jede berechtigte Person schaltet ihn dann unter Einstellungen > Apps > Erweiterte Einstellungen ein.
Qargo-App hinzufügen und veröffentlichen
- Zu Workspace-Einstellungen > Apps navigieren und dann auf Erstellen klicken.
- Qargo als Namen und https://mcp.qargo.com/mcp als Endpunkt eingeben.
- OAuth als Authentifizierungsmethode auswählen. Client-ID und Secret leer lassen; Qargo vergibt keines von beiden.
- Auf Tools scannen klicken, die Anmeldeaufforderung abschließen, sobald sie erscheint, und warten, bis der Scan beendet ist.
- Auf Erstellen klicken. Die App erscheint unter Workspace-Einstellungen > Apps > Entwürfe.
- Den Entwurf vor dem Veröffentlichen in einem neuen Chat testen.
- Die App unter Entwürfe veröffentlichen und anschließend festlegen, wer darauf zugreifen kann.
Festlegen, wer die App nutzen kann
Das Veröffentlichen macht die App verfügbar. Es gewährt niemandem Zugriff auf Qargo-Daten.
- Nutzerzugriff festlegen, damit nur die vorgesehenen Personen die App nutzen können. In Enterprise und Education lässt sich vor dem Veröffentlichen außerdem auswählen, welche Aktionen die App ausführen darf.
- Aktionsbestätigung festlegen, um zu bestimmen, wann ChatGPT vor dem Aufruf eines Tools nachfragt.
- Qargo-Berechtigungen Qargo überlassen. Jedes Mitglied authentifiziert sich separat und erhält nur die eigenen Qargo-Berechtigungen.
Die Mitglieder anweisen, den nächsten Abschnitt zu befolgen.
Qargo-Konto verbinden
Die Qargo-App sollte bereits in der App-Liste erscheinen. Ist dies nicht der Fall, an den Workspace-Admin wenden. Mitglieder können sie nicht selbst hinzufügen.
- Die Qargo-App in ChatGPT öffnen.
- Mit den normalen Qargo-Anmeldedaten anmelden, wenn sich der Browser öffnet.
- Die Zugriffsanfrage genehmigen. Der Browser kehrt zu ChatGPT zurück.
- Die Qargo-App für die Nachricht auswählen und ChatGPT dann bitten, die Qargo-Mandanten aufzulisten. Eine Antwort, die den eigenen Mandanten nennt, bestätigt die Verbindung.
Plus und Pro: Connector selbst hinzufügen
In einem kostenpflichtigen Einzelplan muss nicht auf einen Admin gewartet werden, allerdings lassen sich Qargo-Daten nur lesen, nicht ändern. Benutzerdefinierte Connectoren sind nur im Entwicklermodus der Web-App verfügbar.
- Die ChatGPT-Einstellungen und dann Apps > Erweiterte Einstellungen öffnen und den Entwicklermodus einschalten.
- Auf Erstellen klicken, um einen benutzerdefinierten Connector hinzuzufügen.
- Qargo als Namen und https://mcp.qargo.com/mcp als Endpunkt eingeben.
- OAuth als Authentifizierungsmethode auswählen. Client-ID und Secret leer lassen.
- Die Tools scannen, sich dann mit den normalen Qargo-Anmeldedaten anmelden und die Zugriffsanfrage genehmigen.
- Den Connector für die Nachricht auswählen und ChatGPT dann bitten, die Qargo-Mandanten aufzulisten.
Daten ändern
Dies gilt für Workspaces mit Business, Enterprise und Education. In Plus und Pro kann ChatGPT die Qargo-Daten lesen, aber nicht ändern.
Die erste Änderung an Produktivdaten in einer Sitzung wird angehalten, und ChatGPT gibt einen Genehmigungslink zurück. Den Link öffnen, genehmigen und ChatGPT bitten, es erneut zu versuchen. Die vollständigen Schritte stehen in INTEGRATIONEN – Einen KI-Assistenten über MCP mit Qargo verbinden.
Fehlerbehebung
| Problem | Lösung |
|---|---|
| Die Qargo-App fehlt in der App-Liste | Sie wurde im Workspace noch nicht veröffentlicht. An den Workspace-Admin wenden. In Plus oder Pro die App mit den oben beschriebenen Schritten selbst hinzufügen. |
| Der Toggle für den Entwicklermodus fehlt | Entweder ist er im Plan nicht enthalten, oder er wurde auf Workspace-Ebene nicht freigegeben. In Enterprise und Education gewährt ein Admin zuerst den Zugriff unter Berechtigungen und Rollen > Verbundene Daten. Dies ist eine Richtlinie, kein Fehler. |
| Benutzerdefinierte Connectoren sind auf dem Smartphone nicht auffindbar | Benutzerdefinierte MCP-Apps gibt es nur im Web. ChatGPT im Browser verwenden. |
| Das Scannen der Tools liefert kein Ergebnis | Prüfen, ob der Endpunkt genau https://mcp.qargo.com/mcp lautet. Ein abschließender Schrägstrich oder ein fehlender Pfad verhindert die Erkennung. |
| Die App ist veröffentlicht, aber Mitglieder sehen keine Qargo-Tools | Die Mitglieder haben sich noch nicht authentifiziert, oder ihr MCP-Zugriff steht unter Konfiguration > Organisationseinstellungen > Nutzer noch auf Deaktiviert. Beides prüfen. |
| Tool-Aufrufe schlagen nach einem Qargo-Update fehl | ChatGPT verwendet die Tool-Liste, die beim Veröffentlichen der App erfasst wurde. Den Admin bitten, die Aktionen der App unter Workspace-Einstellungen > Apps zu aktualisieren. In Business-Plänen muss die App neu erstellt und erneut veröffentlicht werden. |
| ChatGPT 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. |
| Die Anmeldung bei Qargo wird immer wieder angefordert | Sitzungen laufen ab, in der Praxis etwa einmal täglich. Eine gelegentliche erneute Authentifizierung ist daher normal. Tritt dies deutlich häufiger auf, den Qargo-Support kontaktieren. |
| Der Browser zeigt bei der Anmeldung einen Fehler zu einem unbekannten Client | Den Workspace-Admin bitten, die App zu entfernen und erneut zu veröffentlichen. Dies kann nach einem Update der Qargo-Plattform vorkommen. |
| ChatGPT ignoriert Qargo und antwortet aus allgemeinem Wissen | Die Qargo-App für diese Nachricht auswählen und Qargo in der Frage nennen. |
| Lesen funktioniert, eine Änderung wird aber abgelehnt | Entweder hat der Nutzer in Qargo nur Nur Lesen, was ein Super admin unter Konfiguration > Organisationseinstellungen > Nutzer ändern kann, oder der Nutzer verwendet ChatGPT Plus oder Pro, wo benutzerdefinierte Connectoren auf das Lesen beschränkt sind. |
