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

# Сервер MCP

Это руководство объясняет, как подключить Phalcon Compliance к AI-ассистенту с помощью Model Context Protocol (MCP). После подключения вы сможете проверять адреса и транзакции, а также просматривать результаты уже проведённых проверок прямо в чате с ассистентом — без перехода в панель управления Phalcon Compliance.

Phalcon Compliance выявляет риски AML и сообщает о них. Он не принимает меры в ответ на них: MCP-сервер позволяет только читать данные и проводить проверки, но не может ничего изменить в вашей учётной записи.

## Предварительные требования

* Активная учётная запись Phalcon Compliance. Доступно на всех тарифных планах.
* AI-ассистент с поддержкой удалённых MCP-серверов.

## Подключение ассистента

Phalcon Compliance предоставляет MCP-сервер. Ничего устанавливать не нужно, сервер автоматически обновляется.

Добавьте следующий URL сервера в настройках MCP-серверов или коннекторов вашего ассистента:

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

При первом обращении ассистента к Phalcon Compliance в браузере откроется страница авторизации:

1. Войдите в Phalcon Compliance или создайте учётную запись.
2. Проверьте, что именно вы разрешаете: куда вас вернут, какая учётная запись и организация будут использоваться для подключения и какие действия оно сможет выполнять. Если вас попросят подтвердить, что вы узнаёте адрес возврата, подтвердите его — иначе продолжить нельзя.
3. Выберите **Authorize**.

Ассистент подключён. Повторная авторизация не потребуется, если только подключение не будет удалено или срок его действия не истечёт.

<figure><img src="https://3440913522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdOfakg6W4j11rMNKDDMB%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 key. Не добавляйте его к 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**.

Чтобы использовать другую организацию, отключитесь и подключитесь снова, когда нужная организация будет активна.

## Отключение

Удалите сервер Phalcon Compliance в настройках MCP или коннекторов вашего ассистента. Ассистенты, поддерживающие отзыв OAuth-токена, также отзывают токен доступа на этом этапе.

Если вам нужно подтверждение, что доступ прекращён, обратитесь по адресу ***<phalcon_support@blocksec.com>***.

## Ограничения

* **Только чтение и проверки.** Подключение не может добавлять или удалять записи в чёрный и белый списки, редактировать данные клиентов, запускать или останавливать мониторинг, а также обрабатывать оповещения и дела.
* **Мониторинг, Alert Hub, управление клиентами и настройка Risk Engine** недоступны через ассистента. Для этого используйте панель управления или API.
* Отправка пакетов запросов требует тарифного плана Scale или Enterprise.

## Следующие шаги

* [Проверка адресов](https://docs.compliance.phalcon.blocksec.com/ru/user-manual/screening/addresses.md): проверка адресов в панели управления.
* [Проверка транзакций](https://docs.compliance.phalcon.blocksec.com/ru/user-manual/screening/transactions.md): принцип проверки на уровне переводов.
* [Тарифные планы, оплата и платежи](https://docs.compliance.phalcon.blocksec.com/ru/user-manual/account/plans-billing-and-payment.md): квоты и ограничения тарифных планов.
* [Документация API](https://docs.compliance.phalcon.blocksec.com/ru/api-documentation/introduction.md): базовый REST API.
