MCP Server Setup Guide

Helpdocs Admin Updated by Helpdocs Admin

This document describes how to configure and connect to the DeskDirector Tokity MCP server.

Overview

The MCP (Model Context Protocol) server uses an authentication system that validates incoming requests via HTTP headers before allowing tool invocations.

Server URL

https://ddmcpserver.azurewebsites.net/runtime/webhooks/mcp

Required Headers

All requests to the MCP server must include the following headers:

Header

Required

Description

dd-host

Yes

The base URL of the API host (must be a valid absolute URI)

dd-api-key

Yes

The API key or authentication token

dd-agent

Yes

The agent ID (must be a valid integer)

Header Details

dd-host

The host URL for the API. This must be a valid absolute URI.

Example:

dd-host: https://demo.deskdirector.com

dd-api-key

The API key used for authentication. Supports two formats:

  1. With authentication scheme (e.g., Basic <credentials>):
    dd-api-key: Basic Z2xvYmFsOjVPTnJSZWxJQm...
  2. Without scheme (defaults to Basic):
    dd-api-key: your-api-key-here

dd-agent

The numeric identifier for the agent making the request.

Example:

dd-agent: 123

Error Responses

HTTP Status

Condition

401 Unauthorized

Missing or invalid dd-host or dd-api-key headers

403 Forbidden

Missing or invalid dd-agent header

Example Configuration

Claude Desktop

Add the following to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "deskdirector": {
      "url": "https://ddmcpserver.azurewebsites.net/runtime/webhooks/mcp",
      "headers": {
        "dd-host": "https://demo.deskdirector.com",
        "dd-api-key": "Basic your-api-key-here",
        "dd-agent": "123"
      }
    }
  }
}
VS Code / Copilot

Add the following to your VS Code settings or MCP configuration:

{
  "mcp": {
    "servers": {
      "deskdirector": {
        "type": "sse",
        "url": "https://ddmcpserver.azurewebsites.net/runtime/webhooks/mcp",
        "headers": {
          "dd-host": "https://demo.deskdirector.com",
          "dd-api-key": "Basic your-api-key-here",
          "dd-agent": "123"
        }
      }
    }
  }
}

Troubleshooting

401 Unauthorized
  • Verify that both dd-host and dd-api-key headers are present
  • Ensure dd-host is a valid absolute URI (e.g., https://demo.deskdirector.com)
  • Check that dd-api-key is not empty
403 Forbidden
  • Verify that the dd-agent header is present
  • Ensure dd-agent contains a valid integer value

How did we do?

Ticket Summary for TECH Portal

Contact