> 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-hant/integrations/mcp-server.md).

# MCP 伺服器

本指南說明如何使用 Model Context Protocol (MCP) 將 Phalcon Compliance 連接至 AI 助理。連線後，您可以直接在與助理的對話中篩查地址和交易，並讀取現有的篩查結果，無需切換至 Phalcon Compliance 儀表板。

Phalcon Compliance 會識別並回報 AML 風險，但不會對其採取行動：MCP Server 僅供讀取與篩查，無法變更您帳戶中的任何內容。

## 先決條件

* 有效的 Phalcon Compliance 帳戶。所有方案皆可使用。
* 支援遠端 MCP Server 的 AI 助理。

## 連接您的助理

Phalcon Compliance 託管 MCP Server。無需安裝任何軟體，且會自動保持在最新狀態。

請在助理管理 MCP Server 或連接器的位置新增以下 Server URL：

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

助理首次呼叫 Phalcon Compliance 時，瀏覽器會開啟授權頁面：

1. 登入 Phalcon Compliance，或建立帳戶。
2. 檢視您授予的權限：您將返回的位置、連線將使用的帳戶和組織，以及它可執行的操作。如果系統要求您確認您認得返回地址，請確認；否則您將無法繼續。
3. 選取 **Authorize**。

您的助理已連線。除非連線遭到移除或過期，否則不會再次要求您授權。

<figure><img src="https://2458772471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLWwO7vpr6nNW5dAF9VOK%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 除了 Server URL 外，還需要在其設定中使用顯示的 client ID。請完全照原樣複製此值：它用來識別助理，而不是您的 Phalcon Compliance 帳戶，也不是 API 金鑰。請勿將它附加至 Server URL。

若您使用的助理未列於此處，請聯絡 <phalcon_support@blocksec.com> 以取得連線指示。

#### Claude

前往 **Customize → Connectors**，選取 **+**，然後選取 **Add custom connector**，並貼上 Server 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` 會讓 Server 在每個專案中都可使用。若未指定此參數，Server 只會新增至您目前所在的專案。

#### Codex

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

Server 設定會寫入 `~/.codex/config.toml`，Codex CLI、IDE 擴充功能和桌面應用程式都會讀取此檔案。新增一次即可供這三者使用。

#### Cursor

將 Server 新增至您的 `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 Server 需要 Developer Mode 和付費 ChatGPT 方案，且僅支援在網頁版使用。在 Business、Enterprise 和 Edu 工作區中，管理員必須先啟用自訂 MCP，其他人才可新增。

請依照 OpenAI 的指示[啟用 Developer Mode 並新增自訂連接器](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt)，並使用上方的 Server 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 Server。支援 OAuth 權杖撤銷的助理也會在此時撤銷存取權杖。

如需確認存取權已終止，請聯絡 ***<phalcon_support@blocksec.com>***。

## 限制

* **僅供讀取與篩查。** 此連線無法新增或移除黑名單和白名單項目、編輯客戶、開始或停止監控，也無法處理警示和案件。
* **監控、Alert Hub、Customer Management 和 Risk Engine 設定**無法透過助理使用。請使用儀表板或 API 進行這些操作。
* 提交批次需要 Scale 或 Enterprise 方案。

## 後續步驟

* [地址篩查](https://docs.compliance.phalcon.blocksec.com/zh-hant/user-manual/screening/addresses.md)：在儀表板中篩查地址。
* [交易篩查](https://docs.compliance.phalcon.blocksec.com/zh-hant/user-manual/screening/transactions.md)：瞭解轉帳層級篩查的運作方式。
* [方案、帳單與付款](https://docs.compliance.phalcon.blocksec.com/zh-hant/user-manual/account/plans-billing-and-payment.md)：額度和方案限制。
* [API 文件](https://docs.compliance.phalcon.blocksec.com/zh-hant/api-documentation/introduction.md)：底層 REST API。
