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

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

1. Allez sur accounts.distribution.prestashop.net
2. Vérifiez l'adresse e-mail avec laquelle vous êtes connecté
3. Retournez à la page de configuration de PS MCP Server et naviguez vers l'onglet "Membres"
4. 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 :

1. Déconnectez-vous du compte actuel
2. Reconnectez-vous avec la bonne adresse e-mail autorisée
3. Essayez de reconnecter votre application IA

Si vous avez une erreur avec Accounts

1. Besoin de réinitialiser le module ps_accounts
2. 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

1. Allez dans votre back office PrestaShop
2. Naviguez vers Modules > Gestionnaire de modules
3. Recherchez "ps_mcp_tools"
4. Cliquez sur le menu déroulant à côté du module
5. Sélectionnez "Réinitialiser"
6. Confirmez l'action de réinitialisation

Cela réinitialisera le module et effacera le cache interne de PrestaShop qui lui est associé.

Problèmes de connexion

Problème : Votre LLM n'arrive pas à se connecter, à découvrir les outils ou ne semble pas trouver de serveur d'authentification.

Solution :

Ce problème peut survenir si votre serveur bloque les requêtes provenant des LLMs. Pour résoudre ce problème, vous devez ajouter les user-agent suivants à la liste blanche de votre serveur ou de votre pare-feu :

• Claude Desktop: "python-httpx/0.28.1" / "Claude-User"
• ChatGPT: "Python/3.12 aiohttp/3.11.18" / "openai-mcp/1.0.0 (ChatGPT)"
• Dust: "node" / "node"
• Gemini CL: "node" / "node"

Assurez-vous que votre configuration de sécurité autorise les requêtes avec ces user-agent.

Erreur lors de l'appel aux outils

Problème : Lorsque l'agent IA appelle un outil, il reçoit une erreur telle que "Erreur interne" ou un message d'erreur inattendu, mais vous ne savez pas ce qui s'est mal passé.

Solution :

Lors du développement d'outils, de ressources ou de prompts MCP, vous devez envelopper votre logique métier dans des gestionnaires d'exception pour retourner des messages d'erreur significatifs à l'agent IA. PrestaShop MCP Server fournit des wrappers d'exception dédiés à cet effet :

use PrestaShop\Module\PsMcpServer\Server\Exceptions\PsMcpToolCallException;

try {
    // votre logique métier
} catch (\Exception $e) {
    throw new PsMcpToolCallException(
        'Impossible de traiter : ' . $e->getMessage(),
        1
    );
}

Utilisez la classe d'exception appropriée en fonction du type d'élément MCP :

Pour des exemples détaillés, consultez la section Gestion des erreurs dans la documentation.

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.