Claude Desktop & API

Connect Unizo MCP to Claude Desktop and Anthropic's Claude API with full MCP support for tools, resources, and prompts.

Overview

Claude Desktop provides full MCP support for tools, resources, and prompts.

Claude Desktop Setup

Step 1: Generate a Service Key

Use your Unizo API key to generate a service key for MCP authentication:

curl --location 'https://api.unizo.ai/api/v1/serviceKeys' \
  --header "apiKey: {unizo_api_key}" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "MCP ClaudeAI 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	Descriptive name for the integration (e.g., "MCP LangChain Integration")
subOrganization.name	Your organization name (e.g., "Acme Inc")
subOrganization.externalKey	Unique identifier (UUID format recommended)

Supported Category Selectors: Use the appropriate category type when interacting with Claude:

• "type": "PLATFORM" - For platform operations and service management
• "type": "TICKETING" - For ticketing system integrations and workflow automation
• "type": "VMS" - For vulnerability management and security operations
• "type": "OBSERVABILITY" - For monitoring, logging, and observability tools
• "type": "INFRA" - For infrastructure and cloud resource management
• "type": "IDENTITY" - For identity and access management operations
• "type": "INCIDENT" - For incident response and management workflows
• "type": "SCM" - For source code management and repository operations
• "type": "COMMS" - For communication platform integrations
• "type": "EDR" - For endpoint detection and response security tools

Response:

{
    "state": "ACTIVE",
    "displayId": "{UNIZO_SERVICE_KEY}",
    ...
}

Important: Save the displayId from the response - this is your service key for authenticating with the MCP server.

Step 2: Locate Configuration File

Claude Desktop uses a JSON configuration file:

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

Step 3: Add Unizo MCP Configuration

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "unizo": {
        "command": "npx",
        "args": [
          "-y",
          "supergateway@latest",
          "--streamableHttp",
          "https://api.unizo.ai/mcp",
          "--header",
          "servicekey:UNIZO_SERVICE_KEY"
      ]
    }
  }
}

Replace:

• UNIZO_SERVICE_KEY: Your Unizo service key from Step 1

Supported Scopes:

• IDENTITY - Identity and access management tools
• TICKETING - Access ticketing system integrations and operations
• VMS - Vulnerability management system tools and data
• INFRA - Infrastructure and cloud resource management
• EDR - Endpoint detection and response tools
• SCM - Source code management integration tools
• STORAGE - File and storage system integrations
• INCIDENT - Incident management and response capabilities
• PCR - Package and container registry operations
• COMMS - Communication platform integrations (Slack, Teams, etc.)
• OBSERVABILITY - Monitoring and observability platform access
• KEY_MANAGEMENT - Key and secret management operations
• PLATFORM - Core platform operations and service management

Example with Scoped Access:

{
  "mcpServers": {
    "unizo": {
        "command": "npx",
        "args": [
          "-y",
          "supergateway@latest",
          "--streamableHttp",
          "https://api.unizo.ai/mcp",
          "--header",
          "servicekey:UNIZO_SERVICE_KEY",
          "x-mcp-scopes:TICKETING,VMS,OBSERVABILITY"
      ]
    }
  }
}

note

If x-mcp-scopes is not specified, all scopes are enabled by default. This provides full access to all Unizo platform capabilities through the MCP interface.

tip

For production environments, we recommend using scoped access to limit the available tools to only those required for your specific use case. This follows the principle of least privilege and enhances security posture.

Step 4: Restart Claude Desktop

Close and reopen Claude Desktop to load the new configuration.

Step 5: Verify Connection

In Claude Desktop, you can now:

1. List Tools: Ask "What Unizo tools are available?"
2. Execute Operations: Request actions like "List all ticketing connectors"

Programmatic Integration

For programmatic integration with Anthropic's Claude API, see our dedicated Anthropic SDK Framework Guide which provides comprehensive examples and production-ready code.

Usage

Once configured, you can interact with Claude Desktop to access Unizo operations. Ask about data from your connected integrations, and Claude will execute the appropriate Unizo tools to provide responses.

Debug Logging

For troubleshooting connection issues, refer to Claude Desktop's logging capabilities as documented in their official MCP integration guide.