Confidentialité, dépannage et points d’accroche pour développeurs — WebMCP

Données et confidentialité

Le module enregistre tout dans la base de données de votre boutique. Rien n’est envoyé à PrestaChamps.

Une visite depuis le lien d’un assistant est mémorisée 30 jours dans le cookie propre à votre boutique (pas de nouveau cookie) : uniquement le canal, l’assistant et l’heure. Les notes et avis sont lus dans votre module d’avis quand un assistant le demande, jamais copiés.

Les demandes de retour et d’annulation ne laissent aucun enregistrement propre dans le module. Une demande de retour est un retour produit de PrestaShop, comme si le client avait utilisé le formulaire de retour de sa page de commande. Une demande d’annulation est un message sur la commande dans le SAV de PrestaShop, écrit depuis le compte du client ; contrairement au formulaire de message de la page de commande, elle n’enregistre aucune adresse IP. Leurs limites quotidiennes sont des compteurs, comme les limites de requêtes ci-dessus.

Le module supprime lui-même les données expirées, au plus toutes les 6 heures. La suppression d’un client supprime ses connexions, jetons, commandes préparées et tests ; ses lignes de journal disparaissent après Jours de conservation du journal. Les commandes préparées d’un test IA (Tester avec un agent IA) sont conservées 30 jours comme les autres. Tant que le module est désactivé, il ne supprime rien, même quand un client est supprimé : désinstallez-le pour supprimer ses données.

Ce qu’il faut mentionner dans votre politique de confidentialité : que les acheteurs peuvent connecter un assistant IA à leur compte, ce que le module conserve de ces connexions (ci-dessus), et que le fournisseur de l’assistant (OpenAI, Anthropic) détermine ce qu’il conserve de la conversation ; et, si vous testez en tant que clients réels dans Tester avec un agent IA, que leurs commandes et leurs prix sont envoyés au fournisseur d’IA avec lequel vous testez.

Désinstallation. La désinstallation du module supprime ses paniers de test ouverts, puis tout ce qui précède : chaque table et chaque paramètre du module. Le robots.txt est laissé tel quel (générez-le à nouveau dans Paramètres de la boutique › Trafic et SEO pour retirer le groupe du module).

Liens de paiement après désactivation ou désinstallation. La désactivation ou la désinstallation du module met fin immédiatement à toutes les connexions ouvertes par un lien de paiement. Un navigateur qui a ouvert un tel lien peut encore afficher le nom, l’adresse e-mail et les adresses de l’acheteur dans les données de sa page jusqu’à l’expiration de son cookie de boutique, car PrestaShop lui-même lit le client dans ce cookie (signalé à PrestaShop).

↑ Retour en haut

Dépannage

Commencez par Diagnostic : chaque ligne ci-dessous est une vérification de sa liste, avec sa signification et la façon de la corriger. Tant que les assistants mobiles sont désactivés, les cinq lignes « Assistants mobiles » sont seulement informatives.

