> 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/ja/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://546960952-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiXFespN0LhxR1F1qvQ2F%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に加えて、設定に表示されているclient 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拡張機能、デスクトップアプリのすべてから読み込まれます。一度追加すれば、3つすべてで利用できます。

#### 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プランが必要です。また、Web版でのみ動作します。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**プランでは、アシスタントから一括送信もできます。1回のリクエストにつき、最大100件のアドレスまたは50件のトランザクションを送信できます。一括処理の各項目で、スクリーニングを1回分使用します。

各スクリーニング結果には、Phalcon Complianceダッシュボード内の該当レコードへのリンクが含まれます。

{% hint style="warning" %}
スクリーニング結果は、スクリーニングを実行した時点のスナップショットです。また、アシスタントが結果を要約したり、別の表現で伝えたりすることがあります。コンプライアンス上の判断を下す前に、リンク先のダッシュボードのレコードを開いて確認してください。
{% endhint %}

### チェーンの選択

同じアドレスやトランザクションハッシュが複数のチェーンに存在することがあります。どのチェーンかを指定しない場合、Bitcoin、Tron、Solanaのアドレスのように形式からチェーンを特定できる場合を除き、スクリーニングの前にアシスタントが確認します。この質問への回答でスクリーニング枠が消費されることはありません。

結果には対象となるチェーンが表示されます。操作を行う前に、意図したチェーンであることを確認してください。

### トランザクションのスクリーニング

スクリーニングはトランザクション単位ではなく、送金単位で行われます。5件の送金を含むトランザクションを完全にカバーするには、5回のスクリーニングが必要です。

トランザクションに複数の送金が含まれている場合、スクリーニングの前にどの送金かをアシスタントが確認します。通常は、資金の受取先アドレスを尋ねます。この質問への回答は通常の手順であり、エラーではありません。対象の送金が特定されるまで、スクリーニング枠は消費されません。

デフォルトでは、資金の送信元と送信先の両方をスクリーニングします。一方向だけでよい場合は、対象を一方に絞るようアシスタントに伝えてください。どちらの場合も、スクリーニングは1回分です。

### リスクレベル

リスクレベルは固定の尺度ではなく、お客様独自のRisk Engineルールに基づいています。各検出結果には、その検出につながったルールに設定した重要度が付与され、全体のレベルにはそのうち最も高いものが適用されます。同じアドレスでも、別の組織では異なるレベルになることがあります。

このため、次の2点に留意してください。

* 全体のレベルは最も高い単一の検出結果によって決まるため、どの検出結果がそのレベルにつながったのかをアシスタントに尋ねてください。
* **リスクなし**は、お客様のルールに該当するものがなかったことを意味します。アドレスや送金に問題がないことを示すものではありません。

レベルだけに頼るのではなく、該当したインジケーター、金額、一致したイベントの数など、そのレベルの根拠をアシスタントに尋ねてください。

ルールはPhalcon Complianceダッシュボードで設定でき、Essentialプラン以上で利用できます。アシスタントを通じて変更することはできません。

## スクリーニング枠

アシスタント経由のスクリーニングでは、ダッシュボードやAPIと同じ枠を使用します。別枠はありません。

既存の結果を読み取る場合、枠は消費されません。最近の結果がすでにある場合、アシスタントは新たにスクリーニングを実行せず、その結果を読み取ることができます。最新の状態が必要な場合は、再スクリーニングを依頼してください。新たにスクリーニングが実行され、枠を1回分使用します。

枠がなくなると、アシスタントからその旨が通知され、請求ページへのリンクが表示されます。利用状況は、いつでもアシスタントに尋ねるか、ダッシュボードを開いて確認できます。

## 権限

接続に付与される権限は、Phalcon Complianceダッシュボードでお客様が持つ権限とまったく同じです。それ以上でも、それ以下でもありません。

組織で閲覧専用のロールが割り当てられている場合、アシスタントは既存のスクリーニング結果を読み取れますが、新しいスクリーニングは実行できません。実行する必要がある場合は、組織管理者にアクセス権を依頼してください。

アシスタントが自ら読み取り専用アクセスを要求することもあります。接続で可能な操作は、**承認**を選択する前に認証ページに表示されます。

## 組織

接続先は単一の組織に限定されます。これは、認証時に直近で使用していた組織です。**承認**を選択する前に、認証ページで組織を確認できます。

別の組織を利用するには、いったん切断し、その組織を有効にした状態で再接続してください。

## 切断

アシスタントのMCPまたはコネクタの設定からPhalcon Complianceサーバーを削除してください。OAuthトークンの失効に対応しているアシスタントでは、その時点でアクセストークンも失効します。

アクセスが終了したことの確認が必要な場合は、\_**<phalcon_support@blocksec.com>**\_までお問い合わせください。

## 制限事項

* **読み取りとスクリーニングのみ。** 接続を通じてブラックリストやホワイトリストのエントリーを追加・削除したり、顧客情報を編集したり、モニタリングを開始・停止したり、アラートやケースに対応したりすることはできません。
* **モニタリング、Alert Hub、顧客管理、Risk Engineの設定**は、アシスタントから利用できません。これらの操作には、ダッシュボードまたはAPIを使用してください。
* 一括送信には、ScaleまたはEnterpriseプランが必要です。

## 次のステップ

* [アドレススクリーニング](https://docs.compliance.phalcon.blocksec.com/ja/user-manual/screening/addresses.md)：ダッシュボードでアドレスをスクリーニングする方法。
* [トランザクションスクリーニング](https://docs.compliance.phalcon.blocksec.com/ja/user-manual/screening/transactions.md)：送金単位のスクリーニングの仕組み。
* [プラン、請求、お支払い](https://docs.compliance.phalcon.blocksec.com/ja/user-manual/account/plans-billing-and-payment.md)：枠とプランの上限。
* [APIドキュメント](https://docs.compliance.phalcon.blocksec.com/ja/api-documentation/introduction.md)：基盤となるREST API。
