Zum Hauptinhalt springen

QrX mit Ihrem KI-Assistenten verbinden (MCP)

Verbinden Sie Claude, ChatGPT, Cursor oder einen anderen KI-Assistenten mit QrX über die MCP-Server-URL https://api.qr-x.net/mcp, melden Sie sich mit Ihrem QrX-Portalkonto an und wählen Sie die Rechte.

H
Verfasst von Hayko

QrX mit Ihrem KI-Assistenten verbinden (MCP)

Sie können QrX mit einem KI-Assistenten wie Claude, ChatGPT oder Cursor verbinden. Danach stellen Sie Fragen in normaler Sprache, zum Beispiel "Welche Produkte haben wenig Bestand?", "Wie viele Bestellungen warten auf das Verpacken?", "Wie ist der Zahlungsstatus von Bestellung 10452?" oder "Was braucht heute meine Aufmerksamkeit?". Der Assistent liest die Antwort direkt aus Ihrem QrX-Konto. Wenn Sie es erlauben, kann der Assistent auch einige wenige Lageränderungen vornehmen, immer erst nach Ihrer Bestätigung.

Die Verbindung nutzt MCP (Model Context Protocol), den offenen Standard, mit dem KI-Assistenten mit anderer Software sprechen. QrX betreibt einen MCP-Server; Ihr Assistent verbindet sich damit als benutzerdefinierter Connector.

Wer es nutzen kann

  • Der KI-Connector ist in den kostenpflichtigen QrX-Tarifen enthalten. Es gibt keinen separaten Preis.

  • Sie melden sich mit Ihrem eigenen QrX-Portalkonto an. Der Assistent erhält dieselben Rechte, die Sie in QrX haben, nie mehr.

  • Fragen zu Bestand und Lager sowie Lageränderungen erfordern das Modul QrX Warehouse (WMS). Fragen zu Retouren erfordern in Ihrer QrX-Rolle die Berechtigung, Retouren zu verwalten. Tools für ein Modul, das Sie nicht nutzen, werden dem Assistenten nicht angezeigt.

  • QrX-Adminkonten können sich nicht verbinden. Wenn Sie PortalX als anderer Benutzer ansehen, beenden Sie das zuerst und melden Sie sich mit Ihrem eigenen Konto an.

  • CRM-Fragen benötigen die CRM-Berechtigungen in Ihrer QrX-Rolle (jedes QrX-Konto hat den kostenlosen CRM-Plan). CRM-Änderungen benötigen zusätzlich die Berechtigung, das CRM zu bearbeiten.

Was Sie brauchen

  • Einen KI-Assistenten, der benutzerdefinierte MCP-Connectors unterstützt (auch Remote-MCP-Server oder Custom Apps genannt).

  • Die URL des QrX-MCP-Servers: https://api.qr-x.net/mcp

  • Ihr QrX-Portalkonto (das Konto, das Sie auf portal.qr-x.app nutzen).

So verbinden Sie (jeder Assistent)

  1. Öffnen Sie in Ihrem KI-Assistenten den Bereich, in dem Sie Connectors hinzufügen, und wählen Sie einen benutzerdefinierten Connector (oder einen benutzerdefinierten MCP-Server).

  2. Geben Sie einen Namen ein, zum Beispiel "QrX", und die Server-URL https://api.qr-x.net/mcp. Sie brauchen keinen API-Schlüssel, keine Client-ID und kein Secret.

  3. Starten Sie die Anmeldung. Das QrX-Portal öffnet sich. Melden Sie sich mit Ihrem QrX-Portalkonto an, falls Sie noch nicht angemeldet sind.

  4. Die QrX-Seite "[Assistent] mit QrX verbinden" zeigt die App, wohin Sie zurückgeleitet werden, und eine Liste dessen, was der Assistent lesen darf. Haken Sie nur an, was Sie teilen möchten. Was jede Option bedeutet, lesen Sie in "Was der QrX-KI-Connector kann und was nicht".

  5. Optional: Haken Sie Lageränderungen an, wenn der Assistent auch Lageränderungen vornehmen darf. Das ist standardmäßig aus und erfordert Bestand und Lager.

  6. Optional: Haken Sie CRM-Änderungen an, wenn der Assistent CRM-Personen, Unternehmen, Deals, Notizen und Aufgaben anlegen oder ändern, Deals verschieben und einen Anruf starten darf. Standardmäßig aus; benötigt CRM.

  7. Optional: Haken Sie Message-Centre-Antworten, Retourenbearbeitung, Bestell-Tags oder Produktänderungen an, wenn der Assistent auch in Unterhaltungen antworten, Retouren bearbeiten, Bestell-Tags ändern oder ein Produkt offline nehmen und seinen Bestand setzen darf. Jede Option ist standardmäßig aus und braucht ihre Leseoption (Nachrichtentext, Retouren, Bestellungen, Produkte). Siehe "Den QrX-KI-Connector für Unterhaltungen, Retouren, Bestellungen und Produkte nutzen".

  8. Klicken Sie auf Zulassen. Sie kehren zu Ihrem Assistenten zurück und die Verbindung ist bereit. Mit Ablehnen brechen Sie ab, ohne zu verbinden.

Die neue Verbindung erscheint nun in QrX unter Einstellungen > Erweitert > Verbundene Apps.

