MCP サーバーを介した Hexa AI

Tenable Hexa AI MCP サーバーは、Tenable がホストするインターフェースで、クラウドサイバーエクスポージャー の構造化されたツールを任意の MCP 互換 AI クライアントに公開します。これは、お好みの大規模言語モデル (LLM) とクラウドセキュリティ環境の間の安全なアダプターとして機能し、AI クライアントがクラウドリソース、検出結果、アイデンティティ、コンプライアンスデータに直接アクセスできるようにします。

MCP サーバーを使用すると、Claude Desktop、Claude Code、Cursor などの AI クライアントを クラウドサイバーエクスポージャー に直接接続できます。その後、AI アシスタントが Tenable ツールを発見して呼び出し、クラウド資産の検索、検出結果の調査、IAM アクセス許可の確認、コンプライアンス体制のクエリ、カスタムワークフローの構築を行うことができます。これらのすべてを、ライブクラウドセキュリティデータを使用して実行できます。

始める前に

Tenable Hexa AI MCP サーバーに接続する前に、以下が揃っていることを確認してください。

• サービスアカウントにアクセスできる クラウドサイバーエクスポージャー アカウント

• クラウドサイバーエクスポージャー サービスアカウントトークン。

  注意: サービスアカウントを作成または取得するには、クラウドサイバーエクスポージャー コンソールで、[Settings > Access Management] に移動します。
• 以下のような、MCP と互換性のある AI クライアント
  • Claude Desktop
  • Claude Code
  • Cursor
  • HTTP 経由で Model Context Protocol をサポートする任意のクライアント

MCP サーバーに接続する

Tenable Hexa AI MCP サーバーは、HTTP MCP エンドポイントとして利用できます。接続するには、サーバー URL と クラウドサイバーエクスポージャー サービスアカウントトークンを使用して MCP クライアントを設定します。

• サーバー URL: https://app.tenable.com/api/mcp
• 認証: ベアラートークン承認ヘッダーとサービスアカウントトークン
  Authorization: Bearer <YOUR_SERVICE_ACCOUNT_TOKEN>

Claude Desktop

Claude Desktop は、mcp-remote npm パッケージを使用して、ローカルの stdio-to-HTTP ブリッジ経由でリモート MCP サーバーに接続します。

前提条件

次の Node.js がインストールされている必要があります。

• macOS: ターミナルで brew install node を実行します。
• Windows:nodejs.org からインストーラーをダウンロードして実行します。

node -v を実行して、インストールを確認します。「トラブルシューティング」の証明書オプションを利用できるように、バージョン 22.15 以降を推奨します。

Tenable Hexa AI MCP サーバーを Claude Desktop に追加するには:

1. Claude Desktop 設定ファイルを開きます。最も簡単な方法は、Settings > Developer > Edit Config、ファイルが存在しない場合はファイルを開き作成することです。ファイルは次の場所にあります。

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   注意: WindowsのMicrosoft StoreからClaude Desktopをインストールした場合、ファイルは上記のパスではなくパッケージフォルダ内に存在します。[構成の編集] ボタンを使用して開きます。

2. 次のエントリを [ mcpServers ] セクションに追加します。<YOUR_SERVICE_ACCOUNT_TOKEN>クラウドサイバーエクスポージャー サービスアカウントのトークンに置き換えます。

   コピー

   JSON

   {
     "mcpServers": {
       "tenable-cloud-security": {
         "command": "npx",
         "args": [
           "-y",
           "mcp-remote",
           "https://app.tenable.com/api/mcp",
           "--header",
           "Authorization: Bearer <YOUR_SERVICE_ACCOUNT_TOKEN>"
         ]
       }
     }
   }

   ファイルにすでに mcpServers セクションが含まれている場合は、その中に tenable-cloud-security エントリのみを追加します。

3. Claude Desktop を完全に終了して再起動します。macOS では、 Cmd+Q キーを押します。Windows で、システムトレイアイコンを右クリックして [終了] を選択します。ウィンドウを閉じるだけでは十分ではありません。Claude Desktop は、利用可能な Tenable ツールを自動的に検出します。接続を確認するには、Claude にクラウドアカウントをリストするか、オープンの検出結果を検索するように依頼します。

   注意: 最初の起動には、 npx のダウンロード mcp-remoteで約 30 秒かかる場合があります。

トラブルシューティング

接続が表示されない場合は、まず完全に終了し、Claude Desktopを再起動したことを確認します。次に、ログを確認します。

• macOS: ~/Library/Logs/Claude/mcp-server-tenable-cloud-security.log
• Windows: %APPDATA%\Claude\logs\mcp-server-tenable-cloud-security.log

ログのメッセージは原因を示しています。

'C:\Program' is not recognized (Windows)。npx コマンドは、起動時に中断されるスペース(Program Files)を含むパスに解決されます。command値を短いパス形式に変更します。

"command": "C:\\PROGRA~1\\nodejs\\npx.cmd",

お使いのマシンで PROGRA~1 解決されない場合は、フルパス C:\\Program Files\\nodejs\\npx.cmdを使用してください。

SELF_SIGNED_CERT_IN_CHAIN - ネットワークは TLS トラフィックを検査し、デフォルトで Node が信頼しない内部認証局で再署名します。ノード 22.15 以降で、サーバーエントリに env ブロックを追加して、オペレーティングシステムの証明書ストアを信頼するようにノードに指示します。

