Datenschutz, Fehlerbehebung und Entwickler-Hooks – WebMCP

Daten und Datenschutz

Das Modul speichert alles in der Datenbank Ihres Shops. Nichts wird an PrestaChamps gesendet.

Ein Besuch über den Link eines Assistenten wird 30 Tage lang im eigenen Cookie Ihres Shops vermerkt (kein neues Cookie): nur der Kanal, der Assistent und die Uhrzeit. Bewertungen und Rezensionen werden aus Ihrem Bewertungsmodul gelesen, wenn ein Assistent fragt, nie kopiert.

Rücksende- und Stornierungsanfragen legen im Modul keinen eigenen Datensatz an. Eine Rücksendeanfrage ist eine Warenrücksendung von PrestaShop, als hätte der Kunde das Rücksendeformular seiner Bestellseite benutzt. Eine Stornierungsanfrage ist eine Nachricht zur Bestellung im Kundenservice von PrestaShop, geschrieben aus dem Konto des Kunden; anders als das Nachrichtenformular der Bestellseite speichert sie keine IP-Adresse. Ihre Tageslimits sind Zähler wie die Anfragelimits oben.

Das Modul löscht abgelaufene Datensätze selbst, höchstens alle 6 Stunden. Wenn Sie einen Kunden löschen, werden seine Verbindungen, Tokens, vorbereiteten Bestellungen und Tests gelöscht; seine Protokollzeilen verschwinden nach Aufbewahrungsdauer (Tage). Vorbereitete Bestellungen eines KI-Tests (Mit einem KI-Agenten testen) werden wie alle anderen 30 Tage aufbewahrt. Solange das Modul deaktiviert ist, löscht es nichts, auch nicht, wenn ein Kunde gelöscht wird: Deinstallieren Sie es, um seine Daten zu löschen.

Was Sie in Ihrer Datenschutzerklärung erwähnen sollten: dass Käufer einen KI-Assistenten mit ihrem Konto verbinden können, was das Modul von diesen Verbindungen speichert (siehe oben) und dass der Anbieter des Assistenten (OpenAI, Anthropic) bestimmt, was er von der Unterhaltung speichert; und, wenn Sie im Tab Mit einem KI-Agenten testen als echte Kunden testen, dass deren Bestellungen und Preise an den KI-Anbieter gesendet werden, mit dem Sie testen.

Deinstallation. Beim Deinstallieren löscht das Modul seine offenen Test-Warenkörbe und dann alles oben Genannte: jede Tabelle und jede Einstellung des Moduls. robots.txt bleibt, wie sie ist (erzeugen Sie die Datei unter Shop-Einstellungen › Traffic & SEO neu, um die Gruppe des Moduls zu entfernen).

Zahlungslinks nach Deaktivieren oder Deinstallieren. Das Deaktivieren oder Deinstallieren des Moduls beendet sofort jede Anmeldung über einen Zahlungslink. Ein Browser, der einen solchen Link geöffnet hat, kann Namen, E-Mail-Adresse und Adressen des Käufers noch in seinen Seitendaten zeigen, bis sein Shop-Cookie abläuft, weil PrestaShop selbst den Kunden aus diesem Cookie liest (an PrestaShop gemeldet).

↑ Nach oben

Fehlerbehebung

Beginnen Sie mit der Diagnose: Jede Zeile unten ist eine Prüfung aus deren Liste, mit ihrer Bedeutung und der Lösung. Solange Handy-Assistenten ausgeschaltet sind, dienen die fünf Zeilen „Handy-Assistenten“ nur zur Information.

