Skip to content

Commit d784a2c

Browse files
Merge pull request #314450 from poliveria/poliveria-mcp-prereq-04082026
Add SCU role requirements for entity analyzer
2 parents 41c6bf5 + 06da8cc commit d784a2c

1 file changed

Lines changed: 15 additions & 1 deletion

File tree

articles/sentinel/datalake/sentinel-mcp-data-exploration-tool.md

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ titleSuffix: Microsoft Security
44
description: Learn about the different tools available in the Data exploration collection in Microsoft Sentinel
55
author: poliveria
66
ms.topic: how-to
7-
ms.date: 04/02/2026
7+
ms.date: 04/14/2026
88
ms.author: pauloliveria
99
ms.service: microsoft-sentinel
1010
ms.subservice: sentinel-platform
@@ -29,6 +29,12 @@ To access the data exploration tool collection, you need the following prerequis
2929
- [Microsoft Foundry](sentinel-mcp-use-tool-azure-ai-foundry.md#add-a-microsoft-sentinel-tool-collection)
3030
- [Visual Studio Code](sentinel-mcp-use-tool-visual-studio-code.md)
3131

32+
> [!IMPORTANT]
33+
> Access to Sentinel MCP tools is supported for users, managed identities, or service principals that are assigned with ***at least*** any of the following roles:
34+
> - Security Administrator
35+
> - Security Operator
36+
> - Security Reader
37+
3238
## Add the data exploration collection
3339

3440
To add the data exploration collection, first set up Microsoft Sentinel's unified MCP server interface. Follow the step-by-step instructions for compatible [AI-powered code editors and agent-building platforms](sentinel-mcp-get-started.md#add-microsoft-sentinels-collection-of-mcp-tools).
@@ -78,6 +84,14 @@ For example, `analyze_user_entity` reasons over the user's authentication patter
7884

7985
Entity analysis tools might require a few minutes to generate results, so there are tools to start analysis for each entity and another one that polls for the analysis results.
8086

87+
> [!IMPORTANT]
88+
> To use the entity analyzer tool, you also need the following roles:
89+
> - **Security Copilot Contributor** – This role is required to use the tool, which consumes Security Compute Units (SCUs) to deliver reasoned entity risk analysis.
90+
> - **Security Copilot Owner** (optional) – This role is only required to view and monitor SCU usage.
91+
>
92+
> For more information, see [Understand authentication in Microsoft Security Copilot](/copilot/security/authentication).
93+
94+
8195
#### Start analysis (`analyze_user_entity` and `analyze_url_entity`)
8296

8397
| Parameters | Required? | Description |

0 commit comments

Comments
 (0)