Zendesk MCP Server

A lightweight C# MCP (Model Context Protocol) server that provides access to Zendesk Help Center articles in Cursor AI.

Features

• Search Articles: Search your Zendesk Help Center by keywords
• Get Article: Retrieve a specific article by ID
• List Articles: Browse all available articles

Setup

1. Build the Server

cd ZendeskMcpServer
dotnet build --no-restore

2. Get Your Zendesk Credentials

You'll need:

• Subdomain: Your Zendesk subdomain (e.g., yourcompany from yourcompany.zendesk.com)
• Email: Your Zendesk account email
• API Token: Generate from Zendesk Admin > Apps and integrations > APIs > Zendesk API > Settings

3. Configure in Cursor

The server supports two modes: stdio mode (default) and HTTP server mode. Choose the one that fits your needs.

Option A: Stdio Mode (Default)

This mode runs the server as a process that Cursor launches directly. Each user needs to configure their own credentials.

Note: You can also create an appsettings.json file with your credentials, and the server will use them if environment variables aren't set. However, for stdio mode, it's typically easier to configure credentials directly in Cursor's MCP settings.

1. Open Cursor Settings (Ctrl+Shift+J on Windows)
2. Go to MCP tab → Add MCP Server
3. Add this configuration:

{
  "mcpServers": {
    "zendesk": {
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "C:\\projects\\ZendeskMcpServer\\ZendeskMcpServer.csproj"
      ],
      "env": {
        "ZENDESK_SUBDOMAIN": "employmenthero1713155541",
        "ZENDESK_EMAIL": "steven.whitehead@webscale.com.au",
        "ZENDESK_API_TOKEN": "your-api-token"
      }
    }
  }
}

Replace:

• your-subdomain with your actual Zendesk subdomain
• your-email@example.com with your Zendesk email
• your-api-token with your API token

Option B: HTTP Server Mode

This mode runs the server as a web service that multiple users can connect to. The server itself has the credentials configured, so users only need to specify the URL.

Server Setup:

1. Run the server in HTTP mode:

dotnet run --project ZendeskMcpServer.csproj -- --http

Or set the environment variable:

export MCP_SERVER_MODE=http
dotnet run --project ZendeskMcpServer.csproj

2. Configure the server with your Zendesk credentials. You can use either a config file or environment variables:

Option 1: Using a config file (Recommended)

Create an appsettings.json file in the project directory:

{
  "Zendesk": {
    "Subdomain": "your-subdomain",
    "Email": "your-email@example.com",
    "ApiToken": "your-api-token"
  },
  "Server": {
    "Port": "8080",
    "Url": "http://0.0.0.0:8080"
  }
}

Copy appsettings.json.example to appsettings.json and fill in your values:

cp appsettings.json.example appsettings.json
# Edit appsettings.json with your credentials

Option 2: Using environment variables

export ZENDESK_SUBDOMAIN="your-subdomain"
export ZENDESK_EMAIL="your-email@example.com"
export ZENDESK_API_TOKEN="your-api-token"
export PORT="8080"  # Optional, defaults to 8080

Note: Environment variables take precedence over config file values if both are set.

3. The server will start on http://0.0.0.0:8080 (or your specified port)

Client Configuration:

In Cursor, configure the MCP server to connect via HTTP:

{
  "mcpServers": {
    "zendesk": {
      "type": "http",
      "url": "https://zendeskmcpserver/"
    }
  }
}

Note: Replace https://zendeskmcpserver/ with your actual server URL. The server must be accessible from where Cursor is running.

4. Restart Cursor

After adding the configuration, restart Cursor to load the MCP server.

Usage in Cursor

Once configured, you can ask Cursor to search your Zendesk articles:

• "Search our Zendesk articles for payroll setup

... View full README on GitHub