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

> 通过 MCP 将 Claude Code、Codex、Cursor、VS Code 或 Claude 连接到 Enclave，让 AI 助手可以读取和分诊发现项、读取 Pull Request 扫描、读取和编辑工作流，启动、停止和读取工作流运行，查询云图谱，以及读取 Threat Feed 和 Enclave 的 CVE 分析。

使用 Model Context Protocol（MCP）将 AI 助手连接到 Enclave。连接后，你可以在编辑器或终端中让助手列出和读取发现项、更改发现项的状态、读取 Enclave 对 Pull Request 的扫描、读取、创建和编辑工作流，启动、停止和读取工作流运行及其保存的记录，查询组织的云图谱和资产，以及读取 Threat Feed 和 Enclave 的 CVE 分析。

## Enclave MCP 服务器

| | |
| - | - |
| **服务器 URL** | `https://mcp.enclave.ai/` |
| **传输方式** | Streamable HTTP |
| **身份验证** | OAuth 登录或 MCP 密钥 |
| **范围** | 每个连接一个组织 |

大多数客户端都接受以下配置：

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

> [!NOTE]
>
> 服务器只支持 Streamable HTTP，不提供旧版 SSE 传输方式，因此请使用能够连接远程 HTTP 服务器的客户端。

## 访问与权限

你需要一个 Enclave 账号，并且是某个组织的成员。

在组织范围内使用的工具要求该组织拥有可用套餐，即使是读取调用也一样。试用也算可用套餐。此要求不适用于公共工具。

每个 OAuth 连接或 MCP 密钥都在一个组织中以你的身份操作。Enclave 会在你授权连接或创建密钥时，将其固定到你当时正在使用的组织。工具调用无法切换组织。要连接另一个组织，请先在 Enclave 中切换到该组织，然后授权另一个连接或创建另一个密钥。

