Zendesk MCP

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”在中文语境下通常不翻译，直接使用原名。）

如果您希望运行时环境相互隔离，可以将服务器容器化：

1. 复制 .env.example to .env 并填写您的Zendesk凭据。请将此文件保存在版本控制之外。

1. 构建镜像：

   docker build -t zendesk-mcp-server .

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

   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 日期时间