Zendesk Tickets Server

This MCP server integrates with the Delightroom Zendesk API to allow searching and filtering user feedback tickets.

Components

Tools

• search
  • Search for user feedback tickets with advanced filtering options
  • Input parameters:
    • query (string): Search query text (required)
    • date (string): Specific date to filter by
    • dateRange (object): Date range to filter by
      • start (string): Start date
      • end (string): End date
    • appVersion (string): Filter by app version
    • os (string): Filter by operating system
    • language (string): Filter by language
    • userType (string): Filter by user type
    • theme (string): Filter by theme
    • type (string): Filter by feedback type
    • rating (number): Filter by rating
    • keywords (string[]): Filter by keywords
    • limit (number): Maximum number of results to return
    • offset (number): Number of results to skip
    • sortBy (string): Field to sort by ('date', 'timestamp', 'rating')
    • sortOrder (string): Sort order ('asc', 'desc')
  • Returns matching tickets with their details

Getting Started

1. Ensure you have the DELIGHTROOM_API_KEY environment variable set
2. Build the server with either npm run build or npm run watch

Authentication

The server requires a valid DELIGHTROOM_API_KEY to authenticate with the Zendesk API:

1. Set the DELIGHTROOM_API_KEY environment variable:

   export DELIGHTROOM_API_KEY=your_api_key_here

2. The server will automatically use this key for all API requests

Usage with Desktop App

To integrate this server with the desktop app, add the following to your app's server configuration:

Docker

{
  "mcpServers": {
    "user-feedback": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DELIGHTROOM_API_KEY=${DELIGHTROOM_API_KEY}",
        "mcp/user-feedback"
      ]
    }
  }
}

NPX

{
  "mcpServers": {
    "user-feedback": {
      "command": "npx",
      "args": [
        "-y",
        "@delightroom-mcp/server-user-feedback"
      ],
      "env": {
        "DELIGHTROOM_API_KEY": "${DELIGHTROOM_API_KEY}"
      }
    }
  }
}

API Endpoint

The server communicates with the following API endpoint:

• Base URL: https://rocket.droom.workers.dev/zendesk/tickets
• Method: GET
• Authentication: Bearer token (DELIGHTROOM_API_KEY)

Error Handling

The server provides detailed error messages for:

• Missing API key
• Authentication failures
• Invalid request parameters
• API communication errors

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.