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

> Collega Claude Code, Codex, Cursor, VS Code o Claude a Enclave tramite MCP, così il tuo assistente IA può leggere e classificare i finding, leggere le analisi delle pull request, leggere e modificare i workflow, avviare, fermare e leggere le esecuzioni dei workflow, interrogare il grafo cloud, e leggere il Threat Feed e le analisi delle CVE di Enclave.

Collega il tuo assistente IA a Enclave con il Model Context Protocol (MCP). Il tuo assistente potrà elencare e leggere i finding, cambiare lo stato di un finding, leggere l'analisi di Enclave di una pull request, leggere, creare e modificare i workflow, avviare, fermare e leggere le esecuzioni dei workflow e i record che salvano, interrogare il grafo cloud e gli asset della tua organizzazione, e leggere il Threat Feed e le analisi delle CVE di Enclave, tutto dal tuo editor o terminale.

## Server MCP di Enclave

| | |
| - | - |
| **URL del server** | `https://mcp.enclave.ai/` |
| **Trasporto** | Streamable HTTP |
| **Autenticazione** | Accesso OAuth o una chiave MCP |
| **Ambito** | Un'organizzazione per connessione |

La maggior parte dei client accetta questa configurazione:

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

> [!NOTE]
>
> Il server supporta solo Streamable HTTP. Non offre il vecchio trasporto SSE, quindi usa un client in grado di connettersi a un server HTTP remoto.

## Accesso e permessi

Ti servono un account Enclave e l'appartenenza a un'organizzazione.

Gli strumenti associati a un'organizzazione richiedono un piano utilizzabile per quell'organizzazione, anche per le chiamate di lettura. Anche un periodo di prova conta come piano utilizzabile. Questo requisito non si applica agli strumenti pubblici.

Ogni connessione OAuth o chiave MCP agisce come te in una sola organizzazione. Enclave fissa quell'organizzazione quando autorizzi la connessione o crei la chiave, usando l'organizzazione in cui stai lavorando in quel momento. Le chiamate agli strumenti non possono cambiare organizzazione. Per collegare un'altra organizzazione, passa a quella in Enclave, poi autorizza un'altra connessione o crea un'altra chiave.

