MCP 오류

현재 OAuth 에지, 보호된 런타임, 속도 제한 및 좁은 상거래 오류를 해석합니다.

한국어 번역 검토 중 기술적 의미가 충돌하는 경우 영어 원문을 기준으로 사용하세요.

개요

현재 오류는 OAuth 에지 오류와 아직 고객이 사용할 수 없는 보호된 런타임을 구분합니다.

상태 또는 코드	의미	동작
401 invalid_token	보호된 요청에 허용된 베어러 토큰이 없음	토큰을 수동으로 붙여넣지 않습니다. 인증된 클라이언트 흐름을 기다립니다.
400 invalid_request	인증 요청이 잘못되었거나 외부 정책입니다.	정확한 콜백, PKCE, 리소스 및 요청된 범위를 확인합니다.
429 temporarily_unavailable	등록, 승인 또는 토큰 유입은 요금이 제한됩니다.	최소 Retry-After 값, 현재 60초 대기
404 tool_not_available	현재 보호된 런타임이 메서드 또는 명명된 도구를 구현하지 않습니다.	MCP 서비스를 사용할 수 없는 것으로 취급합니다.
JSON-RPC -32601	좁은 크레딧 방법은 토큰 범위 또는 조직 허용 목록 밖에 있습니다.	더 넓은 카탈로그를 추론하지 마십시오; 자격을 기다립니다
JSON-RPC -32602	지원 되지 않는 인수를 받은 좁은 크레딧 메서드	통제된 테스트에서만 인식할 수 없는 인수 제거
result.isError: true	좁은 상거래를 완료할 수 없습니다.	살균된 결과와 타임스탬프 보존하기

인증되지 않은 401는 서비스 준비 상태가 아닌 실행을 확인합니다. initialize 또는 tools/list용 404는 현재 알려진 런타임 경계입니다.

문제를 보고할 때는 클라이언트 이름 및 버전, 타임스탬프, 엔드포인트 경로, 상태 및 살균된 오류 코드를 포함합니다. 토큰, 권한 부여 코드, 쿠키, 클라이언트 검증 값 또는 프로젝트 데이터를 포함하지 마십시오.