Le Protocole de Contexte de Modèle (MCP) est un protocole ouvert qui permet aux LLM d’accéder à des outils et sources de données externes. Pour plus de détails sur MCP, consultez la documentation MCP.

Utilisez les serveurs MCP tiers à vos propres risques. Assurez-vous de faire confiance aux serveurs MCP, et soyez particulièrement prudent lors de l’utilisation de serveurs MCP qui communiquent avec internet, car ceux-ci peuvent vous exposer à des risques d’injection de prompt.

​
Configurer les serveurs MCP

1

Ajouter un serveur MCP stdio

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

# Exemple : Ajouter un serveur local
claude mcp add my-server -e API_KEY=123 -- /path/to/server arg1 arg2
2

Ajouter un serveur MCP SSE

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

# Exemple : Ajouter un serveur SSE
claude mcp add --transport sse sse-server https://example.com/sse-endpoint

# Exemple : Ajouter un serveur SSE avec des en-têtes personnalisés
claude mcp add --transport sse api-server https://api.example.com/mcp -e X-API-Key=your-key
3

Ajouter un serveur MCP HTTP

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

# Exemple : Ajouter un serveur HTTP streamable
claude mcp add --transport http http-server https://example.com/mcp

# Exemple : Ajouter un serveur HTTP avec en-tête d'authentification
claude mcp add --transport http secure-server https://api.example.com/mcp -e Authorization="Bearer your-token"
4

Gérer vos serveurs MCP

# Lister tous les serveurs configurés
claude mcp list

# Obtenir les détails d'un serveur spécifique
claude mcp get my-server

# Supprimer un serveur
claude mcp remove my-server

Conseils :

  • Utilisez le flag -s ou --scope pour spécifier où la configuration est stockée :
    • local (par défaut) : Disponible uniquement pour vous dans le projet actuel (était appelé project dans les versions antérieures)
    • project : Partagé avec tous les membres du projet via le fichier .mcp.json
    • user : Disponible pour vous dans tous les projets (était appelé global dans les versions antérieures)
  • Définissez les variables d’environnement avec les flags -e ou --env (par exemple, -e KEY=value)
  • Configurez le délai d’attente de démarrage du serveur MCP en utilisant la variable d’environnement MCP_TIMEOUT (par exemple, MCP_TIMEOUT=10000 claude définit un délai d’attente de 10 secondes)
  • Vérifiez le statut du serveur MCP à tout moment en utilisant la commande /mcp dans Claude Code
  • MCP suit une architecture client-serveur où Claude Code (le client) peut se connecter à plusieurs serveurs spécialisés
  • Claude Code prend en charge les serveurs SSE (Server-Sent Events) et HTTP streamables pour la communication en temps réel
  • Utilisez /mcp pour vous authentifier avec des serveurs distants qui nécessitent une authentification OAuth 2.0

​
Comprendre les portées des serveurs 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.

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

Les configurations des serveurs 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 de portée locale, suivis par les serveurs de portée projet, et enfin les serveurs de portée utilisateur. Cette conception garantit que les configurations personnelles peuvent remplacer les configurations partagées lorsque nécessaire.

​
Portée locale

Les serveurs de 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 doivent pas être partagés.

# Ajouter un serveur de 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 -s local /path/to/server

​
Portée projet

Les serveurs de portée projet permettent la collaboration en équipe en stockant les configurations dans un fichier .mcp.json à la racine de votre projet. Ce fichier est conçu pour être ajouté au 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 de portée projet, Claude Code crée ou met à jour automatiquement ce fichier avec la structure de configuration appropriée.

# Ajouter un serveur de portée projet
claude mcp add shared-server -s 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 une approbation avant d’utiliser les serveurs de 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 de portée utilisateur offrent une accessibilité inter-projets, les rendant disponibles dans tous les projets de 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 -s user /path/to/server

​
Choisir la bonne portée

Sélectionnez votre portée en fonction de :

  • Portée locale : Serveurs personnels, configurations expérimentales, ou identifiants sensibles spécifiques à un projet
  • Portée projet : Serveurs partagés en é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

​
S’authentifier avec des serveurs MCP distants

De nombreux serveurs MCP distants nécessitent une authentification. Claude Code prend en charge le flux d’authentification OAuth 2.0 pour une connexion sécurisée à ces serveurs.

1

Ajouter un serveur distant nécessitant une authentification

# Ajouter un serveur SSE ou HTTP qui nécessite OAuth
claude mcp add --transport sse github-server https://api.github.com/mcp
2

S'authentifier en utilisant la commande /mcp

Dans Claude Code, utilisez la commande /mcp pour gérer l’authentification :

> /mcp

Cela ouvre un menu interactif où vous pouvez :

  • Voir le statut de connexion pour tous les serveurs
  • S’authentifier avec les serveurs nécessitant OAuth
  • Effacer l’authentification existante
  • Voir les capacités des serveurs
3

Compléter le flux OAuth

Lorsque vous sélectionnez “Authentifier” pour un serveur :

  1. Votre navigateur s’ouvre automatiquement vers le fournisseur OAuth
  2. Complétez l’authentification dans votre navigateur
  3. Claude Code reçoit et stocke de manière sécurisée le jeton d’accès
  4. La connexion au serveur devient active

Conseils :

  • Les jetons d’authentification sont stockés de manière sécurisée et actualisés automatiquement
  • Utilisez “Effacer l’authentification” dans le menu /mcp pour révoquer l’accès
  • Si votre navigateur ne s’ouvre pas automatiquement, copiez l’URL fournie
  • L’authentification OAuth fonctionne avec les transports SSE et HTTP

