Zendesk MCP Server

这是一个与Zendesk集成的Model Context Protocol服务器。

该服务器提供了全面的Zendesk集成。它提供：

• 检索和管理Zendesk工单和评论的工具
• 专门用于工单分析和响应草稿的提示
• 完整访问Zendesk帮助中心文章作为知识库

配置

• 构建：uv venv && uv pip install -e . 或者简短地使用 uv build。
• 在.env文件中设置Zendesk凭证，参考 .env.example。
• 在Claude桌面中配置：

{
  "mcpServers": {
      "zendesk": {
          "command": "uv",
          "args": [
              "--directory",
              "/path/to/zendesk-mcp-server",
              "run",
              "zendesk"
          ]
      }
  }
}

Docker

如果你希望在一个隔离的运行时环境中运行，可以容器化这个服务器：

1. 将.env.example复制到.env并填写你的Zendesk凭证。请将此文件保留在版本控制之外。

2. 构建镜像：

   docker build -t zendesk-mcp-server .
   

3. 运行服务器，提供环境文件：

   docker run --rm --env-file /path/to/.env zendesk-mcp-server
   

   当通过STDIN/STDOUT连接容器到MCP客户端时（Claude Code使用这种模式），添加 -i。对于守护进程运行，添加 -d --name zendesk-mcp。

镜像从requirements.lock安装依赖项，降级权限至非root用户，并期望仅通过环境变量进行配置。

Claude 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 (字符串，可选)：排序顺序 - asc或desc（默认为desc）

• 输出：返回包含id、主题、状态、优先级、描述、时间戳和分配人信息等基本字段的工单列表，以及分页元数据

获取工单

通过ID检索一个Zendesk工单

• 输入：
  • ticket_id (整数)：要检索的工单ID

获取工单评论

通过ID检索一个Zendesk工单的所有评论

• 输入：
  • 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 (对象数组，可选)

更新工单

更新现有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日期时间