Zd MCP Server

MCP数据服务

提供方 famousdrew · 包名 zd-mcp-server

数据服务 stdio · 本地进程 Token 社区 / 第三方 Claude DesktopClaudeCursorWindsurf
查看接入方式

一个为AI助手提供Zendesk票务系统无缝集成的MCP服务器,支持通过自然语言进行票务搜索、创建、更新和管理。

一句话选型结论

按资料字段整理

Zd MCP Server 属于数据服务类 MCP 服务器,stdio · 本地进程,Token,可直接接入 Claude Desktop、Claude、Cursor 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式stdio · 本地进程 鉴权Token 部署方式本地部署
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 24 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量24暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

票务管理TypeScript本地部署客户支持AI集成自动化工作流数据分析

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
npx zd-mcp-server

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 24 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 24 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Zd MCP Server当前 24 stdio · 本地进程 本地部署 有 2026-05-17
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方famousdrew上游标注的维护方 famousdrew
分类数据服务本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时zd-mcp-server · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

17.7 KB
来自项目仓库与上游目录的原文,未做删改

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.

✨ 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
  • 🏢 Brand Support: List brands and search/analyze tickets by brand
  • 📊 Ticket Analysis: Analyze tickets for root cause analysis with full comment history
  • 📈 Trend Analysis: Sample tickets per day over time for pattern detection
  • 🎛️ Field Discovery: List all ticket fields with IDs, types, and dropdown options
  • 📝 QA Integration: Access Zendesk QA (formerly Klaus) reviews, CSAT, quizzes, and scorecards
  • ⏱️ Ticket Metrics: Pull response times, resolution times, and reopen counts per ticket
  • 🕵️ Ticket Audits: Full field-level change history for any ticket
  • 📦 Incremental Exports: Cursor-based bulk ticket exports for large dataset pulls
  • 🤖 AI Agent Export: Download bot conversation exports from Zendesk AI Agents
  • 👷 Workforce Management: Access WFM activities, reports, shifts, and time-off data
  • 🔒 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)```bash

npm install -g zd-mcp-server


### Option 2: Use with npx (No Installation)```bash
npx zd-mcp-server

Option 3: Development Setup```bash

git clone https://github.com/famousdrew/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:```bash
export ZENDESK_EMAIL="your-email@company.com"
export ZENDESK_TOKEN="your-zendesk-api-token"
export ZENDESK_SUBDOMAIN="your-company"  # from https://your-company.zendesk.com

# Optional: For Zendesk QA (formerly Klaus) features
export ZENDESK_QA_API_TOKEN="your-qa-api-token"

# Optional: For Workforce Management features
export ZENDESK_WFM_API_TOKEN="your-wfm-api-token"

# Optional: For AI Agent conversation export features
export ZENDESK_AI_EXPORT_TOKEN="your-ai-agents-api-token"
export ZENDESK_AI_EXPORT_ORG_ID="your-organization-id"
export ZENDESK_AI_EXPORT_BOT_ID="your-bot-id"

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:```json
{
"mcpServers": {
"zendesk": {
"command": "npx",
"args": ["-y", "zd-mcp-server"],
"env": {
"ZENDESK_EMAIL": "your-email@company.com",
"ZENDESK_TOKEN": "your-zendesk-api-token",
"ZENDESK_SUBDOMAIN": "your-company"
}
}
}
}


**Alternative (if installed globally):**```json
{
  "mcpServers": {
    "zendesk": {
      "command": "zd-mcp-server",
      "env": {
        "ZENDESK_EMAIL": "your-email@company.com",
        "ZENDESK_TOKEN": "your-zendesk-api-token",
        "ZENDESK_SUBDOMAIN": "your-company"
      }
    }
  }
}

Claude Code (CLI) Setup```bash

claude mcp add zendesk \
--transport stdio \
--env ZENDESK_EMAIL=your-email@company.com \
--env ZENDESK_TOKEN=your-zendesk-api-token \
--env ZENDESK_SUBDOMAIN=your-company \
-- npx -y zd-mcp-server


### Cursor IDE Setup

Add to `~/.cursor/mcp.json` or `.cursor/mcp.json` in your project:```json
{
  "mcpServers": {
    "zendesk": {
      "command": "npx",
      "args": ["-y", "zd-mcp-server"],
      "env": {
        "ZENDESK_EMAIL": "your-email@company.com",
        "ZENDESK_TOKEN": "your-zendesk-api-token",
        "ZENDESK_SUBDOMAIN": "your-company"
      }
    }
  }
}

