Bright Security Mcp

Bright MCP 統合

Bright の Model Context Protocol (MCP) 統合により、AI を活用したアプリケーションセキュリティテストを開発ワークフローに直接取り込めます。AI コーディングアシスタントは、自然言語での会話を通じて、API エンドポイントの検出、セキュリティスキャンの実行、脆弱性の確認を行えます。

Bright MCP は、クラウドでホストされるリモート MCP サーバーです。 ローカルにインストールするものはありません。MCP 対応クライアントから Bright のエンドポイントを指定し、API キーで認証するだけです。

クイックスタート

1. Bright API キーを取得する

Bright アカウントで専用の API キーを作成します。必要なスコープを持つ個人、プロジェクト、または組織レベルのキーを使用できます。詳細は個人用 API キーのスコープをご覧ください。

2. クライアントを設定する

お使いの IDE またはツールに、Bright をリモート MCP サーバーとして追加します。サーバーの URL は次のとおりです。

https://app.brightsec.com/mcp

注： 組織で専用の Bright クラスターを使用している場合は、app.brightsec.com をクラスターのホスト名に置き換えてください。

IDE ごとの手順については、以下のクライアント設定をご覧ください。

3. 使用を開始する

AI アシスタントに、次のように尋ねてみてください。

Scan https://my-app.example.com for security vulnerabilities

アシスタントは Bright MCP ツールを使って、プロジェクトの一覧表示、エントリーポイントの検出、スキャンの実行、検出結果の報告を行います。

---

クライアント設定

VS Code（GitHub Copilot）

MCP 設定に以下を追加します（コマンドパレットから「MCP: Add Server」→「Global」を選択するか、mcp.json を手動で編集します）。

{
  "servers": {
    "brightsec.com": {
      "type": "sse",
      "url": "https://app.brightsec.com/mcp",
      "headers": {
        "Authorization": "Api-Key ${input:apiKey}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "apiKey",
      "description": "Enter your Bright API Key",
      "password": true
    }
  ]
}

次に、拡張機能タブで brightsec.com MCP サーバーを右クリックし、サーバーを起動を選択します。API キーの入力を求められます。

詳細ガイド：VS Code で Bright MCP を設定する

Augment Code

1. Augment Code 拡張機能の設定 → ツール → MCP を開きます。
2. + Add remote MCP をクリックします。
3. 以下の項目を入力します。
   • 接続タイプ： HTTP
   • 認証タイプ： Header
   • 名前： BrightSec
   • URL： https://app.brightsec.com/mcp
   • ヘッダー名： Authorization
   • ヘッダー値： Api-Key YOUR_API_KEY
4. 保存をクリックします。

詳細ガイド：Augment Code で Bright MCP を設定する

Cursor

Cursor の MCP 設定（.cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "brightsec": {
      "url": "https://app.brightsec.com/mcp",
      "headers": {
        "Authorization": "Api-Key YOUR_API_KEY"
      }
    }
  }
}

Windsurf

Windsurf の MCP 設定（~/.codeium/windsurf/mcp_config.json）に追加します。

{
  "mcpServers": {
    "brightsec": {
      "serverUrl": "https://app.brightsec.com/mcp",
      "headers": {
        "Authorization": "Api-Key YOUR_API_KEY"
      }
    }
  }
}

汎用 MCP クライアント

リモート HTTP/SSE サーバーに対応する MCP クライアントであれば、Bright に接続できます。以下のように設定してください。

設定項目	値
トランスポート	SSE（Server-Sent Events）または HTTP
URL	https://app.brightsec.com/mcp
認証ヘッダー	Authorization: Api-Key YOUR_KEY

---

利用可能なツール

Bright MCP は、次のツールを AI アシスタントに公開します。

プロジェクト管理

ツール	説明
listProjects	API キーでアクセス可能なすべてのプロジェクトを一覧表示します。他の操作に必要なプロジェクト ID を探すときに使用します。

エンドポイント検出

ツール	説明
runDiscovery	クローリング（crawlerUrls）または API 定義（uploadApiDefinition の fileId）を使って API エンドポイントを検出します。実行前に、listEntrypoints でプロジェクトにエントリーポイントがすでに存在するか確認してください。プライベートまたはローカルのターゲットには、repeaters で接続済みのリピーターを指定します。
getDiscoveryStatus	検出処理の現在のステータスを取得します。
listDiscoveries	プロジェクトの検出履歴を一覧表示します。過去の検出処理を確認したり、進行中のエンドポイント検出を監視したりできます。
uploadApiDefinition	URL またはコンテンツを使って、API 定義ファイル（OpenAPI/Swagger）をアップロードします。検出処理で参照するファイル ID が返されます。

エントリーポイントの管理

ツール	説明
listEntrypoints	プロジェクトで検出された API エンドポイント／URLを一覧表示します。スキャン対象のエントリーポイントを選択したり、攻撃対象領域のカバレッジを評価したりする際に使用します。HTTP メソッド、ステータス、テキスト検索で絞り込めます。
getEntrypoint	ID を指定して特定のエントリーポイントの詳細情報を取得します。ヘッダー、本文、設定が含まれます。
addEntrypoint	プロジェクトに新しいエントリーポイントを追加します。エントリーポイントでは、セキュリティスキャンに使用できる HTTP リクエスト（メソッド、URL、ヘッダー、本文）を定義します。
editEntrypoint	既存のエントリーポイントを更新します。HTTP リクエストの定義、認証、またはリピーターの設定を変更します。

セキュリティスキャン

