Skip to main content

Claude Desktop Setup

Early Access

Try our newest feature! Only available through reach out. Contact us to join the early access program and get priority support.

Prerequisites​

  • Claude Desktop (download from claude.ai)
  • Unizo API key and VMS 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 Vulnerability Management configuration to claude_desktop_config.json:

{
  "mcpServers": {
    "unizo-vms": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://api.unizo.ai/mcp/vms",
        "--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-vms": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://api.unizo.ai/mcp/vms",
        "--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 Vulnerability Management tools available in Claude.

Available Tools​

Once configured, you'll have access to:

  • list_vulnerabilities - Browse vulnerabilities with filtering
  • get_vulnerability_details - Retrieve detailed vulnerability info
  • list_assets - View scanned assets and their status
  • get_asset_vulnerabilities - Check vulnerabilities for assets
  • analyze_risk - Calculate risk scores and prioritize
  • track_remediation - Monitor patching progress

Multiple Integrations​

To work with multiple Vulnerability Management providers, add separate server instances:

{
  "mcpServers": {
    "unizo-vms": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://api.unizo.ai/mcp/vms",
        "--allow-http",
        "--header",
        "apikey:${UNIZO_API_KEY}"
      ],
      "env": {
        "UNIZO_API_KEY": "your_api_key"
      }
    },
    "unizo-ticketing": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://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",
  }
}