Other MCP Clients

For other MCP-compatible clients (Cline, Windsurf, etc.), refer to their documentation for MCP server configuration. The server supports standard MCP protocols.

🛠️ Available Tools

Core Ticket Tools

Tool Description Example Usage
zendesk_get_ticket Retrieve a ticket by ID "Get ticket #12345"
zendesk_get_ticket_details Get detailed ticket with comments "Show me full details for ticket #67890"
zendesk_search Search tickets with query syntax "Find all urgent tickets from last week"
zendesk_create_ticket Create a new ticket "Create a high priority ticket for login issues"
zendesk_update_ticket Update ticket properties "Set ticket #555 to solved status"
zendesk_add_private_note Add internal agent notes "Add a private note about investigation progress"
zendesk_add_public_note Add public customer comments "Reply to customer with solution steps"
zendesk_get_linked_incidents Get incident tickets linked to problems "Show incidents related to this problem ticket"

Field & Brand Discovery

Tool Description Example Usage
zendesk_list_ticket_fields List all ticket fields with IDs, types, and dropdown options "What custom fields are available?"
zendesk_search_by_field Search tickets by field name (auto-resolves to ID) "Find tickets where Product Area is billing"
zendesk_list_brands List all Zendesk brands in the account "What brands do we have?"
zendesk_search_by_brand Search tickets by brand name "Find open tickets for the uAttend brand"

Analysis Tools

Tool Description Example Usage
zendesk_analyze_tickets Analyze up to 500 tickets with full comment history "Analyze the last 30 days of Citadel tickets for root causes"
zendesk_sample_tickets Sample N tickets per day for trend analysis "Sample 25 tickets per day for 20 days from uAttend"

Ticket Metrics & History

Tool Description Example Usage
zendesk_get_ticket_metrics Get timing metrics for one ticket (reply time, resolution time, reopens) "How long did ticket #12345 take to resolve?"
zendesk_list_ticket_metrics Bulk metrics across all tickets, newest first (max 100/page) "Pull metrics for the last 100 tickets"
zendesk_get_ticket_audits Full field-level change history for a ticket "Show me every change made to ticket #67890"
zendesk_incremental_tickets Cursor-based bulk export of tickets updated since a given time "Export all tickets updated in the last 7 days"

AI Agent Export Tools (requires ZENDESK_AI_EXPORT_TOKEN, ZENDESK_AI_EXPORT_ORG_ID, ZENDESK_AI_EXPORT_BOT_ID)

Tool Description Example Usage
zendesk_ai_export_get_signed_urls Get signed download URLs for bot conversation exports for a given date "Get export URLs for bot conversations on 2024-03-15"
zendesk_ai_export_fetch_conversations Download and parse conversation records from a signed URL "Fetch the conversations from this export URL"

> Data is available back to 2024-01-01. Files are generated once daily at midnight UTC — the most recent available date is yesterday. Signed URLs expire after 24 hours.

> Requests go to https://YOUR-SUBDOMAIN.zendesk.com/ai-agents/api/data-export/v3, so ZENDESK_SUBDOMAIN is required for these tools too. The legacy *.ultimate.ai hosts were retired on 2026-09-15; ZENDESK_AI_EXPORT_REGION is no longer used, as the endpoint is derived from your subdomain in every region.

Zendesk QA Tools (requires ZENDESK_QA_API_TOKEN)

Tool Description Example Usage
zendesk_qa_list_workspaces List all QA workspaces "What QA workspaces do we have?"
zendesk_qa_list_users List all QA users (account-wide) "Show all QA users"
zendesk_qa_get_reviews Get QA reviews (account-wide) "Get all reviews from January 2024"
zendesk_qa_get_csat Get CSAT data (account-wide) "Get CSAT scores for last month"
zendesk_qa_list_quizzes List all quizzes "What quizzes are available?"
zendesk_qa_get_quiz_leaderboard Get quiz leaderboard "Show quiz leaderboard"
zendesk_qa_get_quiz_overview Get quiz statistics "Get statistics for quiz #123"
zendesk_qa_get_quiz_responses Get quiz responses "Get responses for quiz #123"
zendesk_qa_search_conversations Search conversations by email "Find conversations for john@example.com"
zendesk_qa_workspace_users Get workspace users "Get users in workspace #456"
zendesk_qa_workspace_reviews Get workspace reviews "Get reviews for workspace #456 from last month"
zendesk_qa_workspace_csat Get workspace CSAT "Get CSAT for workspace #456"
zendesk_qa_workspace_disputes Get workspace disputes "Get disputes in workspace #456"
zendesk_qa_workspace_scorecards Get workspace scorecards "Show scorecards for workspace #456"

