Zendesk MCP 服务器
Zendesk的模型上下文协议服务器。
此服务器与Zendesk实现了全面集成，提供：
- 用于检索和管理Zendesk工单及评论的工具
- 专门用于工单分析和回复起草的提示
- 作为知识库，可完全访问Zendesk帮助中心的文章
设置
- 构建：
uv venv && uv pip install -e .或者uv build简而言之。 - 在（系统/应用中）设置Zendesk凭据
.env文件，参见 .env.example（通常翻译为“环境配置示例文件”）。 - 在Claude桌面版中进行配置：
{
"mcpServers": {
"zendesk": {
"command": "uv",
"args": [
"--directory",
"/path/to/zendesk-mcp-server",
"run",
"zendesk"
]
}
}
}Docker（注：Docker是一个用于开发、部署和运行应用程序的容器化平台，此译文直接采用了其英文原名，因为“Docker”在中文语境下通常不翻译，直接使用原名。）
如果您希望运行时环境相互隔离，可以将服务器容器化：
- 复制
.env.exampleto.env并填写您的Zendesk凭据。请将此文件保存在版本控制之外。
- 构建镜像：
docker build -t zendesk-mcp-server .- 运行服务器，并提供环境文件：
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 类似于：
{
"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 (整数)：要评论的票证的ID - comment (字符串)：要添加的评论文本/内容 - public （布尔值，可选）：评论是否应为公开（默认为true）
创建工单
创建一个新的Zendesk工单
- 输入：
- subject （字符串）：票证主题 - description (字符串)：票务描述 - requester_id （整数，可选） - assignee_id （整数，可选） - priority （字符串，可选）：其中之一 low， normal， high， urgent - type (字符串，可选)：其中之一 problem， incident， question， task - tags （数组\[字符串\]，可选） - custom_fields （array\[object\]，可选）
更新票据
更新现有 Zendesk 票据中的字段（例如，状态、优先级、负责人）
- 输入：
- ticket_id （整数）：要更新的票据的ID - subject （字符串，可选） - status (字符串，可选)：其中之一 new， open， pending， on-hold， solved， closed - priority (字符串，可选)：其中之一 low， normal， high， urgent - type （字符串，可选） - assignee_id （整数，可选） - requester_id （整数，可选） - tags （数组\[字符串\]，可选） - custom_fields （数组\[对象\]，可选） - due_at （字符串，可选）：ISO8601 日期时间