🚀 Zendesk MCP 服务器

Zendesk MCP 服务器是一个专门为 Zendesk 设计的 Model Context Protocol 服务器，它能与 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"
          ]
      }
  }
}

资源访问

• 访问 zendesk://knowledge-base，可获取整个帮助中心文章的访问权限。

✨ 主要特性

• 提供获取和管理 Zendesk 工单及评论的工具，方便用户对工单进行操作。
• 具备分析工单并起草回复的专业提示，帮助用户更高效地处理工单。
• 支持全面访问 Zendesk 帮助中心文章，将其作为知识库使用。

💻 使用示例

基础用法

分析工单

使用 analyze-ticket 提示分析一个 Zendesk 工单，它会提供详细的工单分析。

起草回复

使用 draft-ticket-respons 提示起草对 Zendesk 工单的回复。

高级用法

获取工单

使用 get_ticket 工具通过工单 ID 获取一个 Zendesk 工单：

# 假设存在一个函数用于调用 get_ticket 工具
def get_ticket(ticket_id):
    # 这里是调用工具的代码逻辑
    pass

ticket_id = 123
get_ticket(ticket_id)

获取工单评论

使用 get_ticket_comments 工具通过工单 ID 获取 Zendesk 工单的所有评论：

# 假设存在一个函数用于调用 get_ticket_comments 工具
def get_ticket_comments(ticket_id):
    # 这里是调用工具的代码逻辑
    pass

ticket_id = 123
get_ticket_comments(ticket_id)

创建工单评论

使用 create_ticket_comment 工具在现有的 Zendesk 工单上创建新评论：

# 假设存在一个函数用于调用 create_ticket_comment 工具
def create_ticket_comment(ticket_id, comment, public=True):
    # 这里是调用工具的代码逻辑
    pass

ticket_id = 123
comment = "这是一条新评论"
create_ticket_comment(ticket_id, comment)

🔧 技术细节

此服务器基于 Model Context Protocol 构建，与 Zendesk 进行全面集成。通过特定的命令和配置，实现了对 Zendesk 工单、评论以及帮助中心文章的管理和访问。在设置过程中，使用 uv 命令进行构建和运行，同时需要在 .env 文件中设置 Zendesk 凭证，以确保服务器能够正常与 Zendesk 进行交互。在 Claude 桌面的配置中，通过 mcpServers 字段指定了服务器的命令和参数，使得 Claude 能够与服务器进行通信。

📄 许可证

文档中未提及相关许可证信息。