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

# MCP 서버

이 가이드에서는 Model Context Protocol (MCP)을 사용해 Phalcon Compliance를 AI 어시스턴트에 연결하는 방법을 설명합니다. 연결하면 Phalcon Compliance 대시보드로 전환하지 않고도 어시스턴트와의 대화에서 주소와 트랜잭션을 스크리닝하고 기존 스크리닝 결과를 확인할 수 있습니다.

Phalcon Compliance는 AML 위험을 식별하고 보고합니다. 위험에 대응하지는 않습니다. MCP 서버는 조회 및 스크리닝만 지원하며 계정의 어떤 항목도 변경할 수 없습니다.

## 사전 준비 사항

* 활성화된 Phalcon Compliance 계정. 모든 플랜에서 이용할 수 있습니다.
* 원격 MCP 서버를 지원하는 AI 어시스턴트.

## 어시스턴트 연결

Phalcon Compliance에서 MCP 서버를 호스팅하므로 설치할 필요가 없으며, 자동으로 최신 상태가 유지됩니다.

어시스턴트에서 MCP 서버 또는 커넥터를 관리하는 위치에 다음 서버 URL을 추가합니다.

```
https://mcp.blocksec.com/mcp
```

어시스턴트가 Phalcon Compliance를 처음 호출하면 브라우저에서 인증 페이지가 열립니다.

1. Phalcon Compliance에 로그인하거나 계정을 만듭니다.
2. 허용하는 권한을 검토합니다. 돌아갈 위치, 연결에 사용할 계정과 조직, 연결을 통해 가능한 작업을 확인합니다. 돌아갈 주소를 알고 있는지 확인하라는 메시지가 표시되면 확인합니다. 그렇지 않으면 계속 진행할 수 없습니다.
3. **승인**을 선택합니다.

이제 어시스턴트가 연결되었습니다. 연결이 제거되거나 만료되지 않는 한 다시 승인하라는 메시지가 표시되지 않습니다.

<figure><img src="https://738662694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmQV7l2sGQOENPKPFUI8o%2Fuploads%2Fgit-blob-cfc1fdc28aa022afb5ad95e1252142d7ed892277%2Fmcp-server-authorization.png?alt=media" alt="The Phalcon Compliance authorization page, showing where you will be sent back to, the account and organization the connection will use, a checkbox confirming you recognize the return address, and what the connection will be able to do"><figcaption><p>The authorization page shows the account and organization the connection will use, and what it will be able to do.</p></figcaption></figure>

### 특정 어시스턴트 설정

아래에서 사용 중인 어시스턴트의 안내를 따르세요. Claude Code, Codex, Cursor의 경우 서버 URL 외에도 구성에 표시된 클라이언트 ID가 필요합니다. 값을 정확하게 복사하세요. 이 값은 어시스턴트를 식별하는 것이지 Phalcon Compliance 계정을 식별하는 값이 아니며, API 키도 아닙니다. 서버 URL에 추가하지 마세요.

여기에 나열되지 않은 어시스턴트의 연결 방법은 <phalcon_support@blocksec.com>으로 문의하세요.

#### Claude

**Customize → Connectors**로 이동하고 \*\*+\*\*를 선택한 다음 **Add custom connector**를 선택하고 서버 URL을 붙여 넣습니다.

Team 및 Enterprise 플랜에서는 소유자가 **Organization Settings → Connectors**에서 커넥터를 한 번 추가합니다. 그러면 각 구성원이 개별적으로 연결할 수 있습니다.

#### Claude Code

```bash
claude mcp add --scope user --transport http \
  --client-id https://claude.ai/oauth/claude-code-client-metadata \
  phalcon-compliance https://mcp.blocksec.com/mcp
```

`--scope user`를 사용하면 모든 프로젝트에서 서버를 사용할 수 있습니다. 이 옵션을 사용하지 않으면 현재 작업 중인 프로젝트에만 서버가 추가됩니다.

#### Codex

```bash
codex mcp add phalcon-compliance \
  --url https://mcp.blocksec.com/mcp \
  --oauth-client-id https://chatgpt.com/oauth/codex/client.json
```

서버 설정은 `~/.codex/config.toml`에 저장되며 Codex CLI, IDE 확장 프로그램, 데스크톱 앱에서 모두 읽습니다. 한 번 추가하면 세 곳에서 모두 사용할 수 있습니다.

#### Cursor

`mcp.json`에 서버를 추가합니다.

```json
{
  "mcpServers": {
    "Phalcon Compliance": {
      "url": "https://mcp.blocksec.com/mcp",
      "auth": {
        "CLIENT_ID": "https://cursor.com"
      }
    }
  }
}
```

