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

> Claude Code、Codex、Cursor、VS Code、Claude を MCP で 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 キー |
| **スコープ** | 接続ごとに 1 つの組織 |

ほとんどのクライアントは次の設定を受け付けます。

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

> [!NOTE]
>
> サーバーは Streamable HTTP のみをサポートします。従来の SSE トランスポートは提供していないため、リモート HTTP サーバーに接続できるクライアントを使用してください。

## アクセスと権限

Enclave アカウントと、組織のメンバーシップが必要です。

組織に紐づくツールは、読み取り呼び出しも含め、組織に利用可能なプランが必要です。トライアルも利用可能なプランに含まれます。この要件は公開ツールには適用されません。

各 OAuth 接続または MCP キーは、1 つの組織であなたとして動作します。Enclave は、接続を承認したときやキーを作成したときに、その時点で作業している組織にこれを固定します。ツール呼び出しで組織を切り替えることはできません。別の組織を接続するには、Enclave でその組織に切り替えてから、別の接続を承認するか別のキーを作成します。

使用できるツールは[ロール](https://docs.enclave.ai/ja/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** |

カスタムロールには対応する権限が必要です。カスタムロールには `workflow_trigger:write` を付与できないため、トリガーを保存できるのは **Owner** と **Admin** だけです。アクセスできるのは 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 はキーを一度しか表示しません。 キーの下でクライアントを選ぶと、キーが入力済みのセットアップコマンドまたは設定をコピーできます。

![新しいキーと、そのキーを含む貼り付け可能な Claude Code コマンドが表示された API Key Created ダイアログ](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]
> >
> > 現在のフォルダーだけでなくすべてのプロジェクトで Enclave を使うには、コマンドに `-s user` を追加します。

> [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** をクリックします。Enclave がインストールされた状態で Cursor が開きます。**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 分析のツールを除き、すべてのツールは接続した組織で動作します。この 2 つは全員に共通のデータを読みます。読み取りツールはデータを変更しないため、クライアントで変更を許可せずに読み取りツールだけを許可できます。

| 領域 | 読み取りアクション | データを変更するアクション |
| - | - | - |
| 検出結果 | `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`：最大 10 件の CVE について Enclave の分析を読みます。 | なし |
| クラウドグラフとリポジトリ | `enclave_graph_read` `query`：クラウドグラフをクエリします。 `validate`：クエリを実行せずにチェックします。 `list_assets`：クラウドアセットを一覧表示します。 `list_repos`：リポジトリとそのスラッグを一覧表示します。 | なし |
| アカウント | `enclave_account_read` `get`：接続しているアカウント、組織、ロール、組織のインテグレーションを表示します。 | なし |

* ステータスで絞り込まない場合、`list` は **Confirmed** の検出結果だけを返します。概念実証は **Confirmed** の検出結果にのみ表示されます。
* ステータス値は Enclave のステータスに対応します：`unverified`（**Needs evidence**）、`verified`（**Confirmed**）、`resolved`（**Resolved**）、`invalid`（**Inactive**）、`discarded`（**Dismissed**）。
* Pull Request は `<repository-slug>#<number>` の形式で指定します。
* 組み込みワークフローは読み取り専用です。有効な[トリガー](https://docs.enclave.ai/ja/workflows/triggers.md)は実行を開始するため、トリガー付きのワークフローを保存すると実行が始まることがあります。
* [実行](https://docs.enclave.ai/ja/workflows/runs.md)を開始するとクレジットを消費します。入力のないワークフロー、または検出結果やリポジトリを入力に取るワークフローを開始できます。各検出結果は `AbCd12` のような短い ID で、各リポジトリは `list_repos` で得られるスラッグで指定します。リポジトリの入力 1 つにつき 1 つのリポジトリを指定します。Pull Request や攻撃対象領域を入力に取るワークフローは Enclave から開始してください。
* レコードの削除は元に戻せません。
* [Threat Feed](https://docs.enclave.ai/ja/threat-feed.md) を読むのに権限は不要です。`enclave_cve_read` は Enclave が完了済みの分析だけを返します。調査を開始することはなく、クレジットも消費しません。分析を開始するには、[分析をリクエストする](https://docs.enclave.ai/ja/threat-feed.md#分析をリクエストする)を参照してください。
* リポジトリの一覧表示とアカウントの確認には、組織のメンバーであること以外の権限は不要です。

## プロンプトの例

* 「Enclave で、**Confirmed** の重大度が Critical と High の検出結果を一覧表示して。」
* 「Enclave の検出結果 `AbCd12` を読んで、このリポジトリで修正して。」
* 「検出結果 `AbCd12` を、理由「Pull Request 123 で修正済み」を付けて **Resolved** にして。」
* 「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/ja/admin/roles.md)
* [トリガー](https://docs.enclave.ai/ja/workflows/triggers.md)
* [実行](https://docs.enclave.ai/ja/workflows/runs.md)
* [Threat Feed](https://docs.enclave.ai/ja/threat-feed.md)
* [Model Context Protocol](https://modelcontextprotocol.io)


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