Microsoft Sentinel

🚀 マイクロソフトSentinel MCPサーバーガイド

このガイドは、マイクロソフトSentinel MCPサーバーのインストール、設定、開発に関する包括的な情報を提供します。

🚀 クイックスタート

このセクションでは、マイクロソフトSentinel MCPサーバーの基本的なセットアップと使用方法を説明します。

📦 インストール

Claude Desktopまたはその他のMCP互換クライアントでのインストール

Claude Desktopまたは同様の環境でMCPサーバーを設定するには、提供されているPowerShellインストールスクリプトを使用します。

# リポジトリのルートディレクトリから実行
.\install.ps1

このスクリプトは以下の操作を実行します：

1. Pythonのインストールを確認します。
2. 仮想環境を作成し、依存関係をインストールします。
3. インストール後の設定手順を実行します。
4. Claude Desktop用の設定ファイルを生成します。
5. 設定をクリップボードにコピーします。

スクリプトを実行した後、生成された設定をClaude DesktopやCursorなどのMCPクライアントに直接貼り付けることができます。

高度なインストールオプション

手動環境設定

手動で環境を設定する場合は、以下の手順に従ってください。

1. 環境変数の設定 提供されているテンプレートをコピーし、Azureの資格情報を入力します。

cp .env.example .env
# .envファイルを編集して以下を設定します：
# AZURE_TENANT_ID, AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, AZURE_SUBSCRIPTION_ID, AZURE_RESOURCE_GROUP, AZURE_WORKSPACE_NAME, AZURE_WORKSPACE_ID

2. 依存関係のインストール（uvを使用）

uv venv
uv pip install -e .

3. サーバーの代替実行オプション

MCP CLIを使用する場合：

mcp run wrapper.py

開発とホットリロード：

mcp dev wrapper.py

SSEモード（IDE用）：

python wrapper.py --sse

チェックツールUI

mcp dev wrapper.pyを実行すると、MCPチェックツールUIがhttp://127.0.0.1:6274で利用可能になります。

💻 使用例

基本的な使用法

Claude Desktopまたはその他のMCP互換クライアントでのインストールは、以下のコマンドを使用して行います。

# リポジトリのルートディレクトリから実行
.\install.ps1

高度な使用法

手動で環境を設定する場合は、以下のコマンドを使用します。

# 環境変数の設定
cp .env.example .env
# .envファイルを編集して以下を設定します：
# AZURE_TENANT_ID, AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, AZURE_SUBSCRIPTION_ID, AZURE_RESOURCE_GROUP, AZURE_WORKSPACE_NAME, AZURE_WORKSPACE_ID

# 依存関係のインストール（uvを使用）
uv venv
uv pip install -e .

# サーバーの代替実行オプション
mcp run wrapper.py
mcp dev wrapper.py
python wrapper.py --sse

📚 ドキュメント

開発ガイド

• リソース：Pythonファイルをresources/ディレクトリに追加し、register_resources(mcp)関数を実装します。
• ツール：Pythonファイルをtools/ディレクトリに追加し、register_tools(mcp)関数を実装します。ツールはdocs/tool-architecture-and-implementation-requirements.mdで定義された構造に従う必要があります。
• プロンプト：プロンプトテンプレートをprompts/ディレクトリに追加し、LLM駆動のワークフローに使用します。

resources/、tools/、prompts/ディレクトリ内のすべてのコンポーネントは、サーバー起動時に自動的に検出され、登録されます。手動でインポートする必要はありません。

認証と環境変数

MCPサーバーは、Azure Python SDKのDefaultAzureCredentialがサポートするすべての認証方法をサポートしています。

サービスプリンシパルによる認証（Azure CLIではなく）

Azureでアプリケーション登録を設定し、以下のロールを付与します：

• Log Analytics Reader
• Microsoft Sentinel Reader

必要に応じて、アプリケーション登録に以下のMicrosoft Graphアクセス許可を付与することもできます：

• User.Read.All
• Group.Read.All

その後、.envファイルまたはMCPサーバーの設定で以下の環境変数を使用します：

• AZURE_TENANT_ID
• AZURE_CLIENT_ID
• AZURE_CLIENT_SECRET
• AZURE_SUBSCRIPTION_ID
• AZURE_RESOURCE_GROUP
• AZURE_WORKSPACE_NAME
• AZURE_WORKSPACE_ID

.env.exampleを参照してテンプレートを取得してください。

Azure CLIによる認証

az login

Azure CLIを使用して認証する場合は、設定からAZURE_CLIENT_SECRETを省略することができます。

🔧 技術詳細

MCP Serverは、Azure Python SDKのDefaultAzureCredentialを使用して認証を行います。これにより、Azureでサポートされているさまざまな認証方法を利用できます。また、サーバーはPythonのuvを使用して仮想環境を管理し、依存関係をインストールします。

📄 ライセンス

本ドキュメントに関するライセンス情報は提供されていません。

トラブルシューティングとサポート

インストールまたは設定中に問題が発生した場合は、プロジェクトのドキュメントを参照するか、サポートチームに連絡してください。また、コミュニティフォーラムやその他のリソースからも支援を得ることができます。