Vai al contenuto principale
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

La maggior parte dei client accetta questa configurazione:
mcp.json
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 decide quali strumenti puoi usare: 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

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. 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
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.
Con OAuth:
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:
Aggiungi -s user al comando per usare Enclave in tutti i progetti, non solo nella cartella corrente.
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.
  • 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 attivi avviano esecuzioni, quindi salvare un workflow con trigger può avviarne una.
  • Avviare un’esecuzione 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 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.
  • 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

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.
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.
Il tuo ruolo non ha il permesso richiesto dall’azione. Consulta Accesso e permessi o chiedi a un Owner o Admin della tua organizzazione.
Verifica che il tuo client supporti server MCP remoti tramite Streamable HTTP. Il server non offre il vecchio trasporto SSE.

Risorse correlate