Les bases de MCP
Les bases du Model Context Protocol : des processus serveurs exposent des outils, APIs et services à Claude Code via un format de communication partagé. Config, transports et premier serveur.
Arrêtez de configurer. Commencez à construire.
Templates SaaS avec orchestration IA.
Problème : Claude Code se heurte sans cesse à des murs. Il peut modifier tes fichiers et exécuter tes commandes, mais dès que tu as besoin d'une ligne de base de données, d'une issue GitHub ou d'un résultat de recherche frais, la réponse est non.
Gain rapide : Connecte un serveur à ta config et le mur disparaît. Ajoute ça dans ton fichier de paramètres MCP :
{
"mcpServers": {
"brave-search": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-brave-search"],
"env": { "BRAVE_API_KEY": "your-api-key" }
}
}
}Redémarre Claude Code, puis demande-lui de "chercher les dernières fonctionnalités de Next.js 15" et regarde les résultats en direct s'afficher.
C'est quoi un serveur MCP ?
Un serveur MCP est un programme séparé qui expose des outils à Claude Code via un format de communication partagé. Ce format s'appelle le Model Context Protocol. Tu l'installes une fois, le programme tourne à côté de Claude, et il répond quand on l'appelle.
Nouveau en 2026 : MCP Tool Search est maintenant intégré à Claude Code. Il charge les définitions de serveurs à la demande, ce qui réduit la surcharge de contexte MCP jusqu'à 95 %. Tu peux connecter une longue liste de serveurs sans voir ta fenêtre de contexte disparaître.
Pense à ce que Claude Code peut faire tout seul. Des fichiers. Des commandes. C'est tout. Avec un seul serveur connecté, la même session peut :
- Récupérer des pages web en temps réel
- Lancer des requêtes sur des bases de données et des APIs
- Piloter GitHub, Slack ou Google Sheets depuis le chat
- Atteindre des outils de niche construits pour un secteur précis
- Enchaîner des étapes sur plusieurs systèmes en un seul workflow
- Communiquer avec Telegram et Discord via les Channels
Comment fonctionnent les serveurs MCP
Chaque serveur MCP tourne comme son propre processus. Claude Code lui parle à travers le protocole, et la connexion que tu vas voir suit les mêmes quatre étapes à chaque fois :
- Connexion : Claude Code ouvre un canal vers le serveur MCP
- Découverte : Le serveur liste les outils et fonctions qu'il expose
- Intégration : Ces outils apparaissent dans la liste d'outils de Claude
- Exécution : Claude peut les appeler en pleine conversation
// Claude Code CLI: ~/.claude.json or project-level .mcp.json
// Claude Desktop: claude_desktop_config.json
{
"mcpServers": {
"brave-search": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-brave-search"],
"env": {
"BRAVE_API_KEY": "your-api-key"
}
}
}
}Les serveurs MCP essentiels à installer
Commence par les incontournables. Ce sont ceux qui résolvent les problèmes que rencontrent la plupart des développeurs dès le premier jour :
Accès web et recherche :
- Brave Search (
@modelcontextprotocol/server-brave-search) - Recherche web - Fetch (
@modelcontextprotocol/server-fetch) - Récupérer et analyser du contenu web
Outils de développement :
- GitHub (
@modelcontextprotocol/server-github) - Accès et gestion des dépôts - Git (
@modelcontextprotocol/server-git) - Opérations git locales - PostgreSQL (
@modelcontextprotocol/server-postgres) - Requêtes de base de données
Opérations de fichiers :
- Filesystem (
@modelcontextprotocol/server-filesystem) - Opérations fichiers avancées - Google Drive (
@modelcontextprotocol/server-gdrive) - Accès aux fichiers cloud
Glisse n'importe lequel de ces serveurs dans le bloc mcpServers en utilisant la même structure que l'exemple ci-dessus.
Chaque serveur ajoute sa tranche de capacité. La liste des serveurs MCP populaires est l'endroit où tu trouveras ceux qui correspondent à ton travail quotidien.
Le processus de configuration
Les serveurs vivent dans du JSON. Pas de commande d'installation. Ta mise en place se fait en quatre courtes étapes :
- Localise ton fichier de config :
- Claude Code CLI :
~/.claude.jsonou.mcp.jsonà la racine du projet - Claude Desktop (macOS) :
~/Library/Application Support/Claude/claude_desktop_config.json - Claude Desktop (Windows) :
%APPDATA%\Claude\claude_desktop_config.json
- Ajoute la configuration du serveur :
{
"mcpServers": {
"server-name": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-name"],
"env": { "API_KEY": "your-key-here" }
}
}
}-
Redémarre Claude Code pour charger la nouvelle configuration.
-
Teste dans Claude Code : Demande à Claude : "What MCP tools are available?" pour voir tes extensions installées.
Problèmes courants et leurs solutions
Erreur : "MCP server not found" Solution : Vérifie que le package est installé globalement et dans le path :
# Reinstall with explicit global flag
npm install -g @modelcontextprotocol/server-brave-searchErreur : "Authentication failed"
Solution : Vérifie que les clés API sont exportées dans ton shell :
# Check environment variables
echo $BRAVE_API_KEY
echo $GITHUB_TOKENErreur : "Server connection timeout" Solution : Redémarre Claude Code pour que les connexions MCP se reconstruisent. Quitte ta session actuelle et ouvre-en une nouvelle pour recharger chaque serveur.
Commandes pour activer/désactiver rapidement
Pas besoin de modifier le JSON pour couper un serveur bruyant. Bascule-le depuis le chat :
# Disable a server temporarily
/mcp disable supabase
# Re-enable when needed
/mcp enable supabaseC'est pratique quand un serveur génère des erreurs, ou quand sa liste d'outils encombre tes prompts. L'entrée dans la config reste en place. Seul l'état actif de la session bascule.
Configuration avancée
Certains serveurs veulent des réglages supplémentaires. Tu passes des commandes personnalisées et des variables d'environnement comme ça :
{
"mcpServers": {
"custom-server": {
"command": "node",
"args": ["path/to/your/server.js"],
"env": {
"LOG_LEVEL": "debug",
"TIMEOUT": "30000"
}
}
}
}Ce que ce pattern t'apporte :
- Des serveurs Node.js ou Python locaux qui tournent depuis tes propres chemins
- Des variables d'environnement personnalisées pour les clés et les paramètres
- Des logs de débogage quand quelque chose déraille
- Un pont vers n'importe quel service qui livre un serveur compatible MCP
Prochaines étapes
Choisis-en une et fais-le aujourd'hui :
- Installe ton premier serveur MCP : Prends Brave Search pour un accès web immédiat
- Explore les options populaires : Consulte notre guide des serveurs MCP populaires pour des recommandations sélectionnées
- Configure l'automatisation du navigateur : Découvre l'automatisation du navigateur avec MCP pour les interactions web avancées
- Crée des intégrations personnalisées : Construis tes propres serveurs MCP avec notre tutoriel d'intégrations personnalisées
Un serveur MCP change la forme de chaque session Claude Code. Ajoute celui dont tu as besoin aujourd'hui. Ajoute le prochain quand le prochain mur apparaît. Si tu préfères éviter les essais-erreurs, le Code Kit de ClaudeFast livre un ensemble sélectionné de configs de serveurs MCP avec son système de 18 agents, pour que la première session soit déjà câblée.
Arrêtez de configurer. Commencez à construire.
Templates SaaS avec orchestration IA.