Claude Code MCP journaux : Trouver la première limite échouée

Si vous cherchez des Claude Code MCP journaux , commencez par l’état du serveur résolu, puis capturez un fichier de débogage à portée d’incident. Ne commencez pas par suivre le répertoire de Claude Desktop journal : la documentation de MCP actuelle étiquette ces chemins de système de fichiers spécifiquement pour le bureau, tandis que Claude Code documents /mcp , claude mcp list , claude debug mcp et debug file . Le résultat utile n’est pas « trouver une bûche ». Il s’agit d’identifier la première limite défaillante : configuration, approbation du projet, démarrage du processus, découverte d’outils, exécution de l’outil, ou le résultat externe que l’outil était censé produire. Un journal peut expliquer une frontière. Il ne peut pas prouver les six. Ce guide utilise la documentation Claude Code actuelle et le 2.1.220 de publication du npm, consultés le 30 juillet 2026. Épinglez votre version installée à chaque incident car MCP comportement et les diagnostics changent encore. Inspecter l’état de résolution avant de lire la sortie brute Effectuez ces vérifications depuis le même répertoire de travail et le même compte utilisateur qui ont présenté le problème : Dans la session Claude Code concernée, exécutez : Le Guide officiel de débogage de la configuration Il indique /mcp montre les serveurs configurés, l’état de la connexion et l’approbation du projet. Le MCP référence Ajoute deux détails opérationnels importants : un serveur .mcp.json à portée de projet peut rester en attente jusqu’à ce que l’espace de travail soit fiable et que le serveur soit approuvé ; Un serveur connecté ne peut toujours exposer aucun outil, et /mcp rapports qui comptent. Ces faits éliminent trois catégories de recherche de journal à l’aveugle : Preuves résolues Première décision Pourquoi les journaux ne sont pas les premiers Serveur absent CONFIG MISSING Il n’y a pas encore de processus serveur chargé à diagnostiquer. Vérifiez les sources de portée et de paramètres. En attente d’approbation APPROVAL WAIT C’est une limite légitime d’autorité, pas un crash. Examinez le et approuvez le de manière interactive. Échec de connexion Capture MCP preuve de débogage La commande, le chemin, l’environnement, l’authentification ou le transport ont peut être échoué. Connecté, aucun outil Reconnectez vous, puis capturez MCP preuves de débogage Le démarrage a suffisamment réussi pour se connecter, mais la découverte n’a pas produit de registre utilisable. Connecté, outils présents Reproduire un appel borné La santé de la connexion ne dit rien sur l’outil sélectionné ni sur son effet externe. Les chemins relatifs méritent une suspicion particulière pour les serveurs stdio locaux. Claude Code documents que command et args chemins se résolvent à partir du répertoire où Claude Code a été lancé, et non à partir de l’emplacement de .mcp.json . Un serveur peut donc fonctionner dans un dépôt et échouer à partir d’un autre avec un texte de configuration identique. Capturez un fichier de débogage Claude Code MCP à portée de portée Le courant actuel Claude Code Référence CLI Documents sur deux drapeaux pertinents : debug active le mode débogage et accepte les filtres de catégorie tels que mcp ; debug file <path écrit la sortie de débogage sur un chemin explicite et active implicitement le mode débogage. Créez un annuaire privé d’incidents, relancez une session à neuf avec uniquement la catégorie de débogage MCP, et reproduisez un symptôme borné : Au cours de cette séance, inspectez /mcp . Si un serveur est connecté sans aucun outil, utilisez son action Reconnect . Si des outils sont présents, invoquez uniquement le plus petit outil en lecture seule qui reproduit le problème. Ne retentez pas un appel capable d’écrire simplement pour rendre le journal plus intéressant. Considérez le fichier de débogage comme sensible. Il peut contenir des chemins absolus, des noms de serveurs, des détails d’environnement, des métadonnées de requête ou des standards de serveur. Enregistrez les preuves dérivées dans le reçu de l’incident, puis conservez ou supprimez le fichier brut selon votre politique de sécurité. Ne copiez pas les jetons d’accès, les corps des requêtes, les arguments d’outils, les résultats ou le texte standard dans un système de surveillance simplement parce que le fichier les contient. Un public Claude Code demande de fonctionnalité pour les fichiers journaux par MCP serveur signale que les utilisateurs souhaitent des fichiers persistants de style bureau pour Claude Code. Cette question est une preuve utile des frontières, pas une garantie de produit. La procédure d’incident prise en charge doit dépendre du fichier de débogage explicite documenté, et non d’un chemin par serveur par défaut supposé. Associez le chemin des preuves au transport Le MCP guide de débogage pour la révision du protocole 2026 07 28 trace une limite de transport cruciale. Pour un serveur local stdio , stdout transporte les messages protocolaires. Les diagnostics serveur appartiennent à stderr ; Écrire du texte de diagnostic dans STDOUT peut corrompre le flux de protocole. Le guide de dépannage de Claude Code recommande spécifiquement claude debug mcp lorsqu’un serveur connecté n’expose aucun outil, car cela rend le serveur stderr disponible dans les preuves de débogage. Pour Streamable HTTP , le client ne peut pas capturer le stderr du processus serveur distant. Un fichier de débogage Claude Code peut toujours montrer le comportement de connexion et de requête côté client, mais la panne interne du serveur nécessite des journaux côté serveur ou des OpenTelemetry plus une inspection au niveau HTTP. Un segment de débogage client vide ne prouve pas que le service distant n’a rien fait. Cette distinction empêche une conclusion fausse courante : Note le transport dans le reçu. Sans cela, « pas de stderr » est ambigu. Construire un reçu d’incident minimisé au contenu Le journal brut est une preuve pour enquête. Le reçu est le dossier médical durable. Il peut rester utile sans stocker de contenu : Gardez explicite la préséance du classificateur : J’ai rejoué cette règle contre huit étuis synthétiques. Il a correctement séparé la configuration manquante, l’attente d’approbation, l’échec de démarrage capturé, la connexion à zéro outil, l’erreur d’outil, la réponse réussie de l’outil sans résultat, le résultat vérifié, et une connexion échouée sans preuves de débogage suffisantes. Les huit États attendus ont tous été adoptés. Les deux derniers cas sont la limite importante. Un résultat JSON RPC réussite ou non erreur est la preuve d’activité. Si la tâche promettait un problème créé, un enregistrement modifié, un fichier livré ou une destination mise à jour, vérifiez cette destination séparément. Sans ce reçu, le bon État est OUTCOME UNVERIFIED , pas sain. Choisissez la plus petite action sûre suivante Chaque état doit conduire à une réponse bornée : CONFIG MISSING : Inspectez le champ des paramètres et le fichier exact Claude Code chargé. Ne modifiez pas le code du serveur. APPROVAL WAIT : Aligne l’approbation vers l’humain responsable. Ne qualifiez pas l’attente d’un accident. STARTUP FAILED : réparer la première cause de démarrage en béton dans les preuves de débogage à portée de champ d’application, puis reconnecter une fois. DISCOVERY EMPTY : comparer les preuves d’initialisation et d’outils ; Testez le serveur indépendamment avec MCP Inspector si besoin. TOOL CALL FAILED : Conservez l’identité de la requête, identifiez si la réessayage est sûre, et évitez de rejouer une écriture incertaine. OUTCOME UNVERIFIED : interroger la destination par identifiant stable. Ne relancez pas l’outil tant que vous n’êtes pas sûr si l’effet a déjà eu lieu ? UNCERTAIN : Collectez les preuves des limites manquantes ou faites une escalade. L’inconnu est un état opérationnel, pas une invitation à deviner. HEALTHY : nécessitent à la fois une chaîne de MCP utilisable et un reçu de résultat déterministe frais. Les journaux rendent une défaillance explicable. Le statut résolu le rend localisable. Un reçu de destination rend la récupération vérifiable. Gardez ces tâches séparées, et un incident Claude Code MCP devient un court exercice de preuves au lieu d’une succession de tentatives de plus en plus risquées. Sidewisp est conçu autour de cette distinction axée sur la santé entre connexion, progrès utile, outils et résultats. Sidewisp est actuellement en préversion privée. Les adaptateurs de surveillance de production et l’exécuteur de récupération ne sont généralement pas livrés.