Workforce Management Tools (requires ZENDESK_WFM_API_TOKEN)

Tool Description Example Usage
zendesk_wfm_get_activities Get WFM activities "Show WFM activities for this week"
zendesk_wfm_get_report_data Get WFM report data "Pull WFM report for last month"
zendesk_wfm_fetch_shifts Fetch agent shifts "Get shifts for the support team"
zendesk_wfm_get_time_off Get time-off records "Show time-off requests for this quarter"
zendesk_wfm_import_time_off Import time-off data "Import time-off records"

💬 Usage Examples

Once configured, you can use natural language with your AI assistant:

Ticket Management```

"Show me all high priority tickets assigned to me"
"Create a new ticket: Customer can't access dashboard, priority urgent"
"Update ticket #12345 status to pending and add a note about waiting for customer response"


### Search & Discovery```
"Find all solved tickets from this week tagged with 'billing'"
"Search for open tickets containing 'password reset'"
"Show me tickets created by john@company.com in the last 30 days"

Customer Communication```

"Add a public comment to ticket #789: 'We've identified the issue and working on a fix'"
"Add a private note: 'Customer confirmed the workaround is effective'"


### Advanced Queries```
"Find all problem tickets that have linked incidents"
"Show me escalated tickets that haven't been updated in 2 days"
"Get details for ticket #456 including all comments and history"

Brand & Field Analysis```

"List all our Zendesk brands"
"Find open tickets for the Citadel brand"
"What custom fields do we have for tickets?"
"Search for tickets where Product Area is billing"


### Root Cause Analysis```
"Analyze the last 30 days of uAttend tickets and identify common issues"
"Get 100 Citadel tickets from the past week with full conversation history"
"Sample 25 tickets per day from CloudPunch for the last 20 days - what trends do you see?"

Ticket Metrics & History```

"How long did ticket #12345 take to get a first reply?"
"Show me every status change on ticket #67890"
"Export all tickets updated since last Monday"


### AI Agent Conversations```
"Get the bot conversation export URLs for March 15th"
"Download and summarize yesterday's bot conversation data"

Zendesk QA Analysis```

"List all QA workspaces"
"Get QA reviews from January 2024"
"Show CSAT scores for workspace #123 from last month"
"What disputes were filed in workspace #456 this quarter?"
"Get the quiz leaderboard"


## 🔑 Authentication Setup

### Standard Zendesk API Token

1. Log in to your Zendesk account
2. Go to **Admin Center** → **Apps and integrations** → **APIs** → **Zendesk API**
3. Click **Add API token**, add a description, click **Create**, and copy the token
4. **Important**: Save this token securely — you won't see it again

### AI Agent Export Token

1. Go to **Zendesk AI Agents** settings
2. Navigate to **Settings** → **API**
3. Generate a new API token and note your **Organization ID** and **Bot ID**

### Find Your Subdomain

Your Zendesk URL format: `https://YOUR-SUBDOMAIN.zendesk.com`
Use `YOUR-SUBDOMAIN` as the `ZENDESK_SUBDOMAIN` value.

### Required Permissions

Ensure your Zendesk user account has:
- **Agent** role (minimum)
- **Ticket access** permissions
- **API access** enabled

## 🔧 Development

### Project Structure```
zd-mcp-server/
├── src/
│   ├── index.ts              # Server entry point
│   └── tools/
│       ├── index.ts          # Core Zendesk tool implementations
│       ├── ticket-fields.ts  # Field, brand, and analysis tools
│       ├── zendesk-qa.ts     # Zendesk QA Export API tools
│       ├── zendesk-wfm.ts    # Workforce Management tools
│       ├── zendesk-analytics.ts  # Ticket metrics, audits, incremental export
│       └── zendesk-ai-export.ts  # AI Agent conversation export
├── .github/
│   └── workflows/
│       └── publish.yml       # Automated npm publishing on version tags
├── dist/                     # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md

