KI-Anwendungen über das Model Context Protocol (MCP) mit dem Admin Interface verbinden: Server-URL eintragen, im Admin Interface anmelden und die Berechtigungen des Agenten festlegen.
Mit dem Model Context Protocol (MCP) können Sie eine KI-Anwendung mit dem Admin-Interface Ihres Shops verbinden. Anschließend kann der KI-Agent Funktionen des Admin-Interfaces für Sie ausführen, beispielsweise Bestellungen abrufen oder Produktdaten auslesen. Welche Funktionen das sind, legen Sie bei der Anmeldung selbst fest.Für die Anbindung sind nur zwei Schritte nötig: Zunächst tragen Sie die Adresse des Shops in Ihrer KI-Anwendung ein. Anschließend melden Sie sich mit Ihrem Benutzerkonto im Admin-Interface an. Im Shop selbst muss dafür nichts eingerichtet werden. Ihre KI-Anwendung muss lediglich den MCP-Server über eine Adresse (URL) anbinden können und die Anmeldung per OAuth unterstützen. Die folgenden Abschnitte beschreiben zunächst, wie der Zugriff des Agenten geregelt ist, und anschließend die Anbindung Schritt für Schritt.
Ein KI-Agent erhält kein eigenes Benutzerkonto. Er arbeitet immer im Namen des Benutzerkontos, mit dem Sie die Anbindung bestätigen. Dabei gelten zwei Grenzen:
Der Agent erhält nur die Berechtigungen, die Sie bei der Anmeldung freigeben. Dies sind dieselben Berechtigungen, die auch für Benutzerkonten im Admin-Interface gelten.
Sie können nur Berechtigungen freigeben, über die Ihr eigenes Benutzerkonto verfügt.
Der Agent sieht nur die Funktionen, für die er eine Berechtigung hat. Wenn Sie beispielsweise nur Leserechte für Bestellungen freigeben, kann der Agent Bestellungen abrufen, aber keine ändern oder löschen. Schreibende Funktionen werden ihm dann gar nicht erst angeboten.Ihre Zugangsdaten bekommt die KI-Anwendung dabei nie zu sehen. Die Anmeldung findet im Admin-Interface statt und die Anwendung erhält anschließend einen Zugangsschlüssel mit den freigegebenen Berechtigungen.
Alles, was der Agent im Shop ändert, geschieht im Namen Ihres Benutzerkontos. Geben Sie schreibende und löschende Berechtigungen deshalb nur frei, wenn der Agent sie für seine Aufgabe tatsächlich benötigt.
Fügen Sie in Ihrer KI-Anwendung einen neuen MCP-Server hinzu. Je nach Anwendung heißt die entsprechende Funktion beispielsweise „Connector hinzufügen“ oder „MCP-Server hinzufügen“. Tragen Sie dort folgende Adresse ein:
https://www.<ihr-shop>.de/admin/api/v1/mcp
Ersetzen Sie www.<ihr-shop>.de durch die Domain Ihres Shops. Einen API-Schlüssel, eine Client-ID oder ein Passwort müssen Sie dabei nicht eingeben. Den Namen des Servers können Sie in der Anwendung frei wählen.
Beim ersten Verbindungsaufbau öffnet die KI-Anwendung ein Browserfenster mit dem Admin-Interface. Wenn Sie sich dort noch nicht angemeldet haben, melden Sie sich mit Ihrem Benutzerkonto an.Danach erscheint die Seite “Zugriff autorisieren” mit der Frage „Möchten Sie <Anwendung> Zugriff auf das Admin-Interface gewähren?“. Unter “Anwendung” sehen Sie, welche KI-Anwendung den Zugriff anfragt. Prüfen Sie diese Angabe, bevor Sie fortfahren.
Unter Berechtigungen sind die Berechtigungen Ihres Benutzerkontos nach Bereichen gruppiert aufgeführt. Wählen Sie die Berechtigungen aus, die der Agent erhalten soll.
Hat die KI-Anwendung bestimmte Berechtigungen angefragt, sind diese bereits vorausgewählt. Sie können die Auswahl ändern.
Berechtigungen, die Ihr Benutzerkonto nicht besitzt, stehen nicht zur Auswahl.
Wenn Ihr Benutzerkonto ein Administrator-Konto ist, ist der Vollzugriff bereits vorausgewählt. Damit erhält der Agent alle Rechte Ihres Kontos. Wenn der Agent nur eingeschränkt arbeiten soll, heben Sie den Vollzugriff auf und wählen Sie die benötigten Berechtigungen einzeln aus. Vollzugriff können nur Administratoren erteilen.
Klicken Sie auf “Autorisieren”, um den Zugriff mit den ausgewählten Berechtigungen zu erteilen. Der Browser leitet Sie anschließend zurück zur KI-Anwendung. Damit ist die Verbindung hergestellt. Mit “Ablehnen” brechen Sie den Vorgang ab, die Anwendung erhält dann keinen Zugriff.Die Anfrage auf der Seite “Zugriff autorisieren” ist 10 Minuten gültig. Bestätigen Sie sie innerhalb dieser Zeit.
Die Seite zeigt „Die Autorisierungsanfrage ist ungültig oder abgelaufen.“
Die Anfrage wurde nicht innerhalb von 10 Minuten bestätigt. Starten Sie die Anmeldung in der KI-Anwendung erneut.
Der Agent findet eine Funktion nicht oder meldet, dass sie nicht verfügbar ist.
Die zugehörige Berechtigung wurde nicht freigegeben. Trennen Sie die Verbindung in der KI-Anwendung, verbinden Sie sie neu und wählen Sie die fehlende Berechtigung aus.
Eine Berechtigung fehlt in der Auswahl auf der Seite “Zugriff autorisieren”.
Ihr Benutzerkonto besitzt diese Berechtigung nicht. Lassen Sie sie Ihrem Konto von einem Administrator zuweisen oder bestätigen Sie die Anbindung mit einem Konto, das sie besitzt.
Die KI-Anwendung meldet einen Fehler, bevor sich das Admin Interface öffnet.
Prüfen Sie die eingetragene Adresse. Sie muss genau auf /admin/api/v1/mcp enden und mit https:// beginnen.
