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

# Serveur MCP

Ce guide explique comment connecter Phalcon Compliance à un assistant IA à l’aide du Model Context Protocol (MCP). Une fois connecté, vous pouvez vérifier des adresses et des transactions, et consulter les résultats de vérifications existants, directement dans une conversation avec votre assistant — sans passer par le tableau de bord de Phalcon Compliance.

Phalcon Compliance identifie et signale les risques AML. Il n’intervient pas : le serveur MCP permet uniquement de consulter et d’effectuer des vérifications, et ne peut rien modifier dans votre compte.

## Prérequis

* Un compte Phalcon Compliance actif. Disponible avec tous les forfaits.
* Un assistant IA prenant en charge les serveurs MCP distants.

## Connecter votre assistant

Phalcon Compliance héberge le serveur MCP. Rien à installer, et il est automatiquement mis à jour.

Ajoutez l’URL du serveur suivante là où votre assistant gère les serveurs MCP ou les connecteurs :

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

La première fois que votre assistant appelle Phalcon Compliance, votre navigateur ouvre une page d’autorisation :

1. Connectez-vous à Phalcon Compliance ou créez un compte.
2. Vérifiez ce que vous autorisez : la destination vers laquelle vous serez redirigé, le compte et l’organisation utilisés par la connexion, ainsi que les actions qu’elle pourra effectuer. Si vous devez confirmer que vous reconnaissez l’adresse de retour, faites-le — vous ne pourrez pas continuer autrement.
3. Sélectionnez **Autoriser**.

Votre assistant est connecté. Vous n’aurez pas à autoriser de nouveau la connexion, sauf si elle est supprimée ou expire.

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

### Configuration pour certains assistants

Suivez les instructions correspondant à votre assistant ci-dessous. Claude Code, Codex et Cursor nécessitent l’ID client indiqué dans leur configuration, en plus de l’URL du serveur. Copiez la valeur exactement : elle identifie l’assistant, et non votre compte Phalcon Compliance, et ce n’est pas une clé API. Ne l’ajoutez pas à l’URL du serveur.

Pour obtenir les instructions de connexion d’un assistant qui ne figure pas dans cette liste, contactez <phalcon_support@blocksec.com>.

#### Claude

Allez dans **Personnaliser → Connecteurs**, sélectionnez **+**, puis **Ajouter un connecteur personnalisé**, et collez l’URL du serveur.

Avec les forfaits Team et Enterprise, un propriétaire ajoute le connecteur une seule fois dans **Paramètres de l’organisation → Connecteurs**. Les membres s’y connectent ensuite individuellement.

#### 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` rend le serveur accessible dans chaque projet. Sans cette option, il est ajouté uniquement au projet dans lequel vous vous trouvez.

#### Codex

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

Le serveur est ajouté à `~/.codex/config.toml`, lu par Codex CLI, l’extension IDE et l’application de bureau. Il suffit de l’ajouter une seule fois pour couvrir les trois.

#### Cursor

Ajoutez le serveur à votre fichier `mcp.json` :

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

`CLIENT_ID` identifie Cursor lui-même, et non votre compte. Copiez-le exactement comme indiqué.

#### VS Code (GitHub Copilot)

Créez `.vscode/mcp.json` dans votre projet :

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

La clé de premier niveau est `servers`, et non `mcpServers`. Rechargez ensuite la fenêtre, puis passez Copilot Chat en mode **Agent** — les outils MCP ne sont disponibles que dans ce mode.

#### ChatGPT

Les serveurs MCP personnalisés nécessitent le mode développeur et un forfait ChatGPT payant, et ne fonctionnent que sur le Web. Dans les espaces de travail Business, Enterprise et Edu, un administrateur doit activer les MCP personnalisés avant que quiconque puisse en ajouter un.

Suivez les instructions d’OpenAI pour [activer le mode développeur et ajouter un connecteur personnalisé](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt), et utilisez l’URL du serveur ci-dessus. Laissez l’authentification définie sur OAuth.

## Ce que votre assistant peut faire

Posez votre question en langage courant — votre assistant sélectionne l’action appropriée.

| Vous pouvez demander                                                 | Utilise le quota de vérifications  |
| -------------------------------------------------------------------- | ---------------------------------- |
| Vérifier le risque AML associé à une adresse                         | Oui — 1 vérification               |
| Vérifier un transfert au sein d’une transaction                      | Oui — 1 vérification par transfert |
| Obtenir le résultat de vérification le plus récent pour une adresse  | Non                                |
| Obtenir la liste des transferts d’une transaction                    | Non                                |
| Obtenir le résultat de vérification le plus récent pour un transfert | Non                                |
| Obtenir le résultat d’une vérification en attente                    | Non                                |
| Consulter votre utilisation des vérifications sur une période donnée | Non                                |
| Obtenir la liste des chaînes prises en charge                        | Non                                |

Avec les forfaits **Scale et Enterprise**, votre assistant peut également envoyer des lots — jusqu’à 100 adresses ou 50 transactions par demande. Chaque élément d’un lot utilise une vérification.

Chaque résultat de vérification comprend un lien vers l’enregistrement correspondant dans le tableau de bord Phalcon Compliance.

{% hint style="warning" %}
Les résultats de vérification sont un instantané de la situation au moment où la vérification a été effectuée, et votre assistant peut les résumer ou les reformuler. Ouvrez l’enregistrement lié dans le tableau de bord avant de prendre une décision de conformité.
{% endhint %}

### Choisir une chaîne

