Bienvenue dans le cours

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.

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.

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 conclusion — Prompts côté serveur et client, récapitulatif

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.

Commençons !