Connecter Claude Code aux outils via MCP

Claude Code peut se connecter à des centaines d’outils externes et de sources de données via le Model Context Protocol (MCP), un standard open-source pour les intégrations d’outils IA. Les serveurs MCP donnent à Claude Code l’accès à vos outils, bases de données et API.

​

Ce que vous pouvez faire avec MCP

Avec les serveurs MCP connectés, vous pouvez demander à Claude Code de :

• Implémenter des fonctionnalités à partir de trackers de problèmes : “Ajouter la fonctionnalité décrite dans le problème JIRA ENG-4521 et créer une PR sur GitHub.”
• Analyser les données de surveillance : “Vérifier Sentry et Statsig pour vérifier l’utilisation de la fonctionnalité décrite dans ENG-4521.”
• Interroger les bases de données : “Trouver les emails de 10 utilisateurs aléatoires qui ont utilisé la fonctionnalité ENG-4521, basé sur notre base de données Postgres.”
• Intégrer les designs : “Mettre à jour notre modèle d’email standard basé sur les nouveaux designs Figma qui ont été postés dans Slack”
• Automatiser les flux de travail : “Créer des brouillons Gmail invitant ces 10 utilisateurs à une session de feedback sur la nouvelle fonctionnalité.”

​

Serveurs MCP populaires

Voici quelques serveurs MCP couramment utilisés que vous pouvez connecter à Claude Code :

​

Installation des serveurs MCP

Les serveurs MCP peuvent être configurés de trois manières différentes selon vos besoins :

​

Option 1 : Ajouter un serveur stdio local

Les serveurs stdio s’exécutent comme des processus locaux sur votre machine. Ils sont idéaux pour les outils qui nécessitent un accès direct au système ou des scripts personnalisés.

# Syntaxe de base
claude mcp add <nom> <commande> [args...]

# Exemple réel : Ajouter le serveur Airtable
claude mcp add airtable --env AIRTABLE_API_KEY=VOTRE_CLE \
  -- npx -y airtable-mcp-server

​

Option 2 : Ajouter un serveur SSE distant

Les serveurs SSE (Server-Sent Events) fournissent des connexions de streaming en temps réel. De nombreux services cloud utilisent cela pour les mises à jour en direct.

# Syntaxe de base
claude mcp add --transport sse <nom> <url>

# Exemple réel : Se connecter à Linear
claude mcp add --transport sse linear https://mcp.linear.app/sse

# Exemple avec en-tête d'authentification
claude mcp add --transport sse private-api https://api.company.com/mcp \
  --header "X-API-Key: votre-cle-ici"

​

Option 3 : Ajouter un serveur HTTP distant

Les serveurs HTTP utilisent des modèles de requête/réponse standard. La plupart des API REST et des services web utilisent ce transport.

# Syntaxe de base
claude mcp add --transport http <nom> <url>

# Exemple réel : Se connecter à Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Exemple avec token Bearer
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer votre-token"

​

Gérer vos serveurs

Une fois configurés, vous pouvez gérer vos serveurs MCP avec ces commandes :

# Lister tous les serveurs configurés
claude mcp list

# Obtenir les détails d'un serveur spécifique
claude mcp get github

# Supprimer un serveur
claude mcp remove github

# (dans Claude Code) Vérifier le statut du serveur
/mcp

# Ceci crée command="cmd" que Windows peut exécuter
claude mcp add my-server -- cmd /c npx -y @some/package

​

Portées d’installation MCP

Les serveurs MCP peuvent être configurés à trois niveaux de portée différents, chacun servant des objectifs distincts pour gérer l’accessibilité et le partage des serveurs. Comprendre ces portées vous aide à déterminer la meilleure façon de configurer les serveurs pour vos besoins spécifiques.

​

Portée locale

Les serveurs à portée locale représentent le niveau de configuration par défaut et sont stockés dans vos paramètres utilisateur spécifiques au projet. Ces serveurs restent privés pour vous et ne sont accessibles que lorsque vous travaillez dans le répertoire du projet actuel. Cette portée est idéale pour les serveurs de développement personnels, les configurations expérimentales, ou les serveurs contenant des identifiants sensibles qui ne devraient pas être partagés.

# Ajouter un serveur à portée locale (par défaut)
claude mcp add my-private-server /path/to/server

# Spécifier explicitement la portée locale
claude mcp add my-private-server --scope local /path/to/server

​

Portée projet

Les serveurs à portée projet permettent la collaboration d’équipe en stockant les configurations dans un fichier .mcp.json à la racine de votre projet. Ce fichier est conçu pour être enregistré dans le contrôle de version, garantissant que tous les membres de l’équipe ont accès aux mêmes outils et services MCP. Lorsque vous ajoutez un serveur à portée projet, Claude Code crée ou met à jour automatiquement ce fichier avec la structure de configuration appropriée.

# Ajouter un serveur à portée projet
claude mcp add shared-server --scope project /path/to/server

Le fichier .mcp.json résultant suit un format standardisé :

{
  "mcpServers": {
    "shared-server": {
      "command": "/path/to/server",
      "args": [],
      "env": {}
    }
  }
}

