Dépannage
Cette page fournit des solutions aux problèmes courants que vous pourriez rencontrer lors de l'utilisation de PrestaShop MCP Server.
Erreur OAuth : "OAuth non implémenté"
Problème : Lors de la connexion de votre application IA à votre MCP Server, vous recevez un message d'erreur indiquant "OAuth non implémenté" ou une erreur similaire liée à OAuth.
Solution :
Cette erreur se produit généralement lorsque le flux d'authentification OAuth ne peut pas être complété. Vérifiez les points suivants :
1. Configuration Cloudflare
Si vous utilisez Cloudflare, vérifiez que :
- Cloudflare autorise l'accès aux routes
.well-known/* - Ces routes sont essentielles pour le processus de découverte OAuth
- Assurez-vous que Cloudflare ne bloque pas ou ne met pas en cache ces points de terminaison
2. Configuration .htaccess et .htpasswd
Vérifiez votre fichier .htaccess pour vous assurer qu'il autorise l'en-tête Authorization :
# Autoriser l'en-tête Authorization
SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1
L'en-tête Authorization est requis pour que l'authentification OAuth fonctionne correctement.
Si vous utilisez un .htpasswd, vous devez demander mcp avec une authentification de base dans votre URL.
Exemple : https://username:password@your_domain.com/mcp
3. Mode Maintenance PrestaShop
Assurez-vous que votre boutique PrestaShop n'est pas en mode maintenance :
- Le mode maintenance bloque l'accès externe à votre boutique
- Cela empêche le flux d'authentification OAuth de se terminer
- Désactivez le mode maintenance avant d'essayer de connecter votre application IA
Astuce : Après avoir effectué ces modifications, essayez de reconnecter votre application IA à votre MCP Server.
Erreur de Configuration de Connexion : "Une erreur s'est produite lors de la configuration de la connexion"
Problème : Lors de la tentative de connexion de votre application IA, vous recevez un message d'erreur indiquant "Une erreur s'est produite lors de la configuration de la connexion".
Solution :
Cette erreur se produit généralement lorsque vous n'êtes pas connecté avec le bon compte autorisé à accéder au MCP Server.
Vérifier Votre Compte
- Allez sur accounts.distribution.prestashop.net
- Vérifiez l'adresse e-mail avec laquelle vous êtes connecté
- Retournez à la page de configuration de PS MCP Server et naviguez vers l'onglet "Membres"
- Vérifiez que vous êtes connecté avec l'adresse e-mail autorisée à se connecter au MCP Server
Si Vous Utilisez le Mauvais Compte
Si vous découvrez que vous êtes connecté avec le mauvais compte :
- Déconnectez-vous du compte actuel
- Reconnectez-vous avec la bonne adresse e-mail autorisée
- Essayez de reconnecter votre application IA
Si vous avez une erreur avec Accounts
- Besoin de réinitialiser le module ps_accounts
- Réessayez l'étape d'intégration des comptes
Erreur de Classe Non Trouvée : "class psMcpTools/LanguagesTool not found"
Problème : Vous rencontrez un message d'erreur indiquant "class psMcpTools/LanguagesTool not found" ou des erreurs similaires liées aux classes du module ps_mcp_tools.
Solution :
Cette erreur se produit lorsque le cache de PrestaShop n'est pas synchronisé avec la structure du module. Pour résoudre ce problème :
Réinitialiser le Module ps_mcp_tools
- Allez dans votre back office PrestaShop
- Naviguez vers Modules > Gestionnaire de modules
- Recherchez "ps_mcp_tools"
- Cliquez sur le menu déroulant à côté du module
- Sélectionnez "Réinitialiser"
- Confirmez l'action de réinitialisation
Cela réinitialisera le module et effacera le cache interne de PrestaShop qui lui est associé.
💡Astuce : Après avoir réinitialisé le module, les problèmes de chargement de classe devraient être résolus. Si le problème persiste, essayez de vider le cache de PrestaShop depuis Paramètres avancés > Performances.
Besoin d'aide ?
Si vous rencontrez des problèmes qui ne sont pas couverts dans ce guide de dépannage, vous pouvez contacter notre service de support à l'URL suivante :
https://care-center.prestashop.com/fr/nous-contacter?form=support&subject=ps_mcp_server
Notre équipe de support sera ravie de vous aider avec tout problème que vous pourriez rencontrer.