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

> Conecta Claude Code, Codex, Cursor, VS Code o Claude a Enclave por MCP para que tu asistente de IA pueda leer y clasificar hallazgos, leer los análisis de pull requests, leer y editar workflows, iniciar, detener y leer ejecuciones de workflows, consultar el grafo de la nube, y leer el Threat Feed y los análisis de CVE de Enclave.

Conecta tu asistente de IA a Enclave con Model Context Protocol (MCP). Así tu asistente puede listar y leer hallazgos, cambiar el estado de un hallazgo, leer el análisis de Enclave de un pull request, leer, crear y editar workflows, iniciar, detener y leer ejecuciones de workflows y los registros que guardan, consultar el grafo de la nube y los activos de tu organización, y leer el Threat Feed y los análisis de CVE de Enclave, todo desde tu editor o terminal.

## Servidor MCP de Enclave

| | |
| - | - |
| **URL del servidor** | `https://mcp.enclave.ai/` |
| **Transporte** | Streamable HTTP |
| **Autenticación** | Inicio de sesión con OAuth o una clave MCP |
| **Alcance** | Una organización por conexión |

La mayoría de los clientes aceptan esta configuración:

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

> [!NOTE]
>
> El servidor solo admite Streamable HTTP. No ofrece el transporte SSE antiguo, así que usa un cliente que pueda conectarse a un servidor HTTP remoto.

## Acceso y permisos

Necesitas una cuenta de Enclave y pertenecer a una organización.

Las herramientas de una organización requieren que esta tenga un plan válido, incluso para las llamadas de lectura. Un período de prueba también cuenta como plan válido. Este requisito no se aplica a las herramientas públicas.

Cada conexión OAuth o clave MCP actúa como tú en una sola organización. Enclave fija esa organización al autorizar la conexión o crear la clave, usando la organización en la que estás trabajando en ese momento. Las llamadas a herramientas no pueden cambiar de organización. Para conectar otra organización, cambia a ella en Enclave y autoriza otra conexión o crea otra clave.

