Extensions avec des serveurs MCP

Claude Code contient un client MCP. On peut donc lui brancher des serveurs MCP, comme celui construit à la section 7, pour lui donner de nouveaux outils, ressources et prompts. Cette leçon montre comment, et comment composer un environnement de travail à partir de plusieurs serveurs.

Ce qu’un serveur ajoute

Un serveur MCP apporte à Claude Code ses trois primitives : des outils pour agir, des ressources pour lire des données, des prompts pour lancer des workflows prêts. Claude Code n’est plus limité à ses capacités intégrées : il travaille avec vos services.

Ajouter un serveur

Un serveur local, lancé par une commande, s’ajoute en transport stdio :

claude mcp add --transport stdio documents -- uv run main.py

Le double tiret -- sépare les options de Claude Code (--transport, --env, --scope) de la commande qui démarre le serveur : tout ce qui suit lui est passé tel quel. Le cours officiel écrit claude mcp add documents uv run main.py ; la documentation actuelle donne la forme avec --.

Un serveur distant s’ajoute par son URL, en transport HTTP :

claude mcp add --transport http <nom> <url>

La documentation prend l’exemple de Notion, avec l’adresse MCP que publie le service.

Une fois enregistré, le serveur se connecte au démarrage de Claude Code. claude mcp list affiche les serveurs et leur état, et la commande /mcp les gère depuis une session.

Trois portées

On choisit avec --scope, par exemple --scope project pour partager un serveur avec toute l’équipe. Un serveur de portée projet doit être approuvé par chaque personne la première fois qu’elle lance claude.

Un exemple : lire des documents Word et PDF

Le cours officiel ajoute un serveur qui expose un outil document_path_to_markdown. Une fois le serveur branché, il suffit de demander « Convertis le fichier tests/fixtures/mcp_docs.docx en Markdown » : Claude Code choisit l’outil de lui-même, lit le document et renvoie son contenu converti.

Composer son environnement

La force de MCP vient de la combinaison. Le cours officiel cite des serveurs pour Sentry (retrouver et corriger les erreurs de production), Playwright (piloter un navigateur pour tester), Figma (lire des maquettes), Confluence et Jira, Firecrawl (récupérer des pages web) et Slack (publier un message). On peut ainsi monter un environnement où Claude :

• récupère le détail d’une erreur de production dans Sentry ;
• lit les exigences du ticket dans Jira ;
• corrige le code, puis prévient l’équipe sur Slack ;
• et s’appuie sur vos propres serveurs pour vos outils internes.

Avant de brancher un serveur tiers, vérifiez d’où il vient : un serveur MCP exécute du code et lit des données en votre nom. Anthropic publie un répertoire de connecteurs relus, qui utilisent la même infrastructure MCP que Claude Code.

À vous de jouer

Brancher le serveur de la section 7. Ajoutez le serveur de documents construit aux leçons 52 à 59 avec claude mcp add --transport stdio, vérifiez son état avec claude mcp list, puis demandez à Claude Code de résumer un des documents. Repérez dans la session l’appel à l’outil du serveur.

Sources officielles : Enhancements with MCP servers (Claude Academy) · Connect Claude Code to tools via MCP (documentation Claude Code : ajout, transports, portées)

Points clés à retenir

• Claude Code contient un client MCP : un serveur lui apporte outils, ressources et prompts.
• Serveur local : claude mcp add --transport stdio <nom> -- <commande> ; serveur distant : --transport http <nom> <url>.
• Trois portées : locale par défaut, projet (.mcp.json, partagé par Git), utilisateur (tous vos projets).
• La combinaison de serveurs (erreurs, tickets, messagerie, outils internes) fait de Claude Code un assistant adapté à votre façon de travailler.
• Un serveur tiers exécute du code en votre nom : vérifiez sa provenance.