Zendesk MCP Server

MCP开发工具

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

开发工具 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaudeCursorWindsurf
查看接入方式

Zendesk MCP Server

一句话选型结论

按资料字段整理

Zendesk MCP Server 属于开发工具类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude、Cursor 等,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

支持客户端

适用场景

developer-tools票务管理TypeScript本地部署AI集成客户支持ZendeskAPI自然语言处理

安装与配置

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

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

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

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

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Zendesk MCP Server当前 未标注 stdio · 本地进程 支持远程部署 有 2026-05-18
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

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

详细介绍

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

Zendesk MCP服务器

一个模型上下文协议(MCP)服务器,为Claude等AI助手提供与Zendesk Support的无缝集成。支持与Zendesk票证的自然语言交互,允许您通过对话式AI搜索、创建、更新和管理支持票证。

✨ 特性

  • 🎫 完整的票务管理:创建、读取、更新和搜索Zendesk票证
  • 💬 评论和注释:添加公开评论和私人内部注释
  • 🔍 高级搜索:使用Zendesk强大的查询语法搜索门票
  • 🔗 事件管理:检索和管理关联的事故单
  • 🏷️ 标签管理:添加和管理票证标签和元数据
  • 🔒 安全认证:使用Zendesk API令牌进行安全访问
  • 🚀 简易安装:可通过npm、npx或手动设置获得

🚀 快速开始

选项1:NPM安装(推荐)```bash

npm install -g zd-mcp-server


### 选项2:与npx一起使用(无需安装)```bash
npx zd-mcp-server

选项3:开发设置```bash

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


## ⚙️ 配置

### 环境变量

在系统或MCP客户端配置中设置这些环境变量:```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

Claude桌面设置

添加到您的Claude Desktop配置文件中:

地点:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 视窗: %APPDATA%/Claude/claude_desktop_config.json

配置:```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"
}
}
}
}


**替代方案(如果全局安装):**```json
{
"mcpServers": {
"zendesk": {
"command": "zd-mcp-server",
"env": {
"ZENDESK_EMAIL": "your-email@company.com",
"ZENDESK_TOKEN": "your-zendesk-api-token",
"ZENDESK_SUBDOMAIN": "your-company"
}
}
}
}

光标IDE设置

增添 ~/.cursor/mcp.json 或 .cursor/mcp.json 在您的项目中:```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"
}
}
}
}


### 其他MCP客户端

对于其他MCP兼容客户端(Cline、Windsurf等),请参阅其MCP服务器配置文档。服务器支持标准MCP协议。

## 🛠️ 可用工具

|工具|说明|示例用法|
|------|-------------|---------------|
| `zendesk_get_ticket` |按ID检索门票|“获取门票#12345”|
| `zendesk_get_ticket_details` |获取带有评论的详细门票|“显示门票#67890的完整详细信息”|
| `zendesk_search` |使用查询语法搜索门票|“查找上周的所有紧急门票”|
| `zendesk_create_ticket` |创建新票证|“为登录问题创建高优先级票证”|
| `zendesk_update_ticket` |更新票证属性|“将票证#555设置为已解决状态”|
| `zendesk_add_private_note` |添加内部代理人备注|“添加关于调查进展的私人备注”|
| `zendesk_add_public_note` |添加公众客户意见|“用解决方案步骤回复客户”|
| `zendesk_get_linked_incidents` |获取与问题关联的事件工单|“显示与此问题工单相关的事件”|

## 💬 使用示例

配置后,您可以与AI助手一起使用自然语言:

### 票务管理```
"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"

搜索与发现```

"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"


### 客户沟通```
"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'"

高级查询```

"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"


## 🔑 身份验证设置

### 1.生成API令牌

1. 登录您的Zendesk帐户
1. 首选 **管理中心** → **应用程序和集成** → **应用程序编程接口** → **中国API**
1. 点击 **添加API令牌**
1. 添加说明:“MCP服务器集成”
1. 点击 **创建** 并复制令牌
1. **重要**:安全保存此令牌-您将不会再看到它

### 2.查找您的子域名

您的Zendesk URL格式: `https://YOUR-SUBDOMAIN.zendesk.com`
使用 `YOUR-SUBDOMAIN` 随着 `ZENDESK_SUBDOMAIN` 价值。

