Zendesk MCP 服务器
Zendesk的模型上下文协议服务器。
此服务器与Zendesk实现了全面集成,提供:
- 用于检索和管理Zendesk工单及评论的工具
- 专门用于工单分析和回复起草的提示
- 作为知识库,可完全访问Zendesk帮助中心的文章
设置
- 构建:
uv venv && uv pip install -e .或者uv build简而言之。 - 在Claude桌面版中进行配置:```json
{
"mcpServers": {
"zendesk": {
"command": "uv",
"args": [
"--directory",
"/path/to/zendesk-mcp-server",
"run",
"zendesk"
]
}
}
}
如果您希望运行时环境相互隔离,可以将服务器容器化:
1. 复制 `.env.example` to `.env` 并填写您的Zendesk凭据。请将此文件保存在版本控制之外。
1. 构建镜像:```bash
docker build -t zendesk-mcp-server .
- 运行服务器,并提供环境文件:```bash
docker run --rm --env-file /path/to/.env zendesk-mcp-server
添加 `-i` 当通过STDIN/STDOUT将容器连接到MCP客户端时(Claude代码使用此模式)。对于作为守护进程运行的情况,请添加 `-d --name zendesk-mcp`。
该镜像从(指定位置)安装依赖项 `requirements.lock`它会降低权限到非root用户,并且仅通过环境变量进行配置。
#### 克劳德MCP集成
要使用Claude Code/Desktop中的Docker化服务器,请在Claude Code中添加一个条目 `settings.json` 类似于:```json
{
"mcpServers": {
"zendesk": {
"command": "/usr/local/bin/docker",
"args": [
"run",
"--rm",
"-i",
"--env-file",
"/path/to/zendesk-mcp-server/.env",
"zendesk-mcp-server"
]
}
}
}
调整路径以匹配您的环境。保存文件后,重启Claude以检测新的MCP服务器。
资源
- zendesk://knowledge-base,访问整个帮助中心的文章。
提示
分析票据
分析一个Zendesk工单,并提供该工单的详细分析。
草稿票务回复
起草对Zendesk工单的回复。
工具
获取门票
获取支持分页的最新票据
-
输入:
-
page(整数,可选):页码(默认为1) per_page(整数,可选):每页的票数,最多100张(默认为25张)sort_by(字符串,可选):按哪个字段排序 - created_at(创建时间)、updated_at(更新时间)、priority(优先级)或 status(状态)(默认为 created_at)-
sort_order(字符串,可选):排序顺序 - 升序或降序(默认为降序) -
输出:返回一个包含必要字段(包括id、主题、状态、优先级、描述、时间戳和负责人信息)的工单列表,以及分页元数据
获取票据
通过ID检索Zendesk工单
- 输入:
ticket_id(整数):要检索的票据的ID
获取工单评论
通过Zendesk工单ID检索所有相关评论
- 输入:
ticket_id(整数):要获取评论的票据ID
创建工单评论
在现有的 Zendesk 票据上创建一条新评论
- 输入:
ticket_id(整数):要评论的票证的IDcomment(字符串):要添加的评论文本/内容public(布尔值,可选):评论是否应为公开(默认为true)
创建工单
创建一个新的Zendesk工单
- 输入:
subject(字符串):票证主题description(字符串):票务描述requester_id(整数,可选)assignee_id(整数,可选)priority(字符串,可选):其中之一low,normal,high,urgenttype(字符串,可选):其中之一problem,incident,question,tasktags(数组[字符串],可选)custom_fields(array[object],可选)
更新票据
更新现有 Zendesk 票据中的字段(例如,状态、优先级、负责人)
- 输入:
ticket_id(整数):要更新的票据的IDsubject(字符串,可选)status(字符串,可选):其中之一new,open,pending,on-hold,solved,closedpriority(字符串,可选):其中之一low,normal,high,urgenttype(字符串,可选)assignee_id(整数,可选)requester_id(整数,可选)tags(数组[字符串],可选)custom_fields(数组[对象],可选)due_at(字符串,可选):ISO8601 日期时间
