OCI 데이터베이스 서비스에 대한 관리형 MCP 서버

MCP(Managed Model Context Protocol) 서버를 사용하면 MCP와 호환되는 AI 에이전트 및 애플리케이션이 OCI 데이터베이스 리소스에 대해 지원되는 정보에 액세스할 수 있습니다.

관리형 MCP 서버의 작동 방식

관리형 MCP 서버는 MCP 호환 클라이언트와 지원되는 OCI 데이터베이스 제어 플레인 API 간의 인터페이스를 제공합니다.

MCP 서버를 만들 때는 서버를 ID 도메인과 연결하고 적용 가능한 데이터베이스 서비스 및 리소스 범주를 선택합니다. OCI는 서버에 대한 MCP 끝점 및 MCP 클라이언트 구성을 생성합니다. 이 정보를 사용하여 호환되는 MCP 클라이언트를 구성할 수 있습니다.

MCP 호환 AI 에이전트 또는 클라이언트를 통해 자연어 요청을 제출하면 클라이언트는 Streamable HTTP를 통해 MCP를 사용하여 관리되는 MCP 서버에 연결됩니다. 관리형 MCP 서버는 클라이언트를 인증하고 OCI IAM(Identity and Access Management) 정책을 기반으로 액세스 권한을 부여합니다. 요청 권한이 부여된 경우 MCP 서버는 지원되는 해당 OCI 데이터베이스 작업을 호출하고 요청된 데이터베이스 리소스에 대한 정보를 클라이언트에 반환합니다.

예를 들어, MCP 호환 AI 에이전트에 구획의 데이터베이스에 대한 정보를 검색하도록 요청할 수 있습니다. 에이전트는 적절한 MCP 도구를 식별하고, 도구를 호출하고, OCI Database Services가 반환한 정보를 사용하여 요청에 응답할 수 있습니다.

MCP 서버를 사용하면 OCI 데이터베이스 리소스에 액세스하는 데 필요한 권한이 변경되지 않습니다. 인증된 ID는 해당 IAM 정책에서 허용하는 리소스 및 작업에만 액세스할 수 있습니다.

MCP 서버

MCP 서버는 MCP 호환 클라이언트에 원격 끝점을 제공하는 OCI 리소스입니다.

OCI Database Services는 Oracle Base Database Service, Oracle Exadata Database Service on Cloud@Customer, Oracle Exadata Database Service on Dedicated Infrastructure, Oracle Exadata Database Service on Exascale Infrastructure를 위한 관리형 MCP 서버를 지원합니다. 여러 데이터베이스 서비스에 대해 테넌시에 여러 MCP 서버를 생성할 수 있습니다.

MCP 서버 구성에는 연관된 ID 도메인, 데이터베이스 서비스, 리소스 범주 및 태그와 같은 정보가 포함됩니다.

OCI는 각 MCP 서버에 대해 고유한 MCP 엔드포인트를 제공합니다. OCI는 또한 호환되는 MCP 클라이언트를 구성하는 데 사용할 수 있는 MCP JSON 구성을 제공합니다.

MCP 서버를 사용 또는 사용 안함으로 설정할 수 있습니다. MCP 서버를 사용 안함으로 설정하면 클라이언트가 구성을 삭제하지 않고 서버에 액세스할 수 없습니다. 더 이상 MCP 서버가 필요하지 않으면 삭제할 수 있습니다.

MCP 도구

MCP 도구는 MCP 호환 클라이언트가 MCP 서버를 통해 검색 및 호출할 수 있는 OCI 데이터베이스 작업을 지원합니다.

MCP 서버는 지원되는 읽기 전용 제어 플레인 작업을 MCP 도구로 사용할 수 있도록 합니다. AI 에이전트는 요청에 적합한 사용 가능한 도구를 결정하고 필요한 매개변수를 사용하여 해당 도구를 호출할 수 있습니다.

MCP 서버를 통해 사용할 수 있는 도구는 서버에 대해 구성된 데이터베이스 서비스 및 리소스 범주에 따라 달라집니다.

지원되는 리소스 범주는 다음과 같습니다.

• 데이터베이스 인프라
• 가상 머신
• 데이터베이스 백업
• Data Guard
• 관련 데이터베이스 운영 메타데이터

MCP 도구의 가용성은 해당 OCI 데이터베이스 작업을 사용할 수 있는 권한을 부여하지 않습니다. OCI IAM 정책은 인증된 ID가 요청된 리소스에 액세스할 수 있는지 여부를 결정합니다.

MCP 끝점 및 클라이언트 구성

각 MCP 서버에는 호환 가능한 클라이언트가 Streamable HTTP를 사용하여 서버에 연결하는 데 사용하는 MCP 끝점이 있습니다.

