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

> Conecte Claude Code, Codex, Cursor, VS Code ou Claude ao Enclave por MCP para que seu assistente de IA possa ler e fazer a triagem de achados, ler as análises de pull requests, ler e editar workflows, iniciar, parar e ler execuções de workflows, consultar o grafo da nuvem, e ler o Threat Feed e as análises de CVE do Enclave.

Conecte seu assistente de IA ao Enclave com o Model Context Protocol (MCP). Assim, seu assistente pode listar e ler achados, mudar o status de um achado, ler a análise do Enclave de um pull request, ler, criar e editar workflows, iniciar, parar e ler execuções de workflows e os registros que elas salvam, consultar o grafo da nuvem e os ativos da sua organização, e ler o Threat Feed e as análises de CVE do Enclave, tudo pelo seu editor ou terminal.

## Servidor MCP do Enclave

| | |
| - | - |
| **URL do servidor** | `https://mcp.enclave.ai/` |
| **Transporte** | Streamable HTTP |
| **Autenticação** | Login com OAuth ou uma chave MCP |
| **Escopo** | Uma organização por conexão |

A maioria dos clientes aceita esta configuração:

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

> [!NOTE]
>
> O servidor aceita apenas Streamable HTTP. Ele não oferece o transporte SSE antigo, então use um cliente que consiga se conectar a um servidor HTTP remoto.

## Acesso e permissões

Você precisa de uma conta no Enclave e ser membro de uma organização.

Ferramentas de uma organização exigem que ela tenha um plano válido, inclusive para chamadas de leitura. Um período de teste também conta como plano válido. Esse requisito não se aplica a ferramentas públicas.

Cada conexão OAuth ou chave MCP age como você em uma única organização. O Enclave fixa essa organização quando você autoriza a conexão ou cria a chave, usando a organização em que você está trabalhando no momento. Chamadas de ferramentas não podem trocar de organização. Para conectar outra organização, mude para ela no Enclave e autorize outra conexão ou crie outra chave.

