AI导哈

Zendesk票务管理服务器

一个为Zendesk提供票务管理、搜索和分析功能的模型上下文协议服务器。

  • by kdopenshaw
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 kdopenshaw/zendesk-mcp-server

使用说明

Zendesk MCP服务器

Zendesk的模型上下文协议服务器。

注： 这是一把叉子 reminia/zendesk mcp服务器 添加以下内容：

  • search_tickets 按文本、筛选器、自定义字段和日期范围搜索票证的工具

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

  • 用于检索和管理Zendesk票证和评论的工具
  • 门票搜索 支持自定义字段、筛选器和日期范围
  • 票务分析和响应起草的专门提示
  • 完全访问Zendesk帮助中心的文章作为知识库

先决条件

  • 紫外线 -Python包管理器（必填）

    如果没有，请安装uv：

    # macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Or with Homebrew
brew install uv

设置

  1. 克隆仓库 并记下完整路径（您需要它进行配置）：

    git clone <repo-url> /path/to/zendesk-mcp-server

  2. 构建项目：

    cd /path/to/zendesk-mcp-server
uv venv && uv pip install -e .

  3. 配置Zendesk凭据 在一个 .env 文件：

    cp .env.example .env
# Edit .env with your Zendesk subdomain, email, and API key

  4. 在Claude桌面中配置 （或克劳德代码）：

    添加到MCP设置中，替换 /path/to/zendesk-mcp-server 随着 绝对路径 到您克隆repo的位置：

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

示例路径：

  • macOS： /Users/yourname/dev/zendesk-mcp-server
  • Linux： /home/yourname/projects/zendesk-mcp-server
  • 窗户： C:\\Users\\yourname\\dev\\zendesk-mcp-server

zendesk帮助技能

这 zendesk-help skill提供搜索和管理Zendesk票证的工具。如果你上传 SKILL.md 文件到克劳德桌面，您可以使用 zendesk-help 搜索和管理门票的技能。这将使克劳德对zendesk mcp服务器的使用更加无缝。

资源

  • zendesk://knowledge-base，访问整个帮助中心文章。

提示

分析票

分析Zendesk票证并提供票证的详细分析。

草稿票响应

起草对Zendesk票证的响应。

工具

获取门票

获取支持分页的最新门票

  • 输入：

    • page （整数，可选）：页码（默认为1）
    • per_page （整数，可选）：每页票数，最多100张（默认为25张）
    • sort_by （字符串，可选）：按-created_at、updated_at、优先级或状态排序的字段（默认为created_at）
    • sort_order （字符串，可选）：排序顺序-asc或desc（默认为desc）

  • 输出：返回一个包含基本字段的票证列表，包括id、主题、状态、优先级、描述、时间戳和受让人信息，以及分页元数据

获取门票

通过ID检索Zendesk票证

  • 输入：
    • ticket_id （整数）：要检索的票证的ID

获取门票_备注

按ID检索Zendesk票证的所有评论

  • 输入：
    • ticket_id （整数）：用于获取评论的票证的ID

创建门票

在现有Zendesk票证上创建新注释

  • 输入：
    • ticket_id （整数）：要评论的票的ID
    • comment （string）：要添加的评论文本/内容
    • public （boolean，可选）：注释是否应公开（默认为true）

创建_票

创建新的Zendesk票证

  • 输入：
    • subject （string）：门票主题
    • description （string）：票务描述
    • requester_id （整数，可选）
    • assignee_id （整数，可选）
    • priority （字符串，可选）：其中之一 low, normal, high, urgent
    • type （字符串，可选）：其中之一 problem, incident, question, task
    • tags （array[string]，可选）
    • custom_fields （数组[对象]，可选）

update_ticket

更新现有Zendesk票证上的字段（例如，状态、优先级、受让人）

  • 输入：
    • ticket_id （整数）：要更新的票证的ID
    • subject （字符串，可选）
    • status （字符串，可选）：其中之一 new, open, pending, on-hold, solved, closed
    • priority （字符串，可选）：其中之一 low, normal, high, urgent
    • type （字符串，可选）
    • assignee_id （整数，可选）
    • requester_id （整数，可选）
    • tags （array[string]，可选）
    • custom_fields （数组[对象]，可选）
    • due_at （字符串，可选）：ISO8601日期时间

搜索门票

使用支持文本搜索、过滤器、自定义字段和日期范围的查询语法搜索Zendesk票证。

  • 输入：

    • query （字符串，可选）：在主题/描述中搜索的文本
    • status （字符串，可选）：按状态筛选- new, open, pending, hold, solved, closed
    • priority （字符串，可选）：按优先级筛选- low, normal, high, urgent
    • assignee （字符串，可选）：按受让人电子邮件筛选
    • requester （字符串，可选）：按请求者电子邮件筛选
    • tags （array[string]，可选）：按标签筛选
    • custom_field_id （整数，可选）：要搜索的自定义字段ID
    • custom_field_value （字符串，可选）：要在自定义字段中匹配的值
    • created_after （字符串，可选）：ISO日期-在此日期之后创建的票证
    • created_before （字符串，可选）：ISO日期-在此日期之前创建的票证
    • sort_by （字符串，可选）：排序依据的字段- created_at, updated_at, priority, status （默认为 updated_at)
    • sort_order （字符串，可选）：排序顺序- asc 或 desc （默认为 desc)
    • limit （整数，可选）：最大结果，最多100个（默认为25个）

  • 输出：返回具有id、主题、状态、优先级、描述、时间戳、受让人信息和标签的匹配票，以及搜索元数据

  • 示例-按自定义字段搜索（例如，转账ID）：

    {
  "custom_field_id": 23301179390491,
  "custom_field_value": "txn_abc123"
}

相关 MCP