zd - Zendesk MCP 服务器

使用说明（简要、易操作）

• 项目简介

  • zd 是一个包含 MCP 服务器实现的命令行应用，内置 Zendesk 的资源/工具/模板操作，通过 MCP 协议向 AI 客户端提供“列表票据、查看票据、创建/更新/删除票据、搜索票据”等工具。
  • 服务器通过标准的 MCP 传输（当前在代码中为标准输入/输出的 stdio 传输）与客户端通信，返回 JSON-RPC 风格的响应和错误信息，并支持通过演示模式使用虚拟数据。

• 主要功能点

  • MCP 服务器核心：暴露 Zendesk 相关操作的工具集合，客户端可按工具名称调用并接收结构化数据。
  • 工具注册与执行：实现了 zendesk_list_tickets、zendesk_show_ticket、zendesk_create_ticket、zendesk_update_ticket、zendesk_delete_ticket 等工具，以及 zendesk_search_tickets 的查询工具。
  • 数据丰富性：支持在返回票据时携带相关用户信息、以及对结果进行字段投影和输出格式化。
  • 演示模式（demo）：在无认证场景下也可演示，生成虚拟数据以演示 MCP 接入流程。
  • 与插件/编辑器的集成：提供命令行启动、以及 Claude/Cursor/Windsurf 等客户端的配置示例。

• 安装步骤

  • 克隆仓库后在本地编译 zd，生成可执行文件 zd。
  • 直接运行命令：zd mcp serve，启动 MCP 服务器，服务将通过标准输入输出与 MCP 客户端通信。

• 服务器配置（MCP 客户端配置示例，服务器端无需客户端额外修改）

  • MCP 客户端需要知道服务器的启动命令及参数，以便建立连接。典型配置如下（请以客户端的配置格式为准，以下为参考描述）：
  • 服务器名称: zendesk
  • 启动命令: zd
  • 参数: ["mcp","serve"]
  • 说明: 使用 zd 执行 mcp serve 将启动 MCP 服务器，客户端将通过该通道进行工具调用与数据交互。

• 基本使用方法

  • 启动后，AI 客户端通过 MCP 协议向 zd 服务器请求工具调用（如 zendesk_list_tickets、zendesk_show_ticket 等），服务器返回工具结果的 JSON 内容。
  • 客户端可通过工具输出的 JSON 数据进行进一步处理或直接展示给用户。
  • 如需在本地体验演示数据，可使用演示模式（demo），无需 Zendesk 认证即可体验 MCP 流程。