Connecter Claude Code aux outils via MCP
Apprenez à connecter Claude Code à vos outils avec le Model Context Protocol.
Claude Code peut se connecter à des centaines d’outils externes et de sources de données grâce au 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 des 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 ticket 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 des 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 des 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 :
Utilisez les serveurs MCP tiers à vos propres risques - Anthropic n’a pas vérifié la justesse ou la sécurité de tous ces serveurs. Assurez-vous de faire confiance aux serveurs MCP que vous installez. Soyez particulièrement prudent lors de l’utilisation de serveurs MCP qui pourraient récupérer du contenu non fiable, car ceux-ci peuvent vous exposer à un risque d’injection de prompt.
Development & Testing Tools
Monitor errors, debug production issues
Command
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
Security analysis for dependencies
Command
claude mcp add --transport http socket https://mcp.socket.dev/
Provides access to Hugging Face Hub information and Gradio AI Applications
Command
claude mcp add --transport http hugging-face https://huggingface.co/mcp
Debug faster with AI agents that can access Jam recordings like video, console logs, network requests, and errors
Command
claude mcp add --transport http jam https://mcp.jam.dev/mcp
Project Management & Documentation
Interact with your Asana workspace to keep projects on track
Command
claude mcp add --transport sse asana https://mcp.asana.com/sse
Manage your Jira tickets and Confluence docs
Command
claude mcp add --transport sse atlassian https://mcp.atlassian.com/v1/sse
Task management, project tracking
Command
claude mcp add clickup --env CLICKUP_API_KEY=YOUR_KEY --env CLICKUP_TEAM_ID=YOUR_ID -- npx -y @hauptsache.net/clickup-mcp
Access real-time customer conversations, tickets, and user data
Command
claude mcp add --transport http intercom https://mcp.intercom.com/mcp
Integrate with Linear's issue tracking and project management
Command
claude mcp add --transport sse linear https://mcp.linear.app/sse
Read docs, update pages, manage tasks
Command
claude mcp add --transport http notion https://mcp.notion.com/mcp
Ask questions about your enterprise content, get insights from unstructured data, automate content workflows
Command
claude mcp add --transport http box https://mcp.box.com/
Extract valuable insights from meeting transcripts and summaries
Command
claude mcp add --transport http fireflies https://api.fireflies.ai/mcp
Manage monday.com boards by creating items, updating columns, assigning owners, setting timelines, adding CRM activities, and writing summaries
Command
claude mcp add --transport sse monday https://mcp.monday.com/sse
Databases & Data Management
Read/write records, manage bases and tables
Command
claude mcp add airtable --env AIRTABLE_API_KEY=YOUR_KEY -- npx -y airtable-mcp-server
Supplies high quality fundamental financial data sourced from SEC Filings, investor presentations
Command
claude mcp add --transport http daloopa https://mcp.daloopa.com/server/mcp
Access and manage HubSpot CRM data by fetching contacts, companies, and deals, and creating and updating records
Command
claude mcp add --transport http hubspot https://mcp.hubspot.com/anthropic
Payments & Commerce
Integrate PayPal commerce capabilities, payment processing, transaction management
Command
claude mcp add --transport http paypal https://mcp.paypal.com/mcp
Analyze, troubleshoot, and optimize Plaid integrations. Banking data, financial account linking
Command
claude mcp add --transport sse plaid https://api.dashboard.plaid.com/mcp/sse
Use an agent to build on Square APIs. Payments, inventory, orders, and more
Command
claude mcp add --transport sse square https://mcp.squareup.com/sse
Payment processing, subscription management, and financial transactions
Command
claude mcp add --transport http stripe https://mcp.stripe.com
Design & Media
Access designs, export assetsRequires latest Figma Desktop with Dev Mode MCP Server. If you have an existing server at http://127.0.0.1:3845/sse, delete it first before adding the new one.
Command
claude mcp add --transport http figma-dev-mode-mcp-server http://127.0.0.1:3845/mcp
Build video creation capabilities into your applications
Command
claude mcp add --transport sse invideo https://mcp.invideo.io/sse
Browse, summarize, autofill, and even generate new Canva designs directly from Claude
Command
claude mcp add --transport http canva https://mcp.canva.com/mcp
Infrastructure & DevOps
Build applications, analyze traffic, monitor performance, and manage security settings through CloudflareMultiple services available. See documentation for specific server URLs. Claude Code can use the Cloudflare CLI if installed.
Create, deploy, and manage websites on Netlify. Control all aspects of your site from creating secrets to enforcing access controls to aggregating form submissions
Command
claude mcp add --transport http netlify https://netlify-mcp.netlify.app/mcp
Configure and manage Stytch authentication services, redirect URLs, email templates, and workspace settings
Command
claude mcp add --transport http stytch http://mcp.stytch.dev/mcp
Vercel's official MCP server, allowing you to search and navigate documentation, manage projects and deployments, and analyze deployment logs—all in one place
Command
claude mcp add --transport http vercel https://mcp.vercel.com/
Automation & Integration
Besoin d’une intégration spécifique ? Trouvez des centaines d’autres serveurs MCP sur GitHub, ou construisez le vôtre en utilisant le SDK MCP.
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 ont besoin d’un accès direct au système ou des scripts personnalisés.
Comprendre le paramètre ”—” :
Le --
(double tiret) sépare les propres drapeaux CLI de Claude de la commande et des arguments qui sont passés au serveur MCP. Tout ce qui précède --
sont des options pour Claude (comme --env
, --scope
), et tout ce qui suit --
est la commande réelle pour exécuter le serveur MCP.
Par exemple :
claude mcp add myserver -- npx server
→ exécutenpx server
claude mcp add myserver --env KEY=value -- python server.py --port 8080
→ exécutepython server.py --port 8080
avecKEY=value
dans l’environnement
Cela évite les conflits entre les drapeaux de Claude et les drapeaux du serveur.
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.
Option 3 : Ajouter un serveur HTTP distant
Les serveurs HTTP utilisent des modèles standard de requête/réponse. La plupart des API REST et des services web utilisent ce transport.
Gestion de vos serveurs
Une fois configurés, vous pouvez gérer vos serveurs MCP avec ces commandes :
Conseils :
- Utilisez le drapeau
--scope
pour spécifier où la configuration est stockée :local
(par défaut) : Disponible seulement pour vous dans le projet actuel (était appeléproject
dans les versions antérieures)project
: Partagé avec tout le monde dans le 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 drapeaux
--env
(par ex.,--env KEY=value
) - Configurez le timeout de démarrage du serveur MCP en utilisant la variable d’environnement MCP_TIMEOUT (par ex.,
MCP_TIMEOUT=10000 claude
définit un timeout de 10 secondes) - Utilisez
/mcp
pour vous authentifier avec les serveurs distants qui nécessitent une authentification OAuth 2.0
Utilisateurs Windows : Sur Windows natif (pas WSL), les serveurs MCP locaux qui utilisent npx
nécessitent le wrapper cmd /c
pour assurer une exécution correcte.
Sans le wrapper cmd /c
, vous rencontrerez des erreurs “Connection closed” car Windows ne peut pas exécuter directement npx
. (Voir la note ci-dessus pour une explication du paramètre --
.)
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.
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.
Le fichier .mcp.json
résultant suit un format standardisé :
Pour des raisons de sécurité, Claude Code demande une 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.
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 de portée et précédence
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 des 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 en la valeur de la variable d’environnementVAR
${VAR:-default}
- Se développe enVAR
si définie, sinon utilisedefault
Emplacements d’expansion : Les variables d’environnement peuvent être développées dans :
command
- Le chemin de l’exécutable du serveurargs
- Arguments de ligne de commandeenv
- Variables d’environnement passées au serveururl
- Pour les types de serveur SSE/HTTPheaders
- Pour l’authentification des serveurs SSE/HTTP
Exemple avec expansion de variable :
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
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 des connexions sécurisées.
Ajouter le serveur qui nécessite une authentification
Par exemple :
Utiliser la commande /mcp dans Claude Code
Dans Claude code, utilisez la commande :
Puis suivez les étapes dans votre navigateur pour vous connecter.
Conseils :
- Les tokens d’authentification sont stockés de manière sécurisée et rafraîchis automatiquement
- Utilisez “Clear authentication” 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
Ajouter des serveurs MCP à partir d’une configuration JSON
Si vous avez une configuration JSON pour un serveur MCP, vous pouvez l’ajouter directement :
Ajouter un serveur MCP à partir de JSON
Vérifier que le serveur a été ajouté
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
--scope user
pour ajouter le serveur à votre configuration utilisateur au lieu de celle spécifique au projet
Importer des serveurs MCP depuis Claude Desktop
Si vous avez déjà configuré des serveurs MCP dans Claude Desktop, vous pouvez les importer :
Importer des serveurs depuis Claude Desktop
Sélectionner quels serveurs importer
Après avoir exécuté la commande, vous verrez un dialogue interactif qui vous permet de sélectionner quels serveurs vous voulez importer.
Vérifier que les serveurs ont été importés
Conseils :
- Cette fonctionnalité ne fonctionne que sur macOS et Windows Subsystem for Linux (WSL)
- Elle lit le fichier de configuration Claude Desktop depuis son emplacement standard sur ces plateformes
- Utilisez le drapeau
--scope user
pour ajouter des serveurs à votre configuration utilisateur - 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 ex.,
server_1
)
Utiliser Claude Code comme serveur MCP
Vous pouvez utiliser Claude Code lui-même comme serveur MCP auquel d’autres applications peuvent se connecter :
Vous pouvez utiliser cela dans Claude Desktop en ajoutant cette configuration à claude_desktop_config.json :
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.
- Notez que ce serveur MCP expose simplement les outils de Claude Code à votre client MCP, donc votre propre client est responsable d’implémenter 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 @, similaire à la façon dont vous référencez les fichiers.
Référencer les ressources MCP
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.
Référencer une ressource spécifique
Utilisez le format @server:protocol://resource/path
pour référencer une ressource :
Références de ressources multiples
Vous pouvez référencer plusieurs ressources dans un seul prompt :
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
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
.
Exécuter un prompt sans arguments
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 :
Conseils :
- Les prompts MCP sont découverts dynamiquement depuis les serveurs connectés
- Les arguments sont analysés basés sur les 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)