Bienvenue dans le cours

Revu le 5 novembre 2026. Ce cours est écrit pour la version 2 du SDK Python mcp (2.3.0, publiée le 2 octobre 2026) et pour la version courante du protocole, la 2026-07-28. Tous les extraits de code ont été exécutés tels quels sur cette version du SDK, et les captures de l’Inspector MCP (2.13.0) sont réelles. Si vous reprenez un projet écrit pour la branche 1.x (FastMCP, champs en camelCase, URI AnyUrl), la leçon 14 détaille ce qui change et dans quel ordre migrer. Le cours officiel de Claude Academy, lui, reste écrit pour la version 1 : les concepts sont identiques, seuls quelques noms diffèrent.

Bienvenue dans ce cours consacré au Model Context Protocol (MCP), le standard ouvert qui permet à Claude et aux autres modèles de langage de se connecter à des outils et à des sources de données externes. Vous n’allez pas vous contenter de lire une spécification : vous allez écrire du code, lancer un serveur, le brancher sur un client, et voir Claude appeler vos fonctions. À la fin de cette première leçon, vous saurez ce que le cours construit, ce qu’il attend de vous, et comment il est organisé.

Ce que vous allez apprendre

Le cours commence par la question de fond : qu’est-ce que le MCP, et quel problème résout-il réellement ? Tant que ce point n’est pas clair, le reste ressemble à de la plomberie gratuite. Vous verrez donc d’abord pourquoi un développeur qui veut brancher Claude sur un service comme GitHub se retrouve à écrire des centaines de définitions d’outils, et comment le protocole déplace ce travail ailleurs.

Vous construirez ensuite un serveur MCP, c’est-à-dire le composant qui expose des capacités : des outils que Claude peut appeler, des ressources que votre application peut lire, et des prompts que vos utilisateurs peuvent déclencher. Vous construirez aussi le client MCP, le composant symétrique qui consomme ces capacités depuis votre code. Dans un vrai projet, vous n’écrirez généralement que l’un des deux — mais les écrire tous les deux ici est le meilleur moyen de comprendre ce qui circule entre eux.

Enfin, vous apprendrez à tester votre serveur avec l’inspecteur intégré, un outil en navigateur qui vous évite d’assembler toute une application pour vérifier qu’un outil renvoie bien ce que vous attendez. C’est la boucle de retour la plus courte du développement MCP, et vous l’utiliserez à chaque étape.

Prérequis

Ce cours suppose des connaissances de base en Python : définir une fonction, manipuler un dictionnaire, lire un décorateur sans être surpris. Une familiarité avec les APIs et les appels de fonctions aide également, car le vocabulaire du protocole (requête, réponse, schéma d’arguments) reprend ces mêmes idées. Côté machine, il vous faut Python 3.10 ou supérieur installé.

Outils nécessaires

Le cours utilise uv, un gestionnaire de paquets Python moderne, pour créer le projet et installer les dépendances. Si vous ne l’avez pas encore, le guide d’installation se trouve sur docs.astral.sh/uv. Une seule commande suffira ensuite pour préparer l’environnement complet, ce qui vous évitera de perdre du temps sur la configuration avant d’arriver au code intéressant.

L’inspecteur, lui, est un outil Node : la commande mcp dev du SDK lance npx @modelcontextprotocol/inspector, qui exige Node 22.19 ou supérieur. Pour approfondir les bases du protocole en parallèle du cours, la documentation officielle est disponible sur modelcontextprotocol.io. Elle est utile en complément, mais vous n’avez pas besoin de l’avoir lue pour suivre les leçons.

Structure du cours

Le parcours est organisé en quatre parties, dans un ordre volontairement progressif : chaque partie s’appuie sur le code écrit dans la précédente.

1. Comprendre le MCP : l’architecture, les clients, le protocole
2. Construire un serveur MCP : configuration, outils, inspecteur
3. Construire un client MCP : implémentation, ressources, accès
4. Prompts et révision : prompts côté serveur et client, évaluation, récapitulatif
5. Mise à jour 2026 : la spécification 2026-07-28 et le SDK v2, pour migrer un projet existant

Concrètement, le fil rouge est une petite application en ligne de commande qui donne à Claude accès à un système de gestion de documents : lire un document, le modifier, le lister, le reformater. Le sujet est volontairement modeste, parce que l’objectif n’est pas de vous apprendre la gestion documentaire mais de vous faire manipuler les trois primitives du protocole sur un cas que vous pouvez tenir entièrement en tête.

À vous de jouer

1. Vérifiez vos versions : python3 --version (3.10 ou plus), uv --version, node --version (22.19 ou plus pour l’inspecteur).
2. Si vous avez déjà un serveur MCP sous les yeux (Claude Desktop, Claude Code ou un dépôt GitHub), repérez-y trois choses : le nom du serveur, un outil, et le transport utilisé (stdio ou HTTP). Vous saurez les lire à la fin de la première partie.
3. Notez un service que vous aimeriez brancher sur Claude : vous le garderez en tête comme cas d’application tout au long du cours.

Sources officielles : Introduction to Model Context Protocol (Claude Academy) · Qu’est-ce que MCP ? · Versioning de la spécification · What’s new in v2 (SDK Python) · MCP Inspector

Points clés à retenir

• MCP est le standard ouvert qui relie Claude à des outils et des données externes ; vous construirez un serveur, un client et les testerez avec l’inspecteur.
• Prérequis : Python 3.10 ou plus, uv, Node 22.19 ou plus pour l’inspecteur, un peu de Python et la notion d’API.
• Le cours est écrit pour le SDK Python v2 et la spécification 2026-07-28 ; le cours officiel reste en v1, les concepts sont les mêmes.
• Fil rouge : une petite application en ligne de commande qui gère des documents, pour manipuler les trois primitives sur un cas simple.

Commençons !