• Modul für diesen Shop aktiv – schlägt fehl, wenn das Modul in der Modul-Verwaltung für diesen Shop nicht aktiviert ist (Modul-Verwaltung öffnen), in seinen Einstellungen ausgeschaltet ist (Einstellungen öffnen) oder wenn sich der Shop im Wartungszustand befindet (Besucher und Assistenten sehen dann die Wartungsseite; Wartungseinstellungen öffnen).
• Angebotene Tools – schlägt fehl, wenn kein Tool eingeschaltet ist („Assistenten finden in Ihrem Shop nichts, was sie nutzen können“), zeigt Handlungsbedarf, wenn nur Warenkorb-Änderungen eingeschaltet sind (Assistenten können Ihren Katalog weder durchsuchen noch lesen, um zu finden, was sie hinzufügen sollen). Lösung: Tools auswählen.
• Sichere Seiten (HTTPS) – schlägt ohne HTTPS fehl: Browser bieten WebMCP nur auf sicheren Seiten an. „HTTPS ist nur für einige Seiten aktiv“: Aktivieren Sie HTTPS für alle Seiten (Allgemeine Einstellungen öffnen). Ein Shop auf Ihrem eigenen Computer zeigt „Nur für die Entwicklung sicher“.
• Verbindung zu Ihren Shop-Seiten – „Das Modul ist nicht vollständig mit Ihren Shop-Seiten verbunden, daher bieten sie die Tools möglicherweise nicht an.“ Lösung: Hooks reparieren auf derselben Karte.
• Origin-Trial-Tokens – Information ohne Token: „Ohne Token sehen nur Browser mit dem WebMCP-Test-Flag Ihre Tools.“ (Token hinzufügen). Warnt, wenn ein Token für eine andere Adresse gilt, nicht zur WebMCP-Testphase gehört, abgelaufen ist oder in den nächsten 14 Tagen abläuft.
• Suchindex – siehe Der Suchindex.
• Das Shop-Frontend antwortet – das Modul ruft von Ihrem Server aus die Adresse seines eigenen Shops auf. „Ihr Server konnte seine eigene Shop-Adresse nicht öffnen (häufig hinter Firewalls und in Docker)“: Nutzen Sie Frontend-Prüfung öffnen in Ihrem Browser. „Das Shop-Frontend leitet diese Adresse weiter, statt zu antworten“: Prüfen Sie Ihre Shop-Adresse und Ihre Weiterleitungsregeln. „Das Shop-Frontend antwortet „nicht verfügbar““: meist wegen des Wartungszustands. Nach einer Behebung Cache löschen.
• Suchfunktion des Shops – Information: welches Modul die Suchanfragen Ihres Shops beantwortet („Suchanfragen im Shop nutzen die eigene Suche von PrestaShop.“ oder „Suchanfragen im Shop beantwortet …“); „Das Suchmodul hat die Anfrage beendet, statt zu antworten“: Sein Fallback leitet auf die Suchseite des Shops weiter; Assistenten erhalten dann die eigene Suche von PrestaShop.
• Handy-Assistenten: sichere Adresse (HTTPS) – schlägt ohne SSL fehl: ChatGPT und Claude verbinden sich nur mit Shops über HTTPS (Allgemeine Einstellungen öffnen). Ein Shop auf Ihrem eigenen Computer besteht als „Nur zur Entwicklung“.
• Handy-Assistenten: suchmaschinenfreundliche URLs – schlägt fehl, wenn benutzerfreundliche URLs ausgeschaltet sind (SEO- und URL-Einstellungen öffnen).
• Handy-Assistenten: Erkennungsadressen – der Shop ruft seine eigenen Dokumente /.well-known/oauth-… ab, aus denen Assistenten erfahren, wie sich Käufer anmelden. Zeigt Handlungsbedarf, wenn nur die eigenen Kopien des Moduls antworten (die meisten Assistenten verbinden sich trotzdem); schlägt fehl, wenn keines antwortet oder wenn sie eine andere Adresse nennen (prüfen Sie die Domain und die SSL-Einstellung des Shops). Lösung: Ihr Webserver muss Adressen, die mit /.well-known/oauth- beginnen, an PrestaShop senden; unter Apache darf keine .htaccess-Regel /.well-known/ vor den Regeln von PrestaShop abfangen; unter Nginx fügen Sie eine location für /.well-known/oauth- hinzu, die an index.php weitergibt. Hinter einer Firewall erreicht der Server seine eigene Adresse möglicherweise nicht: Nutzen Sie stattdessen Dokument öffnen in Ihrem Browser.
• Handy-Assistenten: Anmelde-Header – schlägt fehl, wenn Ihr Server die Anmeldung verwirft, die verbundene Assistenten senden (den Header Authorization): Sie können dann Warenkorb, Bestellungen und Kasse nicht nutzen. Lösung: Apache mit PHP als CGI oder FastCGI: Fügen Sie CGIPassAuth On zur .htaccess des Shops hinzu oder behalten Sie die Zeile von PrestaShop, die den Header nach HTTP_AUTHORIZATION kopiert; Nginx: Fügen Sie fastcgi_param HTTP_AUTHORIZATION $http_authorization zur PHP-location hinzu.
• Handy-Assistenten: derselbe Warenkorb im Web – Information, wenn Warenkorb nach Anmeldung neu anzeigen ausgeschaltet ist: Ein Käufer, der sich auf Ihrer Website anmeldet, erhält dann einen neuen, leeren Warenkorb statt des Warenkorbs des Assistenten (der Zahlungslink öffnet weiterhin den Warenkorb des Assistenten). Lösung: Kundeneinstellungen öffnen und die Option einschalten.
• KI-Agenten-Verzeichnisse – Information, solange Diesen Shop für KI-Agenten-Verzeichnisse beschreiben ausgeschaltet ist; Handlungsbedarf, wenn die robots.txt Verzeichnisse noch auf die Beschreibung verweist (öffnen Sie Einstellungen › Erweiterte Einstellungen › KI-Agenten-Verzeichnisse und speichern Sie). Schlägt fehl, wenn die benutzerfreundlichen URLs ausgeschaltet sind (Shop-Einstellungen › Traffic & SEO), wenn die Beschreibung oder der Leitfaden für KI-Agenten nicht antwortet (prüfen Sie, ob das Modul für diesen Shop aktiviert ist, und leeren Sie dann den Cache des Shops) oder wenn die Beschreibung das Format verletzt (die Details listen jedes Problem auf). Handlungsbedarf, wenn Ihr Server seine eigene Adresse nicht öffnen konnte (nutzen Sie stattdessen Beschreibung öffnen in Ihrem Browser); wenn Ihr Server /.well-known/ard.json und /.well-known/ai-catalog.json nicht an PrestaShop weitergibt (Apache: Keine Regel in der .htaccess darf /.well-known/ vor den Regeln von PrestaShop abfangen; Nginx: eine location für diese beiden Adressen, die an index.php weitergibt); wenn /llms.txt nicht mit der Zusammenfassung des Moduls antwortet (Nginx: Lassen Sie die location für .txt-Dateien auf index.php zurückfallen); wenn die robots.txt noch keine Agentmap:-Zeile oder eine veraltete enthält (öffnen Sie Einstellungen › Erweiterte Einstellungen › KI-Agenten-Verzeichnisse und speichern Sie); oder wenn ihre Agentmap:-Zeile eine andere Domain nennt (entfernen Sie diese Zeile, wenn sie nicht von Ihnen stammt). Siehe KI-Agenten-Verzeichnisse und llms.txt.
• Formulare für KI-Agenten – Information, wenn Formulare für KI-Agenten kennzeichnen ausgeschaltet ist („Chrome Lighthouse führt die Formulare Ihres Shops als nicht für KI-Agenten gekennzeichnet auf“; Einstellungen öffnen) oder Tools in diesem Shop anbieten ausgeschaltet ist. Handlungsbedarf, wenn Shop-Seiten in den letzten 7 Tagen Formulare gemeldet haben, die Chrome als WebMCP-Probleme zählt (nur mit eingeschaltetem Diagnosemodus): ein Formular des Themes oder eines anderen Moduls mit nur einem der Attribute toolname und tooldescription (geben Sie ihm beide oder keines), ein Formular, das den Namen eines der Tools des Moduls verwendet (benennen Sie es um), zwei Formulare mit demselben Namen auf einer Seite, ein gekennzeichnetes Formular mit einem Feld ohne Namen oder Beschriftung oder Optionsfelder außerhalb eines Fieldsets (beheben Sie diese im Theme), oder Formulare, die als nicht für Agenten gekennzeichnet sind und die der Browser trotzdem angeboten hat (schalten Sie Formulare für KI-Agenten kennzeichnen aus und suchen Sie nach einem Modul-Update). Siehe Formular-Tools auf Ihren Seiten.
• Bewertungen und Rezensionen – welches Bewertungsmodul die Produktantworten lesen („Produktantworten enthalten die Bewertungen und neuesten Rezensionen von …“). Information, wenn Bewertungen und Rezensionen für KI-Agenten anzeigen ausgeschaltet ist (Einstellungen öffnen), wenn kein Bewertungsmodul aktiv ist, das diese Version lesen kann, oder wenn das aktive seine Rezensionen auf eigenen Servern speichert, Bewertungen des Shops statt der Artikel sammelt oder von dieser Version noch nicht gelesen werden kann; Handlungsbedarf, wenn das Modul aktiv ist, seine Bewertungstabellen aber nicht gelesen werden können. Siehe Bewertungen und Rezensionen.
• Versand in Ihre Hauptländer – Handlungsbedarf, wenn kein Versanddienst in Ihr Standardland oder in eines der Länder liefert, aus denen Sie in den letzten 90 Tagen die meisten Bestellungen erhalten haben („Kein Versanddienst liefert nach: …. Kunden und Assistenten finden dort keine Versandoption.“). Lösung: Versanddienste öffnen und die Zone des Landes einem Versanddienst hinzufügen.
• Verifizierte KI-Agenten – Information, solange Verifizierte KI-Agenten erkennen ausgeschaltet ist (Einstellungen öffnen) oder solange in der vergangenen Woche kein KI-Agent eine signierte Anfrage gesendet hat (bisher signieren nur wenige Agenten). Bestanden mit der Zahl der Anfragen verifizierter Agenten. Handlungsbedarf, wenn Ihr PHP keine sodium-Erweiterung hat (bitten Sie Ihren Hoster, sie zu aktivieren) oder wenn die meisten Signaturen bekannter Agenten nicht bestätigt werden konnten: Ein Proxy oder CDN, das die Adresse des Shops ändert, oder eine falsche Serveruhr kann das verursachen; die Details nennen die Gründe.
• Firewalls und KI-Agenten – Ihr Server öffnet Ihren Shop wie ein Browser, dann als ChatGPT und andere KI-Agenten, und Ihren MCP-Server als ChatGPT. Bestanden, wenn die Agenten Ihren Shop so erhalten wie ein Browser. Schlägt fehl, wenn eine Firewall- oder Bot-Regel sie abweist oder herausfordert, und nennt sie mit dem, was zu ändern ist: Cloudflare (Richtlinien für KI-Bots: Agent und Search auf Allow setzen; der Bot Fight Mode lässt sich nicht mit Regeln umgehen), Imunify360, ModSecurity, LiteSpeed, Sucuri, Akamai, BitNinja oder ein Limit des Hosters, das mit „zu viele Anfragen“ antwortet. Handlungsbedarf, wenn Ihr Server seine eigene Adresse nicht öffnen kann (häufig hinter Firewalls und in Docker) oder selbst herausgefordert wird, sodass es sich von hier aus nicht sagen lässt.
• Rücksende- und Stornierungsanfragen – Information, solange beide Tools ausgeschaltet sind (Tools öffnen). Handlungsbedarf, wenn Rücksendung anfragen eingeschaltet ist, Ihr Shop aber keine Warenrücksendungen annimmt, sodass jede Rücksendeanfrage abgelehnt wird: Schalten Sie Rücksendungen unter Kundenservice › Warenrücksendungen ein (Warenrücksendungen öffnen). Die Prüfung zeigt Ihre Rücksendefrist.
• Produkt-Feed für ChatGPT – Information, wenn das separate Modul „OpenAI / ChatGPT Ads“ nicht installiert ist. Handlungsbedarf, wenn es installiert, aber in diesem Shop nicht aktiv ist, wenn sein Produkt-Feed ausgeschaltet ist oder wenn seine Übermittlung (gehostete Feed-Adresse oder SFTP) noch nicht gewählt ist (Seine Einstellungen öffnen). Bestanden, wenn es Ihren Feed übernimmt.
• WebMCP in diesem Browser – Information über den Browser, den Sie gerade nutzen (siehe Dieser Browser und die Shop-Berichte).

