클라이언트에 구조화된 로깅 보내기

터미널에 출력하는 것은 본인에게만 도움이 됩니다. MCP를 사용하면 서버가 프로토콜을 통해 로그 메시지를 보내 호스트 앱에서도 표시할 수 있습니다.

로그는 notifications/message 알림으로 전달됩니다. 이 알림에는 수준, 선택적인 로거 이름, 기록하려는 데이터가 담깁니다.

도구 내부에서는 진행 상황을 전달할 때 사용한 것과 동일한 핸들인 Context 객체를 통해 로깅에 접근합니다. 추가 설정은 필요하지 않습니다.

가장 흔히 사용하는 도우미는 ctx.info입니다. 도구가 무엇을 하는지 사용자가 따라가는 데 도움이 되는 일반적이고 예상 가능한 상태 메시지에 사용하십시오.

파싱된 값이나 선택된 분기처럼 일상적인 사용에서는 지나치게 많은 세부 추적 정보가 필요할 때 ctx.debug를 사용하십시오.

선택적 필드가 누락되어 기본값으로 채우는 경우처럼 문제가 있지만 복구할 수 있을 때는 ctx.warning을 사용하십시오.

실제 문제가 발생하면 ctx.error를 호출하십시오. 이 호출은 단계가 실패했음을 클라이언트에 알리며, 호출을 끝내는 예외 발생과는 별개입니다.

MCP는 익숙한 syslog 척도를 따릅니다. debug, info, notice, warning, error, critical 및 그보다 높은 수준이 있습니다. 클라이언트는 수준별로 정렬하고 색상을 지정할 수 있습니다.

많은 도우미는 로거 이름을 받아 메시지를 구성 요소별로 그룹화할 수 있습니다. Python의 표준 로깅 모듈과 비슷한 방식입니다.

로그 메시지는 프로세스를 떠나 클라이언트에 도달하므로 다른 사람이 볼 수 있는 정보로 취급하십시오. 토큰이나 비밀번호 같은 비밀 정보를 로그에 절대 기록하지 마십시오.

진행 상황과 마찬가지로 각 로그는 알림이므로 도구를 차단하지 않고 응답도 요구하지 않습니다. 작업이 진행되는 동안 자유롭게 로그를 기록할 수 있습니다.

이제 ctx.info, debug, warning, error를 사용해 수준별 로그를 내보내고, 로거 이름을 지정하며, 비밀 정보를 로그에서 제외할 수 있습니다. 훌륭하게 진행하셨습니다!