Skip to content
Floskool

Chapter 4 · Sécurité et dépannage

Dépannage, check-list et suite

Free lesson 9 minGroup Claude Code & IA

Follow this course in your space: your progress is saved, and the community answers your questions.

Follow for free

Pourquoi apprendre à dépanner

Un serveur qui ne répond pas, ça arrive : adresse mal copiée, connexion expirée, programme local absent. Avec une méthode, tu règles la plupart des cas en quelques minutes, sans paniquer.

Exemple : Inès, prof de yoga, voit un matin ✘ Failed to connect sur son serveur de notes. Au lieu de tout réinstaller, elle suit l'ordre ci-dessous : c'était une connexion expirée, réglée par une reconnexion dans /mcp.

La méthode, dans l'ordre

  1. Regarde l'état : claude mcp list dans le terminal, ou /mcp dans Claude Code.
  2. Lis le symbole :
    • ! Needs authentication : connecte-toi avec /mcp (ou claude mcp login <nom>).
    • ⏸ Pending approval : lance claude dans le projet et approuve le serveur du .mcp.json.
    • ⊘ Disabled for this project : réactive-le dans /mcp.
    • ✘ Failed to connect : passe à l'étape 3.
  3. Relance : dans /mcp, option Reconnect sur le serveur. Si la connexion a expiré, Re-authenticate.
  4. Vérifie la configuration : claude mcp get <nom>. Compare l'adresse avec la documentation officielle du service, lettre par lettre.
  5. Serveur local : vérifie que le programme nécessaire est installé (par exemple Node.js pour npx) et que tu n'as pas oublié le -- avant la commande.
  6. Repars de zéro proprement : claude mcp remove <nom>, puis ajoute-le de nouveau avec la commande vérifiée.

Deux réglages utiles

  • Démarrage lent : la documentation prévoit la variable MCP_TIMEOUT (en millisecondes) pour laisser plus de temps à un serveur au démarrage. Sur Mac ou Linux : MCP_TIMEOUT=10000 claude (10 secondes). Sous Windows PowerShell : $env:MCP_TIMEOUT=10000; claude.
  • Réponses trop longues : la documentation indique un avertissement au-delà de 10 000 jetons de réponse d'un outil (un jeton est un petit morceau de texte), et une limite par défaut de 25 000, réglable avec MAX_MCP_OUTPUT_TOKENS. Le plus simple reste souvent de demander moins : une période plus courte, une seule page.

Le prompt de diagnostic

Mon serveur MCP [nom] affiche [état exact copié depuis claude mcp list].
Aide-moi à comprendre pourquoi, sans rien modifier et sans me demander de clé :
1. dis-moi d'où vient sa configuration (portée et fichier),
2. liste les causes probables, de la plus simple à la plus rare,
3. donne-moi la commande ou l'action à essayer pour chacune, une à la fois.
J'essaie moi-même et je te donne le résultat avant l'étape suivante.

Les erreurs à éviter

  • Tout réinstaller au premier souci. Commence par lire l'état et relancer.
  • Coller ta clé dans la conversation pour « aider Claude ». Jamais : s'il en faut une, tu la mets toi-même dans le bon fichier.
  • Changer l'adresse au hasard. Seule la documentation officielle du service fait foi.

À toi de jouer

Sur ton serveur, entraîne-toi : désactive-le dans /mcp, constate l'état dans claude mcp list, réactive-le, puis lance le prompt de diagnostic comme si tu avais une panne. Tu sauras quoi faire le jour où elle arrive.

Check-list récapitulative

  • ☐ Je sais expliquer ce qu'est un serveur MCP, distant (HTTP) ou local (stdio).
  • ☐ J'ai pris l'adresse de mon serveur dans la documentation officielle de l'outil.
  • ☐ J'ai choisi la bonne portée : local pour tester, user pour partout, project pour l'équipe.
  • ☐ J'ai ajouté mon serveur avec claude mcp add et vérifié avec claude mcp list.
  • ☐ Je me suis connecté avec /mcp, en autorisant le minimum d'accès.
  • ☐ Aucune clé n'est écrite dans .mcp.json : j'utilise des variables ${NOM}.
  • ☐ Mes demandes précisent l'outil, la page, « lecture seule » et l'accord avant action.
  • ☐ Ma règle « Outils branchés » est dans CLAUDE.md.
  • ☐ J'ai au moins une règle deny utile dans .claude/settings.json.
  • ☐ J'ai fait l'inventaire de mes serveurs et désactivé ou retiré ce qui ne sert pas.
  • ☐ Je sais révoquer un accès côté service, pas seulement retirer le serveur.
  • ☐ Je connais l'ordre de dépannage : état, symbole, relance, configuration, réinstallation.

Aller plus loin

Si cette formation t'a été utile, le Pack Prompts IA de GoVincia va plus loin, sur les mêmes principes : des prompts précis, la sécurité d'abord, et toujours ton accord avant d'agir.

Ce qui concerne directement les MCP :

  • Le guide « Les bases de Claude Code » contient un chapitre sur les connecteurs (MCP) et les clés API, avec la méthode de prompt en cinq parties utilisée ici.
  • Le guide « Sécurité » détaille l'injection de prompt, le choix de serveurs MCP de confiance, les permissions et la relecture avant toute publication.
  • Le skill audit-securite passe ton projet en revue, serveurs MCP compris (ceux de .mcp.json et ceux visibles avec claude mcp list), en lecture seule, et rend un rapport classé par gravité. Tu l'appelles par exemple avec : « /audit-securite Je viens de brancher deux serveurs MCP. Vérifie ce qui a changé côté risques. »
  • Le skill prompt-precis t'aide à formuler des demandes en cinq parties, et createur-claude-md à écrire le CLAUDE.md de ton projet.

Au total, le pack contient 13 skills Claude Code prêts à l'emploi et 10 guides PDF. Tu trouves tout sur govincia.fr (le lien est aussi dans la bio).