# MCP 서버

## 개요

Panther [모델 컨텍스트 프로토콜 (MCP)](https://modelcontextprotocol.io/introduction) 서버는 MCP [클라이언트에서 Panther와의 자연어 상호작용을 가능하게 합니다](https://modelcontextprotocol.io/clients) 중 어떤 것을 선택하든 상관없습니다. 애널리스트로서 알러트를 조사하든, 디택션 엔지니어로서 [Cursor](https://www.cursor.com/en)에서 룰을 작성하든, 또는 CISO로서 지표와 빠른 인사이트를 찾든, MCP 서버를 통해 [Panther API](/ko/panther/api.md) 를 대화형 AI로 사용할 수 있습니다.

Panther MCP 서버는 조직 전반의 사용자들이 Panther에 더 쉽게 접근할 수 있게 합니다. 예를 들어, Python으로 프로그래밍하는 법을 몰라도 룰을 작성할 수 있고, SQL이나 PantherFlow 같은 쿼리 언어 없이 데이터를 검색할 수도 있습니다.

예를 들어, Panther MCP 서버를 다음 용도로 사용할 수 있습니다:

* **디택션 엔지니어링**: Cursor 같은 클라이언트를 사용해 데이터 레이크의 실제 로그를 기반으로 룰을 생성합니다.
  * Cursor에서 "계정 333333444444에서 AWS 관리자 계정이 생성될 때 모니터링하는 룰을 만들어줘"
* **알러트 분류**: 특정 기간 내에 생성된 여러 알러트를 검토하고 상관관계를 분석합니다.
  * Claude for Desktop에서 "지난 24시간 동안 생성된 중간 이상 알러트를 IP별로 그룹화해서 모두 보여줘"
* **위협 조사**: 보안 로그를 쿼리하고 이상 징후를 조사합니다.
  * Claude for Desktop에서 "지난 하루 동안의 AWS CloudTrail 로그에서 로그인 실패 시도를 쿼리해줘."
* **Panther 운영**: 다음과 같은 운영 문제의 해결을 처음부터 끝까지 신속하게 진행합니다. [룰 오류](/ko/detections/rules.md#rule-errors-and-scheduled-rule-errors) 또는 [시스템 오류](/ko/system-configuration/notifications/system-errors.md).
  * Claude for Desktop에서 "이번 달 알러트 볼륨 기준 상위 10개 룰에 대한 보고서를 생성해줘"

Panther MCP 서버에는 알러트, 데이터, 룰, 데이터 모델, 스키마, 메트릭, Panther 사용자 등 여러 엔터티를 다루는 도구가 포함되어 있습니다. 이러한 도구에 대해 자세히 알아보려면 [의 Available Tools 섹션을 참고하세요. `mcp-panther` 리포지토리의 README](https://github.com/panther-labs/mcp-panther?tab=readme-ov-file#available-tools).

Panther MCP 서버는 오픈 소스입니다. 자세한 내용은 [여기서 기여 가이드라인을 확인하세요](https://github.com/panther-labs/mcp-panther/blob/main/CONTRIBUTING.md). MCP 서버에서 버그를 찾았거나 사용 중 추가 지원이 필요하면 [리포지토리에 이슈를 생성하세요](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/creating-an-issue).

{% hint style="info" %}
Panther MCP 기능의 사용은 [법률 페이지에 있는 AI 면책 조항의 적용을 받습니다](/ko/resources/help/legal.md#ai-disclaimer).
{% endhint %}

## MCP 워크플로 사용하기

1. 선택한 클라이언트(예: Claude for Desktop)에 MCP 서버를 설치하세요.
   * 다음을 사용해 로컬에 Panther MCP 서버를 설치할 수 있습니다 `docker` 또는 `uvx`. 전체 설치 방법은 [README의 MCP 서버 설치 섹션을 참고하세요](https://github.com/panther-labs/mcp-panther?tab=readme-ov-file#mcp-server-installation).
2. Panther와 관련된 질문을 하거나 프롬프트를 입력하세요(예: "의심스러운 S3 버킷 접근에 대한 디택션을 작성해줘").
3. 클라이언트는 `mcp-panther`의 [도구를 사용하여](https://github.com/panther-labs/mcp-panther?tab=readme-ov-file#available-tools) 와 상호작용하고 [Panther의 API를](/ko/panther/api.md) 필요한 데이터를 수집합니다.
4. 클라이언트는 `mcp-panther` 의 응답을 사용하여 질문에 답하거나 요청한 작업을 실행합니다.

## MCP 서버 보안 강화

Panther MCP 서버를 안전하게 사용하려면 다음 가이드를 따르는 것이 매우 권장됩니다. [mcp-panther 리포지토리 README의 Security Best Practices 섹션](https://github.com/panther-labs/mcp-panther?tab=readme-ov-file#security-best-practices).

## Panther MCP 서버 vs. Panther AI

Panther MCP 서버와 [Panther AI](/ko/ai.md) 둘 다 자유 형식 프롬프트를 사용해 AI로 Panther 인스턴스와 상호작용할 수 있게 해주지만, 몇 가지 중요한 차이가 있습니다:

<table><thead><tr><th width="205.68743896484375"></th><th>Panther MCP 서버</th><th width="254.5789794921875">Panther AI</th></tr></thead><tbody><tr><td><strong>주요 사용 사례</strong></td><td>디택션 엔지니어링, 도구 간 워크플로, 임시 조사, 내부 맞춤형 에이전트 생성</td><td>가이드형 알러트 분류 및 인시던트 대응</td></tr><tr><td><strong>접근 방식</strong></td><td><a href="https://modelcontextprotocol.io/clients">MCP 클라이언트</a> 예: Cursor, Claude for Desktop, Goose</td><td>Panther Console(및 API, <a href="/pages/2a6e29c77a9d4ad9cd51e03a702c139888983d37">Cloud Connected</a> 고객용)</td></tr><tr><td><strong>통합 기능</strong></td><td>다른 <a href="https://github.com/modelcontextprotocol/servers">MCP 서버와 함께 작동</a> (예: GitHub, Slack, Notion 등)</td><td>Panther 전용 워크플로만</td></tr><tr><td><strong>다음에 적합</strong></td><td>Panther 전반에 걸친 유연성이 필요한 복잡하고 탐색적인 작업</td><td>반복 가능하고 일관된 보안 운영 워크플로</td></tr><tr><td><strong>AI 모델</strong></td><td>MCP 클라이언트가 선택한 모델을 사용함(예: GPT-4, Claude, LLama4 등)</td><td>기반 모델 <a href="https://www.anthropic.com/claude">Anthropic의 Claude AI 모델</a> 을 통해 <a href="https://aws.amazon.com/bedrock/">Amazon Bedrock</a></td></tr></tbody></table>

## MCP 서버 권한 가이드

<table><thead><tr><th width="310.76171875">접근 수준</th><th>API 토큰 권한</th><th data-hidden></th></tr></thead><tbody><tr><td>읽기 전용(권장 최소)</td><td><code>알러트 읽기</code>, <code>룰 보기</code> , <code>정책 보기</code>, <code>데이터 레이크 쿼리</code>, <code>로그 소스 보기</code> <code>개요 보기</code>, <code>사용자 정보 읽기</code>  , <code>API 토큰 정보 읽기</code></td><td></td></tr><tr><td>쓰기 작업</td><td> <code>알러트 관리</code>, <code>룰 관리</code>, 그리고/또는 <code>정책 관리</code></td><td></td></tr><tr><td>AI 분류</td><td> <code>Panther AI 실행</code> </td><td></td></tr></tbody></table>


---

# Agent Instructions: 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/panther/mcp-server.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.