La place de MCP
- Leçon 1
- 50 min
- Module 1 : Comprendre le problème d'intégration
Où nous en sommes
Vous connaissez déjà l'appel d'outils du cours Créer des applications fiables avec les API de LLM : le modèle propose un appel, et votre application le vérifie et l'exécute. Mais cet outil vit dans une seule application. Maintenant, trois applications d'IA ont besoin des connaissances de soutien de Larkfield, et chacune aurait besoin de sa propre connexion. Dans cette leçon, nous comparons trois façons de se connecter. Nous commençons par un tiroir plein de vieux chargeurs de téléphone.
Leçon 1 sur 22 · MCP : connecter les applications d'IA aux outils et aux donnéesLa place de MCP
1. Comprendre le problème d'intégration
2. Concevoir des capacités de serveur utiles
3. Créer et examiner un serveur local
4. Connecter une application d'IA
5. Accès à distance et autorisation
6. Protéger les outils et le contrôle de l'utilisateur
7. Exploiter et maintenir l'intégration
Ce que vous saurez faire
Trois applications d’IA ont besoin des connaissances de soutien de Larkfield. Comparez trois façons d’y connecter une application, préparez le projet du cours et déterminez quand chaque façon suffit.
Avant de commencerCe qu’il faut savoir et avoir sous la main
Ce que vous devez savoir
- Appels d’outils : le modèle propose un appel, puis l’application le vérifie et l’exécute. Vous l’avez fait dans Décrire un outil et Exécuter dans le code de l’application, du cours Créer des applications fiables avec les API de LLM.
- Ce qu’est une API et une requête à une API, grâce au cours Créer et déployer votre première API.
- L’utilisation d’un terminal, de
cdet d’un environnement virtuel Python.
Ce qu’il vous faut sur votre ordinateur
- Python 3.12 ou une version ultérieure. Le cours est testé avec Python 3.12 sur macOS.
- Environ 100 Mo d’espace disque libre. Git est utile, mais le téléchargement d’un fichier ZIP fonctionne aussi.
- Aucun compte, aucune clé et aucun paiement. Tout ce cours s’exécute sur votre ordinateur.
Un câble pour tous les appareils
Section intitulée « Un câble pour tous les appareils »Pensez au tiroir de vieux chargeurs de téléphone qu’on trouve dans bien des maisons. Chaque marque de téléphone avait sa propre fiche. Un nouveau téléphone exigeait un nouveau câble. Souvent, aucun câble de la maison ne convenait au téléphone d’un visiteur.
Puis, la plupart des appareils ont adopté un port standard commun. Maintenant, un seul câble recharge le téléphone, les écouteurs et l’ordinateur portable. Le fabricant intègre le port une seule fois, et tous les câbles conformes à la norme conviennent.
Remarquez ce que la norme ne décide pas. Elle fixe la forme de la fiche et la façon dont les deux extrémités communiquent. Elle ne décide pas qui peut utiliser votre ordinateur, ni quels fichiers un visiteur peut en copier. Ces décisions restent au propriétaire de l’appareil.
Gardez ces deux aspects de l’image en tête. Cette leçon porte surtout sur le premier : une connexion standard plutôt que plusieurs connexions sur mesure. Le reste du cours porte aussi sur le second : ce qu’une norme ne décide jamais pour vous.
Le problème : trois applications veulent les mêmes connaissances
Section intitulée « Le problème : trois applications veulent les mêmes connaissances »Larkfield est le magasin pour la maison et le jardin des cours précédents. Bramble Books est une petite librairie qui utilise le service de soutien de Larkfield. Les deux magasins y conservent leurs documents de politique et leurs billets de soutien.
Le service de soutien a déjà un assistant d’IA. Amira a créé ses outils dans son propre code, comme dans le cours Créer des applications fiables avec les API de LLM. Maintenant, deux autres applications veulent les mêmes connaissances :
- Sam et les autres agents rédigent des réponses avec un assistant dans l’éditeur. Ils veulent qu’il cherche dans les politiques pendant qu’ils écrivent.
- Omar, le gestionnaire de produit, prévoit une application partenaire. Une entreprise partenaire veut chercher dans les politiques publiques de Larkfield.
Amira compte le travail à faire. L’assistant de soutien a deux appels d’API et un schéma d’outil pour son modèle. L’éditeur a besoin d’un module d’extension, écrit pour cet éditeur. Le partenaire a besoin de sa propre API, avec des clés, des schémas et de la documentation. Cela fait trois intégrations sur mesure pour un seul ensemble de connaissances.
Chaque copie peut aussi avoir ses propres erreurs. Supposons que l’outil du service de soutien limite chaque résultat à 300 caractères, mais que le module d’extension l’oublie. Ou que l’API partenaire renvoie un document réservé au personnel. Trois copies, c’est trois endroits où trouver et corriger chaque erreur.
Un petit exemple : compter les intégrations
Section intitulée « Un petit exemple : compter les intégrations »Comptez les intégrations sur mesure. Chaque application a besoin de son propre code pour chaque service qu’elle utilise. Le nombre est donc applications × services.
| Applications | Services | Intégrations sur mesure (applications × services) | Serveurs communs à créer (un par service) |
|---|---|---|---|
| 1 | 1 | 1 × 1 = 1 | 1 |
| 3 | 1 | 3 × 1 = 3 | 1 |
| 3 | 2 | 3 × 2 = 6 | 2 |
| 4 | 2 | 4 × 2 = 8 | 2 |
Lisez les deux dernières lignes. Une quatrième application ajoute deux intégrations sur mesure, une par service. Avec un protocole commun, elle n’ajoute aucun serveur. Elle a seulement besoin d’un client pour le protocole. Elle crée ce client une seule fois pour tous les serveurs.
Avec une application et un service, les deux colonnes indiquent 1. Un protocole commun ne réduit rien dans ce cas. Gardez cette ligne en tête pour la décision à la fin de la leçon.
Trois façons de connecter une application
Section intitulée « Trois façons de connecter une application »Il existe trois façons de donner les connaissances de Larkfield à une application. Elles diffèrent sur deux points : qui décide quand un appel s’exécute et où se trouve le code de connexion.
1. Intégration directe d’API. Votre code appelle le service à un moment précis. Par exemple, la page de soutien appelle GET /v1/tickets/T-30002 quand un agent ouvre un billet. Aucun modèle n’intervient. Votre code décide, chaque fois.
2. Appels d’outils dans une seule application. L’application décrit un outil au modèle : son nom, ses arguments et ce qu’il renvoie. Le modèle propose un appel, par exemple get_order avec LK-581106. L’application vérifie la proposition et l’exécute. La description de l’outil et son code se trouvent dans cette seule application. Une autre application doit écrire sa propre copie.
3. Un protocole commun. L’outil quitte l’application pour un programme distinct, un serveur. Toute application d’IA qui utilise le protocole peut demander au serveur ce qu’il offre et l’appeler. Le modèle propose toujours, et l’application vérifie toujours. Mais on écrit l’outil une seule fois.
Description textuelle du diagramme
- Intégration directe d’API. L’application de soutien (votre code) appelle l’API du service de billets et de politiques. Aucun modèle n’intervient dans ce chemin. Votre code décide toujours. Chaque application écrit ses propres appels.
- Appels d’outils dans une seule application. L’application décrit ses outils au modèle et reçoit une proposition d’appel. Elle contient le schéma de l’outil et le code qui l’exécute, puis appelle l’API. Le modèle propose, et l’application vérifie et exécute. L’outil se trouve dans cette seule application.
- Un protocole commun, MCP. Toute application d’IA avec un client MCP obtient les outils du serveur, et le modèle propose un appel. L’application envoie des messages MCP à un serveur MCP. Celui-ci offre des outils, des ressources et des requêtes, et appelle le service en Python. Le modèle propose, l’application vérifie, et le serveur vérifie encore. Chaque application MCP peut utiliser le même serveur.
La troisième façon a un nom : MCP, le Model Context Protocol. C’est une norme ouverte qui définit comment les applications d’IA se connectent aux outils et aux données. Le « contexte du modèle » désigne ce dont un modèle dispose pour travailler : outils à appeler, documents à lire et modèles de requêtes. Un « protocole » définit des règles convenues pour les messages, comme HTTP pour le Web. MCP fixe le format des messages et leur ordre. Il ne fixe pas ce que font vos outils.
Trois autres noms accompagnent MCP. Vous découvrirez chacun en détail dans la prochaine leçon :
- L’hôte est l’application d’IA qu’une personne utilise, comme l’assistant de soutien.
- Le client est la partie de l’hôte qui communique en MCP avec un serveur.
- Le serveur est le programme qui offre les outils et les données, comme les connaissances de soutien de Larkfield.
Remarquez que MCP ne remplace pas les appels d’outils. Le modèle propose toujours un appel et l’hôte décide toujours. MCP change l’endroit où se trouve l’outil. Il uniformise aussi les messages « qu’offrez-vous? » et « exécutez ceci » pour toutes les applications.
Ce que MCP normalise et ce qui reste votre responsabilité
Section intitulée « Ce que MCP normalise et ce qui reste votre responsabilité »Tomás a lu des articles sur MCP. « Donc MCP est un cadre logiciel pour agents, dit-il, et une fois nos outils derrière MCP, ils sont sécurisés. »
Les deux idées sont fausses, et la fiche du début de la leçon montre pourquoi. MCP est un protocole : un format de messages et quelques règles. Il n’a ni planificateur, ni boucle, ni mémoire. Ces éléments appartiennent à l’application, comme le montre Agents d’IA et orchestration des flux de travail. MCP ne décide pas non plus qui peut lire quoi. Une fiche standard ne verrouille pas votre ordinateur.
Vous pouvez déjà voir où se prend cette décision. Le service métier de Larkfield est le simple code Python sous le futur serveur. Il refuse un billet de Bramble Books demandé par Larkfield :
python -m support_mcp.knowledge ticket larkfield T-40003Not found.La commande se termine avec le code 1. T-40003 existe, mais il appartient à Bramble Books. Pour Larkfield, la réponse est donc « introuvable », comme pour un identifiant absent. Cette vérification se trouve dans knowledge.py, sous tout protocole. MCP transportera la requête et la réponse. Il ne fera pas cette vérification pour vous et ne doit pas la supprimer.
Kwame pose sa question habituelle pour chaque conception : « Qui appelle, que peut cette personne faire, et dans quelle organisation? » Les messages de MCP transportent l’appel. Les réponses à la question de Kwame restent dans votre serveur et votre service métier.
| MCP normalise | Votre application et votre serveur décident encore |
|---|---|
| Comment un client trouve les outils, les ressources et les requêtes d’un serveur (découverte) | Quels outils existent et à quel point leur rôle est limité |
| Le format des messages (JSON-RPC 2.0) et les transports (stdio, Streamable HTTP) | Qui appelle et ce que cette personne peut faire (autorisation) |
| Comment appeler un outil et renvoyer un résultat ou une erreur | Si une personne doit approuver un appel |
| Comment un serveur distant indique où obtenir un jeton | Les limites, les journaux et ce que le modèle peut voir |
Le tableau fait partie du projet. Il se trouve dans docs/integration-map.md, que vous copierez ci-dessous. Les termes de la colonne de gauche, comme JSON-RPC et les transports, auront chacun leur propre leçon plus tard.
Le cas de Larkfield : avant et après
Section intitulée « Le cas de Larkfield : avant et après »Amira dessine le plan pour Larkfield. À gauche se trouve le chemin actuel, avec une intégration sur mesure par application. À droite se trouve le plan de ce cours : un serveur MCP, support-mcp, devant le même service métier.
Description textuelle du diagramme
Sans MCP, chacune des trois applications accède aux connaissances de soutien (politiques et billets) à sa façon. L’application partenaire est encore un projet. Le service de soutien utilise deux appels d’API et un schéma d’outil. L’éditeur utilise un module d’extension. Le partenaire utilise une API partenaire avec des clés, des schémas et de la documentation. Cela fait 3 intégrations sur mesure, et une quatrième application en exige une quatrième.
Avec MCP, chacune des trois applications a un client MCP. Toutes trois envoient des messages MCP à un serveur, support-mcp, et le serveur appelle les connaissances de soutien. Cela fait 1 serveur, et une quatrième application a seulement besoin de son client MCP.
Le service métier est le même code des deux côtés. C’est le but du plan : le serveur est une couche mince qui offre le service sous une forme standard. Dans ce cours, vous créez cette couche étape par étape. Vous concevez d’abord ses outils, puis vous la créez et l’examinez. Vous y connectez ensuite une application d’IA et vous la protégez.
Préparer le projet du cours
Section intitulée « Préparer le projet du cours »Le projet s’appelle support-mcp. Sa première version, l’instantané start, ne contient pas encore de MCP. Elle contient les données synthétiques des deux magasins et le service métier, support_mcp/knowledge.py. Chaque fonction de ce service exige l’organisation comme argument.
-
Ouvrez un terminal et allez dans votre dossier de projets :
Fenêtre de terminal cd ~/projectsSi le dossier n’existe pas, créez-le d’abord avec
mkdir ~/projects. -
Obtenez les fichiers du cours. Si vous avez cloné le dépôt des exercices pour un cours précédent, mettez-le à jour :
Fenêtre de terminal git -C nextia-learning-labs pullSi vous ne l’avez pas, clonez-le avec
git clone https://github.com/Nextia-Intelligence/nextia-learning-labs.git. Sans Git, téléchargez le fichier ZIP du dépôt. Décompressez-le dans~/projects, puis renommez son dossier denextia-learning-labs-mainànextia-learning-labs. -
Copiez l’instantané
startdans un nouveau dossier,support-mcp, puis allez dans ce dossier :Fenêtre de terminal cp -R nextia-learning-labs/C28/snapshots/start support-mcpcd support-mcpFenêtre de terminal Copy-Item -Recurse nextia-learning-labs\C28\snapshots\start support-mcpcd support-mcp -
Créez un environnement virtuel, activez-le et installez les outils de test :
Fenêtre de terminal python3 -m venv .venvsource .venv/bin/activatepython -m pip install -r requirements-dev.txtFenêtre de terminal py -m venv .venv.venv\Scripts\Activate.ps1python -m pip install -r requirements-dev.txtLa version de départ n’exige aucun paquet pour s’exécuter, seulement la bibliothèque standard de Python. Le fichier installe
pytestetruffpour les tests.Vérifiez la version :
python --versiondoit afficher3.12ou une version ultérieure. Sur macOS,python3peut être le Python 3.9 du système. La trousse SDK MCP de la prochaine leçon ne le prend pas en charge. Dans ce cas, supprimez.venvet recréez-le avecpython3.12 -m venv .venv(Windows :py -3.12 -m venv .venv). -
Exécutez les tests :
Fenêtre de terminal python -m pytest -q........ [100%]8 passed in 0.01sVotre temps peut varier. Huit tests réussissent : le service métier fonctionne.
-
Comptez ce que contiennent les données :
Fenêtre de terminal python -m support_mcp.knowledgelarkfield: 9 documents, 13 ticketsbramble: 5 documents, 8 tickets -
Cherchez dans les politiques de Larkfield :
Fenêtre de terminal python -m support_mcp.knowledge search larkfield "return a damaged item"1.32 damaged-or-wrong-items: Damaged, faulty on arrival or wrong items… no, you can keep or recycle the damaged item. - Items of 50 dollars or more: we send a free return label, or arrange a …1.21 returns-policy: Returns policy… Return shipping is free when the item arrived damaged or we sent the wrong item. ## Refunds We inspect the item within 3 business days …0.90 order-changes-and-cancellations: Changing or cancelling an order… your account, choose the item and select Return an item. Or contact the help desk. We email a return label within 1 business day.La recherche renvoie les trois meilleurs documents, le meilleur en premier. Le nombre est le score de recherche : un score plus élevé indique une meilleure correspondance.
-
Demandez le billet de Bramble Books par Larkfield, comme ci-dessus :
Fenêtre de terminal python -m support_mcp.knowledge ticket larkfield T-40003La réponse est
Not found.(introuvable). Demandez maintenant par Bramble Books, avecticket bramble T-40003. Le billet apparaît :T-40003 (open): Book arrived damaged(T-40003, ouvert : le livre est arrivé endommagé). -
Copiez l’exemple détaillé de cette leçon, la carte des intégrations, depuis l’instantané
end-of-m01:Fenêtre de terminal mkdir docscp ../nextia-learning-labs/C28/snapshots/end-of-m01/docs/integration-map.md docs/Fenêtre de terminal mkdir docsCopy-Item ..\nextia-learning-labs\C28\snapshots\end-of-m01\docs\integration-map.md docs\ -
Ouvrez
docs/integration-map.mddans votre éditeur et lisez-le. Il contient les trois applications, le nombre d’intégrations et le tableau de ce que MCP normalise.
Gardez ce terminal ouvert, avec l’environnement virtuel actif. Chaque leçon du cours commence ici, dans ~/projects/support-mcp.
Quand chaque approche suffit
Section intitulée « Quand chaque approche suffit »Décidez maintenant, pour chaque cas, quelle approche est la plus simple et fonctionne. Plus de composants ne veut pas dire mieux. Chaque étape vers la droite du premier diagramme ajoute un composant à exécuter, à tester et à maintenir à jour.
- L’intégration directe d’une API suffit quand les étapes sont fixes et qu’aucun modèle ne les choisit. La page de soutien ouvre un billet quand un agent clique dessus. Un modèle n’apporte rien ici.
- Les appels d’outils dans une seule application suffisent quand une application d’IA utilise quelques outils qu’aucune autre application n’utilise. L’assistant de gestion des billets du cours Créer des applications fiables avec les API de LLM en est un bon exemple. Son outil
get_orderse trouve dans son propre code, et c’est très bien ainsi. - Un protocole partagé devient avantageux quand les mêmes outils et données servent plusieurs applications d’IA. Il l’est encore plus quand vous ne créez pas ces applications vous-même, comme un assistant d’éditeur ou l’application d’un partenaire. Elles possèdent leur propre client MCP, et votre serveur fonctionne avec chacune.
MCP a aussi des coûts. Vous devez les nommer avant de le choisir :
- Un autre programme à exécuter. Le serveur est un processus distinct. En cas de défaillance, vous examinez deux programmes et les messages entre eux. Le module 3 vous montre comment lire ces messages.
- Un protocole qui change vite. MCP a connu plusieurs révisions en peu de temps. Vous devez fixer les versions utilisées, comme le montre Tenir compte des versions.
- Une exposition plus large. Chaque application connectée peut voir et appeler les outils du serveur. Concevez donc des outils ciblés, avec des limites claires, avant de les créer. C’est le sujet du module 2.
- L’accès à distance exige une connexion. Un serveur sur le réseau exige des jetons et des vérifications d’autorisations, comme dans Authentification, autorisations et applications multilocataires. C’est le sujet du module 5.
Pour Larkfield, le nombre tranche : trois applications aujourd’hui, davantage plus tard, et deux qu’Amira n’a pas créées. À long terme, un seul serveur est le plan le plus simple.
Erreurs courantes
Section intitulée « Erreurs courantes »Erreur courante
Aucun module nommé 'support_mcp'
Symptôme : une commande du projet échoue immédiatement :
…/.venv/bin/python: Error while finding module specification for 'support_mcp.knowledge' (ModuleNotFoundError: No module named 'support_mcp')Cause : le terminal n’est pas dans le dossier du projet. python -m cherche support_mcp dans le dossier courant. Cette exécution se faisait un dossier trop haut, dans ~/projects.
Solution : ouvrez le dossier du projet avec cd ~/projects/support-mcp, puis exécutez la commande de nouveau.
Erreur courante
Aucun module nommé pytest
Symptôme : python -m pytest -q affiche No module named pytest (aucun module nommé pytest). Sur macOS, le message peut aussi nommer un autre Python, par exemple /Library/Frameworks/Python.framework/Versions/3.14/bin/python3.
Cause : l’environnement virtuel n’est pas actif. Le terminal utilise le Python du système, qui ne contient pas les paquets du projet.
Solution : activez-le de nouveau : source .venv/bin/activate sur macOS et Linux, .venv\Scripts\Activate.ps1 dans PowerShell. L’invite commence alors par (.venv). Chaque nouveau terminal exige cette étape.
Réinitialisation. Le programme lit les données dans data/ à chaque démarrage, et rien dans cette leçon ne les modifie. Si votre projet ne fonctionne plus, supprimez le dossier support-mcp et refaites les étapes de configuration.
Vérification des connaissances
Section intitulée « Vérification des connaissances »Vérifiez votre compréhension
Expliquez la différence entre les appels d'outils dans une application et un outil offert par un serveur MCP. Où se trouve l'outil, et qui décide si un appel s'exécute?
Afficher la réponse
Dans une application, la description de l’outil et son code d’exécution font partie de cette application. Une autre application doit créer sa propre copie. Avec MCP, l’outil se trouve dans un serveur distinct. Toute application dotée d’un client MCP peut le découvrir et l’appeler. Dans les deux cas, le modèle propose seulement un appel. L’application décide de l’exécuter ou non. Avec MCP, le serveur vérifie aussi la requête avant de l’exécuter.
Votre réponse contient-elle les points principaux de la nôtre ?
Connectez-vous et inscrivez-vous au cours pour enregistrer vos réponses. Chaque vérification compte pour le certificat.
Vérifiez votre compréhension
Faites une prédiction : Larkfield ajoute deux applications d'IA (cinq au total) et un deuxième service, celui des commandes (deux au total). Combien d'intégrations sur mesure faut-il sans protocole partagé? Combien de serveurs MCP faut-il avec un tel protocole?
Afficher la réponse
Sans protocole partagé : 5 applications × 2 services = 10 intégrations sur mesure. Avec MCP : 2 serveurs, un par service. Chacune des cinq applications a besoin d’un client MCP, qu’elle crée une seule fois pour tous les serveurs.
Votre réponse contient-elle les points principaux de la nôtre ?
Connectez-vous et inscrivez-vous au cours pour enregistrer vos réponses. Chaque vérification compte pour le certificat.
Vérifiez votre compréhension
Vérification pratique : qu'affiche python -m support_mcp.knowledge ticket larkfield T-40003? Pourquoi cette vérification doit-elle rester dans le service métier une fois le serveur MCP créé?
Afficher la réponse
La commande affiche Not found. (introuvable) et se termine avec le code 1. T-40003 appartient à Bramble Books, et chaque recherche se fait dans une seule organisation. MCP transporte seulement les requêtes et les réponses. Il ne sait pas à quelle organisation appartient l’appelant, ni ce que celui-ci peut lire. Sans cette vérification dans le service métier, toute application connectée au serveur pourrait lire les billets de l’autre boutique.
Votre réponse contient-elle les points principaux de la nôtre ?
Connectez-vous et inscrivez-vous au cours pour enregistrer vos réponses. Chaque vérification compte pour le certificat.
Récapitulatif
- Trois façons de se connecter : un appel direct d’API (votre code décide), des appels d’outils dans une application (l’outil s’y trouve) et un protocole partagé. Avec le protocole, l’outil se trouve dans un serveur que toute application peut utiliser.
- MCP, le Model Context Protocol, normalise la découverte, le format des messages, les appels et les erreurs. Ce n’est pas un cadriciel d’agents, et il ne décide pas qui peut faire quoi.
- Comptez d’abord : applications × services intégrations sur mesure, contre un serveur par service. Avec une application et un service, MCP ne fait rien économiser.
- Votre projet
~/projects/support-mcpfonctionne :8 passed(8 tests réussis), 9 + 13 enregistrements Larkfield, 5 + 8 enregistrements Bramble Books, etNot found.pour le billet de l’autre boutique.
Ensuite, vous découvrez les trois participants de MCP : l’hôte, le client et le serveur. Vous exécutez aussi le plus petit serveur MCP.
Leçon suivante : Participants et limites