"tenable-cloud-security": {
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote",
    "https://app.tenable.com/api/mcp",
    "--header",
    "Authorization: Bearer <YOUR_SERVICE_ACCOUNT_TOKEN>"
  ],
  "env": {
    "NODE_USE_SYSTEM_CA": "1"
  }
}

403 Forbidden - GET https://registry.npmjs.org/mcp-remote - 組織がパブリック npm レジストリをブロックしており、承認済みの内部 npm レジストリを使用することを期待しています。そのレジストリで npm をポイントしてから、Claude Desktop を再起動します:

npm config set registry <YOUR_ORG_REGISTRY_URL>

レジストリに認証が必要な場合は、最初にログインします。 npm login --registry=<YOUR_ORG_REGISTRY_URL> --auth-type=web。レジストリの URL とアクセス権については、IT チームまたはプラットフォームチームに問い合わせてください。npm config get registryで変更を確定します。

401 または OAuth 検出を繰り返す可能性があります。 authorization ヘッダーが受け入れられていません。Authorization: Bearer <YOUR_SERVICE_ACCOUNT_TOKEN> を使用していることと、トークンが有効であることを確認してください。

初回起動時のみ「取り付けられませんでした」。 Claude Desktop が、 npx がまだ mcp-remote をダウンロードしている間に接続を試みました。30〜60秒待ってからトレイを終了して、再起動します。パッケージは、その後の起動時にキャッシュされます。

Claude Code

Tenable Hexa AI MCP サーバーを Claude Code に追加するには:

1. ターミナルで次のコマンドを実行します。と <YOUR_ACCESS_KEY> を置換します
   <YOUR_SECRET_KEY> を クラウドサイバーエクスポージャー API キーに置き換えます。

   コピー

   claude mcp add \
     --transport http tenable-cloud-security https://app.tenable.com/api/mcp \
     --header "X-ApiKeys: accessKey=<YOUR_ACCESS_KEY>;secretKey=<YOUR_SECRET_KEY>"

   Claude Codeは、次のセッションで利用可能なTenableツールを自動的に検出します。

Cursor

Tenable Hexa AI MCP サーバーを Cursor に追加するには:

1. Open Cursor Settings:
   • macOS: Cmd+ を押します。
   • Windows: Ctrl+を押します。
2. [MCP Servers] (MCP サーバー) > [Add Server] (サーバーを追加) に移動します。

3. 次の設定を行います。<YOUR_ACCESS_KEY> と <YOUR_SECRET_KEY> をTenable クラウドサイバーエクスポージャー API キーに置き換えます。

   設定	意義
   輸送	HTTP
   URL	https://app.tenable.com/api/mcp
   ヘッダー	X-ApiKeys: accessKey=<YOUR_ACCESS_KEY>;secretKey=<YOUR_SECRET_KEY>

VS Code/GitHub Copilot

VS Code の GitHub Copilot では、エージェント モードで MCP サーバーがサポートされています。

Tenable Hexa AI MCP サーバーを VS Code に追加するには:

1. VS Code User Settings (JSON) を開きます。
   • macOS: Cmd+Shift+P キーを押してから、[Preferences: Open User Settings (JSON)] を選択します。
   • Windows: Ctrl+Shift+P キーを押してから、[Preferences: Open User Settings (JSON)] を選択します。

2. 以下を settings.json に追加します。と <YOUR_ACCESS_KEY> を置換します
   <YOUR_SECRET_KEY> を クラウドサイバーエクスポージャー API キーに置き換えます。

   コピー

   JSON

   {
     "mcp": {
       "servers": {
         "tenable-cloud-security": {
           "type": "http",
           "url": "https://app.tenable.com/api/mcp",
           "headers": {
             "X-ApiKeys": "accessKey=<YOUR_ACCESS_KEY>;secretKey=<YOUR_SECRET_KEY>"
           }
         }
       }
     }
   }

   または、ワークスペースルートで .vscode/mcp.json ファイルを作成または編集します。

   コピー

   JSON

   {
     "servers": {
       "tenable-cloud-security": {
         "type": "http",
         "url": "https://app.tenable.com/api/mcp",
         "headers": {
           "X-ApiKeys": "${input:tenableApiKeys}"
         }
       }
     },
     "inputs": [
       {
         "id": "tenableApiKeys",
         "type": "promptString",
         "description": "Tenable API Keys (format: accessKey=...;secretKey=...)",
         "password": true
       }
     ]
   }

   注意: .vscode/mcp.json アプローチでは、VS Code 入力変数を使用して実行時に認証情報の入力を求めるため、ハードコードされたシークレットは回避されます。に .vscode/mcp.json を追加する .gitignore 設定を共有しない場合。
3. ツールを使用するには、Copilot チャット パネル (Windows の場合は Ctrl+Shift+I 、macOS では Cmd+Shift+I ) を開き、 エージェント モードに切り替えて、Copilot に クラウドサイバーエクスポージャー との対話を依頼します。例: 「AWS で未解決の重大な検出結果をリストします。」

その他の MCP クライアント

HTTP トランスポートをサポートする他の MCP 互換クライアントについては、次の設定を行います。<YOUR_ACCESS_KEY> と <YOUR_SECRET_KEY> をTenable クラウドサイバーエクスポージャー
API キーに置き換えます。

信頼、安全性、ガバナンス

Tenable Hexa AI MCP サーバーは、すべてのアクションを完全に制御できるように設計されています。