Sua [função](https://docs.enclave.ai/pt-br/admin/roles.md) define quais ferramentas você pode usar:

| O que você pode fazer | Permissão | Funções padrão |
| - | - | - |
| Ler achados e análises de pull requests | `finding:read` | **Owner**, **Admin**, **Member** |
| Mudar o status de um achado | `finding:status_change` | **Owner**, **Admin** |
| Ler workflows | `workflow:read` | **Owner**, **Admin**, **Member** |
| Criar ou editar workflows | `workflow:write` | **Owner**, **Admin** |
| Arquivar workflows | `workflow:delete` | **Owner**, **Admin** |
| Salvar um workflow com gatilhos | `workflow_trigger:write` | **Owner**, **Admin** |
| Ler execuções de workflows e seus registros | `agent:read` | **Owner**, **Admin**, **Member** |
| Iniciar e parar execuções, e excluir registros | `agent:write` | **Owner**, **Admin** |
| Ler as análises de CVE do Enclave | `session:read` | **Owner**, **Admin**, **Member** |
| Consultar o grafo da nuvem e listar os ativos na nuvem | `asset:read` | **Owner**, **Admin**, **Member** |

Funções personalizadas precisam das permissões correspondentes. Só **Owners** e **Admins** podem salvar gatilhos, porque uma função personalizada não pode receber `workflow_trigger:write`. Você só acessa recursos que consegue ver no Enclave. Tudo fora da organização conectada, ou oculto para você, retorna não encontrado.

Se você for removido de uma organização, suas conexões OAuth e chaves MCP dela são revogadas.

## Autenticação

| Método | Use quando | Como funciona |
| - | - | - |
| **OAuth** (recomendado) | Seu cliente consegue abrir um navegador para fazer login. | Você faz login no Enclave e aprova a conexão. A tela de aprovação mostra a organização em que a conexão vai agir. |
| **Chave MCP** | Seu cliente precisa de um token bearer fixo, por exemplo em um script ou ambiente sem interface. | Seu cliente envia a chave em um cabeçalho `Authorization: Bearer`. |

Chaves MCP funcionam apenas com o servidor MCP do Enclave. A API REST do Enclave não as aceita.

### Criar uma chave MCP

Você precisa de acesso a **Settings** na organização que quer conectar.

**1. Crie a chave**

Abra **Settings → MCP** no [Enclave](https://app.enclave.ai). Em **API Keys**, clique em **Create Key**. Informe um **Name**, escolha uma **Expiration** e clique em **Create Key**.

**2. Copie a chave**

Copie a chave quando ela aparecer. O Enclave a mostra apenas uma vez. Abaixo da chave, escolha seu cliente para copiar o comando ou a configuração de instalação com a chave já preenchida.

![A caixa de diálogo API Key Created com a nova chave e um comando do Claude Code pronto para colar que a inclui](https://mintcdn.com/enclave/s6Xyaf3D28YdPXGs/images/product/mcp-key-created.png?fit=max\&auto=format\&n=s6Xyaf3D28YdPXGs\&q=85\&s=227a224bc4edb7f5b7ebc2a648790cb2)

Mantenha a chave em sigilo. Para revogá-la, clique no botão de revogação ao lado dela em **API Keys**. Todos os clientes que usam essa chave perdem o acesso.

### Revogar um app conectado

Em **Connected apps**, **Settings → MCP** lista os apps que você aprovou com OAuth na organização em que está trabalhando, com quando cada um se conectou e quando esteve ativo pela última vez.

Para revogar um, clique em **Revoke** ao lado dele e confirme. O app perde o acesso e precisa ser conectado de novo. Remover o Enclave do seu cliente não encerra o acesso, então revogue o app aqui também.

## Instruções de configuração

**Settings → MCP** no Enclave também mostra estas instruções em **Setup**. Selecione **OAuth** ou **API key** e seu cliente, e copie-as.

> [tab] Claude Code
>
> **Com OAuth:**
>
> ```bash theme={null}
> claude mcp add --transport http enclave https://mcp.enclave.ai/
> ```
>
> No Claude Code, execute `/mcp`, selecione `enclave` e escolha **Authenticate**. Faça login no Enclave no navegador que abrir e aprove a conexão.
>
> **Com uma chave MCP:**
>
> ```bash theme={null}
> claude mcp add --transport http enclave https://mcp.enclave.ai/ \
>   --header "Authorization: Bearer <your-mcp-key>"
> ```
>
> > [!TIP]
> >
> > Adicione `-s user` ao comando para usar o Enclave em todos os projetos, não só na pasta atual.

> [tab] Codex
>
> **Com OAuth:**
>
> ```bash theme={null}
> codex mcp add enclave --url https://mcp.enclave.ai/
> ```
>
> O Codex abre um navegador. Faça login no Enclave e aprove a conexão.
>
> **Com uma chave 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
>
> Em **Settings → MCP** no Enclave, selecione **Cursor** e clique em **Add to Cursor**. O Cursor abre com o Enclave instalado. Com **API key** selecionado, o Enclave cria uma chave nova e a adiciona para você.
>
> Para configurar manualmente, adicione isto a `.cursor/mcp.json`:
>
> **Com OAuth:**
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "enclave": {
>       "url": "https://mcp.enclave.ai/"
>     }
>   }
> }
> ```
>
> **Com uma chave MCP:**
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "enclave": {
>       "url": "https://mcp.enclave.ai/",
>       "headers": {
>         "Authorization": "Bearer <your-mcp-key>"
>       }
>     }
>   }
> }
> ```

> [tab] VS Code
>
> Adicione isto a `.vscode/mcp.json`:
>
> **Com OAuth:**
>
> ```json theme={null}
> {
>   "servers": {
>     "enclave": {
>       "type": "http",
>       "url": "https://mcp.enclave.ai/"
>     }
>   }
> }
> ```
>
> **Com uma chave MCP:**
>
> ```json theme={null}
> {
>   "servers": {
>     "enclave": {
>       "type": "http",
>       "url": "https://mcp.enclave.ai/",
>       "headers": {
>         "Authorization": "Bearer <your-mcp-key>"
>       }
>     }
>   }
> }
> ```

> [tab] Claude
>
> No Claude (claude.ai ou Claude Desktop), abra **Settings → Connectors** e clique em **Add custom connector**. Informe `Enclave` como nome e `https://mcp.enclave.ai/` como URL do servidor. Clique em **Connect**, faça login no Enclave e aprove a conexão.

Outros clientes que aceitam servidores MCP remotos por Streamable HTTP funcionam da mesma forma. Aponte-os para `https://mcp.enclave.ai/` e faça login com OAuth, ou envie uma chave MCP no cabeçalho `Authorization: Bearer`.

## Ferramentas disponíveis

Todas as ferramentas agem na organização conectada, exceto as do Threat Feed e das análises de CVE, que leem dados iguais para todos. Ferramentas de leitura nunca alteram dados, então seu cliente pode permiti-las sem permitir alterações.

| Área | Ações de leitura | Ações que alteram dados |
| - | - | - |
| Achados | `enclave_finding_read` `list`: encontra achados. `get`: lê até 10 achados. | `enclave_finding_manage` `set_status`: muda o status de um achado. |
| Análises de pull requests | `enclave_pull_request_scan_read` `get`: lê a análise de um pull request. | Nenhuma |
| Workflows | `enclave_workflow_read` `list`: encontra workflows. `get`: lê um workflow. `revisions`: lista as versões salvas. `rules`: como escrever um workflow. | `enclave_workflow_manage` `create`: salva um workflow novo. `update`: edita um workflow. `archive`: arquiva um workflow. |
| Execuções de workflows | `enclave_workflow_run_read` `list`: encontra execuções. `get`: lê uma execução. `steps`: lê as etapas de uma execução. `output`: lê a saída de uma execução. | `enclave_workflow_run_manage` `start`: inicia uma execução. `stop`: para uma execução. |
| Registros de workflows | `enclave_workflow_record_read` `list`: encontra os registros de um workflow. `get`: lê um registro. | `enclave_workflow_record_manage` `delete`: exclui um registro. |
| Threat Feed | `enclave_threat_feed_read` `list`: lista ou pesquisa o feed. `get`: lê uma CVE do feed. | Nenhuma |
| Análises de CVE | `enclave_cve_read` `get`: lê a análise do Enclave de até 10 CVEs. | Nenhuma |
| Grafo da nuvem e repositórios | `enclave_graph_read` `query`: consulta o grafo da nuvem. `validate`: verifica uma consulta sem executá-la. `list_assets`: lista os ativos na nuvem. `list_repos`: lista os repositórios e seus slugs. | Nenhuma |
| Conta | `enclave_account_read` `get`: mostra com qual conta você está conectado, sua organização, seu papel e as integrações dela. | Nenhuma |

* Sem um filtro de status, `list` retorna apenas achados **Confirmed**. A prova de conceito aparece apenas em achados **Confirmed**.
* Os valores de status correspondem aos status do Enclave: `unverified` (**Needs evidence**), `verified` (**Confirmed**), `resolved` (**Resolved**), `invalid` (**Inactive**) e `discarded` (**Dismissed**).
* Indique um pull request como `<repository-slug>#<number>`.
* Workflows integrados são somente leitura. [Gatilhos](https://docs.enclave.ai/pt-br/workflows/triggers.md) ativados iniciam execuções, então salvar um workflow com gatilhos pode iniciar uma.
* Iniciar uma [execução](https://docs.enclave.ai/pt-br/workflows/runs.md) consome créditos. Você pode iniciar um workflow que não recebe entradas ou que recebe achados ou repositórios. Indique cada achado pelo ID curto, como `AbCd12`, e cada repositório pelo slug obtido em `list_repos`. Cada entrada de repositório recebe um único repositório. Inicie no Enclave os workflows que recebem um pull request ou uma superfície de ataque.
* Excluir um registro é permanente.
* Ler o [Threat Feed](https://docs.enclave.ai/pt-br/threat-feed.md) não exige nenhuma permissão. `enclave_cve_read` retorna as análises que o Enclave já concluiu. Ele nunca inicia uma pesquisa nem consome créditos. Para iniciar uma, consulte [Solicitar uma análise](https://docs.enclave.ai/pt-br/threat-feed.md#solicitar-uma-análise).
* Listar repositórios e ler sua conta não exigem permissão além de ser membro.

## Exemplos de prompts

* "Liste meus achados **Confirmed** críticos e altos no Enclave."
* "Leia o achado do Enclave `AbCd12` e corrija-o neste repositório."
* "Marque o achado `AbCd12` como **Resolved** com o motivo 'Corrigido no pull request 123'."
* "Leia as regras de workflows do Enclave e crie um workflow que faça uma varredura de segredos em `acme/api` toda segunda-feira às 08:00 UTC."
* "Inicie meu workflow de triagem de achados do Enclave no achado `AbCd12` e me mostre a saída quando terminar."
* "A CVE-2026-1234 está no Threat Feed do Enclave? Resuma a análise do Enclave sobre ela."
* "Quais dos meus ativos na nuvem no Enclave podem ser acessados pela internet?"

## Solução de problemas

> [accordion] O servidor rejeita minha chave (HTTP 401)
>
> A chave expirou ou foi revogada, ou você foi removido da organização dela. Crie uma chave nova na organização que quer conectar e atualize seu cliente.
>
> Alguns clientes, como o Claude Code, não recorrem ao OAuth enquanto há uma chave configurada. Para mudar para OAuth, remova o servidor do cliente e adicione-o de novo sem o cabeçalho `Authorization`.

> [accordion] Um achado ou workflow que vejo no Enclave retorna não encontrado
>
> Sua conexão age em outra organização. Uma conexão fica na organização em que você estava trabalhando quando a autorizou ou criou a chave. Mude para a organização certa no Enclave e conecte de novo.

> [accordion] Uma ação é recusada
>
> Sua função não tem a permissão que a ação exige. Veja [Acesso e permissões](#acesso-e-permissões) ou peça a um **Owner** ou **Admin** da sua organização.

> [accordion] Meu cliente não consegue se conectar
>
> Verifique se seu cliente aceita servidores MCP remotos por Streamable HTTP. O servidor não oferece o transporte SSE antigo.

## Recursos relacionados

* [Funções](https://docs.enclave.ai/pt-br/admin/roles.md)
* [Gatilhos](https://docs.enclave.ai/pt-br/workflows/triggers.md)
* [Execuções](https://docs.enclave.ai/pt-br/workflows/runs.md)
* [Threat Feed](https://docs.enclave.ai/pt-br/threat-feed.md)
* [Model Context Protocol](https://modelcontextprotocol.io)


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