FRENES

Glossaire · Protocole MCP

API

Une API, ou interface de programmation d’application, définit comment un logiciel peut utiliser les fonctions ou les données d’un autre composant. Elle précise les opérations disponibles et la manière d’échanger des informations, ce qui permet notamment à un agent IA de consulter un service ou de lui demander une action.

API : l'explication

Une API décrit un contrat d’utilisation : quelles opérations demander, quelles informations fournir et quels résultats attendre. Pour une API web, le logiciel envoie généralement une requête par le réseau et reçoit une réponse structurée. L’accès peut exiger une clé ou une autre forme d’authentification. Certaines API fonctionnent toutefois à l’intérieur d’un même appareil ou d’un programme. Le terme ne désigne donc pas uniquement un service distant accessible sur Internet, même si cet usage est fréquent.

Les API permettent de relier des logiciels sans reproduire leur fonctionnement interne. Un agent peut ainsi consulter un agenda, rechercher une commande ou envoyer une demande à un service autorisé. Le modèle ne réalise pas ces opérations simplement en écrivant leur nom : une application doit traduire sa demande en appel effectif, transmettre les paramètres et traiter la réponse. Une fonction exposée par un serveur MCP peut elle-même utiliser une API pour accomplir l’opération demandée.

Une API peut autoriser la lecture, la modification ou les deux, selon ses fonctions et les droits associés à votre accès. Elle peut imposer des quotas, des frais, des formats précis ou des limites de disponibilité. Une erreur réseau ne permet pas toujours de savoir immédiatement si une action a déjà été effectuée. Les applications doivent donc gérer les erreurs et les répétitions avec soin, surtout pour les opérations qui créent, envoient ou modifient quelque chose.

Un exemple concret

Vous demandez à un assistant de vérifier si une salle est libre pour votre réunion. L’application appelle l’API du calendrier avec la période concernée et reçoit les disponibilités accessibles. Elle vous présente ensuite une proposition. Si vous autorisez la réservation, un autre appel peut créer l’événement. L’application doit vérifier le résultat avant d’annoncer la confirmation, et éviter de créer un doublon si une réponse tarde à arriver.

Pourquoi c'est important

Les API déterminent ce qu’un agent peut réellement consulter ou accomplir dans vos services. Vérifiez les permissions, la protection des identifiants et les coûts éventuels. Regardez aussi comment l’outil confirme une action et signale un échec. Une réponse bien formulée ne prouve pas qu’un appel a réussi. Pour les opérations importantes, un identifiant de résultat ou une vérification dans le service concerné apporte une preuve plus utile.

Idées reçues

  • Une API n’est pas forcément publique ou gratuite : son accès peut être réservé, soumis à autorisation ou facturé, et une documentation visible ne signifie pas que vous possédez les droits nécessaires pour utiliser toutes ses fonctions.
  • Disposer d’un accès API ne donne pas automatiquement tous les droits sur un service : les opérations autorisées dépendent des permissions associées, des restrictions du compte et des règles appliquées à chaque demande par le système destinataire.

Autres termes : protocole mcp

MCP (Model Context Protocol)
Le MCP, ou Model Context Protocol, est un protocole qui organise les échanges entre une application IA et des services proposant des données ou des fonctions.
serveur MCP
Un serveur MCP est un composant logiciel qui expose des données ou des fonctions au moyen du Model Context Protocol.
client MCP
Un client MCP est le composant d’une application qui communique avec un serveur au moyen du Model Context Protocol.
SDK
SDK signifie kit de développement logiciel.
webhook
Un webhook est un mécanisme par lequel un service envoie automatiquement une notification à une adresse web lorsqu’un événement se produit.
sortie structurée
Une sortie structurée est une réponse organisée selon un format défini, avec des champs et des types de données prévus.
protocole A2A
Le protocole A2A est un ensemble ouvert de règles qui permet à des agents IA indépendants de communiquer et de se confier des tâches.

Où le site en parle

Le terme apparaît dans 2 618 pages du site. Quelques-unes :

Pour aller plus loin

Questions fréquentes

Une API est-elle une interface graphique ?

Non. Elle s’adresse à des logiciels, tandis qu’une interface graphique présente des commandes à une personne. Une application peut utiliser une API derrière ses boutons, mais les deux interfaces n’ont pas le même rôle ni nécessairement les mêmes possibilités.

Un agent peut-il utiliser une API seul ?

Il lui faut une application capable d’exécuter les appels, les informations de connexion nécessaires et les autorisations adaptées. Le modèle peut proposer une opération, mais un mécanisme logiciel doit réellement la transmettre puis vérifier le résultat reçu.

Où vérifier la définition d’une API ?

Cette [présentation des interfaces de programmation](https://www.redhat.com/en/topics/api/what-are-application-programming-interfaces) explique leur rôle dans les échanges entre logiciels. Pour un usage concret, la documentation du service reste indispensable afin de connaître les paramètres, les autorisations et les résultats possibles.

Neutralité. Aucun lien d'affiliation. Aucun éditeur ne paie pour être évalué, noté ou classé. Les évaluations sont dirigées par François Chollet, neutres et factuelles, et chaque donnée est datée et sourcée. Comment nous notons