Skip to main content

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 Claude Integration",
    "subOrganization": {
      "name": "{YOUR_CUSTOMER_NAME}",
      "externalKey": "{YOUR_CUSTOMER_UNIQUE_IDENTIFIER}"
    },
    "integration": {
      "target": {
        "categorySelectors": [
          {
            "type": "TICKETING"
          }
        ]
      }
    }
  }'

Step 2: Locate Configuration File​

Claude Desktop uses a JSON configuration file:

~/Library/Application Support/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",
        "@modelcontextprotocol/client-http",
        "https://api.unizo.ai/mcp"
      ],
      "env": {
        "UNIZO_SERVICE_KEY": "YOUR_SERVICE_KEY"
      }
    }
  }
}

Replace:

  • YOUR_SERVICE_KEY: Your Unizo service key from Step 1

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"
  3. Access Resources: Ask about API schemas or documentation

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.