> For the complete documentation index, see [llms.txt](https://docs.panther.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.panther.com/ko/ai/mcp/mcp-integrations.md).

# MCP 통합 (Beta)

## 개요

{% hint style="info" %}
MCP 통합은 Panther 버전 1.120부터 오픈 베타로 제공되며, Panther AI를 사용하는 모든 고객에게 이용 가능합니다. 버그 보고와 기능 요청은 Panther 지원 팀에 공유해 주세요.
{% endhint %}

Panther AI는 MCP(Model Context Protocol) 통합을 지원하므로 외부 도구와 서비스를 Panther AI에 직접 연결할 수 있습니다. MCP 통합을 사용하면 Panther AI는 타사 원격 MCP 서버에서 제공하는 도구를 나열하고 사용할 수 있습니다. 예를 들어 Jira 이슈 생성, PagerDuty 인시던트 조회, Notion 페이지 검색 등을 Panther AI 채팅 경험 안에서 모두 수행할 수 있습니다.

오직 **원격** 다음을 사용하는 MCP 서버 **OAuth 2.0 인증** 및 [최신 공식 MCP 사양](https://modelcontextprotocol.io/) 을 준수하는 서버가 지원됩니다. 로컬 MCP 서버는 지원되지 않습니다.

{% hint style="warning" %}
누군가 MCP 서버를 추가, 업데이트 또는 제거하면 해당 변경 사항이 Panther AI에 반영되기까지 최대 10분이 걸릴 수 있습니다.
{% endhint %}

## 작동 방식

MCP 통합은 두 단계 워크플로를 따릅니다.

1. **관리자가 어떤 MCP 서버를 사용할 수 있는지 구성합니다.** 다음 권한이 있는 사용자가 **MCP 서버 관리** 권한으로 MCP 카탈로그에서 Panther에 MCP 서버를 추가하며, 여기에는 **사용자 지정 MCP 서버** 타일이 포함됩니다. 이 타일을 통해 URL로 MCP 호환 서버에 연결할 수 있습니다. 관리자는 언제든지 서버를 활성화하거나 비활성화할 수 있습니다.
2. **각 사용자는 개별적으로 연결합니다.** 다음 권한이 있는 사용자는 **MCP 서버 보기 및 연결** 권한으로 관리자가 구성한 서버를 볼 수 있습니다. 그런 다음 각 사용자는 타사 공급자와 OAuth 승인 흐름을 완료하여 사용하려는 서버에 연결합니다. 연결 후에는 사용 가능한 도구, 차단할 도구, 승인이 필요한 도구를 구성합니다.

이러한 분리 구조를 통해 관리자는 조직에 제공되는 통합을 제어하고, 개별 사용자는 자신의 연결과 도구 기본 설정을 제어할 수 있습니다.

## 권한

MCP 통합은 **Panther AI** 권한 그룹의 두 가지 권한을 사용합니다.

| 권한                 | 설명                                                                                         |
| ------------------ | ------------------------------------------------------------------------------------------ |
| **MCP 서버 관리**      | MCP 서버 통합의 생성, 수정, 삭제를 허용합니다. 여기에는 서버 검색, 생성, 업데이트, 삭제와 **MCP 서버 보기 및 연결**.                |
| **MCP 서버 보기 및 연결** | 구성된 MCP 서버 통합을 보고 연결할 수 있도록 허용합니다. 여기에는 기존 서버 보기, OAuth를 통한 연결, 연결 해제, 개인 도구 설정 구성이 포함됩니다. |

{% hint style="info" %}
**MCP 서버 보기 및 연결** 기본 **관리자**, **분석가**, 그리고 **분석가 읽기 전용** 역할에 포함되어 있습니다. **MCP 서버 관리** 기본 **관리자** 역할 전용입니다. 자세한 내용은 [역할 기반 접근 제어](/ko/system-configuration/rbac.md) 를 참조하세요.

MCP 서버 기능에 대한 액세스가 필요한 사용자 지정 역할이 있는 경우, 해당 역할을 [업데이트하여](/ko/system-configuration/rbac.md#update-a-roles-permissions) 적절한 권한을 추가해야 합니다.
{% endhint %}

## MCP 서버 카탈로그

Panther는 최소한의 설정으로 추가할 수 있는 사전 구성된 MCP 서버 카탈로그를 제공합니다.

| 서버                                                               | URL                                 | 설명                           |
| ---------------------------------------------------------------- | ----------------------------------- | ---------------------------- |
| [Atlassian](/ko/ai/mcp/mcp-integrations/atlassian-mcp-server.md) | `https://mcp.atlassian.com/v1/mcp`  | Jira, Confluence, Compass 도구 |
| [GitHub](/ko/ai/mcp/mcp-integrations/github-mcp-server.md)       | `https://api.githubcopilot.com/mcp` | 리포지토리, 이슈, PR, Actions 도구    |
| [Notion](/ko/ai/mcp/mcp-integrations/notion-mcp-server.md)       | `https://mcp.notion.com/mcp`        | 페이지, 데이터베이스, 작업 공간 도구        |
| [PagerDuty](/ko/ai/mcp/mcp-integrations/pagerduty-mcp-server.md) | `https://mcp.pagerduty.com/mcp`     | 인시던트, 서비스, 일정 도구             |
| [Slack](/ko/ai/mcp/mcp-integrations/slack-mcp-server.md)         | `https://mcp.slack.com/mcp`         | 메시지, 채널, 캔버스, 사용자 도구         |
| 사용자 지정 MCP 서버                                                    | *(사용자 제공)*                          | URL을 입력하여 MCP 호환 서버에 연결      |

합니다. 카탈로그에서 서버를 추가할 때는 서버 URL이 미리 채워집니다.  **사용자 지정 MCP 서버** 타일의 경우 서버 URL을 수동으로 입력합니다.

## MCP 서버 추가

{% hint style="info" %}
다음을 가지고 있어야 합니다 **MCP 서버 관리** MCP 서버를 추가할
{% endhint %}

1. Panther 콘솔의 오른쪽 상단에서 톱니바퀴 아이콘을 클릭하여 설정을 연 다음 **AI 및 자동화** > **MCP 서버**.
2. 다음을 클릭합니다: **MCP 서버 추가**.
3. 권한이 필요합니다. 카탈로그에서 서버를 선택하세요. 목록에 없는 서버에 연결하려면 **사용자 지정 MCP 서버** 타일을 선택하고 서버 URL을 입력하세요.
4. 다음 필드를 입력합니다:
   1. **서버 이름**: 서버 이름을 입력하세요(최대 24자, 영숫자 및 공백, 밑줄, 하이픈 사용 가능). 이 이름은 Panther AI 내부에서 이 서버가 제공하는 도구를 그룹화하고 접두어를 붙이는 데 사용되므로, 서버를 명확히 식별할 수 있는 이름을 선택하세요.
      * 특히 같은 유형의 서버를 여러 개 추가할 때 중요합니다. 예를 들어 GitHub 서버를 두 개 추가하는 경우, 다음과 같이 이름을 지정해 **프로덕션 GitHub** 그리고 **개발 GitHub** 도구를 명확하게 구분할 수 있습니다.
   2. **원격 MCP 서버 URL**: 다음을 추가하는 경우 미리 채워지며 편집할 수 없습니다. [사전 구성된 MCP 서버](#mcp-server-catalog). 사용자 지정 MCP 서버를 설정하는 경우 MCP 서버 URL을 입력하세요.
      * OAuth 2.0 인증을 사용하고 최신 공식 MCP 사양을 준수하는 원격 MCP 서버만 지원됩니다. [최신 공식 MCP 사양](https://modelcontextprotocol.io/) 을 준수하는 서버가 지원됩니다. 로컬 MCP 서버는 지원되지 않습니다.
   3. **설명** (선택 사항): 이 설명은 Panther AI가 이 서버의 도구를 사용할 때마다 문맥으로 전달되므로, AI가 더 나은 결정을 내리는 데 도움이 되는 세부 정보를 제공하는 데 사용하세요.
      * 예를 들어 Jira 서버의 경우 다음과 같이 작성할 수 있습니다: `계정 ID 123456을 사용하고, 별도 지정이 없는 한 SEC 및 OPS 프로젝트로 작업을 제한하세요.`
5. 다음을 클릭합니다: **다음**. Panther가 서버의 OAuth 메타데이터를 검색합니다.
   * 서버가 자동 등록을 지원하면 추가 자격 증명은 필요하지 않습니다.
   * 서버가 수동 자격 증명을 요구하는 경우, 다음 항목을 입력하라는 메시지가 표시됩니다: **OAuth 클라이언트 ID** 그리고 **클라이언트 시크릿**. 서버의 OAuth 리디렉션 URL이 표시되며, 이를 사용해 공급자에 OAuth 애플리케이션을 등록할 수 있습니다.
6. 다음을 클릭합니다: **만들기** 서버를 추가합니다.

이제 서버는 **MCP 서버 보기 및 연결** 권한이 있는 사용자가 연결할 수 있습니다.

## MCP 서버에 연결하기

{% hint style="info" %}
다음을 가지고 있어야 합니다 **MCP 서버 보기 및 연결** MCP 서버에 연결할
{% endhint %}

1. Panther 콘솔의 오른쪽 상단에서 톱니바퀴 아이콘을 클릭하여 설정을 연 다음 **AI 및 자동화** > **MCP 서버**.
2. 연결하려는 서버를 찾아 **연결**.
3. 클릭하세요. 그러면 타사 공급자의 OAuth 승인 페이지로 이동합니다. 로그인하고 요청된 권한을 부여하세요.
4. 승인 후 Panther로 돌아오며 해당 서버의 도구 권한 페이지로 이동합니다.

각 사용자는 고유한 OAuth 자격 증명으로 개별적으로 연결합니다. 즉, Panther AI는 인증된 사용자로서 외부 서비스에서 작업을 수행하며, 공급자 측에서 해당 사용자의 권한을 존중합니다.

## 도구 권한 구성

MCP 서버에 연결한 후에는 Panther AI가 해당 서버에서 제공하는 각 도구를 어떻게 사용하는지 구성할 수 있습니다. 다음을 클릭하여 도구 권한 페이지로 이동하세요. **구성** 연결된 서버에서

모든 도구는 **차단됨** 으로 기본 설정됩니다. Panther AI가 사용하도록 할 각 도구를 명시적으로 활성화해야 합니다.

### 도구 상태

각 도구는 다음 세 가지 상태 중 하나로 설정할 수 있습니다.

| 상태        | 설명                                                                   |
| --------- | -------------------------------------------------------------------- |
| **항상 허용** | Panther AI는 승인 요청 없이 이 도구를 사용할 수 있습니다.                               |
| **승인 필요** | Panther AI는 이 도구를 사용하기 전에 일시 중지하고 승인을 요청합니다. 각 호출을 승인하거나 거부할 수 있습니다. |
| **차단됨**   | Panther AI는 이 도구를 사용하지 않습니다.                                         |

### 도구 범주

도구는 두 범주로 나뉩니다.

* **읽기 전용 도구**: 데이터만 읽는 도구(예: 이슈 검색, 페이지 나열).
* **쓰기/삭제 도구**: 데이터를 생성, 수정 또는 삭제하는 도구(예: 이슈 생성, 페이지 업데이트). 이를 **승인 필요** 로 설정하여 사람의 검토를 유지하는 것을 고려하세요.

전체 범주에 대한 권한을 한 번에 설정하거나, 범주 내의 개별 도구를 구성할 수 있습니다.

## 연결 상태

각 MCP 서버 연결에는 연결 상태를 나타내는 상태가 있습니다.

| 상태        | 설명                                                          |
| --------- | ----------------------------------------------------------- |
| **정상**    | 연결이 정상적으로 작동 중입니다. Panther AI가 도구를 검색하고 사용할 수 있습니다.         |
| **대기 중**  | OAuth 승인이 시작되었지만 아직 완료되지 않았습니다.  **연결** 를 클릭하여 흐름을 완료하세요.   |
| **인증 오류** | OAuth 토큰이 만료되었거나 취소되었습니다.  **다시 연결** 을 클릭하여 재인증하세요.         |
| **연결 불가** | MCP 서버 URL에 연결할 수 없습니다. 서버 URL과 공급자의 상태 페이지를 확인하세요.         |
| **비활성화됨** | 관리자가 이 서버를 비활성화했습니다. 관리자가 다시 활성화할 때까지 이 서버의 도구는 사용할 수 없습니다. |

## MCP 서버 관리

### 서버 편집

1. MCP 서버 페이지에서 서버 행의 옵션 메뉴(**...**)를 클릭하세요.
2. 다음을 클릭합니다: **편집**.
3. 서버 이름, 설명 또는 OAuth 자격 증명(수동 등록 서버의 경우)을 업데이트합니다.
4. 다음을 클릭합니다: **변경 사항 저장**.

{% hint style="info" %}
서버 URL은 생성 후 변경할 수 없습니다. 다른 URL을 사용하려면 서버를 삭제하고 새로 만드세요.
{% endhint %}

### 서버 활성화 또는 비활성화

1. MCP 서버 페이지에서 서버 행의 옵션 메뉴(**...**)를 클릭하세요.
2. 다음을 클릭합니다: **활성화** 또는 **비활성화**.

서버가 비활성화되면 사용자에게는 계속 표시되지만 Panther AI에서는 해당 도구를 사용할 수 없습니다.

### 서버 삭제

1. MCP 서버 페이지에서 서버 행의 옵션 메뉴(**...**)를 클릭하세요.
2. 다음을 클릭합니다: **삭제**.
3. 삭제를 확인하세요.

서버를 삭제하면 모든 사용자에게서 제거되고 모든 활성 연결이 끊어집니다.

### MCP 서버 연결 해제

1. MCP 서버 페이지에서 서버 행의 옵션 메뉴(**...**)를 클릭하세요.
2. 다음을 클릭합니다: **연결 끊기**.

이렇게 하면 OAuth 토큰이 취소되고 개인 연결이 제거됩니다. 언제든지 **연결**.

## MCP 도구를 사용하는 Panther AI 기능

MCP 서버가 연결되면 Panther AI는 다음을 수행할 수 있습니다.

* **사용 가능한 도구 나열**: Panther AI는 연결된 MCP 서버가 제공하는 모든 도구를 인식하며 각 도구의 기능을 설명할 수 있습니다.
* **대화 중 도구 사용**: Panther AI에 질문하거나 작업을 요청하면 필요에 따라 MCP 도구를 호출할 수 있습니다. 예를 들어 "이 알러트에 대한 Jira 티켓을 만들어줘"라고 요청하면 Panther AI는 Atlassian MCP 서버의 `createJiraIssue` 도구.
* **도구 권한을 준수합니다**: Panther AI는 구성된 도구 상태를 따릅니다. 다음으로 설정된 도구만 사용합니다 **항상 허용** 또는 **승인 필요** (사용자의 명시적 동의가 있는 경우).
* **MCP 도구를 기본 제공 도구와 결합하기**: Panther AI는 단일 워크플로에서 기본 제공 도구와 함께 MCP 도구를 사용할 수 있습니다. 예를 들어, 기본 제공 도구로 알러트를 분류한 다음 MCP 도구를 사용해 PagerDuty 인시던트를 생성할 수 있습니다.

## 보안

* 모든 OAuth 토큰과 비밀 정보는 저장 시 암호화됩니다.
* MCP 도구 출력은 Panther AI에서 신뢰할 수 없는 입력으로 취급됩니다.
* MCP 서버 구성 변경 및 도구 호출은 Panther 감사 로그에 기록됩니다.
* Panther AI는 인증된 사용자의 권한을 존중하면서 외부 서비스에서 해당 사용자로 작업을 수행합니다.
* HTTPS MCP 서버 URL만 허용됩니다.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.panther.com/ko/ai/mcp/mcp-integrations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.