• Module activé pour cette boutique – échoue quand le module n’est pas activé pour cette boutique dans le Gestionnaire de modules (Ouvrir le Gestionnaire de modules), quand il est désactivé dans ses paramètres (Ouvrir les paramètres), ou quand la boutique est en mode maintenance (les visiteurs et les assistants voient alors la page de maintenance ; Ouvrir les paramètres de maintenance).
• Outils proposés – échoue quand aucun outil n’est activé (« les assistants ne trouvent rien à utiliser sur votre boutique »), demande votre attention quand seules les modifications du panier sont activées (les assistants ne peuvent ni chercher ni lire votre catalogue pour trouver quoi ajouter). Correction : Choisir les outils.
• Pages sécurisées (HTTPS) – échoue sans HTTPS : les navigateurs ne proposent WebMCP que sur les pages sécurisées. « Le HTTPS n’est activé que sur certaines pages » : activez le HTTPS sur toutes les pages (Ouvrir les paramètres généraux). Une boutique installée sur votre propre ordinateur affiche « Sécurisé pour le développement uniquement ».
• Connexion aux pages de votre boutique – « Le module n’est pas entièrement connecté aux pages de votre boutique, qui risquent donc de ne pas proposer les outils. » Correction : Réparer les points d’accroche sur la même carte.
• Jetons Origin Trial – information quand il n’y a pas de jeton : « Sans jeton, seuls les navigateurs dont l’option de test WebMCP est activée voient vos outils. » (Ajouter un jeton). Avertit quand un jeton est prévu pour une autre adresse, ne concerne pas l’essai WebMCP, a expiré ou expire dans les 14 jours.
• Index de recherche – voir L’index de recherche.
• La boutique répond – le module appelle l’adresse de sa propre boutique depuis votre serveur. « Votre serveur n’a pas pu ouvrir l’adresse de sa propre boutique (fréquent derrière un pare-feu et dans Docker) » : utilisez Ouvrir la vérification de la boutique dans votre navigateur. « La boutique redirige cette adresse ailleurs au lieu de répondre » : vérifiez l’adresse de votre boutique et vos règles de redirection. « La boutique répond « indisponible » » : en général, c’est le mode maintenance. Après une correction, Vider le cache.
• Moteur de recherche de la boutique – information : quel module traite les recherches de votre boutique (« Les recherches de la boutique utilisent la recherche native de PrestaShop. » ou « Les recherches de la boutique sont traitées par … ») ; « Le module de recherche a interrompu la requête au lieu de répondre » : sa solution de repli redirige vers la page de recherche de la boutique ; les assistants utilisent alors la recherche native de PrestaShop.
• Assistants mobiles : adresse sécurisée (HTTPS) – échoue sans SSL : ChatGPT et Claude ne se connectent qu’aux boutiques en HTTPS (Ouvrir les paramètres généraux). Une boutique installée sur votre propre ordinateur est acceptée comme « Développement uniquement ».
• Assistants mobiles : URL simplifiées – échoue quand les URL simplifiées sont désactivées (Ouvrir les réglages SEO et URL).
• Assistants mobiles : adresses de découverte – la boutique récupère ses propres documents /.well-known/oauth-…, où les assistants apprennent comment les acheteurs se connectent. Demande votre attention quand seules les copies du module répondent (la plupart des assistants se connectent quand même) ; échoue quand aucun ne répond ou quand ils indiquent une autre adresse (vérifiez le domaine de la boutique et le réglage SSL). Correction : votre serveur web doit envoyer à PrestaShop les adresses qui commencent par /.well-known/oauth- ; sur Apache, aucune règle du .htaccess ne doit arrêter /.well-known/ avant les règles de PrestaShop ; sur Nginx, ajoutez une location pour /.well-known/oauth- qui passe à index.php. Derrière un pare-feu, le serveur peut ne pas atteindre sa propre adresse : utilisez plutôt Ouvrir le document dans votre navigateur.
• Assistants mobiles : en-tête de connexion – échoue quand votre serveur supprime la connexion qu’envoient les assistants connectés (l’en-tête Authorization) : ils ne peuvent alors utiliser ni le panier, ni les commandes, ni la commande préparée. Correction : Apache avec PHP en CGI ou FastCGI : ajoutez CGIPassAuth On au .htaccess de la boutique, ou gardez la ligne de PrestaShop qui copie l’en-tête dans HTTP_AUTHORIZATION ; Nginx : ajoutez fastcgi_param HTTP_AUTHORIZATION $http_authorization à la location PHP.
• Assistants mobiles : le même panier sur le site – information quand Réafficher le panier après identification est désactivé : un acheteur qui se connecte sur votre site reçoit alors un nouveau panier vide au lieu de celui de l’assistant (le lien de paiement ouvre quand même le panier de l’assistant). Correction : Ouvrir les paramètres clients et activez l’option.
• Annuaires d’agents IA – information tant que Décrire cette boutique pour les annuaires d’agents IA est désactivé ; demande votre attention si le robots.txt renvoie encore les annuaires vers la description (ouvrez Paramètres › Paramètres avancés › Annuaires d’agents IA et enregistrez). Échoue quand les URL simplifiées sont désactivées (Paramètres de la boutique › Trafic et SEO), quand la description ou le guide pour les agents IA ne répond pas (vérifiez que le module est activé pour cette boutique, puis videz le cache de la boutique) ou quand la description ne respecte pas le format (les détails listent chaque problème). Demande votre attention quand votre serveur n’a pas pu ouvrir sa propre adresse (utilisez plutôt Ouvrir la description dans votre navigateur) ; quand votre serveur ne transmet pas /.well-known/ard.json et /.well-known/ai-catalog.json à PrestaShop (Apache : aucune règle du .htaccess ne doit arrêter /.well-known/ avant les règles de PrestaShop ; Nginx : une location pour ces deux adresses qui passe à index.php) ; quand /llms.txt ne répond pas avec le résumé du module (Nginx : faites retomber la location des fichiers .txt sur index.php) ; quand le robots.txt n’a pas encore de ligne Agentmap: ou en a une périmée (ouvrez Paramètres › Paramètres avancés › Annuaires d’agents IA et enregistrez) ; ou quand sa ligne Agentmap: nomme un autre domaine (supprimez cette ligne si elle n’est pas la vôtre). Voir Annuaires d’agents IA et llms.txt.
• Formulaires pour les agents IA – information quand Marquer les formulaires pour les agents IA est désactivé (« Chrome Lighthouse indique que les formulaires de votre boutique ne sont pas marqués pour les agents IA » ; Ouvrir les paramètres) ou que Proposer les outils sur cette boutique est désactivé. Demande votre attention quand les pages de la boutique ont signalé, ces 7 derniers jours, des formulaires que Chrome compte comme des problèmes WebMCP (seulement avec le Mode diagnostic activé) : un formulaire du thème ou d’un autre module qui n’a qu’un seul des attributs toolname et tooldescription (donnez-lui les deux, ou aucun), un formulaire qui utilise le nom de l’un des outils du module (renommez-le), deux formulaires sur une même page avec le même nom, un formulaire marqué avec un champ sans nom ou sans libellé, ou des boutons radio hors d’un fieldset (corrigez-les dans le thème), ou des formulaires marqués comme non destinés aux agents que le navigateur a quand même proposés (désactivez Marquer les formulaires pour les agents IA et cherchez une mise à jour du module). Voir Outils de formulaire sur vos pages.
• Notes et avis – le module d’avis que lisent les réponses sur les produits (« Les réponses sur les produits incluent les notes et les avis récents de … »). Information quand Montrer les notes et avis aux agents IA est désactivé (Ouvrir les paramètres), quand aucun module d’avis que cette version sait lire n’est actif, ou quand le module actif conserve ses avis sur ses propres serveurs, recueille des avis sur la boutique plutôt que sur les produits, ou ne peut pas encore être lu par cette version ; demande votre attention quand le module est actif mais que ses tables d’avis ne peuvent pas être lues. Voir Notes et avis.
• Livraison vers vos pays principaux – demande votre attention quand aucun transporteur ne livre vers votre pays par défaut ou vers l’un des pays d’où vous avez reçu le plus de commandes ces 90 derniers jours (« Aucun transporteur ne livre vers : …. Les clients et les assistants n’y trouvent aucune option de livraison. »). Correction : Ouvrir les transporteurs et ajoutez la zone du pays à un transporteur.
• Agents IA vérifiés – information tant que Reconnaître les agents IA vérifiés est désactivé (Ouvrir les paramètres) ou tant qu’aucun agent IA n’a envoyé de requête signée la semaine passée (peu d’agents signent encore). Réussie avec le nombre de requêtes d’agents vérifiés. Demande votre attention quand votre PHP n’a pas l’extension sodium (demandez à votre hébergeur de l’activer), ou quand la plupart des signatures d’agents connus n’ont pas pu être vérifiées : un proxy ou un CDN qui modifie l’adresse de la boutique, ou une horloge du serveur déréglée, peut en être la cause ; les Détails listent les motifs.
• Pare-feu et agents IA – votre serveur ouvre votre boutique comme un navigateur, puis comme ChatGPT et d’autres agents IA, et votre serveur MCP comme ChatGPT. Réussie quand les agents reçoivent votre boutique comme un navigateur. Échoue quand un pare-feu ou une règle anti-robots les refuse ou leur impose un défi, et la nomme avec ce qu’il faut changer : Cloudflare (politiques des robots IA : réglez Agent et Search sur Allow ; le Bot Fight Mode ne peut pas être contourné par des règles), Imunify360, ModSecurity, LiteSpeed, Sucuri, Akamai, BitNinja, ou une limite de l’hébergement qui répond « trop de requêtes ». Demande votre attention quand votre serveur ne peut pas ouvrir sa propre adresse (courant derrière un pare-feu et dans Docker) ou reçoit lui-même un défi, si bien qu’il ne peut pas conclure d’ici.
• Demandes de retour et d’annulation – information tant que les deux outils sont désactivés (Ouvrir les outils). Demande votre attention quand Demander un retour est activé mais que votre boutique n’accepte pas les retours produits, si bien que chaque demande de retour est refusée : activez les retours dans SAV › Retours produits (Ouvrir les retours produits). Elle affiche votre délai de retour.
• Flux produits pour ChatGPT – information quand le module distinct « OpenAI / ChatGPT Ads » n’est pas installé. Demande votre attention quand il est installé mais pas actif dans cette boutique, quand son flux produits est désactivé, ou quand son mode de livraison (adresse du flux hébergé ou SFTP) n’est pas encore choisi (Ouvrir ses paramètres). Réussie quand il gère votre flux.
• WebMCP dans ce navigateur – information sur le navigateur que vous utilisez en ce moment (voir Ce navigateur et les rapports de la boutique).

