Skip to main content
POST
퍼블릭 클라이언트의 S256 인증 코드 또는 현재 갱신 토큰을 사용하여 유효 기간이 짧은 MCP 액세스 토큰을 발급받습니다.

인증

HTTP 클라이언트 인증을 사용하지 않습니다. URL 인코딩된 본문에 client_id를 보내세요. 모든 Authorization 헤더, client_secret 또는 client_assertion은 거부됩니다.

요청 본문

요청 예제

이 경로에 명시된 인코딩 및 인증 방식을 따르세요. 액션 API의 응답 구조와 멱등성 규칙은 액션 호출에만 적용됩니다.

응답

불투명한 Bearer 액세스 토큰, 초 단위의 남은 유효 기간, 부여된 범위 및 클라이언트가 refresh_token을 등록한 경우 갱신 토큰입니다. expires_in은 최대 900이며 권한 만료가 가까워지면 더 작을 수 있습니다.
HTTP 200

응답 헤더

작업 참고 사항

  • 인식되는 스칼라 매개변수는 ASCII 제어 문자나 DEL이 없는 비어 있지 않은 문자열로 한 번만 제공해야 합니다. 반복된 쿼리/폼 필드는 배열로 디코딩되며, 스칼라로 읽을 때 거부됩니다.
  • 필드별 curl —data-urlencode와 같은 URL 인코딩된 폼 데이터를 사용하세요. JSON 토큰 본문은 invalid_request로 거부됩니다.
  • 두 부여 유형 모두 resource 대상 식별자가 필요하며, 코드 또는 갱신 토큰을 발급한 환경의 MCP URL과 정확히 일치해야 합니다.
  • 인증 코드 교환에는 원래 client_id, 정확한 redirect_uri 및 일치하는 S256 code_verifier가 필요합니다. 코드는 2분 후에 만료되며 한 번만 사용할 수 있습니다.
  • 토큰 엔드포인트는 Basic과 Bearer를 포함해 전달된 모든 Authorization 헤더와 본문의 client_secret 또는 client_assertion 필드를 거부합니다.
  • 액세스 토큰의 유효 기간은 최대 15분입니다. refresh_token이 등록된 경우 연결과 갱신 토큰 계열은 사용자 승인 후 30일에 만료됩니다. 토큰을 교체해도 이 기한은 연장되지 않습니다.
  • refresh_token 반환 여부는 등록된 권한 부여 유형에 따라 결정됩니다. 인증 요청에 offline_access를 포함했는지 여부와는 관계없습니다. 새로 고침 토큰이 반환될 때마다 반환되는 scope에 offline_access가 추가됩니다.
  • 갱신하려면 grant_type=refresh_token을 client_id, 현재 refresh_token, resource 및 선택적으로 축소한 scope와 함께 보내세요. 저장된 갱신 토큰을 새 값으로 원자적으로 교체하세요.
  • 사용된 인증 코드 또는 교체된 새로 고침 토큰을 재사용하면 모든 액세스 토큰을 포함한 전체 연결이 해지됩니다. 동일한 코드나 새로 고침 토큰을 동시에 교환하지 마세요.
  • 갱신 요청은 권한을 추가하지 않습니다. scope를 명시하면 요청한 제품 및 신원 권한만 유지됩니다. offline_access는 생략한 제품 권한을 유지하지 않습니다.
  • 토큰은 권한을 부여한 사용자, 클라이언트, 리소스 대상, 현재 팀 소유권 및 유효한 유료 접근 권한에 연결됩니다. 권한 부여가 철회되거나 소유권이 변경되면 다시 연결해야 합니다.
  • 공개 토큰 요청 한도는 클라이언트 IP당 분당 60회이며 워커 간에 공유됩니다. URL 인코딩된 본문은 32 KiB로 제한됩니다.
  • OAuth 실패 시 error와 error_description이 반환됩니다. 본문 파서의 실패는 이보다 앞서 연동 파서의 오류 형식으로 반환될 수 있습니다.
  • openid와 email은 제품 권한과 별개인 신원 권한이며, 지원이 명시된 경우에만 허용됩니다. email에는 openid가 필요합니다. 최초 권한 부여 시 신원 범위만 요청하면 동의 화면에 표시되는 기본 제품 권한이 사용됩니다.
  • 동적 등록에서 반환한 client_id 또는 클라이언트 메타데이터 문서의 정확한 공개 HTTPS URL입니다.
  • openid가 부여되면 인증 코드 교환 시 RS256으로 서명된 id_token도 반환됩니다. 서명, 발급자, 대상, 만료 시간과 제공된 nonce를 검증하세요. 부여된 신원 범위는 토큰 응답의 scope에 포함됩니다. 갱신 응답은 새 id_token을 발급하지 않습니다.
  • OpenID Connect를 사용할 수 없게 되면 scope 없는 갱신은 제품 권한을 유지하고 신원 권한을 제거합니다. 사용할 수 없는 신원 범위를 명시적으로 요청하면 invalid_scope가 반환됩니다.
  • 계정이 삭제되거나 비활성화된 경우 토큰 엔드포인트는 HTTP 400과 invalid_grant를 반환합니다.

오류