Cursor Setup

Prerequisites

• Cursor IDE
• 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 Cursor Settings (Cmd/Ctrl + ,)

3. Add MCP configuration:

macOS/Linux

Navigate to Cursor's settings.json and add :

{
  "mcpServers": {
    "unizo": {
      "command": "/Users/{user_name}/.nvm/versions/node/v18.x.x/bin/node",
      "args": [
        "/Users/{user_name}/.nvm/versions/node/v18.x.x/bin/mcp-remote",
        "https://api.unizo.ai/mcp",
        "--header",
        "apikey:${UNIZO_API_KEY}",
        "--header",
        "x-mcp-scopes:identity"
      ],
      "env": {
        "UNIZO_API_KEY": "your_api_key"
      }
    }
  }
}

Windows

{
  "mcpServers": {
    "unizo": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.unizo.ai/mcp",
        "--header",
        "apikey:${UNIZO_API_KEY}",
        "--header",
        "x-mcp-scopes:identity"
      ],
      "env": {
        "UNIZO_API_KEY": "your_api_key"
      }
    }
  }
}

4. Restart Cursor to load the MCP server

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": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.unizo.ai/mcp",
        "--header",
        "apikey:${UNIZO_API_KEY}",
        "--header",
        "x-mcp-scopes:identity"
      ],
      "env": {
        "UNIZO_API_KEY": "your_api_key"
      }
    }
  }
}

Available Tools

Once configured, you'll have access to:

• identity_list_integrations - Get list for a specific identity service
• identity_list_users - Browse users with filtering and pagination
• identity_get_user_details - Retrieve user information and permissions
• identity_list_groups - Explore groups, roles, and permissions
• identity_get_group_details - Retrieve comprehensive group information
• identity_list_group_members - Browse members of a specific group
• identity_get_group_member_details - Retrieve detailed member information
• identity_list_user_sessions - List active and historical sessions for a user
• identity_get_session_details - Retrieve detailed session information

Environment Variables

You can also set environment variables in your shell profile:

macOS/Linux

export UNIZO_API_KEY = "your_api_key"

Windows

[System.Environment]::SetEnvironmentVariable("UNIZO_API_KEY", "your_api_key", "User")

Then reference them in settings.json:

{
  "env": {
    "UNIZO_API_KEY" : "${env:UNIZO_API_KEY}",
  }
}

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": [
        "mcp-remote",
        "https://api.unizo.ai/mcp",
        "--header",
        "apikey:${UNIZO_API_KEY}",
        "--header",
        "x-mcp-scopes : identity,scm,ticketing"
      ],
      "env": {
        "UNIZO_API_KEY": "your_api_key"
      }
    }
  }
}

Troubleshooting

MCP not detected

• Check Cursor's output panel: View → Output → MCP
• Ensure Node.js v20+ is installed

Authentication errors

• Verify your API key in Unizo dashboard
• Check that the integration ID is correct
• Ensure the integration is active

Debug mode

Enable debug logging in settings.json:

{
  "args": [
  "--debug"
]
}