Weitere häufige Fragen:

• Der Assistent sagt, der Shop habe keine Tools. Tools in diesem Shop anbieten ist aus, unter Tools ist kein Tool eingeschaltet, oder ein Seiten-Cache liefert noch Seiten von vorher aus: Leeren Sie ihn.
• Der Assistent kann nichts in den Warenkorb legen. In den Warenkorb ist unter Tools ausgeschaltet; auf dem Handy hat der Käufer sein Konto nicht verbunden.
• Ein Käufer kann sich nicht verbinden. Sein Konto wurde bei einer Gastbestellung angelegt (er legt eines mit Passwort an), oder eine andere App als ChatGPT oder Claude versucht sich zu verbinden, während Jede Assistenten-App zulassen ausgeschaltet ist.
• Der Zahlungslink meldet, dass er nicht mehr gültig ist. Er wurde benutzt oder ist abgelaufen: Der Käufer bittet den Assistenten um einen neuen.
• Ein Assistent sagt, der Shop habe keine Antwort zu Versand oder Rücksendungen. Schreiben Sie die Antwort in FAQ für KI-Agenten oder legen Sie unter Design › Seiten eine Seite dazu an (siehe FAQ für KI-Agenten). Shop-Infos suchen muss unter Tools eingeschaltet sein.
• Ein Rabattcode wird mit „Zu viele fehlgeschlagene Versuche“ abgelehnt. Aus dieser Sitzung oder von dieser Adresse wurden zu viele Codes versucht, die Ihr Shop nicht kennt: Nach einer Weile funktionieren die Versuche wieder (siehe Rabattcodes).
• Bestellungen von KI-Assistenten bleibt leer. Es zählen nur gültige Bestellungen, und nur solche, deren Warenkorb ein Assistent bearbeitet hat oder die innerhalb von 30 Tagen über den Link eines Assistenten kamen; prüfen Sie, ob Bestellungen von KI-Assistenten zählen eingeschaltet ist (Einstellungen › Erweiterte Einstellungen › Protokollierung). Hinter einem Seiten-Cache leeren Sie den Cache nach einer Aktualisierung einmal (siehe Besuche über KI-Links hinter einem Seiten-Cache).
• Ein Assistent sagt, er könne keine Rücksendeanfrage senden. Rücksendung anfragen ist unter Tools ausgeschaltet, der Kunde ist nicht angemeldet, Ihr Shop nimmt keine Warenrücksendungen an, die Bestellung ist noch nicht geliefert oder ihre Rücksendefrist ist abgelaufen, oder der Kunde hat heute schon 5 Anfragen gesendet.
• Ein Warenkorb-Link öffnet einen leeren Warenkorb. Warenkorb-Links für KI-Assistenten ist ausgeschaltet, oder die Artikel sind nicht verfügbar oder nicht auf Lager (die Warenkorbseite nennt sie). Der Link füllt den Warenkorb des Browsers, der ihn öffnet, und derselbe Link fügt seine Artikel innerhalb von 10 Minuten nur einmal hinzu.
• Produkte für KI-Agenten zeigt alte Punktzahlen. Die Punktzahlen stammen aus der letzten Prüfung: Wählen Sie Erneut prüfen.
• Assistenten erwähnen Ihren Text für KI-Agenten nicht. Prüfen Sie, ob KI-Agenten Ihre Produkttexte geben (Einstellungen › Produktantworten) und das Tool Artikeldetails abrufen eingeschaltet sind und ob der Text in der Sprache des Käufers oder in Ihrer Standardsprache vorhanden ist.
• Assistenten finden weniger Artikel als Ihr Suchfeld. Siehe Der Suchindex.
• Aufrufe werden hinter einem CDN mit „Zu viele Anfragen“ abgelehnt. Besucher, die über denselben Edge-Server des CDN kommen, teilen sich dessen Limits: Tragen Sie unter Vertrauenswürdige Proxys die veröffentlichten Adressbereiche Ihres CDN ein (Einstellungen › Erweiterte Einstellungen › Grenzwerte).
• Der Tab Mit einem KI-Agenten testen meldet „Fügen Sie einen KI-Schlüssel hinzu oder wählen Sie die Demo.“ Fügen Sie unter KI-Schlüssel einen Schlüssel hinzu oder wählen Sie die Demo. „Das heutige Limit für KI-Tests ist erreicht.“ Erhöhen Sie KI-Testbudget pro Tag oder warten Sie bis morgen; die Demo funktioniert weiterhin. „Keine rechtzeitige Antwort von ….“ / „Keine Verbindung vom Shop zu ….“ Ihr Server kann keine HTTPS-Verbindungen zum Anbieter öffnen: Bitten Sie Ihren Hoster, ausgehende HTTPS-Verbindungen zu dem KI-Anbieter zuzulassen, den Sie nutzen (Anthropic, OpenAI oder Google).
• Das Audit meldet „Ihr Server konnte die eigenen Shop-Seiten nicht öffnen.“ Nutzen Sie Von diesem Browser aus prüfen.
• Die Punktzahl hat sich nach einer Behebung nicht geändert. Die Balken und Antworten stammen aus dem letzten vollständigen Durchlauf: Starten Sie das vollständige Audit erneut.
• Das Audit „Agentic browsing“ von Chrome Lighthouse listet Elemente ohne Namen auf. Starten Sie das vollständige Audit und öffnen Sie Barrierefreiheit für KI-Agenten: Seine Details nennen jedes Element, seine Seite und den Template-Teil, der es ausgibt (siehe Barrierefreiheit für KI-Agenten). Elemente, die Skripte erzeugen, sieht nur Lighthouse.
• /llms.txt zeigt einen anderen Text als die Zusammenfassung des Moduls. Eine Datei namens llms.txt im Stammverzeichnis des Shops wird stattdessen ausgeliefert: Löschen Sie sie oder benennen Sie sie um, damit die Zusammenfassung des Moduls antwortet.
• Ein auf einem Handy geöffneter Zahlungslink antwortet „Seite nicht gefunden“. In PrestaShop 8 ist in der Modul-Verwaltung Auf Mobilgeräten deaktivieren für das Modul eingeschaltet: Zahlungslinks öffnen sich dann nicht auf Handys (es wird nichts angemeldet). Schalten Sie es für dieses Modul aus.

Wenn Sie den PrestaChamps-Support kontaktieren, nennen Sie die Zeilen der Diagnose mit Handlungsbedarf und, wenn das Protokoll eingeschaltet ist, Uhrzeit und Tool eines fehlgeschlagenen Aufrufs.

↑ Nach oben

Für Entwickler

Andere Module können Assistenten über den Hook actionPchwebmcpRegisterTools des Moduls eigene Tools anbieten: Diese erscheinen dann unter Tools als „Von einem anderen Modul hinzugefügt“, bleiben aus, bis Sie sie einschalten, und werden Handy-Assistenten nur angeboten, wenn Tools anderer Module den Handy-Assistenten anbieten eingeschaltet ist. Das Entwicklerhandbuch (erhältlich bei PrestaChamps) beschreibt den Hook, das Tool-Format, die Zugriffsstufen, die Shop-API und den MCP-Server.

↑ Nach oben