Registro estructurado para el cliente

Imprimir en su terminal solo le ayuda a usted. MCP permite que el servidor envíe mensajes de log a través del protocolo para que la aplicación host también pueda mostrarlos.

Los registros se transmiten como una notificación notifications/message. Incluye un nivel, un nombre de logger opcional y los datos que desea registrar.

Desde el interior de una herramienta, accede al registro mediante el objeto Context, el mismo medio que utilizó para el progreso. No hace falta ninguna configuración adicional.

El helper más habitual es ctx.info. Úselo para notas de estado normales y esperadas que ayuden al usuario a seguir lo que hace la herramienta.

Use ctx.debug cuando necesite trazas detalladas, como un valor analizado o una rama elegida, que resultarían demasiado abundantes en el uso cotidiano.

Use ctx.warning cuando algo no sea correcto, pero pueda recuperarse, como un campo opcional ausente que completó con un valor predeterminado.

Llame a ctx.error cuando haya problemas reales. Informa al cliente de que un paso falló, sin lanzar una excepción que termine la llamada.

MCP sigue la conocida escala de syslog: debug, info, notice, warning, error, critical y niveles superiores. Los clientes pueden ordenar y asignar colores según el nivel.

Muchos helpers aceptan un nombre de logger para agrupar los mensajes por componente, de forma similar a como lo hace el módulo estándar de logging de Python.

Los mensajes de registro salen de su proceso y llegan al cliente, así que debe tratarlos como información visible. Nunca escriba secrets como tokens o contraseñas en un registro.

Al igual que el progreso, cada registro es una notification, por lo que nunca bloquea la herramienta ni espera una respuesta. Puede registrar información libremente mientras avanza el trabajo.

Elija el helper adecuado para las actualizaciones de estado rutinarias.

Ahora puede emitir registros con distintos niveles mediante ctx.info, debug, warning y error; asignar nombres a sus loggers y mantener los secretos fuera de los registros. ¡Muy buen progreso!