Guide Claude Code CLI MCP : connectez des données et services externes

Objectifs d'apprentissage

À la fin de ce tutoriel, vous serez capable de :

• Comprendre comment MCP (Model Context Protocol) fonctionne avec Claude Code
• Ajouter des serveurs MCP à Claude Code CLI avec la commande claude mcp add
• Vérifier l'état de connexion de vos serveurs MCP
• Utiliser les outils MCP dans les conversations Claude Code
• Gérer la portée des serveurs (locale, utilisateur, projet)

Temps nécessaire : 15–20 minutes

Difficulté : Débutant

Quelle version ce tutoriel couvre-t-il ? Ce tutoriel couvre Claude Code CLI — la version en ligne de commande de Claude Code. Les serveurs MCP se configurent via la commande claude mcp et les fichiers .mcp.json ou ~/.claude.json. Si vous préférez l'application de bureau, consultez le Guide Claude Desktop MCP.

Prérequis

Avant de commencer, assurez-vous d'avoir :

Qu'est-ce que MCP ?

MCP (Model Context Protocol, Protocole de Contexte de Modèle) est un standard ouvert qui permet aux assistants IA comme Claude Code de se connecter à des outils et sources de données externes. Au lieu que chaque outil construise sa propre intégration personnalisée, ils parlent tous le même protocole.

Un serveur MCP est un petit programme qui expose des outils, des données ou des services à l'assistant IA. Par exemple :

• Un serveur MCP GitHub permet à Claude Code de lire les Issues, créer des Pull Requests et parcourir les dépôts
• Un serveur MCP de base de données permet à Claude Code d'interroger votre base de données en langage naturel
• Un serveur MCP de suivi de tickets permet à Claude Code d'accéder directement à JIRA, Linear ou Notion

Claude Code prend en charge deux types de serveurs MCP :

• Serveurs HTTP (recommandé) : hébergés à une URL, aucun processus local nécessaire
• Serveurs stdio : exécutés comme un programme local sur votre machine

Comment fonctionne Claude Code MCP

Claude Code CLI dispose d'un support MCP intégré. Vous ajoutez des serveurs avec la commande claude mcp add, qui écrit la configuration du serveur dans un fichier. Il existe trois portées :

• Locale (par défaut) : privée à vous, active uniquement dans le répertoire du projet actuel
• Utilisateur : privée à vous, active dans tous vos projets
• Projet : partagée avec les coéquipiers via .mcp.json commité dans le dépôt

Une fois un serveur ajouté, ses outils sont disponibles pour Claude Code dans chaque session. Claude choisit automatiquement l'outil approprié en fonction de votre invite.

Étape 1 : Vérifiez votre configuration MCP

Tout d'abord, confirmez que votre version de Claude Code prend en charge MCP :

claude --version

Ce que vous devriez voir : Un numéro de version (v2.1.x ou ultérieur). Le support MCP est intégré dans toutes les versions récentes de Claude Code.

Vérifiez maintenant les serveurs que vous avez déjà :

claude mcp list

Ce que vous devriez voir : Une liste des serveurs MCP configurés, ou un message comme « Aucun serveur MCP configuré. »

Étape 2 : Trouvez un serveur MCP

Les serveurs MCP Claude Code sont disponibles à plusieurs endroits :

• Annuaire MCP sur Cataito : parcourez /mcp — plus de 55 serveurs MCP sélectionnés, prêts à connecter
• Annuaire Anthropic : claude.ai/directory — connecteurs examinés par Anthropic
• GitHub : recherchez mcp-server — des milliers de serveurs communautaires existent
• npm : de nombreux serveurs s'installent avec npx

Pour ce tutoriel, nous allons connecter le **serveur MCP GitHub** — l'un des plus populaires, qui permet à Claude Code de lire les dépôts, les Issues et les Pull Requests.

Étape 3 : Ajoutez un serveur MCP HTTP

