Client Setup

The Unizo MCP (Model Context Protocol) service enables AI agents to interact directly with Unizo's TICKETING 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 Ticketing Integration",
    "subOrganization": {
      "name": "{YOUR_CUSTOMER_NAME}",
      "externalKey": "{YOUR_CUSTOMER_UNIQUE_IDENTIFIER}"
    },
    "integration": {
      "target": {
        "categorySelectors": [
          {
            "type": "TICKETING"
          }
        ]
      }
    }
  }'

Required Parameters

Parameter	Description
apiKey	Your Unizo API key (found in the Unizo Console)
name	Any descriptive name for the integration (e.g., "MCP Ticketing 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:TICKETING"
      ]
    }
  }
}

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":"TICKETING"
      }
    }
  }
}

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":"TICKETING"
      }
    }
  }
}

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:TICKETING,SCM"
      ],
    }
  }
}

Support

• Documentation
• MCP Protocol