OAuth 2.1을 사용하여 MCP 서버 추가

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 3분
  • 에 OAuth 2.1 AI 에이전트 스튜디오이 있는 MCP 서버를 추가합니다.

    시작하기 전에

    필요한 역할: sn_mcp_client.admin

    이 태스크 정보

    OAuth는 MCP 서버를 인증하는 일반적인 방법입니다. MCP 서버에서 지원하는 경우 인증 방법에서 OAuth 2.1을 선택합니다.

    프로시저

    1. 다음으로 이동 모두 > AI 에이전트 스튜디오 > 설정.
    2. MCP 서버 관리로 이동하여 새로 만들기를 선택합니다.
    3. 양식에서 필드를 채웁니다.
      표 1. MCP 서버 추가
      필드 설명
      이름 MCP 서버의 이름입니다.
      인증 유형 MCP 서버를 추가할 인증 유형입니다.

      OAuth 2.1을 선택합니다.

      MCP 서버 URL MCP 서버의 웹 주소입니다.

      OAuth 2.1을 사용하여 MCP 서버를 AI 에이전트 스튜디오 추가합니다.

    4. 다음을 선택합니다.
      양식은 등록 세부 정보로 확장됩니다.
    5. 양식의 필드에 내용을 입력합니다.
      동적 클라이언트 등록은 양식 필드의 데이터를 자동으로 채웁니다.
      주:
      MCP 서버에서 동적 등록을 지원하는 경우 권한 부여 유형 및 기타 입력을 확인하라는 메시지가 표시됩니다. 동적 등록이 지원되지 않는 경우 6단계에서 수동 등록 방법을 계속 진행할 수 있습니다.
      표 2. 동적 클라이언트 등록
      필드 설명
      부여 유형 보호된 자원에 액세스하기 위한 액세스 토큰을 가져오려는 방법입니다.
      다음 두 옵션 중 하나가 자동으로 채워진 데이터에 사용됩니다.
      • 인증 코드: 애플리케이션 또는 자원에 대한 액세스 권한을 부여하는 데 사용되는 시스템 생성 코드입니다.
      • 클라이언트 자격 증명: 애플리케이션에 직접 액세스할 수 있도록 관리자가 제공하는 액세스 토큰입니다.
      토큰 인증 방법 자원에 액세스할 수 있도록 부여된 고유 토큰입니다.

      드롭다운 목록에서 값을 선택합니다.

      인증 범위 애플리케이션에 대한 특정 권한을 정의합니다.
      주:
      인증 범위는 쉼표로 구분된 값이어야 합니다.
      클라이언트 등록을 위한 인증 토큰 클라이언트의 ID를 확인하고 인증 토큰으로 등록할 수 있는 권한을 부여하는 데 사용되는 인증 토큰입니다.
      다음 값을 제공합니다.
      • 헤더: 권한 부여 헤더입니다.
      • : 인증 암호.
      인증 URL 직접 권한을 부여할 서버의 웹 주소입니다.
      토큰 URL 토큰이 포함된 웹 주소입니다.
      토큰 해지 URL 이전에 제공된 토큰을 해지할 웹 주소입니다.

      양식 필드에 자동으로 채워진 데이터가 있는 동적 클라이언트 등록 양식입니다.

      동적 클라이언트 등록이 있는 MCP 서버는 간단한 연결 및 자격 증명 별칭으로 추가됩니다.
    6. 양식의 필드에 내용을 입력합니다.
      주:
      • MCP 서버가 동적 클라이언트 등록을 지원하지 않는 경우 MCP 서버에서 AI 에이전트용 OAuth 클라이언트를 수동으로 등록하고 에서 해당 클라이언트 세부 정보를 AI 에이전트 스튜디오업데이트할 수 있습니다.
      • 수동 클라이언트 등록은 양식 필드의 데이터를 자동으로 채우지 않으며 수동으로 제공해야 합니다.
      표 3. 수동 등록
      필드 설명
      부여 유형 보호된 자원에 액세스하기 위한 액세스 토큰을 가져오려는 방법입니다.
      다음 두 옵션 중 하나를 선택할 수 있습니다.
      • 인증 코드: 애플리케이션 또는 자원에 대한 액세스를 격자화하는 데 사용되는 시스템 생성 코드입니다.
      • 클라이언트 자격 증명: 애플리케이션에 직접 액세스할 수 있도록 관리자가 제공하는 액세스 토큰입니다.
      토큰 인증 방법 자원에 액세스할 수 있도록 부여된 고유 토큰입니다.

      드롭다운 목록에서 값을 선택합니다.

      클라이언트 ID 인증 및 권한 부여를 위한 고유 ID입니다.
      클라이언트 비밀 인증에 사용되는 고유한 자격 증명입니다.
      인증 범위 애플리케이션에 대한 특정 권한을 정의합니다.
      주:
      인증 범위는 쉼표로 구분된 값이어야 합니다.
      클라이언트 등록을 위한 인증 토큰 클라이언트의 ID를 확인하고 인증 토큰으로 등록할 수 있는 권한을 부여하는 데 사용되는 인증 토큰입니다.
      다음 값을 제공합니다.
      • 헤더: 권한 부여 헤더입니다.
      • : 인증 암호.
      인증 URL 직접 권한을 부여할 서버의 웹 주소입니다.
      토큰 URL 토큰이 포함된 웹 주소입니다.
      토큰 해지 URL 이전에 제공된 토큰을 해지할 웹 주소입니다.

      OAuth MCP 서버에 대한 수동 클라이언트 등록.

    7. 추가를 선택합니다.
      추가를 선택하면 AI 에이전트에 MCP 도구를 추가하기 위해 인증해야 하는 MCP 서버 기록으로 이동합니다.
    8. 인증을 선택합니다.
      인증을 선택하면 작업 공간을 선택하고 인증을 선택해야 하는 타사 인증 페이지로 이동합니다.
      주:
      OAuth 액세스 또는 새로 고침 토큰을 사용할 수 없는 경우 MCP 서버 기록에서 OAuth 구성을 인증하여 AI 에이전트에 도구로 추가해야 합니다.