Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This article introduces Microsoft Perception’s Model Context Protocol (MCP) security tools and the setup guides for supported clients.
The Microsoft Perception MCP server enables preauthorized, MCP-compatible AI clients to use specialized Perception security workflows. Agents can discover available playbooks, launch and monitor asynchronous investigation sessions, provide follow-up guidance, and retrieve summaries and generated Markdown reports. Sessions can be accessed through MCP or Microsoft Defender.
To learn the key concepts behind Microsoft Perception, see Key concepts in Perception.
For more information on how AI is used within Microsoft Perception MCP server, see Application card: Microsoft Perception MCP server.
Prerequisites
Before using Perception MCP, confirm that your organization is onboarded and that you meet the Microsoft Perception prerequisites and permissions.
Why Perception MCP?
Perception coordinates specialized security agents that can perform long-running security analysis. The MCP allows the user to do the following:
- Discover available Perception playbooks.
- Start security analyses asynchronously.
- Retain session identifiers for later use.
- Inspect session activity and agent runs.
- Retrieve concise summaries and detailed Markdown reports.
- Continue existing runs with additional instructions.
The following examples illustrate ways to customize workflows:
| Scenario | How Perception MCP can help |
|---|---|
| Work through an incident queue | Your agent can start an investigation session for each incident or alert, track progress, and gather the findings for review. Each session takes one incident or alert ID. |
| Review findings across investigations | Your agent can bring results from several sessions into a briefing to help analysts identify common findings and decide what needs follow-up. |
| Gather context for a decision | Your agent can check Perception findings against approved sources, such as asset inventories or identity records. This additional context helps analysts assess affected resources and plan their next steps. |
| Investigate incidents in an Azure Logic Apps workflow | An Azure Logic Apps workflow can pass an incident or alert ID to an MCP-enabled agent, which starts a Perception investigation and retrieves its findings. The workflow can then use those findings to update a ticket, notify an analyst, or request approval for a response action. |
| Prepare a handoff or stakeholder update | Your agent can use investigation summaries and supporting reports to draft ticket updates, analyst handoffs, or stakeholder briefings. |
Each investigation runs in a Perception session, which brings together the playbook inputs, agent activity, status, summary, and generated reports for that investigation. To learn what a session contains, see Session details in Microsoft Perception.
Perception agents and workflows
Perception uses specialized security agents to carry out playbooks for specific security tasks. Through the Perception MCP server, supported clients can discover available playbooks, start sessions, monitor progress, and retrieve results. Available playbooks and the agents they use depend on your organization’s configuration and permissions.
For details, see Work with agents in Microsoft Perception to learn how agents are set up and managed, and Work with playbooks in Microsoft Perception to learn how to review playbook requirements and start a session.
For details on the available MCP tools, parameters, and response objects, see Microsoft Perception MCP tools reference.
Add Microsoft Perception MCP tools
For instructions on how to add Microsoft Perception MCP tools, see the setup guide for your client:
- Use Perception MCP in GitHub Copilot CLI
- Use Perception MCP in Visual Studio Code
- Use Perception MCP in Microsoft Foundry
- Use MCP connector in ChatGPT or Claude
Test your added tools with sample prompts
After adding Microsoft Perception tools, use the following sample prompts to interact with Perception.
- “Use Perception to investigate incident [incident ID] and summarize what happened and the recommended next steps.”
- "Use Perception to triage alert [alert ID] and summarize what happened and the recommended next steps"
- “Use Perception to analyze this article: The global socket: how threat actors are weaponizing GSocket for stealthy C2”
- "Review my recent Perception investigations and summarize the most important findings."
Turn off Microsoft Perception MCP tool access
To turn off your access to Microsoft Perception’s MCP tools, contact customer support.