Pour des raisons de sécurité, Claude Code demande l’approbation avant d’utiliser les serveurs à portée projet des fichiers .mcp.json. Si vous devez réinitialiser ces choix d’approbation, utilisez la commande claude mcp reset-project-choices.

​

Portée utilisateur

Les serveurs à portée utilisateur fournissent une accessibilité inter-projets, les rendant disponibles dans tous les projets sur votre machine tout en restant privés à votre compte utilisateur. Cette portée fonctionne bien pour les serveurs utilitaires personnels, les outils de développement, ou les services que vous utilisez fréquemment dans différents projets.

# Ajouter un serveur utilisateur
claude mcp add my-user-server --scope user /path/to/server

​

Choisir la bonne portée

Sélectionnez votre portée basée sur :

• Portée locale : Serveurs personnels, configurations expérimentales, ou identifiants sensibles spécifiques à un projet
• Portée projet : Serveurs partagés par l’équipe, outils spécifiques au projet, ou services requis pour la collaboration
• Portée utilisateur : Utilitaires personnels nécessaires dans plusieurs projets, outils de développement, ou services fréquemment utilisés

​

Hiérarchie et précédence des portées

Les configurations de serveur MCP suivent une hiérarchie de précédence claire. Lorsque des serveurs avec le même nom existent à plusieurs portées, le système résout les conflits en priorisant d’abord les serveurs à portée locale, suivis des serveurs à portée projet, et enfin les serveurs à portée utilisateur. Cette conception garantit que les configurations personnelles peuvent remplacer les partagées quand nécessaire.

​

Expansion des variables d’environnement dans .mcp.json

Claude Code prend en charge l’expansion des variables d’environnement dans les fichiers .mcp.json, permettant aux équipes de partager des configurations tout en maintenant la flexibilité pour les chemins spécifiques à la machine et les valeurs sensibles comme les clés API.

Syntaxe prise en charge :

• ${VAR} - Se développe vers la valeur de la variable d’environnement VAR
• ${VAR:-default} - Se développe vers VAR si définie, sinon utilise default

Emplacements d’expansion : Les variables d’environnement peuvent être développées dans :

• command - Le chemin de l’exécutable du serveur
• args - Arguments de ligne de commande
• env - Variables d’environnement passées au serveur
• url - Pour les types de serveur SSE/HTTP
• headers - Pour l’authentification des serveurs SSE/HTTP

Exemple avec expansion de variable :

{
  "mcpServers": {
    "api-server": {
      "type": "sse",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "Authorization": "Bearer ${API_KEY}"
      }
    }
  }
}

Si une variable d’environnement requise n’est pas définie et n’a pas de valeur par défaut, Claude Code échouera à analyser la configuration.

​

Exemples pratiques

​

Exemple : Surveiller les erreurs avec Sentry

# 1. Ajouter le serveur MCP Sentry
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

# 2. Utiliser /mcp pour s'authentifier avec votre compte Sentry
> /mcp

# 3. Déboguer les problèmes de production
> "Quelles sont les erreurs les plus communes dans les dernières 24 heures ?"
> "Montrer moi la trace de pile pour l'erreur ID abc123"
> "Quel déploiement a introduit ces nouvelles erreurs ?"

​

S’authentifier avec les serveurs MCP distants

De nombreux serveurs MCP basés sur le cloud nécessitent une authentification. Claude Code prend en charge OAuth 2.0 pour les connexions sécurisées.

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

> /mcp

​

Ajouter des serveurs MCP à partir d’une configuration JSON

Si vous avez une configuration JSON pour un serveur MCP, vous pouvez l’ajouter directement :

# Syntaxe de base
claude mcp add-json <nom> '<json>'

# Exemple : Ajouter un serveur stdio avec configuration JSON
claude mcp add-json weather-api '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'

claude mcp get weather-api

​

Importer des serveurs MCP depuis Claude Desktop

Si vous avez déjà configuré des serveurs MCP dans Claude Desktop, vous pouvez les importer :

# Syntaxe de base 
claude mcp add-from-claude-desktop 

claude mcp list 

​

Utiliser Claude Code comme serveur MCP

Vous pouvez utiliser Claude Code lui-même comme serveur MCP auquel d’autres applications peuvent se connecter :

# Démarrer Claude comme serveur MCP stdio
claude mcp serve

Vous pouvez utiliser ceci dans Claude Desktop en ajoutant cette configuration à claude_desktop_config.json :

{
  "mcpServers": {
    "claude-code": {
      "command": "claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}

​

Utiliser les ressources MCP

Les serveurs MCP peuvent exposer des ressources que vous pouvez référencer en utilisant les mentions @, similaire à la façon dont vous référencez les fichiers.

​

Référencer les ressources MCP

> Pouvez-vous analyser @github:issue://123 et suggérer une correction ?

> Veuillez réviser la documentation API à @docs:file://api/authentication

> Comparer @postgres:schema://users avec @docs:file://database/user-model

​

Utiliser les prompts MCP comme commandes slash

Les serveurs MCP peuvent exposer des prompts qui deviennent disponibles comme commandes slash dans Claude Code.

​

Exécuter les prompts MCP

> /mcp__github__list_prs

> /mcp__github__pr_review 456

> /mcp__jira__create_issue "Bug dans le flux de connexion" high