Les bases de MCP

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 :

1. Connexion : Claude Code ouvre un canal vers le serveur MCP
2. Découverte : Le serveur liste les outils et fonctions qu'il expose
3. Intégration : Ces outils apparaissent dans la liste d'outils de Claude
4. 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 :

1. Localise ton fichier de config :

• Claude Code CLI : ~/.claude.json ou .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

2. Ajoute la configuration du serveur :

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-name"],
      "env": { "API_KEY": "your-key-here" }
    }
  }
}

1. Redémarre Claude Code pour charger la nouvelle configuration.

2. 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-search

Erreur : "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_TOKEN

Erreur : "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 supabase

C'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 :

1. Installe ton premier serveur MCP : Prends Brave Search pour un accès web immédiat
2. Explore les options populaires : Consulte notre guide des serveurs MCP populaires pour des recommandations sélectionnées
3. Configure l'automatisation du navigateur : Découvre l'automatisation du navigateur avec MCP pour les interactions web avancées
4. 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.