Tu [rol](https://docs.enclave.ai/es/admin/roles.md) determina qué herramientas puedes usar:

| Qué puedes hacer | Permiso | Roles predeterminados |
| - | - | - |
| Leer hallazgos y análisis de pull requests | `finding:read` | **Owner**, **Admin**, **Member** |
| Cambiar el estado de un hallazgo | `finding:status_change` | **Owner**, **Admin** |
| Leer workflows | `workflow:read` | **Owner**, **Admin**, **Member** |
| Crear o editar workflows | `workflow:write` | **Owner**, **Admin** |
| Archivar workflows | `workflow:delete` | **Owner**, **Admin** |
| Guardar un workflow con disparadores | `workflow_trigger:write` | **Owner**, **Admin** |
| Leer ejecuciones de workflows y sus registros | `agent:read` | **Owner**, **Admin**, **Member** |
| Iniciar y detener ejecuciones, y eliminar registros | `agent:write` | **Owner**, **Admin** |
| Leer los análisis de CVE de Enclave | `session:read` | **Owner**, **Admin**, **Member** |
| Consultar el grafo de la nube y listar los activos en la nube | `asset:read` | **Owner**, **Admin**, **Member** |

Los roles personalizados necesitan los permisos correspondientes. Solo **Owner** y **Admin** pueden guardar disparadores, porque a un rol personalizado no se le puede dar `workflow_trigger:write`. Solo accedes a los recursos que puedes ver en Enclave. Todo lo que esté fuera de la organización conectada, u oculto para ti, devuelve no encontrado.

Si te quitan de una organización, se revocan tus conexiones OAuth y tus claves MCP de esa organización.

## Autenticación

| Método | Úsalo cuando | Cómo funciona |
| - | - | - |
| **OAuth** (recomendado) | Tu cliente puede abrir un navegador para iniciar sesión. | Inicias sesión en Enclave y apruebas la conexión. La pantalla de aprobación indica la organización en la que actuará la conexión. |
| **Clave MCP** | Tu cliente necesita un token bearer fijo, por ejemplo en un script o un entorno sin interfaz. | Tu cliente envía la clave en una cabecera `Authorization: Bearer`. |

Las claves MCP solo funcionan con el servidor MCP de Enclave. La API REST de Enclave no las acepta.

### Crear una clave MCP

Necesitas acceso a **Settings** en la organización que quieres conectar.

**1. Crea la clave**

Abre **Settings → MCP** en [Enclave](https://app.enclave.ai). En **API Keys**, haz clic en **Create Key**. Introduce un **Name**, elige una **Expiration** y haz clic en **Create Key**.

**2. Copia la clave**

Copia la clave cuando aparezca. Enclave solo la muestra una vez. Debajo de la clave, elige tu cliente para copiar su comando o configuración de instalación con la clave ya incluida.

![El diálogo API Key Created con la nueva clave y un comando de Claude Code listo para pegar que la incluye](https://mintcdn.com/enclave/s6Xyaf3D28YdPXGs/images/product/mcp-key-created.png?fit=max\&auto=format\&n=s6Xyaf3D28YdPXGs\&q=85\&s=227a224bc4edb7f5b7ebc2a648790cb2)

Mantén la clave en privado. Para revocarla, haz clic en el botón de revocación junto a ella en **API Keys**. Todos los clientes que usen esa clave pierden el acceso.

### Revocar una app conectada

En **Connected apps**, **Settings → MCP** muestra las apps que aprobaste con OAuth en la organización en la que trabajas, con cuándo se conectó cada una y cuándo estuvo activa por última vez.

Para revocar una, haz clic en **Revoke** junto a ella y confirma. La app pierde el acceso y hay que volver a conectarla. Quitar Enclave de tu cliente no le retira el acceso, así que revoca la app también aquí.

## Instrucciones de configuración

**Settings → MCP** en Enclave también muestra estas instrucciones en **Setup**. Selecciona **OAuth** o **API key** y tu cliente, y cópialas.

> [tab] Claude Code
>
> **Con OAuth:**
>
> ```bash theme={null}
> claude mcp add --transport http enclave https://mcp.enclave.ai/
> ```
>
> En Claude Code, ejecuta `/mcp`, selecciona `enclave` y elige **Authenticate**. Inicia sesión en Enclave en el navegador que se abre y aprueba la conexión.
>
> **Con una clave MCP:**
>
> ```bash theme={null}
> claude mcp add --transport http enclave https://mcp.enclave.ai/ \
>   --header "Authorization: Bearer <your-mcp-key>"
> ```
>
> > [!TIP]
> >
> > Añade `-s user` al comando para usar Enclave en todos los proyectos, no solo en la carpeta actual.

> [tab] Codex
>
> **Con OAuth:**
>
> ```bash theme={null}
> codex mcp add enclave --url https://mcp.enclave.ai/
> ```
>
> Codex abre un navegador. Inicia sesión en Enclave y aprueba la conexión.
>
> **Con una clave 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
>
> En **Settings → MCP** en Enclave, selecciona **Cursor** y haz clic en **Add to Cursor**. Cursor se abre con Enclave instalado. Con **API key** seleccionado, Enclave crea una clave nueva y la añade por ti.
>
> Para configurarlo a mano, añade esto a `.cursor/mcp.json`:
>
> **Con OAuth:**
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "enclave": {
>       "url": "https://mcp.enclave.ai/"
>     }
>   }
> }
> ```
>
> **Con una clave MCP:**
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "enclave": {
>       "url": "https://mcp.enclave.ai/",
>       "headers": {
>         "Authorization": "Bearer <your-mcp-key>"
>       }
>     }
>   }
> }
> ```

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

> [tab] Claude
>
> En Claude (claude.ai o Claude Desktop), abre **Settings → Connectors** y haz clic en **Add custom connector**. Introduce `Enclave` como nombre y `https://mcp.enclave.ai/` como URL del servidor. Haz clic en **Connect**, inicia sesión en Enclave y aprueba la conexión.

Otros clientes que admiten servidores MCP remotos por Streamable HTTP funcionan igual. Apúntalos a `https://mcp.enclave.ai/` e inicia sesión con OAuth, o envía una clave MCP en la cabecera `Authorization: Bearer`.

## Herramientas disponibles

Todas las herramientas actúan en la organización conectada, salvo las del Threat Feed y los análisis de CVE, que leen datos iguales para todos. Las herramientas de lectura nunca cambian datos, así que tu cliente puede permitirlas sin permitir cambios.

| Área | Acciones de lectura | Acciones que cambian datos |
| - | - | - |
| Hallazgos | `enclave_finding_read` `list`: busca hallazgos. `get`: lee hasta 10 hallazgos. | `enclave_finding_manage` `set_status`: cambia el estado de un hallazgo. |
| Análisis de pull requests | `enclave_pull_request_scan_read` `get`: lee el análisis de un pull request. | Ninguna |
| Workflows | `enclave_workflow_read` `list`: busca workflows. `get`: lee un workflow. `revisions`: lista las versiones guardadas. `rules`: cómo escribir un workflow. | `enclave_workflow_manage` `create`: guarda un workflow nuevo. `update`: edita un workflow. `archive`: archiva un workflow. |
| Ejecuciones de workflows | `enclave_workflow_run_read` `list`: busca ejecuciones. `get`: lee una ejecución. `steps`: lee los pasos de una ejecución. `output`: lee la salida de una ejecución. | `enclave_workflow_run_manage` `start`: inicia una ejecución. `stop`: detiene una ejecución. |
| Registros de workflows | `enclave_workflow_record_read` `list`: busca los registros de un workflow. `get`: lee un registro. | `enclave_workflow_record_manage` `delete`: elimina un registro. |
| Threat Feed | `enclave_threat_feed_read` `list`: lista o busca en el feed. `get`: lee un CVE del feed. | Ninguna |
| Análisis de CVE | `enclave_cve_read` `get`: lee el análisis de Enclave de hasta 10 CVE. | Ninguna |
| Grafo de la nube y repositorios | `enclave_graph_read` `query`: consulta el grafo de la nube. `validate`: comprueba una consulta sin ejecutarla. `list_assets`: lista los activos en la nube. `list_repos`: lista los repositorios y sus slugs. | Ninguna |
| Cuenta | `enclave_account_read` `get`: muestra con qué cuenta estás conectado, tu organización, tu rol y sus integraciones. | Ninguna |

* Sin un filtro de estado, `list` solo devuelve hallazgos **Confirmed**. La prueba de concepto solo aparece en hallazgos **Confirmed**.
* Los valores de estado corresponden a los estados de Enclave: `unverified` (**Needs evidence**), `verified` (**Confirmed**), `resolved` (**Resolved**), `invalid` (**Inactive**) y `discarded` (**Dismissed**).
* Indica un pull request como `<repository-slug>#<number>`.
* Los workflows integrados son de solo lectura. Los [disparadores](https://docs.enclave.ai/es/workflows/triggers.md) activados inician ejecuciones, así que guardar un workflow con disparadores puede iniciar una.
* Iniciar una [ejecución](https://docs.enclave.ai/es/workflows/runs.md) consume créditos. Puedes iniciar un workflow que no recibe entradas o que recibe hallazgos o repositorios. Indica cada hallazgo por su ID corto, como `AbCd12`, y cada repositorio por su slug de `list_repos`. Cada entrada de repositorio recibe un solo repositorio. Inicia en Enclave los workflows que reciben un pull request o una superficie de ataque.
* Eliminar un registro es permanente.
* Leer el [Threat Feed](https://docs.enclave.ai/es/threat-feed.md) no requiere ningún permiso. `enclave_cve_read` devuelve los análisis que Enclave ya terminó. Nunca inicia una investigación ni consume créditos. Para iniciar uno, consulta [Solicitar un análisis](https://docs.enclave.ai/es/threat-feed.md#solicitar-un-análisis).
* Listar repositorios y leer tu cuenta no necesitan más permiso que ser miembro.

## Ejemplos de prompts

* "Lista mis hallazgos **Confirmed** críticos y altos en Enclave."
* "Lee el hallazgo de Enclave `AbCd12` y corrígelo en este repositorio."
* "Marca el hallazgo `AbCd12` como **Resolved** con el motivo 'Corregido en el pull request 123'."
* "Lee las reglas de workflows de Enclave y crea un workflow que haga un barrido de secretos en `acme/api` cada lunes a las 08:00 UTC."
* "Inicia mi workflow de triaje de hallazgos de Enclave sobre el hallazgo `AbCd12` y muéstrame su salida cuando termine."
* "¿Está CVE-2026-1234 en el Threat Feed de Enclave? Resume el análisis de Enclave sobre él."
* "¿Cuáles de mis activos en la nube en Enclave son accesibles desde internet?"

## Solución de problemas

> [accordion] El servidor rechaza mi clave (HTTP 401)
>
> La clave caducó o se revocó, o te quitaron de su organización. Crea una clave nueva en la organización que quieres conectar y actualiza tu cliente.
>
> Algunos clientes, como Claude Code, no recurren a OAuth mientras haya una clave configurada. Para cambiar a OAuth, quita el servidor de tu cliente y vuelve a añadirlo sin la cabecera `Authorization`.

> [accordion] Un hallazgo o workflow que veo en Enclave devuelve no encontrado
>
> Tu conexión actúa en otra organización. Una conexión se queda en la organización en la que trabajabas al autorizarla o al crear su clave. Cambia a la organización correcta en Enclave y vuelve a conectar.

> [accordion] Se rechaza una acción
>
> Tu rol no tiene el permiso que necesita la acción. Consulta [Acceso y permisos](#acceso-y-permisos) o pregunta a un **Owner** o **Admin** de tu organización.

> [accordion] Mi cliente no se conecta
>
> Comprueba que tu cliente admite servidores MCP remotos por Streamable HTTP. El servidor no ofrece el transporte SSE antiguo.

## Recursos relacionados

* [Roles](https://docs.enclave.ai/es/admin/roles.md)
* [Disparadores](https://docs.enclave.ai/es/workflows/triggers.md)
* [Ejecuciones](https://docs.enclave.ai/es/workflows/runs.md)
* [Threat Feed](https://docs.enclave.ai/es/threat-feed.md)
* [Model Context Protocol](https://modelcontextprotocol.io)


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