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 Identity 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 Identity configuration to claude_desktop_config.json:

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

Available Tools​

Once configured, you'll have access to:

  • list_users - Browse and search users across identity systems
  • get_user_details - Retrieve user information and permissions
  • list_groups - Explore groups, roles, and permissions
  • manage_group_members - Add or remove users from groups
  • check_permissions - Analyze user access rights
  • audit_access - Review authentication logs and access patterns

Multiple Integrations​

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

{
  "mcpServers": {
    "unizo-identity": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://api.unizo.ai/mcp/identity",
        "--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",
  }
}