Schritte je Assistent

Menünamen in KI-Assistenten ändern sich oft. Wenn ein Schritt unten nicht zu dem passt, was Sie sehen, folgen Sie den allgemeinen Schritten oben und den Hilfeseiten Ihres Assistenten. Die Menünamen stehen unten auf Englisch, wie im Assistenten.

  • Claude (Free, Pro und Max): Gehen Sie zu Customize > Connectors, klicken Sie auf + und dann auf Add custom connector, geben Sie den Namen und die URL https://api.qr-x.net/mcp ein, fahren Sie fort und melden Sie sich mit QrX an. Schalten Sie den Connector in einem Chat über die Schaltfläche +, Connectors ein. Im Claude-Free-Tarif können Sie einen benutzerdefinierten Connector hinzufügen.

  • Claude (Team und Enterprise): Ein Owner fügt den Connector einmal unter Organization settings > Connectors, Add, Custom, Web mit derselben URL hinzu. Jedes Mitglied geht danach zu Customize > Connectors, sucht QrX und klickt auf Connect, um sich mit dem eigenen QrX-Konto anzumelden.

  • ChatGPT (Business, Enterprise und Edu): Benutzerdefinierte MCP-Apps erfordern den Developer Mode, den ein Workspace-Admin einschaltet. Gehen Sie danach zu Settings > Apps > Create (Admins können auch Workspace settings nutzen), geben Sie die URL https://api.qr-x.net/mcp ein, wählen Sie OAuth, klicken Sie auf Scan Tools, melden Sie sich mit QrX an und klicken Sie auf Create.

  • Cursor: Fügen Sie QrX als Remote-MCP-Server mit der URL https://api.qr-x.net/mcp hinzu (in den MCP-Einstellungen oder in mcp.json) und melden Sie sich mit QrX an, wenn Cursor danach fragt.

Jede Person verbindet sich mit dem eigenen QrX-Konto, auch wenn ein Connector in einem Team-Workspace geteilt wird. Der Assistent sieht dann nur, was diese Person in QrX sehen darf.

Gut zu wissen

  • "Nicht verifiziert" auf der Verbindungsseite bedeutet, dass QrX die App nicht verifiziert hat und die App ihren Namen selbst gewählt hat. Fahren Sie nur fort, wenn Sie die Verbindung selbst aus einem Assistenten gestartet haben, dem Sie vertrauen. Die Seite zeigt, wohin Ihre Daten gehen.

  • Was der Assistent liest, wird an das Unternehmen gesendet, das Ihren KI-Assistenten betreibt, damit er Ihnen antworten kann. Teilen Sie nur, was nötig ist. Nachrichtentext wird nie geteilt, außer Sie haken Nachrichtentext an.

  • Sie können jederzeit unter Einstellungen > Erweitert > Verbundene Apps trennen. Siehe "Eine verbundene KI-App trennen (widerrufen)".

  • Mehr über den QrX-KI-Connector: qrx.eu/mcp.

Häufige Probleme

  • "Dieser Verbindungslink ist ungültig": Der Link ist abgelaufen oder wurde bereits verwendet. Starten Sie die Verbindung erneut in Ihrem KI-Assistenten.

  • "Melden Sie sich an, um fortzufahren": Ihre QrX-Sitzung ist abgelaufen. Melden Sie sich erneut an, dann geht die Verbindung weiter.

  • "Ihr Konto kann keine Apps verbinden": Ihr Konto hat keinen Zugriff auf das QrX-Portal. Bitten Sie einen Admin Ihres Unternehmens um Zugriff.

  • "QrX-Adminkonten können sich nicht verbinden": Melden Sie sich stattdessen mit einem Händlerkonto an.

  • Eine Option auf der Verbindungsseite ist ausgegraut: "Dieses Modul ist in Ihrem Konto nicht aktiv" bedeutet, dass Sie dieses QrX-Modul nicht nutzen. "Ihre Rolle erlaubt das nicht" bedeutet, dass Ihrer QrX-Rolle das Recht fehlt; wenden Sie sich an einen Admin Ihres Kontos.

  • Der Assistent meldet, dass er keinen Zugriff hat, oder bittet um erneute Anmeldung: Die Verbindung wurde getrennt, zum Beispiel unter Verbundene Apps, weil Sie sich auf allen Geräten abgemeldet haben, oder nach einem Zurücksetzen des Passworts. Verbinden Sie erneut.

  • Der Assistent meldet, dass ein Limit erreicht ist: Warten Sie eine Minute und versuchen Sie es erneut. Die Limits finden Sie in "Was der QrX-KI-Connector kann und was nicht".

Wann Sie unser Support-Team kontaktieren sollten

Kontaktieren Sie den QrX-Support, wenn die Verbindung trotz der Schritte fehlschlägt, wenn Sie unter Verbundene Apps eine Verbindung sehen, die in Ihrem Unternehmen niemand kennt, oder wenn der Assistent Daten zeigt, die er Ihrer Meinung nach nicht sehen sollte. Nennen Sie den Assistenten, den Zeitpunkt des Versuchs und die genaue Meldung auf dem Bildschirm. Senden Sie nie Passwörter oder Tokens.

Hat dies deine Frage beantwortet?