Journalisation structurée vers le client

Afficher du texte dans votre terminal ne vous aide que vous. MCP permet au serveur d’envoyer des messages de journalisation via le protocole, afin que l’application hôte puisse également les afficher.

Les journaux circulent sous la forme d’une notification notifications/message. Elle contient un niveau, un nom de journaliseur facultatif et les données que vous souhaitez enregistrer.

Depuis un outil, vous accédez à la journalisation via l’objet Contexte, la même référence que celle utilisée pour la progression. Aucune configuration supplémentaire n’est nécessaire.

L’assistant le plus courant est ctx.info. Utilisez-le pour les informations d’état normales et attendues qui aident l’utilisateur à suivre ce que fait l’outil.

Utilisez ctx.debug lorsque vous souhaitez des traces détaillées, par exemple une valeur analysée ou une branche choisie, qui seraient trop nombreuses dans une utilisation quotidienne.

Utilisez ctx.warning lorsque quelque chose est inhabituel mais récupérable, par exemple lorsqu’un champ facultatif manquant a été remplacé par une valeur par défaut.

Appelez ctx.error pour les problèmes réels. Cela indique au client qu’une étape a échoué, indépendamment du déclenchement d’une exception qui met fin à l’appel.

MCP suit l’échelle familière de syslog : debug, info, notice, warning, error, critical et les niveaux supérieurs. Les clients peuvent trier et appliquer une couleur selon le niveau.

De nombreux assistants acceptent un nom de journaliseur afin de regrouper les messages par composant, comme le fait le module de journalisation standard de Python.

Les messages de journalisation quittent votre processus et parviennent au client ; traitez-les donc comme des informations visibles. N’écrivez jamais de secrets, tels que des jetons ou des mots de passe, dans un journal.

Comme la progression, chaque journal est une notification : il ne bloque donc jamais votre outil et n’attend aucune réponse. Vous pouvez journaliser librement au fil du travail.

Vous pouvez désormais émettre des journaux associés à un niveau avec ctx.info, debug, warning et error, nommer vos journaliseurs et ne pas y faire apparaître de secrets. Vous progressez très bien !