Skip to main content

Claude Desktop Setup

Prerequisites​

  • Claude Desktop (download from claude.ai)
  • Unizo API key and EDR & XDR integration ID
  • Node.js v20 or higher

Setup Instructions​

  1. Install @mcp-remote if not already installed:

    npm i mcp-remote

  2. Open Claude Desktop and navigate to Settings → Developer → Edit Config

  3. Add the Unizo EDR configuration to claude_desktop_config.json:

{
  "mcpServers": {
    "unizo-edr&xdr": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.unizo.ai/mcp/edr&xdr",
        "--allow-http",
        "--header",
        "apikey:${UNIZO_API_KEY}"
      ],
      "env": {
        "UNIZO_API_KEY": "your_api_key"
      }
    }
  }
}

Flags: If npx is producing errors, consider adding -y as the first argument to auto-accept the installation of the mcp-remote package.

{
  "mcpServers": {
    "unizo-edr&xdr": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.unizo.ai/mcp/edr&xdr",
        "--allow-http",
        "--header",
        "apikey:${UNIZO_API_KEY}"
      ],
      "env": {
        "UNIZO_API_KEY": "your_api_key"
      }
    }
  }
}

  1. Save the file and restart Claude Desktop

  2. Verify the connection - The tools may take a minute to appear. You should see EDR tools available in Claude.

Available Tools​

Once configured, you'll have access to:

  • list_devices - Browse and search managed endpoints
  • get_device_status - Retrieve device security health
  • list_alerts - View security alerts across endpoints
  • investigate_threat - Deep dive into threat indicators
  • isolate_device - Quarantine compromised endpoints
  • run_scan - Initiate on-demand security scans

Multiple Integrations​

To work with multiple EDR providers, add separate server instances:

{
  "mcpServers": {
    "unizo-edr&xdr": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.unizo.ai/mcp/edr&xdr",
        "--allow-http",
        "--header",
        "apikey:${UNIZO_API_KEY}"
      ],
      "env": {
        "UNIZO_API_KEY": "your_api_key"
      }
    },
    "unizo-ticketing": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.unizo.ai/mcp/ticketing",
        "--allow-http",
        "--header",
        "apikey:${UNIZO_API_KEY}"
      ],
      "env": {
        "UNIZO_API_KEY": "your_api_key"
      }
    }
  }
}

Troubleshooting​

Tools not appearing​

  • Ensure Claude Desktop is fully restarted
  • Verify your API key is valid
  • Check the Developer Console in Claude Desktop for errors

Connection errors​

  • Verify Node.js v20+ is installed
  • Check that your integration is active in Unizo dashboard

Debug mode​

Add debug environment variables:

{
  "env": {
    "UNIZO_API_KEY": "your_api_key",
  }
}