`CLIENT_ID`는 계정이 아닌 Cursor 자체를 식별합니다. 표시된 값을 정확하게 복사하세요.

#### VS Code (GitHub Copilot)

프로젝트에 `.vscode/mcp.json`을 만듭니다.

```json
{
  "servers": {
    "phalcon-compliance": {
      "type": "http",
      "url": "https://mcp.blocksec.com/mcp"
    }
  }
}
```

최상위 키는 `mcpServers`가 아니라 `servers`입니다. 이후 창을 다시 불러오고 Copilot Chat을 **Agent** 모드로 전환하세요. MCP 도구는 이 모드에서만 사용할 수 있습니다.

#### ChatGPT

사용자 지정 MCP 서버를 사용하려면 Developer Mode와 유료 ChatGPT 플랜이 필요하며, 웹에서만 작동합니다. Business, Enterprise, Edu 워크스페이스에서는 관리자가 사용자 지정 MCP를 활성화해야 구성원이 서버를 추가할 수 있습니다.

OpenAI의 안내에 따라 [Developer Mode 활성화 및 사용자 지정 커넥터 추가](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt)를 진행하고, 위의 서버 URL을 사용하세요. 인증 설정은 OAuth로 유지합니다.

## 어시스턴트로 할 수 있는 작업

일상적인 표현으로 요청하면 어시스턴트가 적절한 작업을 선택합니다.

| 요청할 수 있는 작업        | 스크리닝 할당량 사용     |
| ------------------ | --------------- |
| 주소의 AML 위험 스크리닝    | 예 — 스크리닝 1회     |
| 트랜잭션 내 이체 스크리닝     | 예 — 이체당 스크리닝 1회 |
| 주소의 최신 스크리닝 결과     | 아니요             |
| 트랜잭션 내 이체 목록       | 아니요             |
| 이체의 최신 스크리닝 결과     | 아니요             |
| 대기열에 추가된 스크리닝 결과   | 아니요             |
| 일정 기간 동안의 스크리닝 사용량 | 아니요             |
| 지원되는 체인 목록         | 아니요             |

**Scale 및 Enterprise** 플랜에서는 어시스턴트가 일괄 요청도 제출할 수 있습니다. 요청당 최대 주소 100개 또는 트랜잭션 50개를 제출할 수 있습니다. 일괄 요청의 각 항목은 스크리닝 1회를 사용합니다.

모든 스크리닝 결과에는 Phalcon Compliance 대시보드의 해당 기록으로 연결되는 링크가 포함됩니다.

{% hint style="warning" %}
스크리닝 결과는 스크리닝이 실행된 시점의 스냅샷이며, 어시스턴트가 이를 요약하거나 다른 표현으로 바꿔 설명할 수 있습니다. 규정 준수 관련 결정을 내리기 전에 연결된 대시보드 기록을 여세요.
{% endhint %}

### 체인 선택

동일한 주소 또는 트랜잭션 해시가 둘 이상의 체인에 존재할 수 있습니다. 어느 체인인지 말하지 않으면 어시스턴트가 스크리닝 전에 확인을 요청합니다. 단, Bitcoin, Tron, Solana 주소처럼 형식만으로 특정 체인을 식별할 수 있는 경우는 예외입니다. 이 질문에 답해도 할당량은 사용되지 않습니다.

결과에는 해당하는 체인이 표시됩니다. 조치를 취하기 전에 원하는 체인이 맞는지 확인하세요.

### 트랜잭션 스크리닝

스크리닝은 트랜잭션 단위가 아니라 이체 단위로 작동합니다. 이체가 5개 포함된 트랜잭션을 모두 확인하려면 스크리닝 5회가 필요합니다.

트랜잭션에 이체가 둘 이상 포함되어 있으면 어시스턴트가 스크리닝 전에 어떤 이체를 말하는지 확인합니다. 일반적으로 자금을 받은 주소를 묻습니다. 이에 답하는 것은 정상적인 절차이며 오류가 아닙니다. 이체가 식별될 때까지 할당량은 사용되지 않습니다.

기본적으로 스크리닝은 자금의 출처와 목적지를 모두 확인합니다. 한 방향만 필요한 경우 어시스턴트에게 한쪽으로 범위를 좁혀 달라고 요청하세요. 어느 쪽이든 스크리닝 1회가 사용됩니다.

### 위험 수준

