Claude Code et les MCP Servers : comment connecter vos outils métier à l’IA
Publié le : Avril 2026 — Lecture : ~14 minutes — Niveau : Intermédiaire
Imaginez demander à votre IA de coder une fonctionnalité depuis un ticket Jira, vérifier les erreurs Sentry, créer la pull request GitHub et envoyer un message Slack à votre équipe — le tout en une seule instruction. C’est exactement ce que permettent les MCP Servers connectés à Claude Code.
🔗 1. Qu’est-ce que le Model Context Protocol (MCP) ?
Le Model Context Protocol est un standard open source développé par Anthropic pour permettre aux agents IA de communiquer avec des outils et services externes de façon standardisée.
Pensez-y comme à un protocole USB pour l’IA : de la même façon qu’un port USB permet de connecter n’importe quel périphérique à n’importe quel ordinateur, MCP permet de connecter n’importe quel service à n’importe quel agent IA compatible.
Aujourd’hui, MCP est adopté bien au-delà de Claude. OpenAI l’a intégré à ChatGPT en mars 2025, Google l’a confirmé pour Gemini en avril 2025, et des outils comme Zed, Replit, Cursor ou Sourcegraph ont tous des implémentations MCP. C’est devenu le standard de facto de l’écosystème.
Comment ça marche concrètement ?
❌ Sans MCP
Claude Code répond à vos questions et modifie vos fichiers locaux. Périmètre limité à votre machine.
✅ Avec MCP
Claude Code peut lire des tickets, interroger votre BDD, créer des PRs, envoyer des messages Slack, naviguer sur le web…
MCP crée une couche middleware entre Claude et vos systèmes. D’un côté : Claude Code. De l’autre : votre infrastructure réelle. Le serveur MCP sert d’adaptateur entre les deux.
⚙️ 2. Comment MCP fonctionne avec Claude Code
Claude Code joue un double rôle dans l’écosystème MCP :
- En tant que client MCP (usage principal) : Claude Code se connecte à des serveurs MCP externes pour accéder à des outils, des bases de données, des APIs.
- En tant que serveur MCP : via
claude mcp serve, Claude Code peut exposer ses propres outils à d’autres agents IA — c’est l’orchestration d’agents.
La permission avant l’action
Claude Code affiche une invite de permission avant d’appeler n’importe quel outil MCP : nom de l’outil et paramètres d’entrée affichés avant chaque exécution. Vous pouvez pré-approuver des outils spécifiques en mode automatique via --allowedTools avec le format mcp__<nom-serveur>__<nom-outil>.
📶 3. Les 3 types de transport MCP
Le transport définit comment Claude Code communique avec un serveur MCP.
Local — par défaut
Le serveur MCP tourne comme un processus local. Communication via l’entrée/sortie standard. Pas d’exposition réseau — sécurité maximale. Idéal pour les outils nécessitant un accès au système de fichiers.
Exemples : filesystem, PostgreSQL local, outils CLI
Recommandé pour les services cloud
Le serveur MCP est hébergé à distance et accessible via une URL HTTP. Transport recommandé par Anthropic pour les nouvelles intégrations distantes.
Exemples : GitHub, Slack, Jira, services SaaS
Déprécié — à éviter
Server-Sent Events — l’ancienne méthode pour les connexions distantes. Remplacée par HTTP. Évitez-la pour les nouvelles configurations.
🌐 4. Les scopes de configuration
MCP offre trois niveaux de portée pour vos configurations :
| Scope | Fichier | Usage |
|---|---|---|
| local (défaut) | ~/.claude.json | Vous seul, projet en cours |
| project | .mcp.json (racine) | Toute l’équipe du projet |
| user | ~/.claude.json | Vous seul, tous vos projets |
project pour les intégrations liées au projet (GitHub, Jira, BDD) et user pour vos outils personnels. Les tokens sensibles restent toujours en local pour ne pas être committés.
claude mcp add --scope user github -- npx -y @modelcontextprotocol/server-github
# Ajouter pour l'équipe du projet courant
claude mcp add --scope project postgres -- npx -y @modelcontextprotocol/server-postgres
▶️ 5. Ajouter votre premier serveur MCP
Méthode 1 : Via la CLI (rapide)
claude mcp add <nom> -- npx -y <package>
# Avec une variable d'environnement
claude mcp add github -e GITHUB_TOKEN=votre_token -- npx -y @modelcontextprotocol/server-github
# Via HTTP
claude mcp add --transport http mon-api https://api.monservice.com/mcp
Méthode 2 : Éditer le fichier .mcp.json directement (config complexes)
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
}
},
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres"],
"env": {
"POSTGRES_CONNECTION_STRING": "${DATABASE_URL}"
}
}
}
}
${MA_VARIABLE}) plutôt que des valeurs en dur. Claude Code les résout automatiquement au démarrage. Ajoutez .mcp.json à votre .gitignore si votre fichier contient des données sensibles.
Vérifier et gérer vos serveurs
/mcp
# Lister les serveurs configurés
claude mcp list
# Détails d'un serveur
claude mcp get github
# Supprimer un serveur
claude mcp remove github
🔧 6. Les MCP Servers incontournables par catégorie
🐈 Gestion de code — GitHub (officiel)
Le premier serveur à installer. Gestion des dépôts, pull requests, issues, workflows CI/CD.
Ce que vous pouvez demander
- › « Crée une PR pour les changements de cette session avec un titre et une description »
- › « Consulte l’issue #142 et implémente la fonctionnalité décrite »
- › « Liste les PRs ouvertes en attente de review sur le repo principal »
📈 Bases de données — PostgreSQL & Supabase
claude mcp add postgres -e POSTGRES_CONNECTION_STRING=postgresql://user:pass@localhost/mydb -- npx -y @modelcontextprotocol/server-postgres
# Supabase
claude mcp add supabase -- npx -y @supabase/mcp-server-supabase@latest
Ce que vous pouvez demander
- › « Trouve les 10 utilisateurs avec le plus de commandes ce mois-ci »
- › « Génère une requête optimisée pour ce rapport et propose les index manquants »
- › « Analyse les tables et génère les types TypeScript correspondants »
🧪 Tests — Playwright (Microsoft)
Automatisation de navigateur en langage naturel. Idéal pour les tests end-to-end.
claude mcp add playwright -- npx -y @playwright/mcp
@modelcontextprotocol/server-playwright est déprécié. Utilisez toujours @playwright/mcp de Microsoft.
🚨 Monitoring — Sentry
📋 Gestion de projet — Jira & Linear
claude mcp add jira -e JIRA_URL=https://votreentreprise.atlassian.net -e JIRA_TOKEN=votre_token -- npx -y @atlassian/jira-mcp
# Linear
claude mcp add linear -e LINEAR_API_KEY=votre_cle -- npx -y @linear/mcp-server
📖 Documentation — Context7
Fournit une documentation à jour et spécifique à la version des librairies que vous utilisez. Évite les hallucinations sur les APIs deprecated.
Ce que vous pouvez demander
- › « Montre-moi la documentation de useQuery dans React Query v5 »
- › « Quels sont les breaking changes de Next.js 15 ? »
🌞 Communication & Design
claude mcp add slack -e SLACK_BOT_TOKEN=xoxb-votre-token -- npx -y @modelcontextprotocol/server-slack
# Figma (maquettes vers code)
claude mcp add figma -e FIGMA_TOKEN=votre_token -- npx -y figma-mcp
📜 7. Configuration avancée avec .mcp.json
Configuration d’équipe complète
Voici un .mcp.json typique pour une équipe de développement web :
"mcpServers": {
"github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}" } },
"postgres": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-postgres"], "env": { "POSTGRES_CONNECTION_STRING": "${DATABASE_URL}" } },
"playwright": { "command": "npx", "args": ["-y", "@playwright/mcp", "--headless"] },
"sentry": { "command": "npx", "args": ["-y", "@sentry/mcp-server"], "env": { "SENTRY_AUTH_TOKEN": "${SENTRY_TOKEN}", "SENTRY_ORG": "votre-org" } },
"slack": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-slack"], "env": { "SLACK_BOT_TOKEN": "${SLACK_BOT_TOKEN}", "SLACK_TEAM_ID": "T0XXXXXXX" } }
}
}
Chaque développeur crée ses propres variables d’environnement dans son shell (.zshrc, .bashrc) ou un fichier .env.local non committé. Les noms des serveurs restent cohérents pour toute l’équipe, les credentials restent privés.
Configuration pour CI/CD
Timeout de démarrage
Si un serveur MCP met du temps à démarrer (BDD distante, VPN requis) :
MCP_TIMEOUT=30000 claude
🚀 8. Workflows concrets : exemples réels
🏗️ Workflow 1 — Du ticket à la PR en autonomie
Nécessite : GitHub + Jira + Sentry
« Prends le ticket JIRA ENG-4521, implémente la fonctionnalité décrite, vérifie dans Sentry s’il y a des erreurs liées à ce module, corrige-les si nécessaire, puis crée une PR avec un descriptif complet. »
🔍 Workflow 2 — Revue de code enrichie
Nécessite : GitHub + Sentry
« Analyse les changements de cette PR, consulte Sentry pour voir si les fonctions modifiées ont des erreurs en production, et génère un rapport de revue de code avec les points d’attention. »
🚨 Workflow 3 — Debug de production assisté
Nécessite : Sentry + Playwright + fichiers locaux
« Une erreur 500 remonte sur /api/orders/checkout depuis 30 minutes. Consulte Sentry pour les détails, analyse les fichiers concernés, propose un correctif et teste-le avec Playwright sur staging. »
🌞 Workflow 4 — Design vers code
Nécessite : Figma
« Les designers viennent de mettre à jour le composant Button dans Figma. Analyse les changements par rapport à notre implémentation actuelle et mets à jour le composant en conséquence. »
📊 Workflow 5 — Rapport automatique de fin de sprint
Nécessite : GitHub + Jira + Sentry + Slack
« Génère le rapport de sprint : liste les commits de la semaine depuis GitHub, les tickets Jira fermés, les erreurs Sentry résolues, et envoie un résumé formaté dans le canal #dev-updates sur Slack. »
🔒 9. Sécurité et bonnes pratiques
Ne commitez jamais vos tokens dans .mcp.json
❌ Ne jamais faire
✅ Correct
Règles d’or
- Tokens à portée minimale : créez des tokens avec les permissions strictement nécessaires.
- Vérifiez les serveurs tiers : Anthropic n’a pas vérifié tous les serveurs disponibles. Consultez le code source, les issues ouvertes et la réactivité des mainteneurs.
- Attention à l’injection de prompt : les serveurs qui récupèrent du contenu web peuvent exposer à ce risque.
- Tokens à durée limitée en prod : préférez AWS SSO ou IAM roles aux clés permanentes.
- Enterprise : déployez un
managed-mcp.jsondans les répertoires système pour un contrôle centralisé des serveurs autorisés.
🛠️ 10. Créer son propre MCP Server
Vous ne trouvez pas de serveur MCP pour votre outil interne ? Créez-en un avec le MCP SDK officiel.
Structure de base en TypeScript
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
const server = new Server(
{ name: "mon-outil-interne", version: "1.0.0" },
{ capabilities: { tools: {} } }
);
// Déclarer un outil
server.setRequestHandler("tools/list", async () => ({
tools: [{ name: "get_tickets", description: "Récupère les tickets depuis notre système interne", … }]
}));
// Implémenter l'outil
server.setRequestHandler("tools/call", async (request) => {
const tickets = await fetchFromInternalAPI(request.params.arguments);
return { content: [{ type: "text", text: JSON.stringify(tickets) }] };
});
await server.connect(new StdioServerTransport());
claude mcp add mon-outil -- node /chemin/vers/mon-serveur/build/index.js
🔧 11. Dépannage et erreurs fréquentes
« Connection closed » sur Windows ▼
Sur Windows natif (hors WSL), les serveurs MCP locaux avec npx nécessitent le wrapper cmd /c :
« needs-auth » dans /mcp ▼
/mcp dans le prompt interactif, puis suivez le flux OAuth pour autoriser le serveur.
Variable d’environnement non résolue ▼
Claude Code résout les variables au démarrage. Vérifiez avant de lancer claude :
source ~/.zshrc # Si vide, rechargez votre shell
Un outil MCP ne s’affiche plus ▼
❓ 12. FAQ
Combien de serveurs MCP peut-on connecter simultanément ? ▼
Les serveurs MCP ont-ils accès à toute ma machine ? ▼
Est-ce que mes données passent par les serveurs Anthropic ? ▼
Peut-on utiliser MCP en mode non-interactif (CI/CD) ? ▼
Oui. Utilisez --allowedTools pour pré-approuver les outils et éviter les invites de permission :
Quelle est la différence entre MCP stdio et HTTP ? ▼
stdio fait tourner le serveur MCP comme un processus local — idéal pour les outils qui ont besoin d’accéder à votre système de fichiers. HTTP se connecte à un serveur distant — recommandé pour les services cloud. SSE est déprécié.
Les serveurs MCP fonctionnent-ils avec Claude Desktop ? ▼
~/Library/Application Support/Claude/claude_desktop_config.json sur macOS, %APPDATA%\Claude\claude_desktop_config.json sur Windows, avec une interface graphique de gestion intégrée.
🔗
Par où commencer ?
Installez d’abord le serveur GitHub et le serveur correspondant à votre base de données. Ce sont les deux intégrations qui offrent le meilleur retour sur investissement pour la majorité des équipes.
← Lire le guide complet Claude CodeMots-clés : MCP Server Claude Code, Model Context Protocol, installer MCP Claude, MCP GitHub Claude, MCP PostgreSQL, MCP Playwright, Claude Code Jira, Claude Code Slack, Claude Code Figma, automatisation développement IA 2026.