> 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 통합(베타)

## 개요

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

Panther AI는 MCP(Model Context Protocol) 통합을 지원하여 외부 도구와 서비스를 Panther AI에 직접 연결할 수 있습니다. MCP 통합을 사용하면 Panther AI는 Jira 이슈 생성, PagerDuty 인시던트 조회, Notion 페이지 검색 등 서드파티 원격 MCP 서버에서 제공하는 도구를 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는 헤더가 없는 CSV를 사용한 스키마 추론을 지원하지 않습니다.** 권한 그룹:

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

{% hint style="info" %}
**MCP 서버 보기 및 연결** 기본 **관리자**, **Analyst**, 및 **Analyst Read Only** 역할에 포함됩니다. **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 Console의 왼쪽 탐색 모음 하단에서 **설정**를 클릭한 다음 **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 사양](https://modelcontextprotocol.io/) 이 지원됩니다. 로컬 MCP 서버는 지원되지 않습니다.
   3. **설명** (선택 사항): 설명은 Panther AI가 이 서버의 도구를 사용할 때마다 컨텍스트로 전달되므로, AI가 더 나은 결정을 내리는 데 도움이 되는 세부 정보를 제공하는 데 사용하세요.
      * 예를 들어 Jira 서버의 경우 다음과 같이 작성할 수 있습니다. `계정 ID 123456을 사용하고 별도 지정이 없는 한 SEC 및 OPS 프로젝트로 작업을 제한하세요.`
5. 클릭합니다 **다음**. Panther가 서버의 OAuth 메타데이터를 검색합니다.
   * 서버가 자동 등록을 지원하는 경우 추가 자격 증명은 필요하지 않습니다.
   * 서버에 수동 자격 증명이 필요하면 다음을 입력하라는 메시지가 표시됩니다. **OAuth 클라이언트 ID** 및 **Client Secret**. OAuth 애플리케이션을 제공업체에 등록할 때 사용할 서버의 OAuth 리디렉션 URL이 표시됩니다.
6. 클릭합니다 **생성** 서버를 추가하려면.

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

## MCP 서버에 연결하기

{% hint style="info" %}
다음을 보유해야 합니다 **MCP 서버 보기 및 연결** 권한으로 MCP 서버에 연결합니다.
{% endhint %}

1. Panther Console의 왼쪽 탐색 모음 하단에서 **설정**를 클릭한 다음 **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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.