Pourquoi mon MCP ne fonctionne-t-il pas ?

Lorsque vous utilisez le protocole MCP, plusieurs éléments communiquent ensemble : votre ordinateur (Node.js ou Python), le client (Claude Code), et le serveur (l'outil que vous essayez d'utiliser).

La très grande majorité des erreurs provient de l'une de ces 3 choses :

  • Un outil de base est manquant (comme Node.js).
  • Le fichier de configuration comporte une erreur de ponctuation (souvent une virgule manquante).
  • L'IA n'a pas les autorisations nécessaires pour accéder à vos données.
Information

Utilisez cette page comme une table d'orientation. Cherchez l'erreur qui vous bloque dans les catégories ci-dessous et cliquez dessus pour découvrir la solution étape par étape.

1. Problèmes d'Installation

Ces erreurs surviennent généralement lorsque vous essayez d'utiliser un serveur pour la toute première fois.

2. Problèmes avec Claude Code

Ces erreurs apparaissent au moment où vous discutez avec l'IA et qu'elle tente de se servir d'un outil.

3. Erreurs spécifiques aux Serveurs

Ces erreurs concernent des problèmes de transport (STDIO) ou des configurations propres à certains serveurs.

Aller plus loin

Si votre problème ne figure pas dans cette liste, vous pourriez trouver la solution en consultant ces autres ressources :