> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enclave.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Enclave in these docs is the code and cloud security platform at enclave.ai. It is not Open Enclave, Intel SGX or other hardware enclaves, or enclave.gg.
> People use Enclave in the web app at https://app.enclave.ai or the desktop app. These docs describe no public Enclave API or CLI, so don't invent endpoints, commands, or config files.
> Connecting an integration needs a person to sign in and approve access in a browser. Tell the user the exact step to take instead of saying you completed it.

# MCP

> Verbinden Sie Claude Code, Codex, Cursor, VS Code oder Claude über MCP mit Enclave, damit Ihr KI-Assistent Findings lesen und triagieren, Pull-Request-Scans lesen, Workflows lesen und bearbeiten, Workflow-Runs starten, stoppen und lesen, den Cloud-Graphen abfragen sowie den Threat Feed und Enclaves CVE-Analysen lesen kann.

Verbinden Sie Ihren KI-Assistenten über das Model Context Protocol (MCP) mit Enclave. Ihr Assistent kann dann Findings auflisten und lesen, den Status eines Findings ändern, Enclaves Scan eines Pull Requests lesen, Workflows lesen, erstellen und bearbeiten, Workflow-Runs und die von ihnen gespeicherten Datensätze starten, stoppen und lesen, den Cloud-Graphen und die Assets Ihrer Organisation abfragen sowie den Threat Feed und Enclaves CVE-Analysen lesen, alles aus Ihrem Editor oder Terminal.

## Enclave-MCP-Server

| | |
| - | - |
| **Server-URL** | `https://mcp.enclave.ai/` |
| **Transport** | Streamable HTTP |
| **Authentifizierung** | OAuth-Anmeldung oder ein MCP-Schlüssel |
| **Geltungsbereich** | Eine Organisation pro Verbindung |

Die meisten Clients akzeptieren diese Konfiguration:

```json mcp.json theme={null}
{
  "mcpServers": {
    "enclave": {
      "url": "https://mcp.enclave.ai/"
    }
  }
}
```

> [!NOTE]
>
> Der Server unterstützt nur Streamable HTTP. Den älteren SSE-Transport bietet er nicht an. Verwenden Sie daher einen Client, der sich mit einem entfernten HTTP-Server verbinden kann.

## Zugriff und Berechtigungen

Sie benötigen ein Enclave-Konto und die Mitgliedschaft in einer Organisation.

Organisationsbezogene Tools erfordern einen nutzbaren Plan für die Organisation, auch bei Leseaufrufen. Eine Testphase zählt ebenfalls als nutzbarer Plan. Diese Anforderung gilt nicht für öffentliche Tools.

Jede OAuth-Verbindung und jeder MCP-Schlüssel handelt in Ihrem Namen in genau einer Organisation. Enclave legt diese Organisation fest, wenn Sie die Verbindung autorisieren oder den Schlüssel erstellen, und zwar die Organisation, in der Sie gerade arbeiten. Tool-Aufrufe können die Organisation nicht wechseln. Um eine andere Organisation zu verbinden, wechseln Sie in Enclave zu ihr und autorisieren dann eine weitere Verbindung oder erstellen einen weiteren Schlüssel.

