메인 콘텐츠로 건너뛰기
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를 반환합니다.

오류