OAuth 2.1을 사용하여 MCP 서버 추가
에 OAuth 2.1 AI 에이전트 스튜디오이 있는 MCP 서버를 추가합니다.
시작하기 전에
필요한 역할: sn_mcp_client.admin
이 태스크 정보
OAuth는 MCP 서버를 인증하는 일반적인 방법입니다. MCP 서버에서 지원하는 경우 인증 방법에서 OAuth 2.1을 선택합니다.
프로시저
- 다음으로 이동 모두 > AI 에이전트 스튜디오 > 설정.
- MCP 서버 관리로 이동하여 새로 만들기를 선택합니다.
-
양식에서 필드를 채웁니다.
표 1. MCP 서버 추가 필드 설명 이름 MCP 서버의 이름입니다. 인증 유형 MCP 서버를 추가할 인증 유형입니다. OAuth 2.1을 선택합니다.
MCP 서버 URL MCP 서버의 웹 주소입니다. -
다음을 선택합니다.
양식은 등록 세부 정보로 확장됩니다.
-
양식의 필드에 내용을 입력합니다.
동적 클라이언트 등록은 양식 필드의 데이터를 자동으로 채웁니다.주:MCP 서버에서 동적 등록을 지원하는 경우 권한 부여 유형 및 기타 입력을 확인하라는 메시지가 표시됩니다. 동적 등록이 지원되지 않는 경우 6단계에서 수동 등록 방법을 계속 진행할 수 있습니다.
표 2. 동적 클라이언트 등록 필드 설명 부여 유형 보호된 자원에 액세스하기 위한 액세스 토큰을 가져오려는 방법입니다. 다음 두 옵션 중 하나가 자동으로 채워진 데이터에 사용됩니다.- 인증 코드: 애플리케이션 또는 자원에 대한 액세스 권한을 부여하는 데 사용되는 시스템 생성 코드입니다.
- 클라이언트 자격 증명: 애플리케이션에 직접 액세스할 수 있도록 관리자가 제공하는 액세스 토큰입니다.
토큰 인증 방법 자원에 액세스할 수 있도록 부여된 고유 토큰입니다. 드롭다운 목록에서 값을 선택합니다.
인증 범위 애플리케이션에 대한 특정 권한을 정의합니다. 주:인증 범위는 쉼표로 구분된 값이어야 합니다.클라이언트 등록을 위한 인증 토큰 클라이언트의 ID를 확인하고 인증 토큰으로 등록할 수 있는 권한을 부여하는 데 사용되는 인증 토큰입니다. 다음 값을 제공합니다.- 헤더: 권한 부여 헤더입니다.
- 값: 인증 암호.
인증 URL 직접 권한을 부여할 서버의 웹 주소입니다. 토큰 URL 토큰이 포함된 웹 주소입니다. 토큰 해지 URL 이전에 제공된 토큰을 해지할 웹 주소입니다. 동적 클라이언트 등록이 있는 MCP 서버는 간단한 연결 및 자격 증명 별칭으로 추가됩니다. -
양식의 필드에 내용을 입력합니다.
주:
- MCP 서버가 동적 클라이언트 등록을 지원하지 않는 경우 MCP 서버에서 AI 에이전트용 OAuth 클라이언트를 수동으로 등록하고 에서 해당 클라이언트 세부 정보를 AI 에이전트 스튜디오업데이트할 수 있습니다.
- 수동 클라이언트 등록은 양식 필드의 데이터를 자동으로 채우지 않으며 수동으로 제공해야 합니다.
표 3. 수동 등록 필드 설명 부여 유형 보호된 자원에 액세스하기 위한 액세스 토큰을 가져오려는 방법입니다. 다음 두 옵션 중 하나를 선택할 수 있습니다.- 인증 코드: 애플리케이션 또는 자원에 대한 액세스를 격자화하는 데 사용되는 시스템 생성 코드입니다.
- 클라이언트 자격 증명: 애플리케이션에 직접 액세스할 수 있도록 관리자가 제공하는 액세스 토큰입니다.
토큰 인증 방법 자원에 액세스할 수 있도록 부여된 고유 토큰입니다. 드롭다운 목록에서 값을 선택합니다.
클라이언트 ID 인증 및 권한 부여를 위한 고유 ID입니다. 클라이언트 비밀 인증에 사용되는 고유한 자격 증명입니다. 인증 범위 애플리케이션에 대한 특정 권한을 정의합니다. 주:인증 범위는 쉼표로 구분된 값이어야 합니다.클라이언트 등록을 위한 인증 토큰 클라이언트의 ID를 확인하고 인증 토큰으로 등록할 수 있는 권한을 부여하는 데 사용되는 인증 토큰입니다. 다음 값을 제공합니다.- 헤더: 권한 부여 헤더입니다.
- 값: 인증 암호.
인증 URL 직접 권한을 부여할 서버의 웹 주소입니다. 토큰 URL 토큰이 포함된 웹 주소입니다. 토큰 해지 URL 이전에 제공된 토큰을 해지할 웹 주소입니다. -
추가를 선택합니다.
추가를 선택하면 AI 에이전트에 MCP 도구를 추가하기 위해 인증해야 하는 MCP 서버 기록으로 이동합니다.
-
인증을 선택합니다.
인증을 선택하면 작업 공간을 선택하고 인증을 선택해야 하는 타사 인증 페이지로 이동합니다.주:OAuth 액세스 또는 새로 고침 토큰을 사용할 수 없는 경우 MCP 서버 기록에서 OAuth 구성을 인증하여 AI 에이전트에 도구로 추가해야 합니다.