​
Se connecter à un serveur MCP Postgres

Supposons que vous voulez donner à Claude un accès en lecture seule à une base de données PostgreSQL pour les requêtes et l’inspection de schéma.

1

Ajouter le serveur MCP Postgres

claude mcp add postgres-server /path/to/postgres-mcp-server --connection-string "postgresql://user:pass@localhost:5432/mydb"
2

Interroger votre base de données avec Claude

> décris le schéma de notre table users

> quelles sont les commandes les plus récentes dans le système ?

> montre-moi la relation entre customers et invoices

Conseils :

  • Le serveur MCP Postgres fournit un accès en lecture seule pour la sécurité
  • Claude peut vous aider à explorer la structure de la base de données et exécuter des requêtes analytiques
  • Vous pouvez utiliser ceci pour comprendre rapidement les schémas de base de données dans des projets inconnus
  • Assurez-vous que votre chaîne de connexion utilise des identifiants appropriés avec les permissions minimales requises

​
Ajouter des serveurs MCP à partir d’une configuration JSON

Supposons que vous avez une configuration JSON pour un seul serveur MCP que vous voulez ajouter à Claude Code.

1

Ajouter un serveur MCP à partir de JSON

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

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

Vérifier que le serveur a été ajouté

claude mcp get weather-api

Conseils :

  • Assurez-vous que le JSON est correctement échappé dans votre shell
  • Le JSON doit se conformer au schéma de configuration du serveur MCP
  • Vous pouvez utiliser -s global pour ajouter le serveur à votre configuration globale au lieu de celle spécifique au projet

​
Importer des serveurs MCP depuis Claude Desktop

Supposons que vous avez déjà configuré des serveurs MCP dans Claude Desktop et que vous voulez utiliser les mêmes serveurs dans Claude Code sans les reconfigurer manuellement.

1

Importer des serveurs depuis Claude Desktop

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

Sélectionner quels serveurs importer

Après avoir exécuté la commande, vous verrez une boîte de dialogue interactive qui vous permet de sélectionner quels serveurs vous voulez importer.

3

Vérifier que les serveurs ont été importés

claude mcp list

Conseils :

  • Cette fonctionnalité ne fonctionne que sur macOS et Windows Subsystem for Linux (WSL)
  • Elle lit le fichier de configuration de Claude Desktop depuis son emplacement standard sur ces plateformes
  • Utilisez le flag -s global pour ajouter des serveurs à votre configuration globale
  • Les serveurs importés auront les mêmes noms que dans Claude Desktop
  • Si des serveurs avec les mêmes noms existent déjà, ils obtiendront un suffixe numérique (par exemple, server_1)

​
Utiliser Claude Code comme serveur MCP

Supposons que vous voulez utiliser Claude Code lui-même comme serveur MCP auquel d’autres applications peuvent se connecter, leur fournissant les outils et capacités de Claude.

1

Démarrer Claude comme serveur MCP

# Syntaxe de base
claude mcp serve
2

Se connecter depuis une autre application

Vous pouvez vous connecter au serveur MCP Claude Code depuis n’importe quel client MCP, tel que Claude Desktop. Si vous utilisez Claude Desktop, vous pouvez ajouter le serveur MCP Claude Code en utilisant cette configuration :

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

Conseils :

  • Le serveur fournit l’accès aux outils de Claude comme View, Edit, LS, etc.
  • Dans Claude Desktop, essayez de demander à Claude de lire des fichiers dans un répertoire, faire des modifications, et plus encore.
  • Notez que ce serveur MCP expose simplement les outils de Claude Code à votre client MCP, donc votre propre client est responsable de l’implémentation de la confirmation utilisateur pour les appels d’outils individuels.

​
Utiliser les ressources MCP

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

​
Référencer les ressources MCP

1

Lister les ressources disponibles

Tapez @ dans votre prompt pour voir les ressources disponibles de tous les serveurs MCP connectés. Les ressources apparaissent aux côtés des fichiers dans le menu d’autocomplétion.

2

Référencer une ressource spécifique

Utilisez le format @server:protocol://resource/path pour référencer une ressource :

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

> Veuillez examiner la documentation API à @docs:file://api/authentication
3

Références de ressources multiples

Vous pouvez référencer plusieurs ressources dans un seul prompt :

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

Conseils :

  • Les ressources sont automatiquement récupérées et incluses comme pièces jointes lorsqu’elles sont référencées
  • Les chemins de ressources sont recherchables de manière floue dans l’autocomplétion des mentions @
  • Claude Code fournit automatiquement des outils pour lister et lire les ressources MCP lorsque les serveurs les prennent en charge
  • Les ressources peuvent contenir tout type de contenu que le serveur MCP fournit (texte, JSON, données structurées, etc.)

​
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

1

Découvrir les prompts disponibles

Tapez / pour voir toutes les commandes disponibles, y compris celles des serveurs MCP. Les prompts MCP apparaissent avec le format /mcp__servername__promptname.

2

Exécuter un prompt sans arguments

> /mcp__github__list_prs
3

Exécuter un prompt avec des arguments

De nombreux prompts acceptent des arguments. Passez-les séparés par des espaces après la commande :

> /mcp__github__pr_review 456

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

Conseils :

  • Les prompts MCP sont découverts dynamiquement depuis les serveurs connectés
  • Les arguments sont analysés en fonction des paramètres définis du prompt
  • Les résultats des prompts sont injectés directement dans la conversation
  • Les noms de serveur et de prompt sont normalisés (les espaces deviennent des underscores)