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

# MCP-Server

Diese Anleitung erklärt, wie Sie Phalcon Compliance mithilfe des Model Context Protocol (MCP) mit einem KI-Assistenten verbinden. Nach der Verbindung können Sie Adressen und Transaktionen prüfen und bestehende Prüfergebnisse direkt in einem Gespräch mit Ihrem Assistenten abrufen – ohne zum Phalcon Compliance-Dashboard wechseln zu müssen.

Phalcon Compliance erkennt AML-Risiken und meldet sie. Es ergreift jedoch keine Maßnahmen: Der MCP-Server dient ausschließlich zum Lesen und Prüfen und kann nichts in Ihrem Konto ändern.

## Voraussetzungen

* Ein aktives Phalcon Compliance-Konto. In allen Tarifen verfügbar.
* Ein KI-Assistent, der Remote-MCP-Server unterstützt.

## Assistenten verbinden

Phalcon Compliance hostet den MCP-Server. Sie müssen nichts installieren, und der Server wird automatisch auf dem neuesten Stand gehalten.

Fügen Sie die folgende Server-URL dort hinzu, wo Ihr Assistent MCP-Server oder Konnektoren verwaltet:

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

Wenn Ihr Assistent Phalcon Compliance zum ersten Mal aufruft, öffnet sich in Ihrem Browser eine Autorisierungsseite:

1. Melden Sie sich bei Phalcon Compliance an oder erstellen Sie ein Konto.
2. Überprüfen Sie, was Sie freigeben: wohin Sie zurückgeleitet werden, welches Konto und welche Organisation die Verbindung verwenden wird und welche Aktionen damit möglich sind. Wenn Sie bestätigen sollen, dass Sie die Rücksendeadresse erkennen, tun Sie dies – andernfalls können Sie nicht fortfahren.
3. Wählen Sie **Autorisieren**.

Ihr Assistent ist verbunden. Sie werden nicht erneut um Autorisierung gebeten, es sei denn, die Verbindung wird entfernt oder läuft ab.

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

### Einrichtung für bestimmte Assistenten

Folgen Sie den nachstehenden Anweisungen für Ihren Assistenten. Claude Code, Codex und Cursor benötigen zusätzlich zur Server-URL die in ihrer Konfiguration angezeigte Client-ID. Kopieren Sie den Wert exakt: Er identifiziert den Assistenten, nicht Ihr Phalcon Compliance-Konto, und ist kein API-Schlüssel. Fügen Sie ihn nicht an die Server-URL an.

Wenn Ihr Assistent hier nicht aufgeführt ist, wenden Sie sich unter <phalcon_support@blocksec.com> an den Support, um Anweisungen zur Verbindung zu erhalten.

#### Claude

Gehen Sie zu **Anpassen → Konnektoren**, wählen Sie **+** und dann **Benutzerdefinierten Konnektor hinzufügen** und fügen Sie die Server-URL ein.

Bei Team- und Enterprise-Tarifen fügt ein Inhaber den Konnektor einmalig unter **Organisationseinstellungen → Konnektoren** hinzu. Mitglieder verbinden sich anschließend individuell damit.