Les serveurs HTTP sont la méthode recommandée pour se connecter à des serveurs MCP distants. Ils sont hébergés à une URL et ne nécessitent aucune configuration locale.

Ouvrez un terminal et enregistrez le serveur MCP GitHub :

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

Ce que vous devriez voir : Un message de confirmation comme Added HTTP MCP server github with URL: ... suivi d'une ligne File modified: indiquant le fichier de configuration.

Ajouter un serveur Stdio (alternative)

Si le serveur s'exécute comme une commande locale, utilisez le transport stdio :

claude mcp add my-db-server -- npx -y @modelcontextprotocol/server-postgres

Ce que vous devriez voir : La commande se termine sans erreur, et Claude Code écrit l'entrée du serveur dans le fichier de configuration.

Étape 4 : Vérifiez l'état de la connexion

Confirmez que le serveur est connecté :

claude mcp list

Ce que vous devriez voir : Le serveur apparaît avec un indicateur d'état :

Vous pouvez également inspecter un serveur spécifique :

claude mcp get github

Ce que vous devriez voir : Les détails du serveur, y compris le type de transport, l'URL et le statut.

Étape 5 : Utilisez les outils MCP dans une conversation

Maintenant, lancez une session Claude Code et utilisez les outils MCP :

claude

Puis saisissez une invite qui utilise le service connecté, par exemple :

Liste les Issues ouvertes dans le dépôt facebook/react

Ce que vous devriez voir : Claude Code appelle automatiquement les outils du serveur MCP GitHub. La première fois que Claude utilise un outil, il demande votre permission. Approuvez pour continuer. L'appel d'outil dans la sortie de Claude est étiqueté avec le nom du serveur, vous permettant de confirmer que la réponse provient du serveur MCP.

Vous pouvez également taper /mcp dans une session pour voir quels outils MCP sont disponibles.

Étape 6 : Changez la portée du serveur (Optionnel)

Par défaut, les serveurs sont ajoutés en portée locale (privée à vous, dans le projet actuel). Pour enregistrer un serveur pour tous vos projets :

claude mcp add --scope user github -- npx -y @modelcontextprotocol/server-github

Pour partager un serveur avec les coéquipiers via .mcp.json :

claude mcp add --scope project github -- npx -y @modelcontextprotocol/server-github

Étape 7 : Supprimez un serveur (Optionnel)

Si vous n'avez plus besoin d'un serveur, supprimez-le :

claude mcp remove github

Ce que vous devriez voir : Le serveur disparaît de claude mcp list.

Dépannage

FAQ

Ai-je besoin d'un abonnement payant pour utiliser MCP avec Claude Code ? Oui. Le support MCP nécessite un abonnement Claude payant (Pro, Max ou supérieur).

Puis-je utiliser les mêmes serveurs MCP dans CLI et Desktop ? Oui — vous pouvez importer les serveurs Desktop dans CLI avec claude mcp add-from-claude-desktop. Ils partagent le même format de configuration.

Quelle est la différence entre les portées locale, utilisateur et projet ? La portée locale enregistre le serveur dans le .mcp.json du projet ; la portée utilisateur enregistre dans ~/.claude.json ; la portée projet enregistre dans .mcp.json (partagé avec les coéquipiers).

Comment voir les serveurs MCP disponibles dans une session ? Tapez /mcp dans une session Claude Code.

Puis-je exposer Claude Code comme serveur MCP à d'autres outils ? Oui — exécutez claude mcp serve pour exposer les outils de Claude Code à d'autres clients MCP. C'est un cas d'utilisation avancé.

Prochaines étapes

• Parcourez l'annuaire MCP sur Cataito — plus de 55 serveurs MCP sélectionnés, prêts à connecter
• Apprenez plus de commandes Claude Code CLI dans le Guide Claude Code CLI pour débutants
• Utilisez le Guide Claude Desktop MCP si vous préférez une interface graphique