ツール	説明
runScan	選択したエントリーポイントに対してセキュリティスキャンを開始します。ID またはステータス（例：new、changed、vulnerable）で特定のエントリーポイントを対象にできます。実行するテストを設定するか、スキャンテンプレートを使用します。非公開／ローカルのターゲットでは、接続済みのリピーターを指定します。
getScanStatus	実行中のスキャンの現在のステータスを取得します。
listScans	プロジェクトのスキャン履歴を一覧表示します。過去のスキャン結果を確認したり、複数の実行中スキャンのステータスを確認したりできます。
listTests	スキャンに含められる、利用可能なセキュリティテスト（例：SQL インジェクション、XSS、CSRF）をすべて一覧表示します。

脆弱性の管理

ツール	説明
listIssues	プロジェクトで見つかったセキュリティ脆弱性を一覧表示します。重大度（Low、Medium、High、Critical）、ステータス（new、recurring、resolved、ignored）、またはエントリーポイントで絞り込めます。

認証設定

ツール	説明
listAuths	プロジェクトの認証設定を一覧表示します。認証が必要な保護対象エンドポイントをスキャンする前に使用します。
getAuth	特定の認証設定の詳細情報を取得します。
addAuth	新しい認証設定を作成します。複数の認証方式に対応しています：静的ヘッダー、OAuth 2.0/OIDC、複数ステップの HTTP フロー、NTLM、ブラウザーベースのログイン、記録されたブラウザーフロー。
editAuth	既存の認証設定を更新します。

非公開／ローカルターゲットへのアクセス

ツール	説明
createRepeater	非公開／ローカルのターゲットにアクセスするためのリピーターを作成します。作成後、Bright CLI を実行してリピーターを起動し、接続を確立します。
listRepeaters	リピーターとその接続ステータスを一覧表示します。公開されていないアプリケーションをスキャンする前に、リピーターが接続されていることを確認してください。

---

使用例

公開アプリケーションをスキャンする

"https://my-app.example.com のセキュリティ脆弱性をスキャンしてください"

アシスタントは次の操作を行います：

1. プロジェクトを一覧表示し、適切なプロジェクトを探します
2. プロジェクトで検出されたすべてのエントリーポイントを取得します
3. それらのエントリーポイントに対してセキュリティスキャンを実行します
4. スキャンのステータスを監視し、検出結果を報告します

OpenAPI 仕様からエンドポイントを検出する

"https://my-app.example.com/openapi.json の OpenAPI 仕様から API エンドポイントを検出してください"

アシスタントは次の操作を行います：

1. OpenAPI 定義ファイルをアップロードします
2. ファイルベースの検出を実行します
3. 検出のステータスを監視します

ローカル／非公開アプリケーションをスキャンする

"http://localhost:3000 にあるローカルアプリケーションをスキャンしてください"

アシスタントは次の操作を行います：

1. リピーター接続用に Bright CLI がインストールされているか確認します
2. プロジェクトを一覧表示し、適切なプロジェクトを探します
3. 必要に応じてリピーターを作成します
4. リピーター経由でセキュリティスキャンを実行します
5. スキャンのステータスを監視し、検出結果を報告します

重大な脆弱性を確認する

"プロジェクト内の重大度が Critical または High の問題をすべて表示してください"

アシスタントは次の操作を行います：

1. プロジェクトを一覧表示します
2. 重大度を Critical と High に絞り込んで問題を検索します
3. 詳細とともに検出結果を提示します

認証を使用したスキャン

「Bearer トークン認証が必要な API をスキャンしてください」

アシスタントは次の処理を行います。

1. 既存の認証設定を作成するか、検索します
2. 適切なヘッダー／トークンのフローを設定します
3. 認証を適用してスキャンを実行します

ワークフローの詳しい例については、examples/ ディレクトリを参照してください。

---

仕組み

┌─────────────────────┐         ┌──────────────────────┐
│   AI Assistant       │  MCP    │   Bright Cloud       │
│   (VS Code, Cursor,  │◄──────►│   (app.brightsec.com)│
│    Windsurf, etc.)   │  SSE    │                      │
└─────────────────────┘         └──────────┬───────────┘
                                           │
                                           │ Scans
                                           ▼
                                ┌──────────────────────┐
                                │   Your Application   │
                                │   (public or via      │
                                │    repeater)          │
                                └──────────────────────┘

1. AI アシスタントが SSE/HTTP 経由で Bright の MCP エンドポイントに接続します。
2. Bright のクラウドプラットフォームがツール呼び出しを受け取り、セキュリティ操作を調整します。
3. アプリケーションに対してスキャンを実行します — 直接実行する（公開されているターゲットの場合）か、Repeater 経由で実行します（プライベート／ローカルのターゲットの場合）。

---

Repeater（プライベート／ローカルのターゲット）

一般にアクセスできないアプリケーションをスキャンするには、Bright の Repeater を使用します。これは、Bright のクラウドからローカルネットワークを経由してスキャンのトラフィックをルーティングする軽量エージェントです。

1. MCP ツール（createRepeater）を使って Repeater を作成します
2. Bright CLI を使って Repeater を起動します。

   bright-cli repeater \
     --id <REPEATER_ID> \
     --hostname app.brightsec.com \
     --token <YOUR_API_KEY>
   

3. スキャンまたは検出を実行するときに Repeater を指定します

セットアップ手順については、Bright CLI Installation Guide を参照してください。

---

リソース

• Bright Documentation
• Bright MCP Tools Reference
• VS Code Configuration Guide
• Augment Code Configuration Guide
• API Key Scopes
• Bright CLI Installation
• Model Context Protocol Specification

---

ライセンス

このリポジトリには、Bright の MCP 統合に関する設定例とドキュメントが含まれています。Bright のセキュリティスキャンプラットフォームは商用 SaaS 製品です。詳しくは brightsec.com をご覧ください。