#### 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
```

Mit `--scope user` ist der Server in jedem Projekt verfügbar. Ohne diese Option wird er nur dem Projekt hinzugefügt, in dem Sie sich gerade befinden.

#### Codex

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

Der Server wird in `~/.codex/config.toml` eingetragen, das von der Codex-CLI, der IDE-Erweiterung und der Desktop-App verwendet wird. Wenn Sie ihn einmal hinzufügen, ist er in allen drei verfügbar.

#### Cursor

Fügen Sie den Server zu Ihrer `mcp.json` hinzu:

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

`CLIENT_ID` identifiziert Cursor selbst, nicht Ihr Konto. Kopieren Sie den Wert exakt wie gezeigt.

#### VS Code (GitHub Copilot)

Erstellen Sie `.vscode/mcp.json` in Ihrem Projekt:

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

Der oberste Schlüssel lautet `servers`, nicht `mcpServers`. Laden Sie anschließend das Fenster neu und wechseln Sie dann im Copilot Chat in den **Agent**-Modus – MCP-Tools sind nur dort verfügbar.

#### ChatGPT

Benutzerdefinierte MCP-Server erfordern den Entwicklermodus und einen kostenpflichtigen ChatGPT-Tarif und funktionieren nur im Web. In Business-, Enterprise- und Edu-Arbeitsbereichen muss ein Administrator benutzerdefiniertes MCP aktivieren, bevor jemand einen Server hinzufügen kann.

Folgen Sie den Anweisungen von OpenAI zum [Aktivieren des Entwicklermodus und Hinzufügen eines benutzerdefinierten Konnektors](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt) und verwenden Sie die obige Server-URL. Lassen Sie die Authentifizierung auf OAuth eingestellt.

## Was Ihr Assistent tun kann

Fragen Sie in einfacher Sprache – Ihr Assistent wählt die passende Aktion aus.

| Sie können fragen nach                                     | Wird das Prüfkontingent genutzt? |
| ---------------------------------------------------------- | -------------------------------- |
| Prüfung einer Adresse auf AML-Risiken                      | Ja – 1 Prüfung                   |
| Prüfung eines Transfers innerhalb einer Transaktion        | Ja – 1 Prüfung pro Transfer      |
| Dem neuesten Prüfergebnis für eine Adresse                 | Nein                             |
| Der Liste der Transfers in einer Transaktion               | Nein                             |
| Dem neuesten Prüfergebnis für einen Transfer               | Nein                             |
| Dem Ergebnis einer in die Warteschlange gestellten Prüfung | Nein                             |
| Ihrer Prüfungsnutzung über einen Zeitraum                  | Nein                             |
| Der Liste der unterstützten Chains                         | Nein                             |

Bei **Scale- und Enterprise**-Tarifen kann Ihr Assistent auch Stapel einreichen – bis zu 100 Adressen oder 50 Transaktionen pro Anfrage. Jeder Eintrag in einem Stapel verbraucht eine Prüfung.

Jedes Prüfergebnis enthält einen Link zum entsprechenden Datensatz im Phalcon Compliance-Dashboard.

{% hint style="warning" %}
Prüfergebnisse sind eine Momentaufnahme vom Zeitpunkt der Prüfung, und Ihr Assistent fasst sie möglicherweise zusammen oder formuliert sie um. Öffnen Sie den verlinkten Dashboard-Datensatz, bevor Sie eine Compliance-Entscheidung treffen.
{% endhint %}

### Chain auswählen

Dieselbe Adresse oder derselbe Transaktions-Hash kann auf mehreren Chains existieren. Wenn Sie nicht angeben, welche Chain Sie meinen, fragt Ihr Assistent vor der Prüfung nach – es sei denn, das Format weist eindeutig auf eine einzelne Chain hin, wie bei Bitcoin-, Tron- und Solana-Adressen. Die Beantwortung dieser Frage verbraucht kein Kontingent.

In den Ergebnissen wird die Chain angegeben, auf die sie sich beziehen. Überprüfen Sie, ob es die von Ihnen gemeinte Chain ist, bevor Sie Maßnahmen ergreifen.

### Transaktion prüfen

Die Prüfung erfolgt auf Transferebene, nicht auf Transaktionsebene. Eine Transaktion mit fünf Transfers erfordert fünf Prüfungen, um sie vollständig abzudecken.

Wenn eine Transaktion mehr als einen Transfer enthält, fragt Ihr Assistent vor der Prüfung nach, welchen Sie meinen – in der Regel nach der Adresse, die die Gelder erhalten hat. Die Beantwortung dieser Frage ist ein normaler Schritt, kein Fehler, und das Kontingent wird erst verbraucht, wenn der Transfer identifiziert wurde.

Standardmäßig umfasst eine Prüfung sowohl die Herkunft als auch das Ziel der Gelder. Bitten Sie Ihren Assistenten, die Prüfung auf eine Seite einzugrenzen, wenn Sie nur eine Richtung benötigen. In beiden Fällen kostet sie eine Prüfung.

### Risikostufen

Die Risikostufen ergeben sich aus Ihren eigenen Risk Engine-Regeln und nicht aus einer festen Skala. Jeder Befund trägt den Schweregrad, den Sie für die Regel festgelegt haben, die ihn ausgelöst hat, und die Gesamtstufe entspricht einfach dem höchsten dieser Werte. Dieselbe Adresse kann für eine andere Organisation eine andere Stufe ergeben.

Daraus folgen zwei Dinge:

* Da die Gesamtstufe dem höchsten Einzelbefund entspricht, fragen Sie Ihren Assistenten, welcher Befund dafür ausschlaggebend war.
* **Kein Risiko** bedeutet, dass keine Ihrer Regeln zutraf. Es bedeutet nicht, dass die Adresse oder der Transfer unbedenklich ist.

Fragen Sie Ihren Assistenten nach den Belegen für eine Stufe – dem ausgelösten Indikator, den Beträgen und der Anzahl der zutreffenden Ereignisse –, anstatt sich allein auf die Stufe zu verlassen.

Regeln werden im Phalcon Compliance-Dashboard konfiguriert und sind ab dem Essential-Tarif verfügbar. Sie können nicht über einen Assistenten geändert werden.

## Prüfkontingent

Prüfungen über Ihren Assistenten werden vom selben Kontingent abgezogen wie Prüfungen über das Dashboard und die API. Es gibt kein separates Kontingent.

Das Abrufen bestehender Ergebnisse verbraucht niemals Kontingent. Wenn bereits ein aktuelles Ergebnis vorliegt, kann Ihr Assistent dieses abrufen, anstatt eine neue Prüfung durchzuführen. Bitten Sie ihn um eine erneute Prüfung, wenn Sie den aktuellen Stand benötigen – dadurch wird eine neue Prüfung ausgeführt und ein Prüfungsguthaben verbraucht.

Wenn Ihr Kontingent aufgebraucht ist, teilt Ihr Assistent Ihnen dies mit und verlinkt auf die Abrechnungsseite. Um Ihre Nutzung jederzeit zu überprüfen, fragen Sie Ihren Assistenten nach Ihrer Prüfungsnutzung oder öffnen Sie das Dashboard.

## Berechtigungen

Die Verbindung hat genau dieselben Berechtigungen wie Sie im Phalcon Compliance-Dashboard – nicht mehr und nicht weniger.

Wenn Ihre Rolle in der Organisation schreibgeschützt ist, kann Ihr Assistent bestehende Prüfergebnisse abrufen, aber keine neuen Prüfungen durchführen. Wenn Sie Prüfungen durchführen müssen, bitten Sie einen Organisationsadministrator um Zugriff.

Ein Assistent kann auch selbst schreibgeschützten Zugriff anfordern. Welche Aktionen über eine Verbindung möglich sind, wird auf der Autorisierungsseite aufgeführt, bevor Sie **Autorisieren** auswählen.

## Organisation

Die Verbindung ist an eine einzelne Organisation gebunden: die Organisation, die Sie zuletzt verwendet haben, als Sie die Verbindung autorisiert haben. Die Organisation wird auf der Autorisierungsseite angezeigt, bevor Sie **Autorisieren** auswählen.

Um eine andere Organisation zu verwenden, trennen Sie die Verbindung und verbinden Sie sich erneut, während diese Organisation aktiv ist.

## Verbindung trennen

Entfernen Sie den Phalcon Compliance-Server aus den MCP- oder Konnektor-Einstellungen Ihres Assistenten. Assistenten, die den Widerruf von OAuth-Tokens unterstützen, widerrufen zu diesem Zeitpunkt auch das Zugriffstoken.

Wenn Sie eine Bestätigung benötigen, dass der Zugriff beendet wurde, wenden Sie sich an ***<phalcon_support@blocksec.com>***.

## Einschränkungen

* **Nur Lesen und Prüfen.** Die Verbindung kann keine Einträge zu Black- oder Whitelists hinzufügen oder daraus entfernen, Kunden bearbeiten, die Überwachung starten oder stoppen oder auf Warnmeldungen und Fälle reagieren.
* **Überwachung, Alert Hub, Kundenverwaltung und Risk Engine-Konfiguration** sind über einen Assistenten nicht verfügbar. Verwenden Sie dafür das Dashboard oder die API.
* Für das Einreichen von Stapeln ist ein Scale- oder Enterprise-Tarif erforderlich.

## Nächste Schritte

* [Adressprüfung](https://docs.compliance.phalcon.blocksec.com/de/user-manual/screening/addresses.md): Adressen im Dashboard prüfen.
* [Transaktionsprüfung](https://docs.compliance.phalcon.blocksec.com/de/user-manual/screening/transactions.md): So funktioniert die Prüfung auf Transferebene.
* [Tarife, Abrechnung und Zahlung](https://docs.compliance.phalcon.blocksec.com/de/user-manual/account/plans-billing-and-payment.md): Kontingent- und Tariflimits.
* [API-Dokumentation](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/introduction.md): Die zugrunde liegende REST-API.
