MCP : Model Context Protocol - Astuces

Le Model Context Protocol (MCP) connecte Claude Code à des outils externes (GitHub, navigateurs, bases de données) via un standard ouvert. Voici 18 astuces classées par thème pour configurer, sécuriser et exploiter vos serveurs MCP au quotidien. Chaque tip est directement applicable en session.

Le Model Context Protocol (MCP) est un standard ouvert créé par Anthropic qui permet aux assistants IA comme Claude Code de communiquer avec des serveurs d'outils externes via un protocole unifié. MCP supporte trois modes de transport : stdio en local, Streamable HTTP recommandé pour le distant, et SSE désormais déprécié. Il donne accès à des centaines de serveurs communautaires. MCP réduit significativement le temps de configuration des intégrations par rapport aux plugins propriétaires.

Comment fonctionne le protocole MCP avec Claude Code ?

MCP (Model Context Protocol) est une couche d'abstraction qui standardise la communication entre un client IA et des serveurs d'outils. Chaque serveur expose des « tools » que Claude Code découvre automatiquement au démarrage de la session.

Le protocole repose sur JSON-RPC 2.0. Le client envoie une requête, le serveur répond avec le résultat structuré. Cette architecture découplée permet d'ajouter ou retirer des serveurs sans modifier le code de l'assistant.

En pratique, un serveur MCP se lance en local (stdio) ou en réseau (Streamable HTTP recommandé, SSE déprécié en fallback). Claude Code détecte les outils disponibles et les propose dans ses appels de fonction. Vous n'avez aucune configuration côté prompt à effectuer.

Composant	Rôle	Exemple
Client MCP	Envoie les requêtes d'outils	Claude Code
Serveur MCP	Expose des outils via JSON-RPC	@modelcontextprotocol/server-github
Transport	Canal de communication	stdio (local), Streamable HTTP (distant recommandé), SSE (déprécié)
Tool	Action unitaire exposée	`create_issue`, `brave_search`

Pour comprendre l'ensemble du protocole et ses cas d'usage, consultez le guide complet MCP : Model Context Protocol qui couvre l'architecture en détail.

À retenir : MCP est un protocole JSON-RPC 2.0 qui connecte Claude Code à des serveurs d'outils externes de manière standardisée.

Quels sont les trois modes de transport MCP disponibles ?

Astuce 1 : Privilégiez stdio pour les serveurs locaux

Le transport stdio lance le serveur comme un processus enfant. La communication passe par stdin/stdout. C'est le mode le plus simple et le plus rapide, sans surcoût réseau.

claude mcp add mon-serveur -- npx -y @modelcontextprotocol/server-filesystem /chemin/dossier

Astuce 2 : Adoptez Streamable HTTP pour tous les serveurs distants

Streamable HTTP est le transport distant recommandé depuis la spécification MCP 2025-03. Il combine requêtes/réponses classiques et streaming optionnel, et il remplace SSE sur les déploiements cloud et en production. Ce transport réduit la consommation mémoire par rapport à SSE sur les connexions longues.

claude mcp add --transport http serveur-cloud https://api.example.com/mcp

Astuce 3 : N'utilisez SSE qu'en fallback pour les serveurs existants

SSE (Server-Sent Events) maintient une connexion HTTP longue durée. Ce transport est désormais déprécié au profit de Streamable HTTP. Réservez SSE aux serveurs distants existants qui ne proposent pas encore HTTP, et migrez-les dès que possible.

claude mcp add --transport sse serveur-distant https://mon-serveur.example.com/sse

Transport	Latence	Cas d'usage	Persistance
stdio	Minimale (local, sans réseau)	Serveurs locaux, CLI	Durée de session
Streamable HTTP	Dépend du réseau	Cloud, production, distant (recommandé)	Par requête
SSE (déprécié)	Dépend du réseau	Serveurs distants existants uniquement	Connexion longue

Consultez les astuces de gestion du contexte pour optimiser la taille des réponses MCP dans votre fenêtre de contexte.

À retenir : Choisissez stdio en local et Streamable HTTP pour tout serveur distant. SSE est déprécié et ne sert qu'en fallback temporaire pour les serveurs existants.

Comment ajouter et gérer vos serveurs MCP ?

Astuce 4 : Déclarez les serveurs au bon scope

Claude Code gère trois niveaux de configuration (scopes) : local (par défaut, stocké dans ~/.claude.json sous le chemin du projet), projet (.mcp.json à la racine, partagé via Git) et utilisateur (~/.claude.json, disponible dans tous vos projets). Placez les serveurs partagés dans .mcp.json à la racine du projet pour que toute l'équipe en bénéficie.