MCP 서버를 만든 후 MCP 서버 세부 정보에서 생성된 끝점을 가져올 수 있습니다. 호환되는 MCP 클라이언트를 구성하는 데 필요한 MCP JSON 구성을 얻을 수도 있습니다.

클라이언트가 구성되고 인증된 후 끝점에 연결하고 서버를 통해 사용 가능한 MCP 도구를 검색할 수 있습니다.

클라이언트에 MCP 서버 구성을 추가하는 방법은 사용하는 MCP 클라이언트에 따라 달라집니다.

인증

MCP 서버는 OCI Identity를 통해 OAuth 기반 인증을 사용합니다. MCP 서버를 만들 때 ID 도메인과 연관시킵니다.

MCP 서버에 액세스하기 위해 MCP 클라이언트는 연관된 ID 도메인으로 인증되고 OAuth 액세스 토큰을 얻습니다. 클라이언트는 MCP 서버에 연결할 때 액세스 토큰을 사용합니다. MCP 서버는 클라이언트가 지원되는 MCP 도구에 액세스할 수 있도록 허용하기 전에 토큰을 검증합니다.

권한 부여

OCI IAM은 MCP 서버를 통해 액세스되는 OCI 데이터베이스 리소스에 대한 액세스를 제어합니다.

IAM 정책은 사용자, 그룹, 테넌시, 구획 및 기타 지원되는 OCI IAM 구성을 기반으로 액세스를 제어할 수 있습니다. 인증된 ID의 권한에 따라 ID가 MCP 도구를 통해 액세스할 수 있는 리소스가 결정됩니다.

MCP 서버는 추가 권한을 제공하거나 기존 IAM 정책을 우회하지 않습니다. 예를 들어, ID에 한 컴파트먼트의 데이터베이스를 볼 수 있는 권한이 있지만 다른 컴파트먼트는 볼 수 없는 경우 ID는 ID가 볼 수 있는 권한이 부여된 데이터베이스에 대해서만 정보를 검색할 수 있습니다. MCP 서버를 통한 연결은 해당 액세스를 다른 구획의 데이터베이스로 확장하지 않습니다.

따라서 MCP 서버를 통한 액세스에는 MCP 서버 구성과 인증된 ID에 지정된 권한이 모두 적용됩니다.

읽기 전용 작업

관리형 MCP 서버는 승인된 읽기 전용 OCI 데이터베이스 제어 플레인 작업을 지원합니다.

MCP 호환 AI 에이전트는 이러한 작업을 사용하여 데이터베이스 리소스 및 해당 작동 상태에 대해 지원되는 정보를 검색할 수 있습니다. OCI 데이터베이스 리소스를 생성, 업데이트 또는 삭제하는 작업은 MCP 서버를 통해 사용할 수 없습니다.

예를 들어, 권한이 부여된 에이전트는 해당하는 읽기 전용 MCP 도구를 사용할 수 있을 때 데이터베이스, 데이터베이스 기반 구조, 백업 또는 Data Guard 구성에 대한 정보를 검색할 수 있습니다. 에이전트가 MCP 서버를 사용하여 해당 리소스를 수정할 수 없습니다.

읽기 전용 제한 사항은 관리되는 MCP 서버를 통해 노출된 작업에 적용되며 다른 OCI 인터페이스를 통해 사용 가능한 작업은 변경되지 않습니다.

다중 MCP 서버 사용

여러 MCP 서버를 만들어 다양한 액세스 및 구성 요구 사항을 지원할 수 있습니다.

예를 들어, 서로 다른 데이터베이스 서비스에 대해 별도의 MCP 서버를 구성하거나 서로 다른 서버를 통해 다른 리소스 범주를 노출할 수 있습니다. 각 MCP 서버에는 고유한 구성 및 끝점이 있습니다.

인증된 ID의 권한은 클라이언트가 사용하는 MCP 서버와 독립적으로 계속 적용됩니다.

MCP 서버 상태

MCP 서버는 활성, 비활성 또는 삭제할 수 있습니다.

• MCP 서버가 사용으로 설정된 경우 클라이언트는 MCP 끝점에 연결하고 인증 및 권한 부여에 따라 지원되는 MCP 도구를 사용할 수 있습니다.
• MCP 서버가 비활성 상태인 경우 클라이언트는 MCP 끝점에 연결하거나 지원되는 MCP 도구를 사용할 수 없습니다. MCP 서버 구성은 보존되며 액세스가 필요할 때 서버를 다시 사용으로 설정할 수 있습니다.
• MCP 서버가 삭제되면 클라이언트는 더 이상 MCP 끝점에 연결하거나 지원되는 MCP 도구를 사용할 수 없으며 MCP 서버 구성은 영구적으로 제거됩니다.

보안 지침

관리 MCP 서버를 사용할 때는 다음을 고려하십시오.

