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

> Connectez Claude Code, Codex, Cursor, VS Code ou Claude à Enclave via MCP pour que votre assistant IA puisse lire et trier les findings, lire les analyses de pull requests, lire et modifier les workflows, lancer, arrêter et lire les exécutions de workflows, interroger le graphe cloud, et lire le Threat Feed et les analyses de CVE d'Enclave.

Connectez votre assistant IA à Enclave avec le Model Context Protocol (MCP). Votre assistant peut alors lister et lire les findings, changer le statut d'un finding, lire l'analyse d'une pull request par Enclave, lire, créer et modifier des workflows, lancer, arrêter et lire des exécutions de workflows et les enregistrements qu'elles sauvegardent, interroger le graphe cloud et les actifs de votre organisation, et lire le Threat Feed et les analyses de CVE d'Enclave, le tout depuis votre éditeur ou votre terminal.

## Serveur MCP d'Enclave

| | |
| - | - |
| **URL du serveur** | `https://mcp.enclave.ai/` |
| **Transport** | Streamable HTTP |
| **Authentification** | Connexion OAuth ou clé MCP |
| **Portée** | Une organisation par connexion |

La plupart des clients acceptent cette configuration :

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

> [!NOTE]
>
> Le serveur ne prend en charge que Streamable HTTP. Il ne propose pas l'ancien transport SSE : utilisez un client capable de se connecter à un serveur HTTP distant.

## Accès et autorisations

Vous avez besoin d'un compte Enclave et d'être membre d'une organisation.

Les outils liés à une organisation nécessitent un forfait utilisable pour celle-ci, y compris pour les appels de lecture. Une période d'essai compte aussi comme forfait utilisable. Cette exigence ne s'applique pas aux outils publics.

Chaque connexion OAuth ou clé MCP agit en votre nom dans une seule organisation. Enclave fixe cette organisation quand vous autorisez la connexion ou créez la clé, en utilisant l'organisation dans laquelle vous travaillez à ce moment-là. Les appels d'outils ne peuvent pas changer d'organisation. Pour connecter une autre organisation, basculez vers elle dans Enclave, puis autorisez une autre connexion ou créez une autre clé.