{
 "mcpServers": {
 "github": {
 "type": "http",
 "url": "https://api.githubcopilot.com/mcp/",
 "headers": {
 "Authorization": "Bearer ${GITHUB_TOKEN}"
 }
 }
 }
}

Astuce 5 : Listez vos serveurs actifs en un clic

Exécutez la commande claude mcp list pour afficher tous les serveurs configurés avec leur statut. En pratique, cette commande affiche le transport, le scope et l'état de connexion de chaque serveur.

claude mcp list

Astuce 6 : Supprimez un serveur proprement

Lancez claude mcp remove nom-serveur pour retirer un serveur de la configuration. Le processus est arrêté et la référence supprimée du fichier de scope correspondant.

Pour une liste de vérifications avant de modifier vos serveurs, consultez la checklist MCP complète qui couvre chaque étape.

À retenir : Déclarez les serveurs partagés dans .mcp.json au niveau projet, et utilisez claude mcp list pour vérifier l'état à tout moment.

Comment utiliser les outils MCP pendant une session ?

Astuce 7 : Découvrez les outils disponibles avec /mcp

En session Claude Code, la commande slash /mcp liste tous les outils MCP accessibles. Chaque outil affiche son nom, sa description et ses paramètres attendus. Consultez les commandes slash essentielles pour d'autres raccourcis utiles.

Astuce 8 : Laissez Claude Code choisir l'outil automatiquement

Vous n'avez pas besoin de nommer l'outil explicitement. Décrivez votre intention en langage naturel. Claude Code sélectionne le bon outil MCP et forge l'appel avec les bons paramètres.

Concrètement, si vous dites « crée une issue GitHub pour ce bug », Claude Code appellera automatiquement l'outil create_issue du serveur GitHub MCP.

Astuce 9 : Combinez plusieurs outils MCP dans une requête

Claude Code enchaîne les appels d'outils dans un seul tour de conversation. Par exemple : rechercher avec Brave Search, puis créer un fichier avec les résultats.

Pour tirer le meilleur parti de vos conversations avec MCP, explorez les astuces pour vos premières conversations.

À retenir : Claude Code découvre et sélectionne automatiquement les outils MCP : décrivez votre besoin en langage naturel sans nommer l'outil.

Comment configurer et sécuriser vos serveurs MCP ?

Astuce 10 : Stockez les tokens dans des variables d'environnement

Ne codez jamais un token en dur dans .mcp.json. Utilisez la syntaxe ${NOM_VARIABLE} pour référencer des variables d'environnement. Le fichier .mcp.json peut être versionné sans risque si les secrets restent dans .env.

{
 "env": {
 "API_KEY": "${MON_API_KEY}"
 }
}

Astuce 11 : Restreignez les permissions par outil

Claude Code permet de configurer les autorisations par outil MCP. Ajoutez des règles comme mcp__github__create_issue dans permissions.allow ou permissions.deny de settings.json (utilisez mcp__github__* pour tout un serveur). Cela empêche un serveur compromis d'appeler des outils sensibles.

la majorité des incidents de sécurité MCP proviennent de tokens trop permissifs. Appliquez le principe du moindre privilège.

Astuce 12 : Validez les serveurs tiers avant installation

Avant d'ajouter un serveur communautaire, vérifiez le dépôt source, le nombre de contributeurs et la date du dernier commit. Un serveur sans mise à jour depuis plus de 6 mois présente un risque accru.

Les astuces permissions et sécurité détaillent les bonnes pratiques de contrôle d'accès pour Claude Code.

Risque	Mitigation	Priorité
Token en clair dans le code	Variables d'environnement `${VAR}`	Critique
Serveur tiers malveillant	Audit du dépôt source	Haute
Permissions trop larges	Restriction par outil (allow/deny)	Haute
Accès réseau non contrôlé	Transport stdio en local	Moyenne

À retenir : Stockez vos secrets dans des variables d'environnement et restreignez les permissions outil par outil : jamais de token en dur.

Quels sont les serveurs MCP les plus utiles au quotidien ?

Astuce 13 : Installez le serveur GitHub pour la gestion de projet

Le serveur GitHub expose des outils pour la création d'issues, les pull requests, la recherche de code et la gestion de branches. Configurez votre GITHUB_TOKEN avec les scopes repo et read:org minimum.

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ --header "Authorization: Bearer YOUR_GITHUB_PAT"

Astuce 14 : Ajoutez Brave Search pour la recherche web