Une même adresse ou un même hachage de transaction peut exister sur plusieurs chaînes. Si vous ne précisez pas la chaîne concernée, votre assistant vous le demandera avant d’effectuer la vérification — à moins que le format ne permette d’identifier une seule chaîne, comme c’est le cas pour les adresses Bitcoin, Tron et Solana. Répondre à cette question n’utilise aucun quota.

Les résultats indiquent la chaîne concernée. Vérifiez qu’il s’agit bien de celle que vous aviez en tête avant d’agir.

### Vérifier une transaction

La vérification s’effectue au niveau du transfert, et non de la transaction. Une transaction contenant cinq transferts nécessite cinq vérifications pour être entièrement couverte.

Si une transaction contient plusieurs transferts, votre assistant vous demandera lequel vous souhaitez vérifier — généralement en vous demandant l’adresse qui a reçu les fonds. Répondre à cette question est une étape normale, et non une erreur, et aucun quota n’est utilisé tant que le transfert n’a pas été identifié.

Par défaut, une vérification couvre à la fois l’origine et la destination des fonds. Demandez à votre assistant de limiter la vérification à un seul côté si vous n’avez besoin que d’une seule direction. Dans les deux cas, cela coûte une vérification.

### Niveaux de risque

Les niveaux de risque sont définis par les règles de votre propre Risk Engine, et non par une échelle fixe. Chaque constat est associé à la gravité que vous avez définie pour la règle qui l’a produit, et le niveau global correspond simplement au niveau le plus élevé parmi ces constats. Une même adresse peut être associée à un niveau différent pour une autre organisation.

Cela entraîne deux conséquences :

* Comme le niveau global correspond au constat le plus élevé, demandez à votre assistant quel constat en est à l’origine.
* **Aucun risque** signifie qu’aucune de vos règles ne correspond. Cela ne signifie pas que l’adresse ou le transfert est exempt de risque.

Demandez à votre assistant les éléments qui justifient un niveau — l’indicateur déclenché, les montants, le nombre d’événements correspondants — plutôt que de vous fier uniquement au niveau.

Les règles sont configurées dans le tableau de bord Phalcon Compliance et sont disponibles avec les forfaits Essential et supérieurs. Elles ne peuvent pas être modifiées par l’intermédiaire d’un assistant.

## Quota de vérifications

Les vérifications effectuées par votre assistant utilisent le même quota que celles du tableau de bord et de l’API. Il n’y a pas de quota distinct.

La consultation des résultats existants n’utilise jamais de quota. Si un résultat récent existe déjà, votre assistant peut le consulter au lieu d’effectuer une nouvelle vérification. Demandez-lui de relancer la vérification si vous avez besoin de connaître la situation actuelle — cela effectue une nouvelle vérification et utilise une unité de votre quota.

Lorsque votre quota est épuisé, votre assistant vous en informe et fournit un lien vers la page de facturation. Pour vérifier votre utilisation à tout moment, demandez à votre assistant de vous indiquer votre utilisation des vérifications, ou ouvrez le tableau de bord.

## Autorisations

La connexion dispose exactement des mêmes autorisations que vous dans le tableau de bord Phalcon Compliance — ni plus ni moins.

Si votre rôle dans l’organisation est limité à la consultation, votre assistant peut lire les résultats de vérifications existants, mais ne peut pas effectuer de nouvelles vérifications. Si vous devez en effectuer, demandez un accès à un administrateur de l’organisation.

Un assistant peut également demander un accès en lecture seule pour lui-même. Les actions autorisées pour une connexion sont indiquées sur la page d’autorisation avant que vous sélectionniez **Autoriser**.

## Organisation

La connexion est associée à une seule organisation : celle que vous utilisiez le plus récemment lorsque vous l’avez autorisée. L’organisation est indiquée sur la page d’autorisation avant que vous sélectionniez **Autoriser**.

Pour utiliser une autre organisation, déconnectez-vous, puis reconnectez-vous pendant que cette organisation est active.

## Déconnecter

Supprimez le serveur Phalcon Compliance des paramètres MCP ou des connecteurs de votre assistant. Les assistants qui prennent en charge la révocation des jetons OAuth révoquent également le jeton d’accès à ce moment-là.

Si vous avez besoin de confirmation que l’accès a été révoqué, contactez ***<phalcon_support@blocksec.com>***.

## Limitations

* **Consultation et vérifications uniquement.** La connexion ne peut pas ajouter ou supprimer des entrées de liste noire ou de liste blanche, modifier les clients, démarrer ou arrêter la surveillance, ni agir sur les alertes et les dossiers.
* **La surveillance, Alert Hub, la gestion des clients et la configuration de Risk Engine** ne sont pas disponibles par l’intermédiaire d’un assistant. Utilisez le tableau de bord ou l’API pour ces actions.
* L’envoi de lots nécessite un forfait Scale ou Enterprise.

## Étapes suivantes

* [Vérification des adresses](https://docs.compliance.phalcon.blocksec.com/fr/user-manual/screening/addresses.md) : vérifier des adresses dans le tableau de bord.
* [Vérification des transactions](https://docs.compliance.phalcon.blocksec.com/fr/user-manual/screening/transactions.md) : comprendre le fonctionnement de la vérification au niveau des transferts.
* [Forfaits, facturation et paiements](https://docs.compliance.phalcon.blocksec.com/fr/user-manual/account/plans-billing-and-payment.md) : quotas et limites des forfaits.
* [Documentation de l’API](https://docs.compliance.phalcon.blocksec.com/fr/api-documentation/introduction.md) : l’API REST sous-jacente.