• IAM 정책을 사용하여 MCP를 통해 OCI 데이터베이스 리소스에 액세스하는 사용자 및 그룹에 필요한 권한만 부여합니다.
• 서로 다른 서비스 또는 조직 요구 사항에 서로 다른 구성이 필요한 경우 별도의 MCP 서버를 사용합니다.
• MCP 액세스가 일시적으로 필요하지 않은 경우 MCP 서버를 사용 안함으로 설정합니다.
• 더 이상 필요하지 않은 MCP 서버를 삭제합니다.
• MCP 호환 클라이언트를 사용하는 ID에 지정된 권한을 검토합니다.

관리형 MCP 서버는 지원되는 OCI 데이터베이스 제어 플레인 작업에 다른 인터페이스를 제공합니다. 기존 OCI 인증, 권한 부여, 테넌시 및 컴파트먼트 경계는 해당 작업이 MCP를 통해 액세스될 때 계속 적용됩니다.

MCP Server 생성

MCP 서버를 생성하여 MCP 호환 클라이언트에 지원되는 OCI 데이터베이스 서비스에 대한 액세스 권한을 제공합니다.

기본적으로 MCP 서버는 지원되는 모든 데이터베이스 서비스에 대해 구성됩니다. 생성 시 서버를 특정 데이터베이스 서비스로 제한할 수 있습니다.

1. 탐색 메뉴를 엽니다. Oracle AI Database에서 기본 데이터베이스 서비스를 선택한 다음 AI 기능을 선택합니다.
2. View MCP Servers(MCP 서버 보기)를 선택하거나 MCP Servers(MCP 서버) 탭을 선택합니다.
3. Create MCP server(MCP 서버 만들기)를 선택합니다.
4. 다음 정보를 지정합니다.
   • Name(이름): MCP 서버의 이름을 입력합니다.
   • 구획: MCP 서버를 생성할 컴파트먼트를 선택합니다.
   • 도메인의 컴파트먼트: ID 도메인을 포함하는 컴파트먼트를 선택합니다.
   • 도메인: MCP 서버와 연관시킬 ID 도메인을 선택합니다.
   • 서비스: MCP 서버가 액세스할 수 있는 데이터베이스 서비스를 선택합니다. 지원되는 모든 서비스는 기본적으로 선택됩니다. 서비스 범위를 제한하려면 다음 중 하나 이상을 선택하십시오.
     • Oracle Base Database Service
     • Oracle Exadata Database Service on Cloud@Customer
     • Oracle Exadata Database Service on Dedicated Infrastructure
     • 엑사스케일 인프라의 Oracle Exadata Database Service
   • 태그: 선택적으로 MCP 서버에 태그를 추가합니다.
5. 생성을 선택합니다.

MCP 서버가 생성된 후 MCP 서버 페이지에 나타납니다.

MCP 서버 목록 보기

컴파트먼트에서 액세스할 수 있는 MCP 서버를 확인합니다.

1. 탐색 메뉴를 엽니다. Oracle AI Database에서 기본 데이터베이스 서비스를 선택한 다음 AI 기능을 선택합니다.
2. View MCP Servers(MCP 서버 보기)를 선택하거나 MCP Servers(MCP 서버) 탭을 선택합니다.

MCP 서버 페이지에는 액세스 권한이 있는 MCP 서버가 다음 정보와 함께 표시됩니다.

• Name(이름): MCP 서버의 이름입니다.
• 상태: MCP 서버의 현재 상태(활성 또는 비활성)입니다.
• 서비스: MCP 서버와 연관된 데이터베이스 서비스입니다.
• 생성됨: MCP 서버가 생성된 날짜 및 시간입니다.

MCP 서버의 세부정보 보기

MCP 서버의 구성, 끝점 및 기타 세부정보를 확인합니다.

1. 탐색 메뉴를 엽니다. Oracle AI Database에서 기본 데이터베이스 서비스를 선택한 다음 AI 기능을 선택합니다.
2. View MCP Servers(MCP 서버 보기)를 선택하거나 MCP Servers(MCP 서버) 탭을 선택합니다.
3. MCP 서버 목록에서 다음 방법 중 하나를 사용하여 MCP 서버의 세부정보를 확인합니다.
   • MCP 서버의 이름을 선택합니다.
   • MCP 서버에 대한 작업 메뉴(점 3개)를 선택한 다음 세부정보 보기를 선택합니다.

   MCP 서버 세부 정보 페이지에는 선택한 MCP 서버의 끝점 및 구성 세부 정보가 표시됩니다.

4. MCP 끝점을 복사하려면 끝점 복사를 선택합니다.
5. MCP 서버와 연관된 태그를 보거나 관리하려면 태그 탭을 선택합니다.

MCP 서버 사용 또는 사용 안함으로 설정

클라이언트 액세스를 제어하기 위해 MCP 서버를 사용 또는 사용 안함으로 설정합니다. MCP 서버를 사용 안함으로 설정하면 클라이언트가 구성을 삭제하지 않고 서버에 액세스할 수 없습니다.

