Claude Code MCP se déconnecte dès qu’il démarre sous Windows, surtout lorsque le serveur MCP local commence avec 'npx', vérifiez d’abord si l’enveloppe 'cmd /c’manque. La documentation Anthropic avertit clairement que sous Windows natif, les serveurs MCP locaux utilisant le 'npx' doivent généralement être exécutés correctement via 'cmd /c'.
Déterminez d’abord si vous êtes Windows ou WSL
Si vous exécutez du code Claude en WSL, dépannez par chemin Linux et environnement Linux Node. L’accent est mis sur la question de savoir si « quel nœud » et « quel npm » pointent à l’intérieur de WSL.
Si vous jouez sous Windows natif, le problème peut venir de l’analyse par commandes. De nombreux exemples de configuration MCP écrivent « npx server-name », qui peut ne pas être exécuté directement par le code Claude comme on s’y attend sous Windows.
Comment changer la configuration
Changez la commande d’appeler directement 'npx' à appeler via 'cmd /c'. L’idée est de laisser l’interpréteur de commandes Windows être responsable de la recherche et de l’exécution des NPX. Les noms spécifiques des champs dépendent du format de configuration de votre MCP, mais l’essentiel est que la commande est 'cmd', et les arguments incluent '/c', 'npx' et le nom du paquet serveur.
Après avoir effectué des modifications, redémarrez Claude Code et utilisez '/mcp' pour vérifier l’état de la connexion. Ne regardez pas seulement si le fichier de configuration est sauvegardé, mais si le service est réellement connecté.
Corrigez aussi ces problèmes
Node n’est pas installé, npm n’est pas dans le PATH, l’agent de la société intercepte npm, et le serveur MCP nécessite des variables d’environnement mais ne les transmet pas, ce qui provoque la déconnexion de la connexion. Exécutez la même commande manuellement dans un terminal normal pour confirmer qu’il peut démarrer, puis passez-la à Claude Code.
Si le serveur nécessite une clé API, n’écrivez pas la clé dans le message du chat, elle doit être placée dans la variable d’environnement ou la configuration de sécurité.
L’approche la plus stable
Windows vérifie nativement « cmd /c » en premier, WSL priorise les chemins des nœuds Linux. Ensuite, utilisez '/mcp' pour voir le statut, et utilisez le terminal normal pour reproduire la commande de démarrage. Tant que vous cochez séparément « la commande peut-elle s’exécuter » et « si le code Claude peut être connecté », la déconnexion MCP sera beaucoup plus facile à corriger.