Il tuo [ruolo](https://docs.enclave.ai/it/admin/roles.md) decide quali strumenti puoi usare:

| Cosa puoi fare | Permesso | Ruoli predefiniti |
| - | - | - |
| Leggere finding e analisi delle pull request | `finding:read` | **Owner**, **Admin**, **Member** |
| Cambiare lo stato di un finding | `finding:status_change` | **Owner**, **Admin** |
| Leggere i workflow | `workflow:read` | **Owner**, **Admin**, **Member** |
| Creare o modificare workflow | `workflow:write` | **Owner**, **Admin** |
| Archiviare workflow | `workflow:delete` | **Owner**, **Admin** |
| Salvare un workflow con trigger | `workflow_trigger:write` | **Owner**, **Admin** |
| Leggere le esecuzioni dei workflow e i loro record | `agent:read` | **Owner**, **Admin**, **Member** |
| Avviare e fermare esecuzioni ed eliminare record | `agent:write` | **Owner**, **Admin** |
| Leggere le analisi delle CVE di Enclave | `session:read` | **Owner**, **Admin**, **Member** |
| Interrogare il grafo cloud ed elencare gli asset cloud | `asset:read` | **Owner**, **Admin**, **Member** |

I ruoli personalizzati devono avere i permessi corrispondenti. Solo **Owner** e **Admin** possono salvare i trigger, perché a un ruolo personalizzato non si può assegnare `workflow_trigger:write`. Raggiungi solo le risorse che vedi in Enclave. Tutto ciò che è fuori dall'organizzazione collegata, o nascosto per te, restituisce non trovato.

Se vieni rimosso da un'organizzazione, le tue connessioni OAuth e le tue chiavi MCP per quell'organizzazione vengono revocate.

## Autenticazione

| Metodo | Usalo quando | Come funziona |
| - | - | - |
| **OAuth** (consigliato) | Il tuo client può aprire un browser per accedere. | Accedi a Enclave e approvi la connessione. La schermata di approvazione indica l'organizzazione in cui agirà la connessione. |
| **Chiave MCP** | Il tuo client ha bisogno di un token bearer fisso, per esempio in uno script o in un ambiente senza interfaccia. | Il tuo client invia la chiave in un'intestazione `Authorization: Bearer`. |

Le chiavi MCP funzionano solo con il server MCP di Enclave. L'API REST di Enclave non le accetta.

### Creare una chiave MCP

Ti serve l'accesso a **Settings** nell'organizzazione che vuoi collegare.

**1. Crea la chiave**

Apri **Settings → MCP** in [Enclave](https://app.enclave.ai). In **API Keys**, fai clic su **Create Key**. Inserisci un **Name**, scegli una **Expiration** e fai clic su **Create Key**.

**2. Copia la chiave**

Copia la chiave quando compare. Enclave la mostra una sola volta. Sotto la chiave, scegli il tuo client per copiare il comando o la configurazione di installazione con la chiave già inserita.

![La finestra API Key Created con la nuova chiave e un comando di Claude Code pronto da incollare che la contiene](https://mintcdn.com/enclave/s6Xyaf3D28YdPXGs/images/product/mcp-key-created.png?fit=max\&auto=format\&n=s6Xyaf3D28YdPXGs\&q=85\&s=227a224bc4edb7f5b7ebc2a648790cb2)

Mantieni la chiave privata. Per revocarla, fai clic sul pulsante di revoca accanto a essa in **API Keys**. Tutti i client che usano quella chiave perdono l'accesso.

### Revocare un'app connessa

In **Connected apps**, **Settings → MCP** elenca le app che hai approvato con OAuth nell'organizzazione in cui stai lavorando, con quando ciascuna si è connessa e quando è stata attiva l'ultima volta.

Per revocarne una, fai clic su **Revoke** accanto all'app e conferma. L'app perde l'accesso e deve essere connessa di nuovo. Rimuovere Enclave dal tuo client non ne termina l'accesso, quindi revoca l'app anche qui.

## Istruzioni di configurazione

**Settings → MCP** in Enclave mostra queste istruzioni anche in **Setup**. Seleziona **OAuth** o **API key** e il tuo client, poi copiale.

> [tab] Claude Code
>
> **Con OAuth:**
>
> ```bash theme={null}
> claude mcp add --transport http enclave https://mcp.enclave.ai/
> ```
>
> In Claude Code, esegui `/mcp`, seleziona `enclave` e scegli **Authenticate**. Accedi a Enclave nel browser che si apre e approva la connessione.
>
> **Con una chiave MCP:**
>
> ```bash theme={null}
> claude mcp add --transport http enclave https://mcp.enclave.ai/ \
>   --header "Authorization: Bearer <your-mcp-key>"
> ```
>
> > [!TIP]
> >
> > Aggiungi `-s user` al comando per usare Enclave in tutti i progetti, non solo nella cartella corrente.

> [tab] Codex
>
> **Con OAuth:**
>
> ```bash theme={null}
> codex mcp add enclave --url https://mcp.enclave.ai/
> ```
>
> Codex apre un browser. Accedi a Enclave e approva la connessione.
>
> **Con una chiave 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
>
> In **Settings → MCP** in Enclave, seleziona **Cursor** e fai clic su **Add to Cursor**. Cursor si apre con Enclave installato. Con **API key** selezionato, Enclave crea una nuova chiave e la aggiunge per te.
>
> Per configurarlo a mano, aggiungi questo a `.cursor/mcp.json`:
>
> **Con OAuth:**
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "enclave": {
>       "url": "https://mcp.enclave.ai/"
>     }
>   }
> }
> ```
>
> **Con una chiave MCP:**
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "enclave": {
>       "url": "https://mcp.enclave.ai/",
>       "headers": {
>         "Authorization": "Bearer <your-mcp-key>"
>       }
>     }
>   }
> }
> ```

> [tab] VS Code
>
> Aggiungi questo a `.vscode/mcp.json`:
>
> **Con OAuth:**
>
> ```json theme={null}
> {
>   "servers": {
>     "enclave": {
>       "type": "http",
>       "url": "https://mcp.enclave.ai/"
>     }
>   }
> }
> ```
>
> **Con una chiave MCP:**
>
> ```json theme={null}
> {
>   "servers": {
>     "enclave": {
>       "type": "http",
>       "url": "https://mcp.enclave.ai/",
>       "headers": {
>         "Authorization": "Bearer <your-mcp-key>"
>       }
>     }
>   }
> }
> ```

> [tab] Claude
>
> In Claude (claude.ai o Claude Desktop), apri **Settings → Connectors** e fai clic su **Add custom connector**. Inserisci `Enclave` come nome e `https://mcp.enclave.ai/` come URL del server. Fai clic su **Connect**, poi accedi a Enclave e approva la connessione.

Gli altri client che supportano server MCP remoti tramite Streamable HTTP funzionano allo stesso modo. Puntali a `https://mcp.enclave.ai/` e accedi con OAuth, oppure invia una chiave MCP nell'intestazione `Authorization: Bearer`.

## Strumenti disponibili

Ogni strumento agisce nell'organizzazione collegata, tranne quelli del Threat Feed e delle analisi delle CVE, che leggono dati uguali per tutti. Gli strumenti di lettura non modificano mai i dati, quindi il tuo client può consentirli senza consentire modifiche.

| Area | Azioni di lettura | Azioni che modificano i dati |
| - | - | - |
| Finding | `enclave_finding_read` `list`: trova finding. `get`: legge fino a 10 finding. | `enclave_finding_manage` `set_status`: cambia lo stato di un finding. |
| Analisi delle pull request | `enclave_pull_request_scan_read` `get`: legge l'analisi di una pull request. | Nessuna |
| Workflow | `enclave_workflow_read` `list`: trova workflow. `get`: legge un workflow. `revisions`: elenca le versioni salvate. `rules`: come scrivere un workflow. | `enclave_workflow_manage` `create`: salva un nuovo workflow. `update`: modifica un workflow. `archive`: archivia un workflow. |
| Esecuzioni dei workflow | `enclave_workflow_run_read` `list`: trova esecuzioni. `get`: legge un'esecuzione. `steps`: legge i passaggi di un'esecuzione. `output`: legge l'output di un'esecuzione. | `enclave_workflow_run_manage` `start`: avvia un'esecuzione. `stop`: ferma un'esecuzione. |
| Record dei workflow | `enclave_workflow_record_read` `list`: trova i record di un workflow. `get`: legge un record. | `enclave_workflow_record_manage` `delete`: elimina un record. |
| Threat Feed | `enclave_threat_feed_read` `list`: elenca il feed o lo cerca. `get`: legge una CVE del feed. | Nessuna |
| Analisi delle CVE | `enclave_cve_read` `get`: legge l'analisi di Enclave di fino a 10 CVE. | Nessuna |
| Grafo cloud e repository | `enclave_graph_read` `query`: interroga il grafo cloud. `validate`: controlla una query senza eseguirla. `list_assets`: elenca gli asset cloud. `list_repos`: elenca i repository e i loro slug. | Nessuna |
| Account | `enclave_account_read` `get`: mostra con quale account sei collegato, la tua organizzazione, il tuo ruolo e le sue integrazioni. | Nessuna |

* Senza un filtro di stato, `list` restituisce solo i finding **Confirmed**. La proof of concept compare solo per i finding **Confirmed**.
* I valori di stato corrispondono agli stati di Enclave: `unverified` (**Needs evidence**), `verified` (**Confirmed**), `resolved` (**Resolved**), `invalid` (**Inactive**) e `discarded` (**Dismissed**).
* Indica una pull request come `<repository-slug>#<number>`.
* I workflow integrati sono di sola lettura. I [trigger](https://docs.enclave.ai/it/workflows/triggers.md) attivi avviano esecuzioni, quindi salvare un workflow con trigger può avviarne una.
* Avviare un'[esecuzione](https://docs.enclave.ai/it/workflows/runs.md) consuma crediti. Puoi avviare un workflow che non riceve input o che riceve finding o repository. Indica ogni finding con il suo ID breve, per esempio `AbCd12`, e ogni repository con il suo slug ottenuto da `list_repos`. Ogni input di repository riceve un solo repository. Avvia in Enclave i workflow che ricevono una pull request o una superficie di attacco.
* L'eliminazione di un record è definitiva.
* Leggere il [Threat Feed](https://docs.enclave.ai/it/threat-feed.md) non richiede alcun permesso. `enclave_cve_read` restituisce le analisi che Enclave ha già completato. Non avvia mai una ricerca e non consuma crediti. Per avviarne una, consulta [Richiedi un'analisi](https://docs.enclave.ai/it/threat-feed.md#richiedi-un-analisi).
* Elencare i repository e leggere il tuo account non richiedono permessi oltre all'appartenenza all'organizzazione.

## Prompt di esempio

* "Elenca i miei finding **Confirmed** critici e alti in Enclave."
* "Leggi il finding di Enclave `AbCd12` e correggilo in questo repository."
* "Segna il finding `AbCd12` come **Resolved** con il motivo 'Corretto nella pull request 123'."
* "Leggi le regole dei workflow di Enclave, poi crea un workflow che cerchi segreti in `acme/api` ogni lunedì alle 08:00 UTC."
* "Avvia il mio workflow di Enclave per il triage dei finding sul finding `AbCd12`, poi mostrami il suo output quando termina."
* "CVE-2026-1234 è nel Threat Feed di Enclave? Riassumi l'analisi di Enclave su di essa."
* "Quali dei miei asset cloud in Enclave sono raggiungibili da internet?"

## Risoluzione dei problemi

> [accordion] Il server rifiuta la mia chiave (HTTP 401)
>
> La chiave è scaduta o è stata revocata, oppure sei stato rimosso dalla sua organizzazione. Crea una nuova chiave nell'organizzazione che vuoi collegare e aggiorna il tuo client.
>
> Alcuni client, come Claude Code, non passano a OAuth finché è configurata una chiave. Per passare a OAuth, rimuovi il server dal client e aggiungilo di nuovo senza l'intestazione `Authorization`.

> [accordion] Un finding o un workflow che vedo in Enclave restituisce non trovato
>
> La tua connessione agisce in un'altra organizzazione. Una connessione resta nell'organizzazione in cui lavoravi quando l'hai autorizzata o ne hai creato la chiave. Passa all'organizzazione giusta in Enclave, poi collegati di nuovo.

> [accordion] Un'azione viene rifiutata
>
> Il tuo ruolo non ha il permesso richiesto dall'azione. Consulta [Accesso e permessi](#accesso-e-permessi) o chiedi a un **Owner** o **Admin** della tua organizzazione.

> [accordion] Il mio client non riesce a connettersi
>
> Verifica che il tuo client supporti server MCP remoti tramite Streamable HTTP. Il server non offre il vecchio trasporto SSE.

## Risorse correlate

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


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