Le serveur Brave Search donne à Claude Code un accès direct au web. Vous avez besoin d'une clé API Brave, configurée via une variable d'environnement.

claude mcp add brave-search -- npx -y @brave/brave-search-mcp-server

Astuce 15 : Utilisez Playwright MCP pour les tests navigateur

Le serveur Playwright permet à Claude Code de naviguer sur des pages web, capturer des screenshots et interagir avec des formulaires.

Pour diagnostiquer les erreurs de connexion avec ces serveurs, référez-vous au guide de dépannage MCP.

Serveur	Capacités	Clé API requise	Cas d'usage principal
GitHub	Issues, PRs, recherche de code, branches	GITHUB_TOKEN	Gestion de code et issues
Brave Search	Recherche web	BRAVE_API_KEY	Recherche web contextuelle
Playwright	Navigation, captures, interactions	Non	Tests UI et screenshots
Filesystem	Lecture et écriture de fichiers	Non	Lecture/écriture fichiers
PostgreSQL	Requêtes sur base de données	Connexion DB	Requêtes base de données

À retenir : GitHub, Brave Search et Playwright couvrent la majorité des besoins MCP courants : commencez par ces trois serveurs.

Comment déboguer un serveur MCP qui ne répond pas ?

Astuce 16 : Vérifiez les logs en lançant le serveur manuellement

Lancez le serveur manuellement pour observer la sortie standard et les erreurs. La plupart des problèmes viennent d'un binaire introuvable (npx non installé) ou d'un token expiré.

npx -y @playwright/mcp@latest 2>&1 | head -20

Astuce 17 : Testez la connexion avec un appel minimal

Exécutez claude mcp list et vérifiez que le statut affiche « connected ». Si le serveur apparaît comme « disconnected », ouvrez la commande /mcp en session pour vérifier le statut et relancer la connexion (ou ré-authentifier le serveur).

Concrètement, la grande majorité des erreurs MCP se résolvent en vérifiant trois points : le binaire est accessible, le token est valide, et le port réseau est ouvert.

La FAQ MCP répond aux questions fréquentes sur les erreurs de connexion et les timeouts.

À retenir : Lancez le serveur manuellement pour lire les logs, puis vérifiez binaire, token et réseau : ces trois points résolvent la grande majorité des problèmes.

Comment intégrer MCP dans un workflow CI/CD ?

Astuce 18 : Utilisez MCP en mode headless

Claude Code supporte le mode headless (claude -p "instruction") avec les serveurs MCP. Configurez vos serveurs dans .mcp.json à la racine du dépôt et le pipeline CI les lance automatiquement.

claude -p "Analyse les 5 dernières issues GitHub et crée un rapport" --allowedTools "mcp__github__*"

Le flag --allowedTools restreint les outils MCP autorisés en CI. Vous évitez ainsi qu'un prompt injecté déclenche des actions non désirées. la restriction d'outils réduit significativement la surface d'attaque dans les pipelines IA automatisés.

Pour aller plus loin sur l'automatisation, consultez les astuces mode headless et CI/CD qui couvrent les patterns d'intégration avancés.

SFEIR Institute propose la formation Claude Code sur 1 jour, avec des labs pratiques sur la configuration MCP et l'intégration CI/CD. Pour une montée en compétences complète, la formation Développeur Augmenté par l'IA sur 2 jours couvre l'ensemble des outils d'assistance au développement, y compris les workflows MCP avancés. Les développeurs expérimentés peuvent poursuivre avec la formation Développeur Augmenté par l'IA – Avancé sur 1 jour, axée sur l'optimisation et les pipelines automatisés.

À retenir : En CI/CD, combinez le mode headless avec --allowedTools pour contrôler précisément les outils MCP accessibles au pipeline.

Peut-on personnaliser le comportement MCP avec CLAUDE.md ?

Astuce bonus : Documentez vos serveurs MCP dans CLAUDE.md

Ajoutez une section MCP dans votre fichier CLAUDE.md pour guider Claude Code dans l'utilisation des outils. Précisez quels serveurs utiliser pour quels types de tâches et les contraintes spécifiques à votre projet.

## MCP Servers
- GitHub: utiliser pour toute gestion d'issues et PRs
- Brave Search: limiter à 5 recherches par session
- Playwright: screenshots en 1280x720 uniquement

Le guide du système de mémoire CLAUDE.md explique comment structurer ce fichier pour maximiser l'efficacité de Claude Code avec vos outils MCP.

À retenir : Le fichier CLAUDE.md sert de mémoire persistante : documentez vos conventions MCP pour que Claude Code les applique automatiquement.