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.
Admin Interface API: Übersicht der Funktionen, die ein Agent je nach Berechtigung nutzen kann.
War diese Seite hilfreich?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"WEBSALE Dokumentation","description":"Offizielle Dokumentation der E-Commerce-Plattform WEBSALE der WEBSALE AG. Sie umfasst Template-Engine, Shopkonfiguration, Admin-Interface, Schnittstellen, Strapi CMS und WEBSALE | search für die aktuelle Generation sowie für Version V8s.","colors":{"primary":"#0066CC"},"logo":{"light":"https://mintcdn.com/websaleag-44ee7ea6/yeKhhJTjoXWEQCsc/logo/Logo_WEBSALE_2024_Farbverlauf_RGB.png?fit=max\u0026auto=format\u0026n=yeKhhJTjoXWEQCsc\u0026q=85\u0026s=b96a564fcbb0d782bfeb7df19423835e","dark":"https://mintcdn.com/websaleag-44ee7ea6/yeKhhJTjoXWEQCsc/logo/Logo_WEBSALE_2024_Farbverlauf_RGB.png?fit=max\u0026auto=format\u0026n=yeKhhJTjoXWEQCsc\u0026q=85\u0026s=b96a564fcbb0d782bfeb7df19423835e","href":"/"},"favicon":"https://mintcdn.com/websaleag-44ee7ea6/yeKhhJTjoXWEQCsc/logo/favicon.ico?fit=max\u0026auto=format\u0026n=yeKhhJTjoXWEQCsc\u0026q=85\u0026s=5d387abffbbbc1811401ecb3afd2a807","footer":{"socials":{"linkedin":"https://www.linkedin.com/company/websale-ag"},"links":[{"items":[{"label":"Impressum","href":"https://websale.de/impressum"},{"label":"Datenschutz","href":"https://websale.de/datenschutz"}]}]},"search":{"prompt":"Durchsuchen"},"fonts":{"family":"Inter"},"styling":{"codeblocks":{"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}},"latex":true},"navigation":{"languages":[{"language":"de","href":""},{"language":"en","href":"en"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"websaleag-44ee7ea6","hasAudioNarration":false,"actualSubdomain":"websaleag-44ee7ea6","customDomains":["dokumentation.websale.de"],"gitSource":{"type":"gitlab","owner":"websale-ag-group","repo":"dokumentation","deployBranch":"main","contentDirectory":"","isPrivate":false,"projectId":83013579,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aedc3985097775cf1354d2d","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"de","tag":"Version V8s","count":563},{"language":"de","tag":"Wegweiser","count":546},{"language":"de","tag":"Referenz","count":326},{"language":"en","tag":"Reference","count":326},{"language":"en","tag":"Version V8s","count":325},{"language":"en","tag":"Guide","count":248},{"language":"de","tag":"Neue Generation","count":245},{"language":"en","tag":"New generation","count":245},{"language":"de","tag":"Schnittstellen","count":174},{"language":"de","tag":"Tags","count":132},{"language":"en","tag":"Tags","count":132},{"language":"de","tag":"Frontend","count":93},{"language":"en","tag":"Frontend","count":93},{"language":"de","tag":"Konfiguration","count":76},{"language":"en","tag":"Configuration","count":76},{"language":"de","tag":"Bestellprozess","count":61},{"language":"en","tag":"Interfaces","count":60},{"language":"de","tag":"Materialien","count":58},{"language":"en","tag":"Reference – Modules","count":39},{"language":"en","tag":"Admin Interface API","count":36}],"searchSettings":{"isFiltersEnabled":true,"showContentSnippets":true}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@websale.de","showHelpButton":false}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"*:has(>[data-component-part=\"products-selector-trigger\"]){flex-shrink:0!important;min-width:fit-content!important}[data-component-part=\"products-selector-trigger\"]{flex-shrink:0!important;overflow:visible!important;max-width:none!important}[data-component-part=\"products-selector-trigger\"]>span{max-width:none!important;overflow:visible!important}"}],"page":{"pagePath":"ki-agenten-anbinden-mcp","slug":"/ki-agenten-anbinden-mcp","pageMetadata":{"title":"KI-Agenten anbinden (MCP)","description":"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.","keywords":["MCP, Model Context Protocol, KI-Agent, KI-Assistent, Admin Interface, Berechtigungen, Zugriff autorisieren, OAuth"],"href":"/ki-agenten-anbinden-mcp"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"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.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`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.`}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`so-ist-der-zugriff-des-agenten-geregelt`,children:`So ist der Zugriff des Agenten geregelt`}),`\n`,_jsx(_components.p,{children:`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:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`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.`}),`\n`,_jsx(_components.li,{children:`Sie können nur Berechtigungen freigeben, über die Ihr eigenes Benutzerkonto verfügt.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`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.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`ki-agenten-anbinden`,children:`KI-Agenten anbinden`}),`\n`,_jsx(Heading,{level:`3`,id:`schritt-1-server-in-der-ki-anwendung-hinzufügen`,children:`Schritt 1: Server in der KI-Anwendung hinzufügen`}),`\n`,_jsx(_components.p,{children:`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:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://www.\u003cihr-shop>.de/admin/api/v1/mcp`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`Ersetzen Sie `,_jsx(_components.code,{children:`www.\u003cihr-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.`]}),`\n`,_jsx(Heading,{level:`3`,id:`schritt-2-im-admin-interface-anmelden`,children:`Schritt 2: Im Admin-Interface anmelden`}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsxs(_components.p,{children:[`Danach erscheint die Seite “`,_jsx(_components.strong,{children:`Zugriff autorisieren”`}),` mit der Frage „Möchten Sie \u003cAnwendung> Zugriff auf das Admin-Interface gewähren?“. Unter `,_jsx(_components.strong,{children:`“Anwendung”`}),` sehen Sie, welche KI-Anwendung den Zugriff anfragt. Prüfen Sie diese Angabe, bevor Sie fortfahren.`]}),`\n`,_jsx(Heading,{level:`3`,id:`schritt-3-berechtigungen-auswählen`,children:`Schritt 3: Berechtigungen auswählen`}),`\n`,_jsxs(_components.p,{children:[`Unter `,_jsx(_components.strong,{children:`Berechtigungen`}),` sind die Berechtigungen Ihres Benutzerkontos nach Bereichen gruppiert aufgeführt. Wählen Sie die Berechtigungen aus, die der Agent erhalten soll.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Hat die KI-Anwendung bestimmte Berechtigungen angefragt, sind diese bereits vorausgewählt. Sie können die Auswahl ändern.`}),`\n`,_jsx(_components.li,{children:`Berechtigungen, die Ihr Benutzerkonto nicht besitzt, stehen nicht zur Auswahl.`}),`\n`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`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.`})}),`\n`,_jsx(Heading,{level:`3`,id:`schritt-4-zugriff-bestätigen`,children:`Schritt 4: Zugriff bestätigen`}),`\n`,_jsxs(_components.p,{children:[`Klicken Sie auf `,_jsx(_components.strong,{children:`“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 `,_jsx(_components.strong,{children:`“Ablehnen”`}),` brechen Sie den Vorgang ab, die Anwendung erhält dann keinen Zugriff.`]}),`\n`,_jsxs(_components.p,{children:[`Die Anfrage auf der Seite `,_jsx(_components.strong,{children:`“Zugriff autorisieren”`}),` ist 10 Minuten gültig. Bestätigen Sie sie innerhalb dieser Zeit.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`wenn-etwas-nicht-funktioniert`,children:`Wenn etwas nicht funktioniert`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.strong,{children:`Problem`})}),_jsx(_components.th,{children:_jsx(_components.strong,{children:`Ursache und Lösung`})})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Die Seite zeigt „Die Autorisierungsanfrage ist ungültig oder abgelaufen.“`}),_jsx(_components.td,{children:`Die Anfrage wurde nicht innerhalb von 10 Minuten bestätigt. Starten Sie die Anmeldung in der KI-Anwendung erneut.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Der Agent findet eine Funktion nicht oder meldet, dass sie nicht verfügbar ist.`}),_jsx(_components.td,{children:`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.`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Eine Berechtigung fehlt in der Auswahl auf der Seite `,_jsx(_components.strong,{children:`“Zugriff autorisieren”`}),`.`]}),_jsx(_components.td,{children:`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.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Die KI-Anwendung meldet einen Fehler, bevor sich das Admin Interface öffnet.`}),_jsxs(_components.td,{children:[`Prüfen Sie die eingetragene Adresse. Sie muss genau auf `,_jsx(_components.code,{children:`/admin/api/v1/mcp`}),` enden und mit `,_jsx(_components.code,{children:`https://`}),` beginnen.`]})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`weiterführende-links`,children:`Weiterführende Links`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/schnittstellen/admin-interface-api/api-referenz-oauth`,children:`API-Referenz OAuth`}),`: technischer Ablauf der Anmeldung, Berechtigungen (Scopes) und Gültigkeit der Zugangsschlüssel.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/schnittstellen/admin-interface-api/api-referenz-benutzerverwaltung`,children:`API-Referenz Benutzerverwaltung`}),`: Benutzerkonten und Berechtigungen verwalten.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/schnittstellen/admin-interface-api`,children:`Admin Interface API`}),`: Übersicht der Funktionen, die ein Agent je nach Berechtigung nutzen kann.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}},"config":{},"pageMetadata":{"title":"KI-Agenten anbinden (MCP)","description":"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.","keywords":["MCP, Model Context Protocol, KI-Agent, KI-Assistent, Admin Interface, Berechtigungen, Zugriff autorisieren, OAuth"],"href":"/ki-agenten-anbinden-mcp"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"So ist der Zugriff des Agenten geregelt","slug":"so-ist-der-zugriff-des-agenten-geregelt","depth":2,"children":[]},{"title":"KI-Agenten anbinden","slug":"ki-agenten-anbinden","depth":2,"children":[{"title":"Schritt 1: Server in der KI-Anwendung hinzufügen","slug":"schritt-1-server-in-der-ki-anwendung-hinzufügen","depth":3,"children":[]},{"title":"Schritt 2: Im Admin-Interface anmelden","slug":"schritt-2-im-admin-interface-anmelden","depth":3,"children":[]},{"title":"Schritt 3: Berechtigungen auswählen","slug":"schritt-3-berechtigungen-auswählen","depth":3,"children":[]},{"title":"Schritt 4: Zugriff bestätigen","slug":"schritt-4-zugriff-bestätigen","depth":3,"children":[]}]},{"title":"Wenn etwas nicht funktioniert","slug":"wenn-etwas-nicht-funktioniert","depth":2,"children":[]},{"title":"Weiterführende Links","slug":"weiterführende-links","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"websaleag-44ee7ea6","siteName":"WEBSALE Dokumentation","title":"KI-Agenten anbinden (MCP) - WEBSALE Dokumentation","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"de":{"href":"/ki-agenten-anbinden-mcp","matchLevel":0},"en":{"href":"/en/ki-agenten-anbinden-mcp","matchLevel":1}}},"lastModified":"2026-10-26T16:43:29.205Z","originalFileLocation":"ki-agenten-anbinden-mcp.mdx","locale":"de"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"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.\">\u003cmeta data-mint-head name=\"application-name\" content=\"WEBSALE Dokumentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/websaleag-44ee7ea6/b-DMHJEWRrC_pLQS/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/websaleag-44ee7ea6/b-DMHJEWRrC_pLQS/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/websaleag-44ee7ea6/b-DMHJEWRrC_pLQS/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/websaleag-44ee7ea6/b-DMHJEWRrC_pLQS/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/websaleag-44ee7ea6/b-DMHJEWRrC_pLQS/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/websaleag-44ee7ea6/b-DMHJEWRrC_pLQS/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/websaleag-44ee7ea6/b-DMHJEWRrC_pLQS/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/websaleag-44ee7ea6/b-DMHJEWRrC_pLQS/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/websaleag-44ee7ea6/b-DMHJEWRrC_pLQS/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"KI-Agenten anbinden (MCP) - WEBSALE Dokumentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"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.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"WEBSALE Dokumentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://dokumentation.websale.de/ki-agenten-anbinden-mcp\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://websaleag-44ee7ea6.mintlify.site/_mintlify/api/og/v2?division=Admin+Interface\u0026amp;title=KI-Agenten+anbinden+%28MCP%29\u0026amp;description=KI-Anwendungen+%C3%BCber+das+Model+Context+Protocol+%28MCP%29+mit+dem+Admin+Interface+verbinden%3A+Server-URL+eintragen%2C+im+Admin+Interface+anmelden+und+die+Berechtigungen\u0026amp;theme=2f1e88ce90c5c698bc58bf46\u0026amp;signature=8530db1b3c4b40a54cb72d4b6e39be11995d0a2719c93b835aa1634868c3b7e3\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"KI-Agenten anbinden (MCP) - WEBSALE Dokumentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"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.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://websaleag-44ee7ea6.mintlify.site/_mintlify/api/og/v2?division=Admin+Interface\u0026amp;title=KI-Agenten+anbinden+%28MCP%29\u0026amp;description=KI-Anwendungen+%C3%BCber+das+Model+Context+Protocol+%28MCP%29+mit+dem+Admin+Interface+verbinden%3A+Server-URL+eintragen%2C+im+Admin+Interface+anmelden+und+die+Berechtigungen\u0026amp;theme=2f1e88ce90c5c698bc58bf46\u0026amp;signature=8530db1b3c4b40a54cb72d4b6e39be11995d0a2719c93b835aa1634868c3b7e3\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/websaleag-44ee7ea6/b-DMHJEWRrC_pLQS/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"WEBSALE Dokumentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0066CC\">\u003clink data-mint-head rel=\"canonical\" href=\"https://dokumentation.websale.de/ki-agenten-anbinden-mcp\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ki-agenten-anbinden-mcp.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://dokumentation.websale.de/ki-agenten-anbinden-mcp\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://dokumentation.websale.de/en/ki-agenten-anbinden-mcp\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://dokumentation.websale.de/ki-agenten-anbinden-mcp\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://dokumentation.websale.de/#organization\",\"name\":\"WEBSALE Dokumentation\",\"url\":\"https://dokumentation.websale.de\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/websaleag-44ee7ea6/yeKhhJTjoXWEQCsc/logo/Logo_WEBSALE_2024_Farbverlauf_RGB.png?fit=max\u0026auto=format\u0026n=yeKhhJTjoXWEQCsc\u0026q=85\u0026s=b96a564fcbb0d782bfeb7df19423835e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://dokumentation.websale.de#website\",\"name\":\"WEBSALE Dokumentation\",\"url\":\"https://dokumentation.websale.de\",\"publisher\":{\"@id\":\"https://dokumentation.websale.de/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://dokumentation.websale.de/ki-agenten-anbinden-mcp#webpage\",\"url\":\"https://dokumentation.websale.de/ki-agenten-anbinden-mcp\",\"name\":\"KI-Agenten anbinden (MCP)\",\"description\":\"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.\",\"dateModified\":\"2026-10-26T16:43:29.205Z\",\"isPartOf\":{\"@id\":\"https://dokumentation.websale.de#website\"},\"breadcrumb\":{\"@id\":\"https://dokumentation.websale.de/ki-agenten-anbinden-mcp#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://dokumentation.websale.de/ki-agenten-anbinden-mcp#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Admin Interface\",\"item\":\"https://dokumentation.websale.de/admin-interface\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"KI-Agenten anbinden (MCP)\",\"item\":\"https://dokumentation.websale.de/ki-agenten-anbinden-mcp\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://dokumentation.websale.de/ki-agenten-anbinden-mcp#article\",\"headline\":\"KI-Agenten anbinden (MCP)\",\"name\":\"KI-Agenten anbinden (MCP)\",\"description\":\"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.\",\"url\":\"https://dokumentation.websale.de/ki-agenten-anbinden-mcp\",\"mainEntityOfPage\":{\"@id\":\"https://dokumentation.websale.de/ki-agenten-anbinden-mcp#webpage\"},\"dateModified\":\"2026-10-26T16:43:29.205Z\",\"keywords\":\"MCP, Model Context Protocol, KI-Agent, KI-Assistent, Admin Interface, Berechtigungen, Zugriff autorisieren, OAuth\",\"publisher\":{\"@id\":\"https://dokumentation.websale.de/#organization\"},\"isPartOf\":{\"@id\":\"https://dokumentation.websale.de#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"WEBSALE Dokumentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"WEBSALE Dokumentation","nav":{"global":null,"languages":[{"language":"de","products":[{"product":"Neue Generation","icon":"rocket","description":"Aktuelle Produktgeneration","tabs":[{"tab":"Frontend","pages":[{"title":"Frontend","href":""}]},{"tab":"Konfiguration","pages":[{"title":"Konfiguration","href":"/konfiguration"}]},{"tab":"Strapi CMS","pages":[{"title":"Strapi CMS","href":"/strapi-cms"}]},{"tab":"Schnittstellen","pages":[{"title":"Schnittstellen","href":"/schnittstellen"}]},{"tab":"Admin Interface","groups":[{"group":"Admin Interface","pages":[{"title":"Admin Interface","description":"Das Admin Interface ist das zentrale Backend des WEBSALE-Shops: kaufmännische, organisatorische und technische Verwaltung von Daten und Modulen.","href":"/admin-interface"},{"title":"KI-Agenten anbinden (MCP)","href":"/ki-agenten-anbinden-mcp"},{"group":"Katalog","pages":[{"group":"Produkte","pages":[{"title":"Varianten","description":"Varianten sind der zentrale Ort, an dem alle Ausführungen gepflegt werden, in denen der Shop seine Produkte anbieten kann.","href":"/admin-interface/katalog/produkte/varianten"},{"title":"Kaufgutschein-Produkt anlegen","href":"/admin-interface/katalog/produkte/kaufgutschein-produkt"}]}]},{"group":"Templates und Content","pages":[{"title":"Textbausteine","href":"/admin-interface/templates-und-content/textbausteine"}]},{"group":"Marketing","pages":[{"title":"Gutscheine","href":"/admin-interface/marketing/gutscheine"}]},{"group":"Logs und Statistiken","pages":[{"title":"LogManager (Logs)","href":"/admin-interface/logmanager-logs"},{"title":"Bekannte Fehlermeldungen","href":"/admin-interface/logs-und-statistiken/bekannte-fehlermeldungen"}]}]}]},{"tab":"WEBSALE | search","pages":[{"title":"WEBSALE | search","href":"/ws-search/websale-search"}]},{"tab":"Migration","pages":[{"title":"Migration","href":"/migration"}]},{"tab":"Ressourcen","pages":[{"title":"Ressourcen","href":"/changelog"}]}]},{"product":"Version V8s","icon":"clock-rotate-left","description":"Dokumentation der WEBSALE V8s-Generation","pages":[{"title":"Version V8s","href":"/v8s"}]}]},{"language":"en","pages":[{"title":"en","href":"/en/ki-agenten-anbinden-mcp"}]}]},"basePath":"","title":"KI-Agenten anbinden (MCP) - WEBSALE Dokumentation","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":[],"chunks":[]}