1. 탐색 메뉴를 엽니다. Oracle AI Database에서 기본 데이터베이스 서비스를 선택한 다음 AI 기능을 선택합니다.
2. MCP Servers(MCP 서버) 탭을 선택합니다.
3. MCP 서버 목록에서 다음 방법 중 하나를 사용합니다.
   • 사용 또는 사용 안함으로 설정할 MCP 서버에 대한 작업 메뉴(점 3개)를 선택한 다음 해당하는 경우 사용 또는 사용 안함을 선택합니다.
   • 세부 정보 페이지를 열 MCP 서버의 이름을 선택한 다음 해당하는 경우 사용 또는 사용 안함을 선택합니다.
4. 확인 대화 상자에서 Enable(사용) 또는 Disable(사용 안함)을 선택하여 작업을 확인합니다.

선택한 작업에 따라 MCP 서버의 상태가 Active 또는 Inactive로 변경됩니다.

MCP 서버 상태:

MCP 서버는 다음 상태 중 하나를 가질 수 있습니다.

• Active(활성): MCP 서버가 사용으로 설정됩니다. 인증되고 인증된 MCP 클라이언트는 서버 끝점에 연결하고 지원되는 MCP 도구를 사용할 수 있습니다.
• 비활성: MCP 서버가 비활성 상태입니다. MCP 클라이언트는 서버 끝점에 액세스하거나 해당 MCP 도구를 사용할 수 없습니다. 서버 구성은 유지되며 다시 사용으로 설정할 수 있습니다.

구성을 변경하지 않고 MCP 서버를 사용 또는 사용 안함으로 설정할 수 있습니다. 비활성 MCP 서버를 사용으로 설정하면 해당 상태가 Active로 변경됩니다. 활성 MCP 서버를 사용 안함으로 설정하면 해당 상태가 비활성으로 변경됩니다.

MCP 서버를 다른 컴파트먼트로 이동

MCP 서버를 현재 컴파트먼트에서 다른 컴파트먼트로 이동합니다.

1. 탐색 메뉴를 엽니다. Oracle AI Database에서 기본 데이터베이스 서비스를 선택한 다음 AI 기능을 선택합니다.
2. MCP Servers(MCP 서버) 탭을 선택합니다.
3. MCP 서버 목록에서 다음 방법 중 하나를 사용합니다.
   • 이동할 MCP 서버에 대한 작업 메뉴(점 3개)를 선택한 다음 리소스 이동을 선택합니다.
   • 세부 정보 페이지를 열 MCP 서버의 이름을 선택하고 작업 메뉴를 선택한 다음 리소스 이동을 선택합니다.
4. [리소스 이동] 페이지에서 대상 컴파트먼트를 선택한 다음 리소스 이동을 선택합니다.

MCP 서버가 선택된 컴파트먼트로 이동됩니다.

MCP 서버 삭제

현재 컴파트먼트에서 MCP 서버를 삭제합니다.

1. 탐색 메뉴를 엽니다. Oracle AI Database에서 기본 데이터베이스 서비스를 선택한 다음 AI 기능을 선택합니다.
2. MCP Servers(MCP 서버) 탭을 선택합니다.
3. MCP 서버 목록에서 다음 방법 중 하나를 사용합니다.
   • 삭제할 MCP 서버에 대한 작업 메뉴(점 3개)를 선택한 다음 삭제를 선택합니다.
   • 세부 정보 페이지를 열 MCP 서버의 이름을 선택하고 작업 메뉴를 선택한 다음 삭제를 선택합니다.
4. 확인 대화 상자에서 삭제를 선택하여 작업을 확인합니다.

MCP 서버가 삭제되고 MCP 서버 페이지에서 더 이상 사용할 수 없습니다. MCP 클라이언트는 더 이상 끝점을 통해 서버에 액세스할 수 없습니다.

MCP 서버 세부 정보 편집

MCP 서버를 편집하여 이름 또는 연관된 데이터베이스 서비스를 업데이트합니다.

1. 탐색 메뉴를 엽니다. Oracle AI Database에서 기본 데이터베이스 서비스를 선택한 다음 AI 기능을 선택합니다.
2. MCP Servers(MCP 서버) 탭을 선택합니다.
3. MCP 서버 목록에서 MCP 서버의 이름을 선택하여 세부정보 페이지를 열고 작업 메뉴를 선택한 다음 편집을 선택합니다.
4. [MCP 서버 편집] 페이지에서 필요에 따라 다음 정보를 업데이트합니다.
   • Name(이름): MCP 서버의 이름을 편집합니다.
   • 서비스: MCP 서버가 액세스할 수 있는 데이터베이스 서비스를 선택합니다.
5. 업데이트를 선택합니다.