Registro estruturado para o cliente

Imprimir no seu terminal só ajuda você. O MCP permite que o servidor envie mensagens de registro pelo protocolo para que o aplicativo hospedeiro também possa exibi-las.

Os registros viajam como uma notificação notifications/message. Ela contém um nível, um nome opcional do registrador e os dados que você deseja registrar.

Dentro de uma ferramenta, você acessa o registro por meio do objeto Context, o mesmo identificador que usou para o progresso. Nenhuma configuração adicional é necessária.

O auxiliar mais comum é ctx.info. Use-o para observações normais e esperadas sobre o estado, que ajudam o usuário a acompanhar o que a ferramenta está fazendo.

Use ctx.debug quando quiser rastreamentos detalhados, como um valor analisado ou um ramo escolhido, que seriam excessivos no uso cotidiano.

Use ctx.warning quando algo estiver errado, mas puder ser recuperado, como um campo opcional ausente que você preencheu com um valor padrão.

Chame ctx.error para problemas reais. Ele informa ao cliente que uma etapa falhou, separadamente do lançamento de uma exceção que encerra a chamada.

O MCP segue a conhecida escala do syslog: debug, info, notice, warning, error, critical e níveis superiores. Os clientes podem ordenar e colorir por nível.

Muitos auxiliares aceitam um nome de registrador para que as mensagens sejam agrupadas por componente, assim como faz o módulo padrão de registro do Python.

As mensagens de registro saem do seu processo e chegam ao cliente, portanto trate-as como visíveis. Nunca escreva segredos, como tokens ou senhas, em um registro.

Assim como o progresso, cada registro é uma notificação; portanto, ele nunca bloqueia sua ferramenta nem espera uma resposta. Você pode registrar informações livremente à medida que o trabalho avança.

Escolha o auxiliar correto para atualizações rotineiras de estado.

Agora você pode emitir registros com níveis usando ctx.info, debug, warning e error, dar nomes aos seus registradores e manter os segredos fora deles. Excelente progresso!