### 3.所需权限

确保您的Zendesk用户帐户具有:

- **代理** 角色(最小)
- **门票入场** 权限
- **API访问** 启用

## 🔧 发展

### 项目结构```
zd-mcp-server/
├── src/
│   ├── index.ts          # Server entry point
│   └── tools/
│       └── index.ts      # Zendesk tool implementations
├── dist/                 # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md

从源头构建```bash

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


### 本地运行```bash
# Start the server
npm start

# Development mode with auto-rebuild
npm run dev

测试```bash

Test with MCP Inspector (if available)

npx @modelcontextprotocol/inspector zd-mcp-server

Or test the built version

npx @modelcontextprotocol/inspector node dist/index.js


## 🔍 故障排除

### 常见问题

**❌ “身份验证失败”错误**

- 验证您的API令牌是否正确且尚未过期
- 确保您的电子邮件地址与您的Zendesk帐户匹配
- 检查您的子域拼写是否正确(否 `.zendesk.com` 后缀)

**❌ “权限被拒绝”错误**

- 验证您的Zendesk用户是否具有代理权限或更高权限
- 确保为您的帐户启用API访问
- 检查您的令牌是否具有所需的范围

**❌ “找不到服务器”错误**

- 确保您已安装该软件包: `npm install -g zd-mcp-server`
- 请尝试使用npx: `npx zd-mcp-server`
- 检查MCP客户端配置文件语法是否正确

**❌ “未设置环境变量”错误**

- 验证是否已设置所有三个环境变量: `ZENDESK_EMAIL`, `ZENDESK_TOKEN`, `ZENDESK_SUBDOMAIN`
- 设置环境变量后重新启动MCP客户端
- 检查环境变量名称中的拼写错误

### 调试模式

启用调试日志记录:```bash
DEBUG=zd-mcp-server:* zd-mcp-server

日志文件

检查MCP客户端日志:

  • 克劳德桌面: ~/Library/Logs/Claude/ (macOS)或 %APPDATA%/Claude/logs/ (Windows)
  • 光标:检查MCP服务器日志的输出面板
  • 终端:直接运行服务器以查看实时日志

📚 高级用法

搜索查询语法

Zendesk搜索支持强大的查询运算符:```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


### 批量操作

虽然服务器不直接支持批处理操作,但您可以链接命令:```
&quot;Search for all urgent tickets, then show me details for the first 3 results&quot;
&quot;Find tickets tagged &#x27;billing&#x27;, update them to normal priority, and add a note about the billing system maintenance&quot;

🤝 贡献

欢迎投稿!请随时提交拉取请求。

开发设置

  1. 分叉存储库
  2. 创建功能分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m &#x27;Add amazing feature&#x27;)
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

报告问题

发现bug了吗?请通过以下方式打开问题:

  • 问题描述
  • 重现步骤
  • 预期行为
  • 您的环境(操作系统、Node.js版本、MCP客户端)
  • 相关日志输出

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🔗 链接

  • GitHub: https://github.com/koundinya/zd-mcp-server
  • npm: https://www.npmjs.com/package/zd-mcp-server
  • Zendesk API文档: https://developer.zendesk.com/api-reference/
  • 模型上下文协议: https://modelcontextprotocol.io/

🆘 支持

  • 问题: GitHub问题
  • 中国API: Zendesk开发人员文档
  • MCP协议: MCP文件

由以下材料制成❤️ 面向MCP和Zendesk社区

常见问题

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

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

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

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

Zendesk MCP Server 收费吗?

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

Zendesk MCP Server 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Zendesk MCP Server 支持哪些客户端?

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

Zendesk MCP Server 能提供哪些能力?

资料显示能力标签包括 TypeScript、Claude、自然语言处理。具体工具清单以官方文档为准。

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

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

Zendesk MCP Server 是本地还是远程?

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

热门专题

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

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