Autres questions fréquentes :

• L’assistant dit que la boutique n’a pas d’outils. Proposer les outils sur cette boutique est désactivé, aucun outil n’est activé dans Outils, ou un cache de pages sert encore des pages d’avant : videz-le.
• L’assistant ne peut pas ajouter au panier. Ajouter au panier est désactivé dans Outils ; sur le téléphone, l’acheteur n’a pas connecté son compte.
• Un acheteur ne peut pas se connecter. Son compte a été créé lors d’une commande en invité (il doit créer un compte avec un mot de passe), ou une autre application que ChatGPT ou Claude essaie de se connecter alors que Autoriser toute application d’assistant est désactivé.
• Le lien de paiement indique qu’il n’est plus valable. Il a déjà servi ou a expiré : l’acheteur en demande un nouveau à l’assistant.
• Un assistant dit que la boutique n’a pas de réponse sur la livraison ou les retours. Écrivez la réponse dans FAQ pour les agents IA, ou ajoutez une page à ce sujet dans Apparence › Pages (voir FAQ pour les agents IA). Rechercher les infos de la boutique doit être activé dans Outils.
• Un code de réduction est refusé avec « Trop de tentatives échouées ». Trop de codes que votre boutique ne connaît pas ont été essayés depuis cette session ou cette adresse : les essais fonctionnent à nouveau après un moment (voir Codes de réduction).
• Commandes des assistants IA reste vide. Seules les commandes valides comptent, et seulement celles dont un assistant a touché le panier ou qui sont venues du lien d’un assistant dans les 30 jours ; vérifiez que Compter les commandes des assistants IA est activé (Paramètres › Paramètres avancés › Journalisation). Derrière un cache de pages, videz le cache une fois après une mise à jour (voir Visites des liens IA derrière un cache de page).
• Un assistant dit qu’il ne peut pas envoyer de demande de retour. Demander un retour est désactivé dans Outils, le client n’est pas connecté, votre boutique n’accepte pas les retours produits, la commande n’est pas encore livrée ou son délai de retour est dépassé, ou le client a déjà envoyé 5 demandes aujourd’hui.
• Un lien de panier ouvre un panier vide. Liens de panier pour les assistants IA est désactivé, ou les produits ne sont pas disponibles ou sont en rupture de stock (la page panier les nomme). Le lien remplit le panier du navigateur qui l’ouvre, et un même lien n’ajoute ses produits qu’une seule fois en 10 minutes.
• Produits pour les agents IA affiche d’anciens scores. Les scores sont ceux de la dernière vérification : choisissez Vérifier à nouveau.
• Les assistants ne mentionnent pas votre texte pour les agents IA. Vérifiez que Donner vos textes produits aux agents IA (Paramètres › Réponses sur les produits) et l’outil Voir le détail d’un produit sont activés, et que le texte existe dans la langue de l’acheteur ou dans votre langue par défaut.
• Les assistants trouvent moins de produits que votre champ de recherche. Voir L’index de recherche.
• Des appels sont refusés avec « Trop de requêtes » derrière un CDN. Les visiteurs qui arrivent par un même nœud du CDN partagent ses limites : remplissez Proxys de confiance avec les plages d’adresses publiées par votre CDN (Paramètres › Paramètres avancés › Limites).
• Tester avec un agent IA indique « Ajoutez une clé d’IA ou choisissez la démonstration. » Ajoutez une clé sous Clés d’IA, ou choisissez la démonstration. « La limite du jour pour les tests IA est atteinte. » Augmentez le Budget des tests IA par jour ou attendez demain ; la démonstration fonctionne toujours. « … n’a pas répondu à temps. » / « La boutique n’a pas pu joindre …. » Votre serveur ne peut pas ouvrir de connexions HTTPS vers le fournisseur : demandez à votre hébergeur d’autoriser les connexions HTTPS sortantes vers le fournisseur d’IA que vous utilisez (Anthropic, OpenAI ou Google).
• L’audit indique « Votre serveur n’a pas pu ouvrir les pages de sa propre boutique. » Utilisez Vérifier depuis ce navigateur.
• Le score n’a pas changé après une correction. Les barres et les réponses sont celles du dernier audit complet : relancez l’audit complet.
• L’audit « Agentic browsing » de Chrome Lighthouse liste des éléments sans nom. Lancez l’audit complet et ouvrez Accessibilité pour les agents IA : ses détails nomment chaque élément, sa page et la partie du modèle qui l’affiche (voir Accessibilité pour les agents IA). Les éléments construits par des scripts ne sont vus que par Lighthouse.
• /llms.txt affiche un autre texte que le résumé du module. Un fichier nommé llms.txt à la racine de la boutique est servi à la place : supprimez-le ou renommez-le pour que le résumé du module réponde.
• Un lien de paiement ouvert sur un téléphone affiche « Page non trouvée ». Sur PrestaShop 8, l’option Désactiver sur mobiles du Gestionnaire de modules est activée pour le module : les liens de paiement ne s’ouvrent alors pas sur les téléphones (personne n’est connecté). Désactivez cette option pour ce module.

Quand vous contactez le support PrestaChamps, indiquez quelles lignes de Diagnostic demandent votre attention et, si le journal est activé, l’heure et l’outil d’un appel en échec.

↑ Retour en haut

Pour les développeurs

D’autres modules peuvent proposer leurs propres outils aux assistants grâce au point d’accroche du module actionPchwebmcpRegisterTools : ils apparaissent alors dans Outils avec la mention « Ajouté par un autre module », désactivés jusqu’à ce que vous les activiez, et ne sont proposés aux assistants mobiles que si Proposer les outils d’autres modules aux assistants mobiles est activé. Le guide du développeur (disponible auprès de PrestaChamps) décrit le point d’accroche, le format des outils, les niveaux d’accès, l’API de la boutique et le serveur MCP.

↑ Retour en haut