문서 둘러보기
MCP(모델 컨텍스트 프로토콜)

MCP 인증

PKCE, 동적 클라이언트 등록, 갱신, 취소를 지원하는 OAuth 2.1 인증 코드 흐름입니다.

검색 및 확인

예시
/.well-known/oauth-protected-resource/mcp
/.well-known/oauth-authorization-server

보호 리소스 문서는 MCP 리소스와 인증 서버를 지정합니다. 인증 서버 문서는 인증, 토큰, 등록, 취소 및 사용자 정보 엔드포인트를 제공합니다.

인증 흐름

  1. 1클라이언트와 정확한 리디렉션 URI를 등록하세요.
  2. 2PKCE verifier와 S256 challenge를 생성하세요.
  3. 3resource, state, scope, challenge를 지정해 사용자를 /oauth/authorize로 보내세요.
  4. 41회용 코드를 /oauth/token에서 교환하세요.
  5. 5액세스 토큰을 Bearer 토큰으로 전송하세요. 만료되면 갱신하고 로그아웃할 때 취소하세요.

보안 속성

  • 인증 코드는 한 번만 사용할 수 있으며 10분 후 만료됩니다.
  • 액세스 및 갱신 토큰은 서버에서 해시로 저장되며 정식 MCP 리소스 audience에 바인딩됩니다.
  • 리디렉션 URI는 HTTPS를 사용해야 합니다. 로컬 클라이언트의 루프백 HTTP와 Cursor의 cursor:// MCP 콜백은 예외입니다.
  • MCP 핸들러는 인증된 사용자 ID별로 모든 비공개 리소스를 격리합니다.