Building from Source```bash

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


### Running Locally```bash
# Start the server
npm start

# Development mode with auto-rebuild
npm run dev

Testing```bash

npx @modelcontextprotocol/inspector node dist/index.js


### Publishing a New Version

Bump the version in `package.json`, then push a version tag:```bash
git tag v0.6.0
git push origin v0.6.0

GitHub Actions will build and publish to npm automatically.

🔍 Troubleshooting

Common Issues

❌ "Authentication failed" errors
- Verify your API token is correct and hasn't expired
- Ensure your email address matches your Zendesk account
- Check that your subdomain is spelled correctly (no .zendesk.com suffix)

❌ "Permission denied" errors
- Verify your Zendesk user has Agent permissions or higher
- Ensure API access is enabled for your account

❌ "Server not found" errors
- Ensure you've installed the package: npm install -g zd-mcp-server
- Try using npx instead: npx zd-mcp-server
- Check that your MCP client configuration file syntax is correct

❌ "Environment variables not set" errors
- Verify all three required variables are set: ZENDESK_EMAIL, ZENDESK_TOKEN, ZENDESK_SUBDOMAIN
- Restart your MCP client after setting environment variables

❌ AI Export errors
- Confirm ZENDESK_AI_EXPORT_TOKEN, ZENDESK_AI_EXPORT_ORG_ID, and ZENDESK_AI_EXPORT_BOT_ID are all set
- Export files are only available for dates up to yesterday — today's data hasn't been generated yet
- Signed URLs expire after 24 hours; request fresh ones if you get a 403

Log Files

  • Claude Desktop: ~/Library/Logs/Claude/ (macOS) or %APPDATA%/Claude/logs/ (Windows)
  • Cursor: Check the output panel for MCP server logs

📚 Advanced Usage

Analysis Tool Parameters

zendesk_analyze_tickets

Parameter Type Default Description
brand_name string required Brand to analyze (partial match)
days_back number 30 Days to look back
max_tickets number 100 Max tickets (up to 500)
status string all Filter: open, pending, solved, closed
priority string all Filter: low, normal, high, urgent

zendesk_sample_tickets

Parameter Type Default Description
brand_name string required Brand to sample (partial match)
days_back number 20 Days to look back
tickets_per_day number 25 Tickets per day (up to 50)
status string all Filter: open, pending, solved, closed
priority string all Filter: low, normal, high, urgent
include_comments boolean true Include full comment history

zendesk_incremental_tickets

Parameter Type Default Description
start_time number 30 days ago Unix timestamp to start from
cursor string — Pagination cursor from a previous response's after_cursor field

Search Query Syntax```bash

Status-based searches

status:open status:pending status:solved

Priority searches

priority:urgent priority:high priority:normal priority:low

Date-based searches

created>2024-01-01 updated<2024-01-31

Tag searches

tags:billing tags:technical-issue

Requester searches

requester:customer@company.com

Complex combinations

status:open priority:high created>2024-01-01 tags:billing
```

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes
  4. Push to the branch and open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Links

  • GitHub: https://github.com/famousdrew/zd-mcp-server
  • npm: https://www.npmjs.com/package/zd-mcp-server
  • Zendesk API Docs: https://developer.zendesk.com/api-reference/
  • Model Context Protocol: https://modelcontextprotocol.io/

🆘 Support

  • Issues: GitHub Issues
  • Zendesk API: Zendesk Developer Documentation
  • MCP Protocol: MCP Documentation

Made with ❤️ for the MCP and Zendesk communities

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Zd MCP Server 怎么安装?

在客户端按下面的安装命令接入:npx zd-mcp-server。对应的包名是 zd-mcp-server。装完在客户端配置里引用同一个包或端点。

Zd MCP Server 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Zd MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Zd MCP Server 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Zd MCP Server 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、Windsurf、Cline;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Zd MCP Server 能提供哪些能力?

资料显示约 24 个工具;能力标签包括 工作流自动化、TypeScript、Claude。具体工具清单以官方文档为准。

Zd MCP Server 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

Zd MCP Server 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。