위험 수준은 고정된 척도가 아니라 사용자가 직접 설정한 Risk Engine 규칙에서 결정됩니다. 각 탐지 결과에는 해당 결과를 생성한 규칙에 설정된 심각도가 적용되며, 전체 수준은 그중 가장 높은 심각도로 결정됩니다. 동일한 주소라도 다른 조직에서는 다른 수준으로 표시될 수 있습니다.

다음 두 가지 사항에 유의하세요.

* 전체 수준은 가장 높은 단일 탐지 결과를 기준으로 하므로, 어시스턴트에게 어떤 탐지 결과가 그 수준을 결정했는지 물어보세요.
* **No Risk**는 규칙에 일치하는 항목이 없다는 의미입니다. 주소나 이체에 문제가 없다는 의미는 아닙니다.

수준만으로 판단하지 말고 해당 수준의 근거를 물어보세요. 어떤 지표가 탐지되었는지, 금액은 얼마인지, 일치하는 이벤트는 몇 건인지 확인하세요.

규칙은 Phalcon Compliance 대시보드에서 구성할 수 있으며 Essential 플랜 이상에서 사용할 수 있습니다. 어시스턴트를 통해 규칙을 변경할 수는 없습니다.

## 스크리닝 할당량

어시스턴트를 통한 스크리닝에는 대시보드 및 API와 동일한 할당량이 적용됩니다. 별도의 할당량은 없습니다.

기존 결과를 조회해도 할당량은 사용되지 않습니다. 최근 결과가 이미 있으면 어시스턴트가 새 스크리닝을 실행하는 대신 기존 결과를 조회할 수 있습니다. 최신 상태가 필요하면 다시 스크리닝해 달라고 요청하세요. 이 경우 새 스크리닝이 실행되며 할당량 1회가 사용됩니다.

할당량이 소진되면 어시스턴트가 이를 알리고 결제 페이지 링크를 제공합니다. 사용량을 언제든지 확인하려면 어시스턴트에게 스크리닝 사용량을 물어보거나 대시보드를 여세요.

## 권한

연결에 부여되는 권한은 Phalcon Compliance 대시보드에서 사용자가 가진 권한과 정확히 동일합니다. 그보다 많거나 적지 않습니다.

조직에서 사용자의 역할이 보기 전용인 경우 어시스턴트는 기존 스크리닝 결과를 조회할 수 있지만 새 스크리닝을 실행할 수는 없습니다. 스크리닝을 실행해야 한다면 조직 관리자에게 액세스 권한을 요청하세요.

어시스턴트가 자체적으로 읽기 전용 액세스를 요청할 수도 있습니다. 연결을 통해 할 수 있는 작업은 **승인**을 선택하기 전에 인증 페이지에 표시됩니다.

## 조직

연결은 단일 조직, 즉 연결을 승인할 때 가장 최근에 사용 중이던 조직에 바인딩됩니다. 조직은 **승인**을 선택하기 전에 인증 페이지에 표시됩니다.

다른 조직을 사용하려면 연결을 해제한 다음 해당 조직이 활성화된 상태에서 다시 연결하세요.

## 연결 해제

어시스턴트의 MCP 또는 커넥터 설정에서 Phalcon Compliance 서버를 제거합니다. OAuth 토큰 취소를 지원하는 어시스턴트는 이때 액세스 토큰도 취소합니다.

액세스가 종료되었는지 확인해야 한다면 \_**<phalcon_support@blocksec.com>**\_으로 문의하세요.

## 제한 사항

* **조회 및 스크리닝만 가능합니다.** 연결을 통해 블랙리스트 및 화이트리스트 항목을 추가하거나 제거하고, 고객 정보를 편집하고, 모니터링을 시작하거나 중지하고, 알림 및 케이스에 대응할 수 없습니다.
* **모니터링, Alert Hub, Customer Management, Risk Engine 구성**은 어시스턴트를 통해 이용할 수 없습니다. 해당 기능에는 대시보드 또는 API를 사용하세요.
* 일괄 요청을 제출하려면 Scale 또는 Enterprise 플랜이 필요합니다.

## 다음 단계

* [주소 스크리닝](https://docs.compliance.phalcon.blocksec.com/ko-kr/user-manual/screening/addresses.md): 대시보드에서 주소를 스크리닝합니다.
* [트랜잭션 스크리닝](https://docs.compliance.phalcon.blocksec.com/ko-kr/user-manual/screening/transactions.md): 이체 단위 스크리닝의 작동 방식입니다.
* [플랜, 결제 및 청구](https://docs.compliance.phalcon.blocksec.com/ko-kr/user-manual/account/plans-billing-and-payment.md): 할당량 및 플랜 제한입니다.
* [API 문서](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/introduction.md): 기반이 되는 REST API입니다.