Votre [rôle](https://docs.enclave.ai/fr/admin/roles.md) détermine les outils que vous pouvez utiliser :

| Ce que vous pouvez faire | Autorisation | Rôles par défaut |
| - | - | - |
| Lire les findings et les analyses de pull requests | `finding:read` | **Owner**, **Admin**, **Member** |
| Changer le statut d'un finding | `finding:status_change` | **Owner**, **Admin** |
| Lire les workflows | `workflow:read` | **Owner**, **Admin**, **Member** |
| Créer ou modifier des workflows | `workflow:write` | **Owner**, **Admin** |
| Archiver des workflows | `workflow:delete` | **Owner**, **Admin** |
| Enregistrer un workflow avec des déclencheurs | `workflow_trigger:write` | **Owner**, **Admin** |
| Lire les exécutions de workflows et leurs enregistrements | `agent:read` | **Owner**, **Admin**, **Member** |
| Lancer et arrêter des exécutions, et supprimer des enregistrements | `agent:write` | **Owner**, **Admin** |
| Lire les analyses de CVE d'Enclave | `session:read` | **Owner**, **Admin**, **Member** |
| Interroger le graphe cloud et lister les actifs cloud | `asset:read` | **Owner**, **Admin**, **Member** |

Les rôles personnalisés ont besoin des autorisations correspondantes. Seuls les **Owners** et **Admins** peuvent enregistrer des déclencheurs, car un rôle personnalisé ne peut pas recevoir `workflow_trigger:write`. Vous n'accédez qu'aux ressources que vous voyez dans Enclave. Tout ce qui se trouve hors de l'organisation connectée, ou qui vous est masqué, renvoie introuvable.

Si vous êtes retiré d'une organisation, vos connexions OAuth et vos clés MCP pour celle-ci sont révoquées.

## Authentification

| Méthode | À utiliser quand | Fonctionnement |
| - | - | - |
| **OAuth** (recommandé) | Votre client peut ouvrir un navigateur pour vous connecter. | Vous vous connectez à Enclave et approuvez la connexion. L'écran d'approbation indique l'organisation dans laquelle la connexion agira. |
| **Clé MCP** | Votre client a besoin d'un jeton bearer fixe, par exemple dans un script ou un environnement sans interface. | Votre client envoie la clé dans un en-tête `Authorization: Bearer`. |

Les clés MCP ne fonctionnent qu'avec le serveur MCP d'Enclave. L'API REST d'Enclave ne les accepte pas.

### Créer une clé MCP

Vous devez avoir accès à **Settings** dans l'organisation à connecter.

**1. Créez la clé**

Ouvrez **Settings → MCP** dans [Enclave](https://app.enclave.ai). Sous **API Keys**, cliquez sur **Create Key**. Saisissez un **Name**, choisissez une **Expiration**, puis cliquez sur **Create Key**.

**2. Copiez la clé**

Copiez la clé quand elle apparaît. Enclave ne l'affiche qu'une seule fois. Sous la clé, choisissez votre client pour copier sa commande ou sa configuration d'installation, avec la clé déjà renseignée.

![La boîte de dialogue API Key Created avec la nouvelle clé et une commande Claude Code prête à coller qui la contient](https://mintcdn.com/enclave/s6Xyaf3D28YdPXGs/images/product/mcp-key-created.png?fit=max\&auto=format\&n=s6Xyaf3D28YdPXGs\&q=85\&s=227a224bc4edb7f5b7ebc2a648790cb2)

Gardez la clé privée. Pour la révoquer, cliquez sur le bouton de révocation à côté d'elle sous **API Keys**. Tous les clients qui utilisent cette clé perdent l'accès.

### Révoquer une app connectée

Sous **Connected apps**, **Settings → MCP** liste les apps que vous avez approuvées avec OAuth dans l'organisation où vous travaillez, avec la date de connexion et la dernière activité de chacune.

Pour en révoquer une, cliquez sur **Revoke** à côté d'elle et confirmez. L'app perd l'accès et doit être reconnectée. Retirer Enclave de votre client ne met pas fin à son accès : révoquez donc aussi l'app ici.

## Instructions de configuration

**Settings → MCP** dans Enclave affiche aussi ces instructions sous **Setup**. Sélectionnez **OAuth** ou **API key** et votre client, puis copiez-les.

> [tab] Claude Code
>
> **Avec OAuth :**
>
> ```bash theme={null}
> claude mcp add --transport http enclave https://mcp.enclave.ai/
> ```
>
> Dans Claude Code, exécutez `/mcp`, sélectionnez `enclave` et choisissez **Authenticate**. Connectez-vous à Enclave dans le navigateur qui s'ouvre et approuvez la connexion.
>
> **Avec une clé MCP :**
>
> ```bash theme={null}
> claude mcp add --transport http enclave https://mcp.enclave.ai/ \
>   --header "Authorization: Bearer <your-mcp-key>"
> ```
>
> > [!TIP]
> >
> > Ajoutez `-s user` à la commande pour utiliser Enclave dans tous vos projets, pas seulement dans le dossier actuel.

> [tab] Codex
>
> **Avec OAuth :**
>
> ```bash theme={null}
> codex mcp add enclave --url https://mcp.enclave.ai/
> ```
>
> Codex ouvre un navigateur. Connectez-vous à Enclave et approuvez la connexion.
>
> **Avec une clé MCP :**
>
> ```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
>
> Dans **Settings → MCP** dans Enclave, sélectionnez **Cursor** et cliquez sur **Add to Cursor**. Cursor s'ouvre avec Enclave installé. Si **API key** est sélectionné, Enclave crée une nouvelle clé et l'ajoute pour vous.
>
> Pour le configurer à la main, ajoutez ceci à `.cursor/mcp.json` :
>
> **Avec OAuth :**
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "enclave": {
>       "url": "https://mcp.enclave.ai/"
>     }
>   }
> }
> ```
>
> **Avec une clé MCP :**
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "enclave": {
>       "url": "https://mcp.enclave.ai/",
>       "headers": {
>         "Authorization": "Bearer <your-mcp-key>"
>       }
>     }
>   }
> }
> ```

> [tab] VS Code
>
> Ajoutez ceci à `.vscode/mcp.json` :
>
> **Avec OAuth :**
>
> ```json theme={null}
> {
>   "servers": {
>     "enclave": {
>       "type": "http",
>       "url": "https://mcp.enclave.ai/"
>     }
>   }
> }
> ```
>
> **Avec une clé MCP :**
>
> ```json theme={null}
> {
>   "servers": {
>     "enclave": {
>       "type": "http",
>       "url": "https://mcp.enclave.ai/",
>       "headers": {
>         "Authorization": "Bearer <your-mcp-key>"
>       }
>     }
>   }
> }
> ```

> [tab] Claude
>
> Dans Claude (claude.ai ou Claude Desktop), ouvrez **Settings → Connectors** et cliquez sur **Add custom connector**. Saisissez `Enclave` comme nom et `https://mcp.enclave.ai/` comme URL du serveur. Cliquez sur **Connect**, puis connectez-vous à Enclave et approuvez la connexion.

Les autres clients qui prennent en charge les serveurs MCP distants via Streamable HTTP fonctionnent de la même façon. Pointez-les vers `https://mcp.enclave.ai/` et connectez-vous avec OAuth, ou envoyez une clé MCP dans l'en-tête `Authorization: Bearer`.

## Outils disponibles

Chaque outil agit dans l'organisation connectée, sauf les outils du Threat Feed et des analyses de CVE, qui lisent des données identiques pour tous. Les outils de lecture ne modifient jamais les données : votre client peut donc les autoriser sans autoriser les modifications.

| Domaine | Actions de lecture | Actions qui modifient des données |
| - | - | - |
| Findings | `enclave_finding_read` `list` : trouve des findings. `get` : lit jusqu'à 10 findings. | `enclave_finding_manage` `set_status` : change le statut d'un finding. |
| Analyses de pull requests | `enclave_pull_request_scan_read` `get` : lit l'analyse d'une pull request. | Aucune |
| Workflows | `enclave_workflow_read` `list` : trouve des workflows. `get` : lit un workflow. `revisions` : liste les versions enregistrées. `rules` : comment écrire un workflow. | `enclave_workflow_manage` `create` : enregistre un nouveau workflow. `update` : modifie un workflow. `archive` : archive un workflow. |
| Exécutions de workflows | `enclave_workflow_run_read` `list` : trouve des exécutions. `get` : lit une exécution. `steps` : lit les étapes d'une exécution. `output` : lit la sortie d'une exécution. | `enclave_workflow_run_manage` `start` : lance une exécution. `stop` : arrête une exécution. |
| Enregistrements de workflows | `enclave_workflow_record_read` `list` : trouve les enregistrements d'un workflow. `get` : lit un enregistrement. | `enclave_workflow_record_manage` `delete` : supprime un enregistrement. |
| Threat Feed | `enclave_threat_feed_read` `list` : liste le feed ou y recherche. `get` : lit une CVE du feed. | Aucune |
| Analyses de CVE | `enclave_cve_read` `get` : lit l'analyse d'Enclave de 10 CVE au maximum. | Aucune |
| Graphe cloud et dépôts | `enclave_graph_read` `query` : interroge le graphe cloud. `validate` : vérifie une requête sans l'exécuter. `list_assets` : liste les actifs cloud. `list_repos` : liste les dépôts et leurs slugs. | Aucune |
| Compte | `enclave_account_read` `get` : indique avec quel compte vous êtes connecté, votre organisation, votre rôle et ses intégrations. | Aucune |

* Sans filtre de statut, `list` ne renvoie que les findings **Confirmed**. La preuve de concept n'apparaît que pour les findings **Confirmed**.
* Les valeurs de statut correspondent aux statuts d'Enclave : `unverified` (**Needs evidence**), `verified` (**Confirmed**), `resolved` (**Resolved**), `invalid` (**Inactive**) et `discarded` (**Dismissed**).
* Désignez une pull request sous la forme `<repository-slug>#<number>`.
* Les workflows intégrés sont en lecture seule. Les [déclencheurs](https://docs.enclave.ai/fr/workflows/triggers.md) activés lancent des exécutions : enregistrer un workflow avec des déclencheurs peut donc en lancer une.
* Lancer une [exécution](https://docs.enclave.ai/fr/workflows/runs.md) consomme des crédits. Vous pouvez lancer un workflow qui ne prend aucune entrée, ou qui prend des findings ou des dépôts. Désignez chaque finding par son ID court, par exemple `AbCd12`, et chaque dépôt par son slug donné par `list_repos`. Chaque entrée de dépôt prend un seul dépôt. Lancez dans Enclave les workflows qui prennent une pull request ou une surface d'attaque.
* La suppression d'un enregistrement est définitive.
* La lecture du [Threat Feed](https://docs.enclave.ai/fr/threat-feed.md) ne demande aucune autorisation. `enclave_cve_read` renvoie les analyses qu'Enclave a déjà terminées. Il ne lance jamais de recherche et ne consomme pas de crédits. Pour en lancer une, consultez [Demander une analyse](https://docs.enclave.ai/fr/threat-feed.md#demander-une-analyse).
* Lister les dépôts et lire votre compte ne demandent aucune permission au-delà de l'appartenance à l'organisation.

## Exemples de prompts

* "Liste mes findings **Confirmed** critiques et élevés dans Enclave."
* "Lis le finding Enclave `AbCd12` et corrige-le dans ce dépôt."
* "Marque le finding `AbCd12` comme **Resolved** avec le motif 'Corrigé dans la pull request 123'."
* "Lis les règles des workflows Enclave, puis crée un workflow qui recherche les secrets dans `acme/api` chaque lundi à 08:00 UTC."
* "Lance mon workflow Enclave de triage des findings sur le finding `AbCd12`, puis montre-moi sa sortie quand il a terminé."
* "CVE-2026-1234 est-elle dans le Threat Feed d'Enclave ? Résume l'analyse d'Enclave à son sujet."
* "Lesquels de mes actifs cloud dans Enclave sont accessibles depuis Internet ?"

## Dépannage

> [accordion] Le serveur refuse ma clé (HTTP 401)
>
> La clé a expiré ou a été révoquée, ou vous avez été retiré de son organisation. Créez une nouvelle clé dans l'organisation à connecter et mettez à jour votre client.
>
> Certains clients, comme Claude Code, ne basculent pas vers OAuth tant qu'une clé est configurée. Pour passer à OAuth, retirez le serveur de votre client et ajoutez-le de nouveau sans l'en-tête `Authorization`.

> [accordion] Un finding ou un workflow visible dans Enclave renvoie introuvable
>
> Votre connexion agit dans une autre organisation. Une connexion reste dans l'organisation où vous travailliez quand vous l'avez autorisée ou avez créé sa clé. Basculez vers la bonne organisation dans Enclave, puis connectez-vous de nouveau.

> [accordion] Une action est refusée
>
> Votre rôle n'a pas l'autorisation requise par l'action. Consultez [Accès et autorisations](#accès-et-autorisations) ou demandez à un **Owner** ou **Admin** de votre organisation.

> [accordion] Mon client ne parvient pas du tout à se connecter
>
> Vérifiez que votre client prend en charge les serveurs MCP distants via Streamable HTTP. Le serveur ne propose pas l'ancien transport SSE.

## Ressources associées

* [Rôles](https://docs.enclave.ai/fr/admin/roles.md)
* [Déclencheurs](https://docs.enclave.ai/fr/workflows/triggers.md)
* [Exécutions](https://docs.enclave.ai/fr/workflows/runs.md)
* [Threat Feed](https://docs.enclave.ai/fr/threat-feed.md)
* [Model Context Protocol](https://modelcontextprotocol.io)


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