Architecture
OpenAPI (Swagger) décrit une API pour les développeurs. MCP décrit des outils pour un modèle. Ce sont des couches, pas des rivaux, et le choix se voit dans la découverte, la sécurité et les tâches longues.
6 nov. 2026 · 6 min de lecture
Le schéma et les sources sont en anglais.
La plupart des entreprises ont déjà des API, documentées en OpenAPI, la spécification derrière Swagger. La question, pour un projet d'agents, est de savoir s'il faut relier l'agent à ces API à la main ou placer un serveur MCP devant elles. La réponse honnête, c'est que ce n'est pas l'un ou l'autre : un serveur MCP enveloppe très souvent la même API REST.
La spécification OpenAPI décrit les API HTTP : chemins, paramètres, corps de requête et de réponse. La version 3.1 définit son Schema Object comme un sur-ensemble de JSON Schema draft 2020-12. Son lecteur est un développeur ou un générateur de code, au moment de la construction.
Le Model Context Protocol est conçu pour un autre lecteur : le modèle, à l'exécution. Les messages sont en JSON-RPC. Un client envoie une requête tools/list pour découvrir les outils qu'offre un serveur, et le serveur doit répondre avec l'ensemble alors disponible pour ce client. Un serveur peut aussi aviser le client que sa liste d'outils a changé.
Aucun des deux modèles n'offre la sécurité gratuitement. La spécification de MCP indique que, pour la confiance et la sécurité, il devrait toujours y avoir une personne dans la boucle capable de refuser les invocations d'outils, et son autorisation HTTP repose sur OAuth 2.1. Les portées, les limites, les approbations et la vérification restent à construire, et elles devraient vivre hors du modèle.
Une tâche qui dure des minutes ne devrait pas garder une connexion ouverte. Le 202 Accepted de HTTP signifie que la requête a été acceptée pour traitement, mais que le traitement n'est pas terminé. Retournez-le avec un identifiant de tâche, laissez le client interroger, et décrivez les événements sous-jacents, par exemple avec AsyncAPI. Le deuxième onglet ci-dessus illustre ce flux.
Parlez-nous d'un processus. Nous vous montrerons comment un agent pourrait le prendre en charge et quoi mesurer pour savoir qu'il fonctionne.