Client Setup

The Unizo MCP (Model Context Protocol) service enables AI agents to interact directly with Unizo's EDR & XDR tools. This setup will walk you through the process of setting up the MCP integration and using it with Claude Desktop , Cursor or Windsurf.

Prerequisites

Before setting up the MCP integration, you'll need:

• Unizo Api Key: This is used for authentication.(found in the Unizo Console)
• A Client that supports the MCP protocol such as Claude Desktop , Cursor or Windsurf.

Authentication

Generate a service key for MCP authentication API Reference:

curl  --location'https://api.unizo.ai/api/v1/serviceKeys' \
  --header "apiKey: {unizo_api_key}" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "MCP EDR & XDR Integration",
    "subOrganization": {
      "name": "{YOUR_CUSTOMER_NAME}",
      "externalKey": "{YOUR_CUSTOMER_UNIQUE_IDENTIFIER}"
    },
    "integration": {
      "target": {
        "categorySelectors": [
          {
            "type": "EDR"
          }
        ]
      }
    }
  }'

Required Parameters

Parameter	Description
apiKey	Your Unizo API key (found in the Unizo Console)
name	Any descriptive name for the integration (e.g., "MCP EDR & XDR Integration")
subOrganization.name	Your organization name (e.g., "Acme Inc")
subOrganization.externalKey	Must be a unique identifier (UUID format recommended)

Response

{
    "state": "ACTIVE",
    "displayId": "{UNIZO_SERVICE_KEY}",
    ...
}

Important:

Save the displayId from the response — you'll need this service key to authenticate with the MCP server.

Client Configuration

The examples below describe how to configure popular MCP clients.

Claude

To configure, navigate to Settings → Developer and click on Edit Config.

{
  "mcpServers": {
    "unizo": {
        "command": "npx",
        "args": [
          "-y",
          "supergateway@latest",
          "--streamableHttp",
          "https://api.unizo.ai/mcp",
          "--header",
          "servicekey:${UNIZO_SERVICE_KEY}",
          "x-mcp-scopes:EDR"
      ]
    }
  }
}

Cursor

To configure, navigate to Settings -> Cursor Settings -> Tools & Integrations and click on Add a Custom MCP Server.

{
  "mcpServers": {
    "unizo": {
      "url": "https://api.unizo.ai/mcp",
      "headers": {
        "servicekey":"${UNIZO_SERVICE_KEY}",
        "x-mcp-scopes":"EDR"
      }
    }
  }
}

Windsurf

To configure, navigate to Windsurf Settings → Cascade and click on View raw config or Manage plugins → View raw config.

{
  "mcpServers": {
    "unizo": {
      "url": "https://api.unizo.ai/mcp",
      "headers": {
       "servicekey":"${UNIZO_SERVICE_KEY}",
        "x-mcp-scopes":"EDR"
      }
    }
  }
}

Note:

Replace ${UNIZO_SERVICE_KEY} with your actual servicekey from the authentication step.

Multiple Integrations

To work with multiple categories or integrations, add them as a comma-separated list under the x-mcp-scopes header:

{
  "mcpServers": {
    "unizo": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway@latest",
        "--streamableHttp",
        "https://api.unizo.ai/mcp",
        "--header",
        "servicekey:${UNIZO_SERVICE_KEY}",
        "x-mcp-scopes:EDR,SCM"
      ],
    }
  }
}

Support

• Documentation
• MCP Protocol