Claude Code MCP 로그: 첫 번째 실패한 경계 찾기

Claude Code MCP 로그 를 찾고 있는 경우 해결된 서버 상태로 시작한 다음 하나의 사건 범위 디버그 파일을 캡처하세요. Claude Desktop 로그 디렉터리를 추적하는 것으로 시작하지 마십시오. 현재 MCP 문서에서는 해당 파일 시스템 경로를 데스크톱용으로 특별히 표시하는 반면 Claude Code에서는 /mcp , claude mcp list , claude debug mcp 및 debug file 를 문서화합니다. 유용한 결과는 "로그 찾기"가 아닙니다. 이는 구성, 프로젝트 승인, 프로세스 시작, 도구 검색, 도구 실행 또는 도구가 생성해야 하는 외부 결과 등 첫 번째 실패한 경계를 식별하는 것입니다. 로그는 하나의 경계를 설명할 수 있습니다. 여섯 가지를 모두 증명할 수는 없습니다. 이 가이드에서는 2026년 7월 30일에 확인된 현재 Claude Code 문서와 npm 릴리스 2.1.220 를 사용합니다. MCP 동작 및 진단은 계속 변경되므로 모든 사고에 설치된 버전을 고정하세요. 원시 출력을 읽기 전에 해결 상태를 검사합니다. 문제가 발생한 동일한 작업 디렉터리 및 사용자 계정에서 다음 검사를 실행하세요. 영향을 받은 Claude Code 세션 내에서 다음을 실행합니다. 공식 구성 디버깅 가이드에는 /mcp 가 구성된 서버, 연결 상태 및 프로젝트 승인을 표시한다고 나와 있습니다. MCP 참조는 중요한 두 가지 작업 세부 정보를 추가합니다. 프로젝트 범위의 .mcp.json 서버는 작업공간이 신뢰되고 서버가 승인될 때까지 보류 상태로 남아 있을 수 있습니다. 연결된 서버는 여전히 제로 도구를 노출할 수 있으며 /mcp 는 ​​그 수를 보고합니다. 이러한 사실은 블라인드 로그 검색의 세 가지 클래스를 제거합니다. 해결된 증거 첫 번째 결정 로그가 먼저가 아닌 이유 서버 부재 CONFIG MISSING 아직 진단할 로드된 서버 프로세스가 없습니다. 범위 및 설정 소스를 확인하세요. 승인 대기 중 APPROVAL WAIT 이는 충돌이 아닌 정당한 권한 경계입니다. 대화형으로 검토하고 승인하세요. 연결 실패 MCP 디버그 증거 캡처 명령, 경로, 환경, 인증 또는 전송이 실패했을 수 있습니다. 연결된 제로 도구 다시 연결한 후 MCP 디버그 증거 캡처 연결에 충분할 정도로 시작이 성공했지만 검색에서 사용 가능한 레지스트리를 생성하지 못했습니다. 연결됨, 도구 있음 한 번의 제한된 호출 재현 연결 상태는 선택한 도구나 외부 효과에 대해 아무 것도 알려주지 않습니다. 상대 경로는 로컬 stdio 서버에 대해 특별한 의심을 받을 가치가 있습니다. Claude Code는 command 및 args 경로가 .mcp.json 의 위치가 아닌 Claude Code가 시작된 디렉터리에서 확인된다는 것을 문서화합니다. 따라서 서버는 동일한 구성 텍스트로 인해 한 저장소에서는 작동하고 다른 저장소에서는 실패할 수 있습니다. 범위가 지정된 Claude Code MCP 디버그 파일 캡처 현재 클로드 코드 CLI 참조에는 두 가지 관련 플래그가 문서화되어 있습니다. debug 는 디버그 모드를 활성화하고 mcp 와 같은 범주 필터를 허용합니다. debug file <path 는 디버그 출력을 명시적 경로에 기록하고 암시적으로 디버그 모드를 활성화합니다. 개인 사건 디렉터리를 생성하고 MCP 디버그 범주만으로 새 세션을 시작한 후 하나의 제한된 증상을 재현합니다. 해당 세션 내에서 /mcp 를 검사합니다. 서버가 도구 없이 연결된 경우 재연결 작업을 한 번 사용하세요. 도구가 있는 경우 문제를 재현하는 가장 작은 읽기 전용 도구만 호출하십시오. 단지 로그를 더 흥미롭게 만들기 위해 쓰기 가능 호출을 재시도하지 마십시오. 디버그 파일을 중요한 파일로 취급하십시오. 여기에는 절대 경로, 서버 이름, 환경 세부 정보, 요청 메타데이터 또는 서버 표준 오류가 포함될 수 있습니다. 사고 영수증에 파생된 증거를 기록한 다음 보안 정책에 따라 원시 파일을 보관하거나 삭제하세요. 파일에 포함되어 있다는 이유만으로 액세스 토큰, 프롬프트 본문, 도구 인수, 결과 또는 stderr 텍스트를 모니터링 시스템에 복사하지 마십시오. 공개 MCP 서버별 로그 파일에 대한 Claude Code 기능 요청는 사용자가 Claude Code용 데스크톱 스타일 영구 파일을 원한다고 보고합니다. 그 문제는 제품 보증이 아니라 유용한 경계 증거입니다. 지원되는 사고 절차는 가정된 기본 서버별 경로가 아니라 문서화된 명시적 디버그 파일에 따라 달라져야 합니다. 증거 경로를 전송 경로와 일치시킵니다. 프로토콜 개정판에 대한 MCP 디버깅 가이드 2026 07 28는 중요한 전송 경계를 그립니다. 로컬 stdio 서버의 경우 stdout은 프로토콜 메시지를 전달합니다. 서버 진단은 stderr에 속합니다. 진단 텍스트를 stdout에 쓰면 프로토콜 스트림이 손상될 수 있습니다. Claude Code의 문제 해결 가이드에서는 연결된 서버가 제로 도구를 노출하는 경우 특히 claude debug mcp 를 권장합니다. 이렇게 하면 디버그 증거에서 서버 stderr을 사용할 수 있기 때문입니다. 스트리밍 가능한 HTTP 의 경우 클라이언트는 원격 서버 프로세스의 stderr을 캡처할 수 없습니다. Claude Code 디버그 파일은 여전히 ​​클라이언트 측 연결 및 요청 동작을 표시할 수 있지만 서버의 내부 오류에는 서버 측 로그 또는 OpenTelemetry와 HTTP 수준 검사가 필요합니다. 빈 클라이언트 디버그 세그먼트는 원격 서비스가 아무 작업도 수행하지 않았다는 증거가 아닙니다. 이러한 구별은 일반적인 잘못된 결론을 방지합니다. 영수증에 운송 내용을 기록하십시오. 이것이 없으면 “stderr 없음”은 모호합니다. 콘텐츠가 최소화된 사고 영수증 작성 원시 로그는 조사를 위한 증거입니다. 영수증은 지속적인 건강 기록입니다. 콘텐츠를 저장하지 않고도 유용하게 사용할 수 있습니다. 분류자 우선순위를 명시적으로 유지합니다. 나는 여덟 가지 합성 사례에 대해 그 규칙을 다시 적용했습니다. 누락된 구성, 승인 대기, 캡처된 시작 실패, 연결된 제로 도구, 도구 오류, 결과가 없는 성공적인 도구 응답, 확인된 결과 및 디버그 증거가 불충분한 연결 실패를 올바르게 분리했습니다. 예상되는 8개 주가 모두 통과되었습니다. 마지막 두 경우는 중요한 경계입니다. JSON RPC 성공 또는 오류 없음 도구 결과는 활동 증거입니다. 작업에서 생성된 이슈, 변경된 기록, 전달된 파일 또는 업데이트된 대상을 약속한 경우 해당 대상을 별도로 확인하세요. 해당 영수증이 없으면 올바른 상태는 정상이 아닌 OUTCOME UNVERIFIED 입니다. 가장 작은 안전한 다음 동작을 선택하세요 각 상태는 하나의 제한된 응답으로 이어져야 합니다. CONFIG MISSING : 설정 범위와 클로드 코드가 로드된 정확한 파일을 검사합니다. 서버 코드를 변경하지 마십시오. APPROVAL WAIT : 승인을 담당자에게 전달합니다. 기다리는 것을 충돌로 묘사하지 마십시오. STARTUP FAILED : 범위가 지정된 디버그 증거에서 첫 번째 구체적인 시작 원인을 복구한 다음 한 번 다시 연결합니다. DISCOVERY EMPTY : 초기화 및 도구 목록 증거를 비교합니다. 필요한 경우 MCP Inspector를 사용하여 독립적으로 서버를 테스트하십시오. TOOL CALL FAILED : 요청 ID를 유지하고, 재시도가 안전한지 확인하고, 불확실한 쓰기 재생을 방지합니다. OUTCOME UNVERIFIED : 안정적인 식별자로 대상을 쿼리합니다. 효과가 이미 발생했는지 확인할 때까지 도구를 다시 실행하지 마십시오. UNCERTAIN : 누락된 경계 증거를 수집하거나 에스컬레이션합니다. 알 수 없음은 추측하라는 초대가 아니라 작동 상태입니다. HEALTHY : 사용 가능한 MCP 체인과 새롭고 결정적인 결과 영수증이 모두 필요합니다. 로그는 실패를 설명 가능하게 만듭니다. 해결된 상태에서는 위치를 찾을 수 있습니다. 대상 영수증을 통해 복구를 확인할 수 있습니다. 이러한 작업을 별도로 유지하면 Claude Code MCP 사고는 점점 더 위험해지는 일련의 재시도 대신 짧은 증거 연습이 됩니다. Sidewisp는 연결, 유용한 진행, 도구 및 결과 간의 건강 우선 구별을 중심으로 설계되었습니다. Sidewisp는 현재 비공개 프리뷰 단계입니다. 프로덕션 모니터링 어댑터 및 복구 실행기는 일반적으로 배송되지 않습니다.