MCP 연동 관리

MCP 연동 관리는 조직 내에서 사용하는 MCP 서버를 관리할 수 있는 기능입니다.

MCP 연동 종류

QueryPie AIP에서는 조직 내의 MCP 연동을 크게 두 종류로 구분합니다.

• 기본 제공 MCP 연동(Built-in MCP Integrations): QueryPie AIP에서 기본적으로 제공하는 MCP 연동
• 구성형 MCP 연동(Configured MCP Integrations): 조직 관리자가 미리 설정하여 사용자에게 제공하는 MCP 연동

기본 제공 MCP 연동 관리

관리자 콘솔에서는 기본 제공 MCP 연동의 목록을 확인하고 관리할 수 있습니다. 기본 제공 MCP 연동에 대해 수행할 수 있는 관리 작업은 다음과 같습니다.

• MCP 연동 활성화 여부 선택: 연동을 비활성화하는 경우 기존에 설치된 연동이 모두 비활성화 되며, 설치 가능한 연동 목록에서 제거됩니다.
• MCP Access Control: 활성화된 연동에 대해, 조직 내 사용자에게 허용할 툴 목록을 설정할 수 있습니다.
• 도구 목록 불러오기: Custom Remote MCP처럼 서버에서 도구 목록을 동적으로 제공하는 연동은 상세 화면에서 도구 목록을 가져올 수 있습니다.

구성형 MCP 연동 관리

관리자 콘솔에서는 구성형 MCP 연동의 목록을 확인하고 관리할 수 있습니다. 구성형 MCP 연동에 대해 수행할 수 있는 관리 작업은 다음과 같습니다.

• 구성형 MCP 연동 생성: 구성형 MCP 연동을 생성할 수 있습니다.
  • 지원 대상: 다음 종류의 MCP 연동 타입을 지원합니다.
    • Custom Remote MCP
    • n8n Chat
    • n8n Webhook
    • Dify API Access
    • Backlog
    • Redis
    • Salesforce - Custom
    • Zendesk
    • MySQL
    • MariaDB
    • PostgreSQL
    • SQL Server
    • Oracle Database
    • ClickHouse
    • Snowflake
  • 구성형 MCP 연동 생성 시, 연동 타입에 따라 필요한 설정 정보를 입력해야 합니다.
    • 인증정보를 미리 입력해두어, 사용자가 직접 인증 정보를 입력하지 않아도 연동을 설치하고 사용하게 할 수 있습니다.
• MCP 연동 활성화 여부 선택: 연동을 비활성화하는 경우 기존에 설치된 연동이 모두 비활성화 되며, 설치 가능한 연동 목록에서 제거됩니다.
• MCP Access Control: 활성화된 연동에 대해, 조직 내 사용자에게 허용할 툴 목록을 설정할 수 있습니다.
• Client ID / Secret 재사용: OAuth 기반 구성형 연동을 수정하거나 인증을 다시 진행할 때 새 Client ID / Secret을 입력하지 않으면 기존에 저장된 Client 정보를 유지합니다.

MCP 연동 활성화/비활성화

MCP 연동은 기본적으로 활성화되어 있으며, 활성화된 연동은 사용자가 Integration 메뉴에서 자유롭게 설치할 수 있습니다. MCP 연동을 비활성화하는 경우 기존에 설치된 연동이 모두 비활성화 되며, 설치 가능한 연동 목록에서 제거됩니다. 기존에 설치된 연동을 MCP Preset에 추가해 두었더라도, 툴을 호출할 수 없게 됩니다. MCP 연동을 다시 활성화하면 기존의 사용자 설정은 원래대로 복원됩니다.

MCP 연동 목록에서 활성화 여부 변경하기

1. MCP 연동 관리 페이지 내의 목록 테이블에서 활성화 여부를 변경하고자 하는 MCP 연동을 찾습니다.
2. 우측 더보기 버튼을 클릭하면 드롭다운 메뉴가 표시됩니다.
3. 메뉴 버튼을 클릭하면 활성화 상태가 변경됩니다.

MCP 상세 페이지에서 활성화 여부 변경하기

1. MCP 연동 관리 페이지에서 항목을 클릭하면 상세 페이지로 이동합니다.
2. 헤더의 우측 더보기 버튼을 클릭하면 드롭다운 메뉴가 표시됩니다.
3. 메뉴 버튼을 클릭하면 활성화 상태가 변경됩니다.

MCP Access Control

MCP Access Control은 활성화된 MCP 연동에 대해, 조직 내 사용자에게 허용할 툴 목록을 설정할 수 있는 기능입니다.

도구 목록 불러오기

Custom Remote MCP와 같이 서버에서 도구 목록을 동적으로 제공하는 연동은 MCP 상세 화면에서 도구 목록을 가져올 수 있습니다.

다음과 같은 경우 도구 목록 불러오기를 사용합니다.

• MCP 서버에 새로운 도구가 추가된 경우
• MCP 서버에서 기존 도구 이름이나 설명이 변경된 경우
• 연동 생성 당시 도구 목록을 불러오지 못했거나 일부만 표시된 경우

Client ID / Secret 재사용

OAuth 기반 구성형 MCP 연동은 외부 서비스의 OAuth App에서 발급한 Client ID와 Client Secret을 사용해 인증을 진행합니다. 관리자가 MCP를 사전 구성형으로 등록할 때 입력한 Credential을 저장하면, 사용자는 별도 Client 정보 입력 없이 관리자가 구성한 인증정보를 그대로 사용할 수 있습니다.

1. 관리자가 사전 구성형 MCP를 등록할 때 Credential을 입력한 뒤 인증하면, 이 인증정보를 저장할 것인지 확인하는 팝업이 표시됩니다.
2. 저장을 선택하면 해당 인증정보가 저장되고, Authentication 설정은 OAuth / 관리자 인증으로 변경됩니다.
3. 사용자가 각자 인증하도록 변경하려면 관리자 인증 옆의 설정 버튼을 눌러 저장된 인증정보를 삭제하고 사용자 인증으로 변경합니다.

이 기능을 사용하면 여러 사용자가 동일한 OAuth App을 사용해야 하는 경우에도 사용자가 Client ID나 Client Secret을 직접 입력하지 않아도 됩니다. 반대로 사용자별 계정 권한으로 연결해야 하는 연동은 사용자 인증으로 전환하여 각 사용자가 직접 OAuth 인증을 진행하게 할 수 있습니다.