koundinya/zd-mcp-server

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

16 stars 12 forks 质量 80 趋势 25MIT

Repository Install

Zendesk MCP Server

概览

A Model Context Protocol (MCP) server that provides AI assistants like Claude with seamless integration to Zendesk Support. Enables natural language interactions with Zendesk tickets, allowing you to search, create, update, and manage support tickets through conversational AI. - 🎫 : Create, read, update, and search Zendesk tickets - 💬 : Add public comments and private internal notes - 🔍 : Search tickets using Zendesk's powerful query syntax - 🔗 : Retrieve and manage linked incident tickets - 🏷️ : Add and manage ticket tags and metadata - 🔒 : Uses Zendesk API tokens for secure access - 🚀 : Available via npm, npx, or manual setup Set these environment variables in your system or MCP client configuration: Add to your Claude Desktop configuration file: - : ~/Library/Application Support/Claude/claude_desktop_config.json - : %APPDATA%/Claude/claude_desktop_config.json Add to ~/.cursor/mcp.json or .cursor/mcp.

README

以下为原文 README 节选，完整内容请查看原文。

Zendesk MCP Server

✨ Features

🎫 Complete Ticket Management: Create, read, update, and search Zendesk tickets
💬 Comments & Notes: Add public comments and private internal notes
🔍 Advanced Search: Search tickets using Zendesk’s powerful query syntax
🔗 Incident Management: Retrieve and manage linked incident tickets
🏷️ Tag Management: Add and manage ticket tags and metadata
🔒 Secure Authentication: Uses Zendesk API tokens for secure access
🚀 Easy Installation: Available via npm, npx, or manual setup

🚀 Quick Start

Option 1: NPM Installation (Recommended)

npm install -g zd-mcp-server

Option 2: Use with npx (No Installation)

npx zd-mcp-server

Option 3: Development Setup

git clone https://github.com/koundinya/zd-mcp-server.git
cd zd-mcp-server
npm install
npm run build

⚙️ Configuration

Environment Variables

Set these environment variables in your system or MCP client configuration:

export ZENDESK_EMAIL="[email protected]"
export ZENDESK_TOKEN="your-zendesk-api-token"
export ZENDESK_SUBDOMAIN="your-company"  # from https://your-company.zendesk.com

Claude Desktop Setup

Add to your Claude Desktop configuration file:

Location:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

Configuration:

{
  "mcpServers": {
    "zendesk": {
      "command": "npx",
      "args": ["-y", "zd-mcp-server"],
      "env": {
        "ZENDESK_EMAIL": "[email protected]",
        "ZENDESK_TOKEN": "your-zendesk-api-token",
        "ZENDESK_SUBDOMAIN": "your-company"
      }
    }
  }
}

Alternative (if installed globally):

{
  "mcpServers": {
    "zendesk": {
      "command": "zd-mcp-server",
      "env": {
        "ZENDESK_EMAIL": "[email protected]",
        "ZENDESK_TOKEN": "your-zendesk-api-token",
        "ZENDESK_SUBDOMAIN": "your-company"
      }
    }
  }
}

Cursor IDE Setup

Add to ~/.cursor/mcp.json or .cursor/mcp.json in your project:

{
  "mcpServers": {
    "zendesk": {
      "command": "npx",
      "args": ["-y", "zd-mcp-server"],
      "env": {
        "ZENDESK_EMAIL": "[email protected]",
        "ZENDESK_TOKEN": "your-zendesk-api-token",
        "ZENDESK_SUBDOMAIN": "your-company"
      }
    }
  }
}

Other MCP Clients

在 GitHub 查看完整 README

安装

npx -y zd-mcp-server

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "zendesk": {
      "command": "npx",
      "args": ["-y", "zd-mcp-server"],
      "env": {
        "ZENDESK_EMAIL": "[email protected]",
        "ZENDESK_TOKEN": "your-zendesk-api-token",
        "ZENDESK_SUBDOMAIN": "your-company"
      }
    }
  }
}