Ihre [Rolle](https://docs.enclave.ai/de/admin/roles.md) bestimmt, welche Tools Sie verwenden können:

| Was Sie tun können | Berechtigung | Standardrollen |
| - | - | - |
| Findings und Pull-Request-Scans lesen | `finding:read` | **Owner**, **Admin**, **Member** |
| Status eines Findings ändern | `finding:status_change` | **Owner**, **Admin** |
| Workflows lesen | `workflow:read` | **Owner**, **Admin**, **Member** |
| Workflows erstellen oder bearbeiten | `workflow:write` | **Owner**, **Admin** |
| Workflows archivieren | `workflow:delete` | **Owner**, **Admin** |
| Workflow mit Triggern speichern | `workflow_trigger:write` | **Owner**, **Admin** |
| Workflow-Runs und ihre Datensätze lesen | `agent:read` | **Owner**, **Admin**, **Member** |
| Runs starten und stoppen sowie Datensätze löschen | `agent:write` | **Owner**, **Admin** |
| Enclaves CVE-Analysen lesen | `session:read` | **Owner**, **Admin**, **Member** |
| Den Cloud-Graphen abfragen und Cloud-Assets auflisten | `asset:read` | **Owner**, **Admin**, **Member** |

Benutzerdefinierte Rollen benötigen die passenden Berechtigungen. Nur **Owner** und **Admins** können Trigger speichern, weil einer benutzerdefinierten Rolle `workflow_trigger:write` nicht zugewiesen werden kann. Sie erreichen nur Ressourcen, die Sie in Enclave sehen können. Alles außerhalb der verbundenen Organisation oder vor Ihnen Verborgene gibt „nicht gefunden“ zurück.

Wenn Sie aus einer Organisation entfernt werden, werden Ihre OAuth-Verbindungen und MCP-Schlüssel für diese Organisation widerrufen.

## Authentifizierung

| Methode | Verwenden Sie sie, wenn | So funktioniert es |
| - | - | - |
| **OAuth** (empfohlen) | Ihr Client zur Anmeldung einen Browser öffnen kann. | Sie melden sich bei Enclave an und genehmigen die Verbindung. Der Genehmigungsbildschirm nennt die Organisation, in der die Verbindung handeln wird. |
| **MCP-Schlüssel** | Ihr Client ein festes Bearer-Token braucht, zum Beispiel in einem Skript oder einer Umgebung ohne Oberfläche. | Ihr Client sendet den Schlüssel in einem `Authorization: Bearer`-Header. |

MCP-Schlüssel funktionieren nur mit dem MCP-Server von Enclave. Die REST-API von Enclave akzeptiert sie nicht.

### MCP-Schlüssel erstellen

Sie benötigen Zugriff auf **Settings** in der Organisation, die Sie verbinden möchten.

**1. Schlüssel erstellen**

Öffnen Sie **Settings → MCP** in [Enclave](https://app.enclave.ai). Klicken Sie unter **API Keys** auf **Create Key**. Geben Sie einen **Name** ein, wählen Sie eine **Expiration** und klicken Sie auf **Create Key**.

**2. Schlüssel kopieren**

Kopieren Sie den Schlüssel, sobald er erscheint. Enclave zeigt ihn nur einmal an. Wählen Sie unter dem Schlüssel Ihren Client, um seinen Einrichtungsbefehl oder seine Konfiguration mit bereits eingesetztem Schlüssel zu kopieren.

![Der Dialog API Key Created mit dem neuen Schlüssel und einem einfügefertigen Claude-Code-Befehl, der ihn enthält](https://mintcdn.com/enclave/s6Xyaf3D28YdPXGs/images/product/mcp-key-created.png?fit=max\&auto=format\&n=s6Xyaf3D28YdPXGs\&q=85\&s=227a224bc4edb7f5b7ebc2a648790cb2)

Halten Sie den Schlüssel geheim. Um ihn zu widerrufen, klicken Sie unter **API Keys** auf die Widerrufen-Schaltfläche daneben. Alle Clients, die diesen Schlüssel verwenden, verlieren den Zugriff.

### Eine verbundene App widerrufen

Unter **Connected apps** listet **Settings → MCP** die Apps auf, die Sie mit OAuth in der Organisation genehmigt haben, in der Sie gerade arbeiten, jeweils mit Verbindungszeitpunkt und letzter Aktivität.

Um eine App zu widerrufen, klicken Sie daneben auf **Revoke** und bestätigen Sie. Die App verliert den Zugriff und muss neu verbunden werden. Wenn Sie Enclave aus Ihrem Client entfernen, endet ihr Zugriff nicht. Widerrufen Sie die App deshalb auch hier.

## Einrichtungsanleitung

**Settings → MCP** in Enclave zeigt diese Anleitung auch unter **Setup**. Wählen Sie **OAuth** oder **API key** und Ihren Client und kopieren Sie sie.

> [tab] Claude Code
>
> **Mit OAuth:**
>
> ```bash theme={null}
> claude mcp add --transport http enclave https://mcp.enclave.ai/
> ```
>
> Führen Sie in Claude Code `/mcp` aus, wählen Sie `enclave` und dann **Authenticate**. Melden Sie sich im geöffneten Browser bei Enclave an und genehmigen Sie die Verbindung.
>
> **Mit einem MCP-Schlüssel:**
>
> ```bash theme={null}
> claude mcp add --transport http enclave https://mcp.enclave.ai/ \
>   --header "Authorization: Bearer <your-mcp-key>"
> ```
>
> > [!TIP]
> >
> > Fügen Sie dem Befehl `-s user` hinzu, um Enclave in jedem Projekt zu verwenden, nicht nur im aktuellen Ordner.

> [tab] Codex
>
> **Mit OAuth:**
>
> ```bash theme={null}
> codex mcp add enclave --url https://mcp.enclave.ai/
> ```
>
> Codex öffnet einen Browser. Melden Sie sich bei Enclave an und genehmigen Sie die Verbindung.
>
> **Mit einem MCP-Schlüssel:**
>
> ```bash theme={null}
> export ENCLAVE_MCP_API_KEY="<your-mcp-key>"
> codex mcp add enclave --url https://mcp.enclave.ai/ --bearer-token-env-var ENCLAVE_MCP_API_KEY
> ```

> [tab] Cursor
>
> Wählen Sie in Enclave unter **Settings → MCP** **Cursor** aus und klicken Sie auf **Add to Cursor**. Cursor öffnet sich mit installiertem Enclave. Ist **API key** ausgewählt, erstellt Enclave einen neuen Schlüssel und fügt ihn für Sie hinzu.
>
> Um es von Hand zu konfigurieren, fügen Sie Folgendes zu `.cursor/mcp.json` hinzu:
>
> **Mit OAuth:**
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "enclave": {
>       "url": "https://mcp.enclave.ai/"
>     }
>   }
> }
> ```
>
> **Mit einem MCP-Schlüssel:**
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "enclave": {
>       "url": "https://mcp.enclave.ai/",
>       "headers": {
>         "Authorization": "Bearer <your-mcp-key>"
>       }
>     }
>   }
> }
> ```

> [tab] VS Code
>
> Fügen Sie Folgendes zu `.vscode/mcp.json` hinzu:
>
> **Mit OAuth:**
>
> ```json theme={null}
> {
>   "servers": {
>     "enclave": {
>       "type": "http",
>       "url": "https://mcp.enclave.ai/"
>     }
>   }
> }
> ```
>
> **Mit einem MCP-Schlüssel:**
>
> ```json theme={null}
> {
>   "servers": {
>     "enclave": {
>       "type": "http",
>       "url": "https://mcp.enclave.ai/",
>       "headers": {
>         "Authorization": "Bearer <your-mcp-key>"
>       }
>     }
>   }
> }
> ```

> [tab] Claude
>
> Öffnen Sie in Claude (claude.ai oder Claude Desktop) **Settings → Connectors** und klicken Sie auf **Add custom connector**. Geben Sie `Enclave` als Namen und `https://mcp.enclave.ai/` als Server-URL ein. Klicken Sie auf **Connect**, melden Sie sich dann bei Enclave an und genehmigen Sie die Verbindung.

Andere Clients, die entfernte MCP-Server über Streamable HTTP unterstützen, funktionieren genauso. Richten Sie sie auf `https://mcp.enclave.ai/` aus und melden Sie sich mit OAuth an, oder senden Sie einen MCP-Schlüssel im `Authorization: Bearer`-Header.

## Verfügbare Tools

Jedes Tool handelt in der verbundenen Organisation, außer den Tools für den Threat Feed und die CVE-Analysen, die für alle gleiche Daten lesen. Lese-Tools ändern nie Daten, sodass Ihr Client sie erlauben kann, ohne Änderungen zu erlauben.

| Bereich | Leseaktionen | Aktionen, die Daten ändern |
| - | - | - |
| Findings | `enclave_finding_read` `list`: Findings suchen. `get`: bis zu 10 Findings lesen. | `enclave_finding_manage` `set_status`: Status eines Findings ändern. |
| Pull-Request-Scans | `enclave_pull_request_scan_read` `get`: Scan eines Pull Requests lesen. | Keine |
| Workflows | `enclave_workflow_read` `list`: Workflows suchen. `get`: einen Workflow lesen. `revisions`: gespeicherte Versionen auflisten. `rules`: wie man einen Workflow schreibt. | `enclave_workflow_manage` `create`: neuen Workflow speichern. `update`: Workflow bearbeiten. `archive`: Workflow archivieren. |
| Workflow-Runs | `enclave_workflow_run_read` `list`: Runs suchen. `get`: einen Run lesen. `steps`: Schritte eines Runs lesen. `output`: Ausgabe eines Runs lesen. | `enclave_workflow_run_manage` `start`: Run starten. `stop`: Run stoppen. |
| Workflow-Datensätze | `enclave_workflow_record_read` `list`: Datensätze eines Workflows suchen. `get`: einen Datensatz lesen. | `enclave_workflow_record_manage` `delete`: Datensatz löschen. |
| Threat Feed | `enclave_threat_feed_read` `list`: den Feed auflisten oder durchsuchen. `get`: eine CVE im Feed lesen. | Keine |
| CVE-Analysen | `enclave_cve_read` `get`: Enclaves Analyse von bis zu 10 CVEs lesen. | Keine |
| Cloud-Graph und Repositories | `enclave_graph_read` `query`: den Cloud-Graphen abfragen. `validate`: eine Abfrage prüfen, ohne sie auszuführen. `list_assets`: Cloud-Assets auflisten. `list_repos`: Repositories und ihre Slugs auflisten. | Keine |
| Konto | `enclave_account_read` `get`: zeigen, als wer Sie verbunden sind, Ihre Organisation, Ihre Rolle und deren Integrationen. | Keine |

* Ohne Statusfilter gibt `list` nur **Confirmed**-Findings zurück. Ein Proof of Concept erscheint nur bei **Confirmed**-Findings.
* Die Statuswerte entsprechen den Status in Enclave: `unverified` (**Needs evidence**), `verified` (**Confirmed**), `resolved` (**Resolved**), `invalid` (**Inactive**) und `discarded` (**Dismissed**).
* Geben Sie einen Pull Request als `<repository-slug>#<number>` an.
* Integrierte Workflows sind schreibgeschützt. Aktivierte [Trigger](https://docs.enclave.ai/de/workflows/triggers.md) starten Runs, daher kann das Speichern eines Workflows mit Triggern einen Run starten.
* Das Starten eines [Runs](https://docs.enclave.ai/de/workflows/runs.md) verbraucht Credits. Sie können einen Workflow starten, der keine Eingaben erwartet oder Findings oder Repositories als Eingaben erwartet. Geben Sie jedes Finding mit seiner kurzen ID an, zum Beispiel `AbCd12`, und jedes Repository mit seinem Slug aus `list_repos`. Jede Repository-Eingabe nimmt ein Repository. Starten Sie Workflows, die einen Pull Request oder eine Angriffsfläche erwarten, in Enclave.
* Das Löschen eines Datensatzes ist endgültig.
* Für das Lesen des [Threat Feed](https://docs.enclave.ai/de/threat-feed.md) ist keine Berechtigung nötig. `enclave_cve_read` gibt nur Analysen zurück, die Enclave bereits abgeschlossen hat. Es startet nie eine Recherche und verbraucht keine Credits. Wie Sie eine Analyse starten, lesen Sie unter [Eine Analyse anfordern](https://docs.enclave.ai/de/threat-feed.md#eine-analyse-anfordern).
* Repositories auflisten und Ihr Konto lesen erfordern keine Berechtigung über die Mitgliedschaft hinaus.

## Beispiel-Prompts

* "Liste meine kritischen und hohen **Confirmed**-Findings in Enclave auf."
* "Lies das Enclave-Finding `AbCd12` und behebe es in diesem Repository."
* "Markiere das Finding `AbCd12` als **Resolved** mit der Begründung 'Behoben in Pull Request 123'."
* "Lies die Enclave-Workflow-Regeln und erstelle dann einen Workflow, der jeden Montag um 08:00 UTC `acme/api` nach Secrets durchsucht."
* "Starte meinen Enclave-Workflow zur Finding-Triage für das Finding `AbCd12` und zeig mir seine Ausgabe, wenn er fertig ist."
* "Ist CVE-2026-1234 im Threat Feed von Enclave? Fasse Enclaves Analyse dazu zusammen."
* "Welche meiner Cloud-Assets in Enclave sind aus dem Internet erreichbar?"

## Fehlerbehebung

> [accordion] Der Server lehnt meinen Schlüssel ab (HTTP 401)
>
> Der Schlüssel ist abgelaufen oder wurde widerrufen, oder Sie wurden aus seiner Organisation entfernt. Erstellen Sie einen neuen Schlüssel in der Organisation, die Sie verbinden möchten, und aktualisieren Sie Ihren Client.
>
> Manche Clients, etwa Claude Code, weichen nicht auf OAuth aus, solange ein Schlüssel konfiguriert ist. Um zu OAuth zu wechseln, entfernen Sie den Server aus Ihrem Client und fügen ihn ohne den `Authorization`-Header erneut hinzu.

> [accordion] Ein Finding oder Workflow, den ich in Enclave sehe, gibt „nicht gefunden“ zurück
>
> Ihre Verbindung handelt in einer anderen Organisation. Eine Verbindung bleibt in der Organisation, in der Sie gearbeitet haben, als Sie sie autorisiert oder ihren Schlüssel erstellt haben. Wechseln Sie in Enclave zur richtigen Organisation und verbinden Sie sich erneut.

> [accordion] Eine Aktion wird abgelehnt
>
> Ihrer Rolle fehlt die Berechtigung, die die Aktion braucht. Siehe [Zugriff und Berechtigungen](#zugriff-und-berechtigungen), oder fragen Sie einen **Owner** oder **Admin** Ihrer Organisation.

> [accordion] Mein Client kann sich gar nicht verbinden
>
> Prüfen Sie, ob Ihr Client entfernte MCP-Server über Streamable HTTP unterstützt. Der Server bietet den älteren SSE-Transport nicht an.

## Verwandte Ressourcen

* [Rollen](https://docs.enclave.ai/de/admin/roles.md)
* [Trigger](https://docs.enclave.ai/de/workflows/triggers.md)
* [Runs](https://docs.enclave.ai/de/workflows/runs.md)
* [Threat Feed](https://docs.enclave.ai/de/threat-feed.md)
* [Model Context Protocol](https://modelcontextprotocol.io)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.