> 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/zh/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. 选择 **Authorize**。

你的助手现已连接。除非连接被移除或过期，否则无需再次授权。

<figure><img src="https://1173431473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLVe0rlwDVlmwtHERF9ws%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"
    }
  }
}
```

顶层键是 `servers`，不是 `mcpServers`。之后重新加载窗口，并将 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 笔交易。批次中的每个项目都会消耗一次筛查。

每项筛查结果都包含一个链接，可跳转到 Phalcon Compliance 控制面板中的对应记录。

{% hint style="warning" %}
筛查结果是筛查执行时的快照，助手可能会对其进行总结或转述。做出合规决策前，请打开链接中的控制面板记录。
{% endhint %}

### 选择链

同一个地址或交易哈希可能存在于多条链上。如果你没有说明所指的链，助手会在筛查前询问你——但如果地址格式本身能唯一确定链，则不会询问，例如 Bitcoin、Tron 和 Solana 地址。回答此问题不会消耗配额。

结果会注明其所对应的链。采取行动前，请确认链与你所指的相符。

### 筛查交易

筛查针对转账，而不是交易本身。一笔包含五笔转账的交易需要进行五次筛查才能全部覆盖。

如果一笔交易包含多笔转账，助手会在筛查前询问你要筛查哪一笔——通常会要求你提供收款地址。回答此问题是正常流程，并非错误；只有确定要筛查的转账后才会消耗配额。

默认情况下，筛查会同时覆盖资金来源和去向。如果你只需要一个方向，可以让助手将筛查范围缩小到一侧。无论哪种情况，都会消耗一次筛查。

### 风险级别

风险级别由你自己的 Risk Engine 规则决定，而非基于固定等级。每个发现都会采用生成该发现的规则所设定的严重程度，总体级别就是其中最高的严重程度。同一个地址在不同组织中可能得到不同级别。

由此可得：

* 总体级别取决于单个最高级别的发现，因此可以询问助手是哪项发现导致了该级别。
* **无风险**表示没有任何内容匹配你的规则。这并不代表该地址或转账没有风险。

请向助手询问风险级别背后的证据——触发的指标、金额以及匹配的事件数量——不要只依赖风险级别本身。

规则在 Phalcon Compliance 控制面板中配置，Essential 套餐及以上版本均可使用。你无法通过助手更改这些规则。

## 筛查配额

通过助手进行的筛查与控制面板和 API 使用相同的配额，不设单独的配额。

读取现有结果不会消耗配额。如果近期已有筛查结果，助手可以读取该结果，而无需重新运行筛查。如果你需要获取当前状态，请让助手重新筛查——这会运行一次新的筛查，并消耗一次配额。

配额用尽时，助手会告知你并提供计费页面的链接。你可以随时询问助手当前的筛查用量，或打开控制面板查看。

## 权限

该连接拥有的权限与你在 Phalcon Compliance 控制面板中拥有的权限完全一致，不多不少。

如果你在组织中的角色为只读，助手可以读取现有筛查结果，但无法运行新的筛查。如需运行筛查，请联系组织管理员申请访问权限。

助手也可以为自身请求只读权限。授权页面会在你选择 **Authorize** 前列出该连接能够执行的操作。

## 组织

该连接绑定到单个组织：你授权时最近使用的组织。授权页面会在你选择 **Authorize** 前显示该组织。

如需使用其他组织，请先断开连接，然后在该组织处于启用状态时重新连接。

## 断开连接

从助手的 MCP 或连接器设置中移除 Phalcon Compliance 服务器。支持撤销 OAuth 令牌的助手也会在此时撤销访问令牌。

如果你需要确认访问权限已终止，请联系 ***<phalcon_support@blocksec.com>***。

## 限制

* **仅支持读取和筛查。** 此连接无法添加或移除黑名单和白名单条目、编辑客户、启动或停止监控，也无法处理警报和案件。
* **监控、Alert Hub、Customer Management 和 Risk Engine 配置**无法通过助手使用。请通过控制面板或 API 进行操作。
* 批量提交需要 Scale 或 Enterprise 套餐。

## 后续步骤

* [地址筛查](https://docs.compliance.phalcon.blocksec.com/zh/user-manual/screening/addresses.md)：在控制面板中筛查地址。
* [交易筛查](https://docs.compliance.phalcon.blocksec.com/zh/user-manual/screening/transactions.md)：了解转账级别筛查的工作方式。
* [套餐、计费和付款](https://docs.compliance.phalcon.blocksec.com/zh/user-manual/account/plans-billing-and-payment.md)：了解配额和套餐限制。
* [API 文档](https://docs.compliance.phalcon.blocksec.com/zh/api-documentation/introduction.md)：底层 REST API。
