> ## Documentation Index > Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt > Use this file to discover all available pages before exploring further. # Dépannage MCP > Diagnostiquez et corrigez les problèmes courants de connexion, d'authentification et d'outils du serveur MCP. Repérez le symptôme qui correspond à votre problème. Chaque entrée indique la cause probable et la solution. ## Dépannage de Claude Code | Symptôme | Cause | Solution | | - | - | - | | Le navigateur ne s'ouvre pas. | Le lancement automatique a échoué. | Copiez l'URL depuis le terminal et ouvrez-la manuellement. | | Connexion refusée sur le port 35535. | Le port est déjà utilisé. | Exécutez `lsof -i :35535` sous macOS ou Linux, ou `netstat -ano \| findstr :35535` sous Windows, arrêtez le processus, puis réessayez. | | Échec de connexion après OAuth. | Le jeton n'a pas été conservé. | Relancez la [commande de l'étape 2](https://docs.kameleoon.com/fr/mcp/set-up-clients.md#étape-2--terminer-l’authentification-oauth) pour renouveler votre jeton. | | Les outils ne sont pas visibles dans Claude. | La session a démarré avant l'ajout du serveur. | Démarrez une nouvelle conversation Claude Code. | | Un outil plus récent, comme `experiment_update` ou `trigger_list`, est absent de la liste des outils. | Le client conserve la liste d'outils chargée avant que Kameleoon ne publie ces outils. | Reconnectez le serveur. Dans Claude.ai, accédez à **Customize** > **Connectors** et reconnectez Kameleoon. Dans Claude Code, exécutez `/mcp` et choisissez **Reconnect**. | | Clé `mcpServers` rejetée dans `settings.json`. | Mauvais fichier : Claude Code n'utilise pas cette clé. | Utilisez la commande `claude mcp add` à la place. | | Erreur d'authentification après une longue période. | Le jeton OAuth a expiré. | Relancez la [commande de l'étape 2](https://docs.kameleoon.com/fr/mcp/set-up-clients.md#étape-2--terminer-l’authentification-oauth). | ## Dépannage général ### Erreur de limite de débit Un appel d'outil renvoie une erreur de limite de débit qui inclut une valeur `retryAfterSeconds`. * **Cause :** L'appel a dépassé la limite par outil du serveur MCP pour votre utilisateur, ou la limite de la passerelle de l'Automation API pour l'intégration MCP. * **Solution :** Attendez le nombre de secondes indiqué dans `retryAfterSeconds`, puis relancez l'appel. Pour les traitements en volume, regroupez vos requêtes ou limitez le rythme de la boucle pour rester sous les limites. ### Le port 35535 est déjà utilisé Si l'authentification échoue avec une erreur `EADDRINUSE`, un autre processus écoute déjà sur le port de callback OAuth. * **Cause :** Un processus `mcp-remote` obsolète reste actif après une tentative d'authentification précédente. * **Solution :** Arrêtez le processus obsolète qui utilise le port 35535, puis relancez la commande OAuth. ### Le serveur MCP n'apparaît pas dans le chat Codex Codex ne recharge peut-être pas à chaud les serveurs MCP ajoutés dans un fil déjà en cours d'exécution. * **Solution :** Actualisez Codex ou démarrez une nouvelle session après avoir modifié `config.toml`. ### Le flux du navigateur ne se termine pas Si la fenêtre d'authentification OAuth s'ouvre, mais que l'autorisation ne se termine pas : * Vérifiez que vous avez cliqué sur le bouton **Authorize** de la page de connexion Kameleoon. * Vérifiez que les paramètres de votre navigateur ou de votre système ne bloquent pas les callbacks sur `localhost`. * Ouvrez manuellement l'URL de callback si votre navigateur ne parvient pas à la lancer automatiquement. ### Un outil renvoie BLOCKED au lieu d'effectuer la modification Les outils qui modifient le trafic en direct renvoient un aperçu au statut `BLOCKED` tant que vous n'avez pas confirmé. Ce statut ne signifie pas une erreur. * **Solution :** Lisez l'aperçu et, si la modification vous convient, demandez à votre assistant IA de relancer l'appel avec `confirm` défini sur `true`. Pour `segment_delete` et `trigger_delete`, utilisez `force` à la place. ### Le health check renvoie DOWNSTREAM\_ERROR `experiment_health_check_get` échoue pour une expérience qui utilise un objectif de ratio dont l'objectif numérateur n'est pas attaché à l'expérience. * **Solution :** Attachez l'objectif manquant dans l'application, ou exécutez le contrôle sur une autre expérience. ### Les impacts d'objectif ne renvoient aucune ligne `goal_experiment_impacts_list` peut ne renvoyer aucune ligne pendant que les données sont encore en préparation. * **Solution :** Vérifiez le champ `readiness` (`PREPARING` ou `PARTIAL`), puis posez de nouveau la question après `retryAfterSeconds`. ### Les résultats d'une seule journée diffèrent de la découpe quotidienne Une fenêtre d'un seul jour suit le fuseau horaire de votre organisation. Les tranches quotidiennes suivent le fuseau horaire du site, si bien que les deux peuvent couvrir des périodes de 24 heures différentes. ### L'amélioration est à 0 ou absente pour une variation Il n'existe aucune base de comparaison lorsque l'original reçoit 0 % du trafic. ### Une page, une taille de page ou une limite égale à 0 renvoie la valeur par défaut Dans `takeaway_list` et `goal_experiment_impacts_list`, la valeur 0 pour une page, une taille de page ou une limite signifie « utiliser la valeur par défaut ». ### Des outils récents manquent après une version Les clients conservent l'ancienne liste d'outils jusqu'à ce que vous vous reconnectiez. * **Solution :** Après une version, reconnectez le connecteur MCP Kameleoon. ### Les agents sans interface ou à distance n'arrivent pas à s'authentifier Les agents à distance ou sans interface (comme Codex hébergé dans le cloud) ne peuvent pas terminer l'étape d'autorisation par navigateur. * **Solution :** Utilisez une version de bureau de votre outil. ### Commande du gestionnaire de paquets introuvable Si la commande échoue avec une erreur « not found », vérifiez que `npx` est accessible dans le PATH de votre système. Les versions de Node.js 8.2 et ultérieures incluent `npx` par défaut.