你的[角色](https://docs.enclave.ai/zh/admin/roles.md)决定你可以使用哪些工具：

| 你可以做什么 | 权限 | 默认角色 |
| - | - | - |
| 读取发现项和 Pull Request 扫描 | `finding:read` | **Owner**、**Admin**、**Member** |
| 更改发现项的状态 | `finding:status_change` | **Owner**、**Admin** |
| 读取工作流 | `workflow:read` | **Owner**、**Admin**、**Member** |
| 创建或编辑工作流 | `workflow:write` | **Owner**、**Admin** |
| 归档工作流 | `workflow:delete` | **Owner**、**Admin** |
| 保存带触发器的工作流 | `workflow_trigger:write` | **Owner**、**Admin** |
| 读取工作流运行及其记录 | `agent:read` | **Owner**、**Admin**、**Member** |
| 启动和停止运行，以及删除记录 | `agent:write` | **Owner**、**Admin** |
| 读取 Enclave 的 CVE 分析 | `session:read` | **Owner**、**Admin**、**Member** |
| 查询云图谱并列出云资产 | `asset:read` | **Owner**、**Admin**、**Member** |

自定义角色需要具备相应权限。只有 **Owner** 和 **Admin** 可以保存触发器，因为自定义角色无法获得 `workflow_trigger:write`。你只能访问在 Enclave 中可见的资源。已连接组织之外的内容或对你隐藏的内容会返回“未找到”。

当你被移出某个组织时，你在该组织的 OAuth 连接和 MCP 密钥会被撤销。

## 身份验证

| 方式 | 适用场景 | 工作原理 |
| - | - | - |
| **OAuth**（推荐） | 你的客户端可以打开浏览器登录。 | 你登录 Enclave 并批准连接。批准页面会显示该连接将在哪个组织中操作。 |
| **MCP 密钥** | 你的客户端需要固定的 Bearer 令牌，例如在脚本或无界面环境中。 | 你的客户端通过 `Authorization: Bearer` 请求头发送密钥。 |

MCP 密钥只能用于 Enclave 的 MCP 服务器，Enclave REST API 不接受它们。

### 创建 MCP 密钥

你需要拥有要连接的组织中 **Settings** 的访问权限。

**1. 创建密钥**

在 [Enclave](https://app.enclave.ai) 中打开 **Settings → MCP**。在 **API Keys** 下点击 **Create Key**。输入 **Name**，选择 **Expiration**，然后点击 **Create Key**。

**2. 复制密钥**

密钥出现后立即复制。Enclave 只显示一次。 在密钥下方选择你的客户端，即可复制已填入该密钥的设置命令或配置。

![API Key Created 对话框，显示新密钥以及包含该密钥、可直接粘贴的 Claude Code 命令](https://mintcdn.com/enclave/s6Xyaf3D28YdPXGs/images/product/mcp-key-created.png?fit=max\&auto=format\&n=s6Xyaf3D28YdPXGs\&q=85\&s=227a224bc4edb7f5b7ebc2a648790cb2)

请妥善保管密钥。要撤销密钥，请在 **API Keys** 下点击其旁边的撤销按钮。所有使用该密钥的客户端都会失去访问权限。

### 撤销已连接的应用

**Settings → MCP** 的 **Connected apps** 下列出你在当前组织中通过 OAuth 批准的应用，并显示每个应用的连接时间和最近活跃时间。

要撤销某个应用，请点击其旁边的 **Revoke** 并确认。该应用会失去访问权限，需要重新连接。从客户端中移除 Enclave 并不会结束其访问权限，因此也请在这里撤销该应用。

## 设置说明

Enclave 的 **Settings → MCP** 中的 **Setup** 下也会显示这些说明。选择 **OAuth** 或 **API key** 以及你的客户端，然后复制说明。

> [tab] Claude Code
>
> **使用 OAuth：**
>
> ```bash theme={null}
> claude mcp add --transport http enclave https://mcp.enclave.ai/
> ```
>
> 在 Claude Code 中运行 `/mcp`，选择 `enclave`，然后选择 **Authenticate**。在打开的浏览器中登录 Enclave 并批准连接。
>
> **使用 MCP 密钥：**
>
> ```bash theme={null}
> claude mcp add --transport http enclave https://mcp.enclave.ai/ \
>   --header "Authorization: Bearer <your-mcp-key>"
> ```
>
> > [!TIP]
> >
> > 在命令中添加 `-s user`，即可在所有项目中使用 Enclave，而不只是当前文件夹。

> [tab] Codex
>
> **使用 OAuth：**
>
> ```bash theme={null}
> codex mcp add enclave --url https://mcp.enclave.ai/
> ```
>
> Codex 会打开浏览器。登录 Enclave 并批准连接。
>
> **使用 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
>
> 在 Enclave 的 **Settings → MCP** 中选择 **Cursor**，然后点击 **Add to Cursor**。Cursor 会打开并已安装 Enclave。如果选择了 **API key**，Enclave 会创建一个新密钥并为你添加。
>
> 如需手动配置，请将以下内容添加到 `.cursor/mcp.json`：
>
> **使用 OAuth：**
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "enclave": {
>       "url": "https://mcp.enclave.ai/"
>     }
>   }
> }
> ```
>
> **使用 MCP 密钥：**
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "enclave": {
>       "url": "https://mcp.enclave.ai/",
>       "headers": {
>         "Authorization": "Bearer <your-mcp-key>"
>       }
>     }
>   }
> }
> ```

> [tab] VS Code
>
> 将以下内容添加到 `.vscode/mcp.json`：
>
> **使用 OAuth：**
>
> ```json theme={null}
> {
>   "servers": {
>     "enclave": {
>       "type": "http",
>       "url": "https://mcp.enclave.ai/"
>     }
>   }
> }
> ```
>
> **使用 MCP 密钥：**
>
> ```json theme={null}
> {
>   "servers": {
>     "enclave": {
>       "type": "http",
>       "url": "https://mcp.enclave.ai/",
>       "headers": {
>         "Authorization": "Bearer <your-mcp-key>"
>       }
>     }
>   }
> }
> ```

> [tab] Claude
>
> 在 Claude（claude.ai 或 Claude Desktop）中打开 **Settings → Connectors**，然后点击 **Add custom connector**。名称输入 `Enclave`，服务器 URL 输入 `https://mcp.enclave.ai/`。点击 **Connect**，然后登录 Enclave 并批准连接。

其他支持通过 Streamable HTTP 连接远程 MCP 服务器的客户端用法相同。将它们指向 `https://mcp.enclave.ai/` 并使用 OAuth 登录，或在 `Authorization: Bearer` 请求头中发送 MCP 密钥。

## 可用工具

除 Threat Feed 和 CVE 分析工具外，每个工具都在已连接的组织中操作。这两个工具读取对所有人都相同的数据。读取工具从不更改数据，因此你的客户端可以只允许读取工具而不允许更改。

| 领域 | 读取操作 | 更改数据的操作 |
| - | - | - |
| 发现项 | `enclave_finding_read` `list`：查找发现项。 `get`：读取最多 10 个发现项。 | `enclave_finding_manage` `set_status`：更改发现项的状态。 |
| Pull Request 扫描 | `enclave_pull_request_scan_read` `get`：读取 Pull Request 的扫描。 | 无 |
| 工作流 | `enclave_workflow_read` `list`：查找工作流。 `get`：读取工作流。 `revisions`：列出已保存的版本。 `rules`：了解如何编写工作流。 | `enclave_workflow_manage` `create`：保存新工作流。 `update`：编辑工作流。 `archive`：归档工作流。 |
| 工作流运行 | `enclave_workflow_run_read` `list`：查找运行。 `get`：读取运行。 `steps`：读取运行的步骤。 `output`：读取运行的输出。 | `enclave_workflow_run_manage` `start`：启动运行。 `stop`：停止运行。 |
| 工作流记录 | `enclave_workflow_record_read` `list`：查找工作流的记录。 `get`：读取记录。 | `enclave_workflow_record_manage` `delete`：删除记录。 |
| Threat Feed | `enclave_threat_feed_read` `list`：列出或搜索信息流。 `get`：读取信息流中的 CVE。 | 无 |
| CVE 分析 | `enclave_cve_read` `get`：读取 Enclave 对最多 10 个 CVE 的分析。 | 无 |
| 云图谱和仓库 | `enclave_graph_read` `query`：查询云图谱。 `validate`：检查查询但不运行。 `list_assets`：列出云资产。 `list_repos`：列出仓库及其 slug。 | 无 |
| 账户 | `enclave_account_read` `get`：显示你以哪个账户连接、你的组织、你的角色及组织的集成。 | 无 |

* 不使用状态筛选时，`list` 只返回 **Confirmed** 发现项。概念验证只会出现在 **Confirmed** 发现项中。
* 状态值与 Enclave 的状态对应：`unverified`（**Needs evidence**）、`verified`（**Confirmed**）、`resolved`（**Resolved**）、`invalid`（**Inactive**）和 `discarded`（**Dismissed**）。
* 以 `<repository-slug>#<number>` 的形式指定 Pull Request。
* 内置工作流为只读。已启用的[触发器](https://docs.enclave.ai/zh/workflows/triggers.md)会启动运行，因此保存带触发器的工作流可能会启动一次运行。
* 启动[运行](https://docs.enclave.ai/zh/workflows/runs.md)会消耗积分。你可以启动不需要输入、或需要发现项或仓库作为输入的工作流。用短 ID 指定每个发现项，例如 `AbCd12`，用 `list_repos` 中的 slug 指定每个仓库。每个仓库输入只接受一个仓库。需要 Pull Request 或攻击面作为输入的工作流，请在 Enclave 中启动。
* 删除记录是永久性的。
* 读取 [Threat Feed](https://docs.enclave.ai/zh/threat-feed.md) 不需要任何权限。`enclave_cve_read` 只返回 Enclave 已完成的分析。它从不启动研究，也不消耗积分。要启动分析，请参阅[请求分析](https://docs.enclave.ai/zh/threat-feed.md#请求分析)。
* 列出仓库和读取账户只需要是组织成员，不需要其他权限。

## 示例提示词

* “列出我在 Enclave 中 **Confirmed** 的严重和高危发现项。”
* “读取 Enclave 发现项 `AbCd12`，并在这个仓库中修复它。”
* “将发现项 `AbCd12` 标记为 **Resolved**，原因是‘已在 Pull Request 123 中修复’。”
* “阅读 Enclave 工作流规则，然后创建一个工作流，每周一 08:00 UTC 在 `acme/api` 上扫描密钥。”
* “在发现项 `AbCd12` 上启动我的 Enclave 发现项分诊工作流，完成后给我看它的输出。”
* “CVE-2026-1234 在 Enclave 的 Threat Feed 中吗？总结一下 Enclave 对它的分析。”
* “在 Enclave 中，我的哪些云资产可以从互联网访问？”

## 故障排除

> [accordion] 服务器拒绝了我的密钥（HTTP 401）
>
> 密钥已过期或被撤销，或者你已被移出其所属组织。请在要连接的组织中创建新密钥，并更新你的客户端。
>
> 某些客户端（例如 Claude Code）在配置了密钥时不会回退到 OAuth。要切换到 OAuth，请从客户端中移除该服务器，然后在不带 `Authorization` 请求头的情况下重新添加。

> [accordion] 我在 Enclave 中能看到的发现项或工作流返回“未找到”
>
> 你的连接在另一个组织中操作。连接会固定在你授权它或创建其密钥时所使用的组织。请在 Enclave 中切换到正确的组织，然后重新连接。

> [accordion] 某个操作被拒绝
>
> 你的角色没有该操作所需的权限。请参阅[访问与权限](#访问与权限)，或联系组织的 **Owner** 或 **Admin**。

> [accordion] 我的客户端完全无法连接
>
> 请检查你的客户端是否支持通过 Streamable HTTP 连接远程 MCP 服务器。服务器不提供旧版 SSE 传输方式。

## 相关资源

* [角色](https://docs.enclave.ai/zh/admin/roles.md)
* [触发器](https://docs.enclave.ai/zh/workflows/triggers.md)
* [运行](https://docs.enclave.ai/zh/workflows/runs.md)
* [Threat Feed](https://docs.enclave.ai/zh/threat-feed.md)
* [Model Context Protocol](https://modelcontextprotocol.io)


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