Wiz MCP Server
Aembit supports the official Wiz MCP server, which lets AI Agent: A software workload that authenticates to systems, requests credentials, and accesses resources, either on behalf of a person or on its own. Aembit secures AI agents with the same identity-first model it uses for any workload. User-driven agents such as Claude Desktop also carry a blended identity that ties access to both the user and the agent.Learn more query Wiz cloud security findings through Model Context Protocol: A standard protocol for AI agent and server interactions that defines how AI assistants communicate with external tools and data sources.Learn more(opens in new tab) tools.
This page describes how to configure Wiz as an MCP Server: A server that implements the Model Context Protocol to provide tools, resources, or data to AI agents and MCP clients.Learn more(opens in new tab) behind the Aembit MCP Identity Gateway: A component that brokers MCP traffic between MCP clients and target MCP servers, validating authorization and presenting Aembit-managed credentials on each request.Learn more.
This guide builds the Gateway-to-Server Policy: The Access Policy that authorizes the MCP Identity Gateway to access an MCP server on behalf of authenticated users—the Gateway itself is the Client Workload. Also called right-side auth; each MCP server behind the Gateway needs its own.Learn more—the second of the two Access Policy: Access Policies define, enforce, and audit access between Client and Server Workloads by cryptographically verifying workload identity and contextual factors rather than relying on static secrets.Learn more the MCP Identity Gateway requires. You create the first, the Client-to-Gateway Policy: The Access Policy that validates which MCP client can connect to the MCP Identity Gateway and authenticates users through your Identity Provider. Also called left-side auth; you create one per MCP client and Gateway combination.Learn more, during Gateway setup.
Prerequisites
Section titled “Prerequisites”Before you begin, ensure you have the following:
- A Wiz subscription with permission to manage integrations
- A configured Aembit MCP Identity Gateway
Requirements and considerations
Section titled “Requirements and considerations”Before you configure Wiz, review these requirements and behaviors specific to Wiz’s MCP server.
- Token lifetime. Wiz refresh tokens expire after a maximum of 1 month; users must re-authenticate after that period.
Choose an authentication approach
Section titled “Choose an authentication approach”Aembit supports two authentication approaches for Wiz. The tabs in the following sections stay in sync with the approach you choose.
- User-Based: each user authenticates with their own Wiz identity, and the Gateway injects that user’s token into MCP requests. Aembit stores and refreshes each user’s tokens individually.
- Admin-Based: an administrator completes the OAuth flow once during setup, and all users who access Wiz through the Gateway share the resulting tokens.
Enable the Wiz MCP integration
Section titled “Enable the Wiz MCP integration”Before configuring either authentication approach, enable the Wiz MCP integration from the Wiz integration portal.
- Go to
https://app.wiz.io/settings/automation/integrations/new/wiz-mcp. - Enable the Wiz MCP integration.
Configure the Credential Provider
Section titled “Configure the Credential Provider”Create an MCP User-Based Access Token Credential Provider: Credential Providers obtain the specific access credentials—such as API keys, OAuth tokens, or temporary cloud credentials—that Client Workloads need to authenticate to Server Workloads.Learn more in Aembit.
-
Log into your Aembit Tenant.
-
Go to Credential Providers in the left sidebar and click + New.
-
Configure the following fields:
Field Value Name A user-friendly name Credential Type MCP User-Based Access Token MCP Server URL https://mcp.app.wiz.ioClient ID Auto-populated—no pre-registration needed Client Secret Auto-populated by Discover PKCE Required On For MCP Server URL, click Discover to populate the Authorization URL and Token URL.
-
Click Save.
-
Copy the read-only Callback URL from the Credential Provider.
Create an OAuth 2.0 Authorization Code Credential Provider: Credential Providers obtain the specific access credentials—such as API keys, OAuth tokens, or temporary cloud credentials—that Client Workloads need to authenticate to Server Workloads.Learn more in Aembit.
-
Log into your Aembit Tenant.
-
Go to Credential Providers in the left sidebar and click + New.
-
Configure the following fields:
Field Value Name A user-friendly name Credential Type OAuth 2.0 Authorization Code Client ID The Client ID you copied earlier Client Secret The Client Secret, if required—see the app setup notes Scopes read:all offline_accessOAuth URL https://mcp.app.wiz.ioPKCE Required On Lifetime 1 monthFor OAuth URL, click URL Discovery to populate the Authorization URL and Token URL.
-
Click Save.
-
Copy the read-only Callback URL from the Credential Provider.
Finish configuring the OAuth client
Section titled “Finish configuring the OAuth client”Wiz’s MCP server supports OAuth Dynamic Client Registration, so you don’t need to register an app in the Wiz console. When you click Discover on the Credential Provider, Aembit registers the OAuth client automatically. Wiz grants access when the user completes the OAuth consent flow in the browser.
Admin-Based Auth needs a Client ID. Because Wiz’s MCP server supports Dynamic Client Registration, there’s no app to create in a console—instead, an administrator obtains a Client ID with a one-time registration request to Wiz’s registration endpoint.
-
Create the Credential Provider in Aembit and copy its read-only Callback URL.
-
Run the following request, replacing
<credential-provider-callback-url>with the Callback URL you copied and<tenantId>with your Aembit tenant:curl -X POST "https://mcp.app.wiz.io/oauth2/register" \-H "Content-Type: application/json" \-d '{"redirect_uris": ["<credential-provider-callback-url>"],"grant_types": ["authorization_code", "refresh_token"],"response_types": ["code"],"token_endpoint_auth_method": "none","application_type": "native","client_name": "<tenantId>.aembit.io"}' -
Copy the returned
client_idinto the Credential Provider configuration. -
When the Credential Provider asks for a Client Secret, enter any value—the registration is a public client.
Authorize the Credential Provider
Section titled “Authorize the Credential Provider”There’s no administrator authorization step for this credential type. Each user completes their own Wiz sign-in and consent the first time they access Wiz through the Gateway, and Aembit stores and refreshes each user’s tokens individually.
-
Return to the Credential Provider in Aembit and click Authorize.
-
Complete the Wiz sign-in as an administrator and approve access. The Credential Provider status changes to Ready when the flow completes.
Create the Server Workload
Section titled “Create the Server Workload”-
Go to Server Workloads in the left sidebar and click + New.
-
Configure the following fields:
Field Value Name A user-friendly name Host mcp.app.wiz.ioApplication Protocol MCP Port 443 with TLS URL Path Authentication method HTTP Authentication Authentication scheme Bearer -
Click Save.
Create an Access Policy
Section titled “Create an Access Policy”This section creates the Gateway-to-Server Access Policy, which authorizes the MCP Identity Gateway to access Wiz on behalf of authenticated users.
Create an Access Policy linking the MCP Identity Gateway (as the Client Workload: Client Workloads represent software applications, scripts, or automated processes that initiate access requests to Server Workloads, operating autonomously without direct user interaction.Learn more), the Credential Provider you created, and the Server Workload for Wiz.
For step-by-step instructions, including the Client Workload settings that identify the Gateway, see Create the gateway-to-server Access Policy.
Verify
Section titled “Verify”After authorization completes, the Aembit AI Access Authorized page lists the Wiz MCP Server as Ready. The AI agent can then call Wiz MCP tools through the Gateway.