zendesk-mcp-server-kon

🚀 Zendesk MCP 服务器 KON

这是一个基于 reminia/zendesk-mcp-server 的分支项目，增加了对额外功能的支持和改进，是 Zendesk 的模型上下文协议服务器，可提供与 Zendesk 的全面集成。

](https://opensource.org/licenses/Apache-2.0)

🚀 快速开始

此服务器提供的集成功能包括：

• 工单和评论的检索和管理工具
• 社区文章、评论和主题的管理工具
• 工单分析和回复草拟的专业提示
• 对 Zendesk 帮助中心文章的知识库完整访问

📦 安装指南

1. 安装包

uv venv && uv pip install -e .

2. 在 Claude 桌面配置

{
  "mcpServers": {
    "zendesk": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/zendesk-mcp-server-kon",
        "run",
        "zendesk"
      ],
      "env": {
        "ZENDESK_SUBDOMAIN": "your-zendesk-subdomain",
        "ZENDESK_EMAIL": "your-zendesk-email",
        "ZENDESK_API_KEY": "your-zendesk-api-key"
      }
    }
  }
}

替换环境变量说明

• ZENDESK_SUBDOMAIN：您的 Zendesk 子域名（例如，如果您的 Zendesk URL 是 company.zendesk.com，则使用 company）
• ZENDESK_EMAIL：您的 Zendesk 管理员电子邮件地址
• ZENDESK_API_KEY：您的 Zendesk API 令牌

📚 详细文档

资源

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

提示

analyze - ticket

分析一个 Zendesk 工单并提供详细的工单分析。

draft - ticket - response

为一个 Zendesk 工单草拟回复。

工具

工单管理

get_ticket

通过其 ID 检索 Zendesk 工单

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

get_ticket_comments

通过其 ID 获取 Zendesk 工单的所有评论

• 输入：
  • ticket_id (整数)：获取评论的工单 ID

create_ticket_comment

在现有的 Zendesk 工单上创建新评论

• 输入：
  • ticket_id (整数)：要评论的工单 ID
  • comment (字符串)：评论文本/内容
  • public (布尔值，可选)：评论是否公开（默认为 true）

社区管理

get_community_posts

通过筛选和排序检索社区帖子

• 输入：
  • filter_by (字符串，可选)：按状态过滤帖子（planned, not_planned, completed, answered, none）
  • sort_by (字符串，可选)：按排序方式对帖子进行排序

get_community_post

通过其 ID 检索社区文章

• 输入：
  • id (整数)：要检索的文章 ID

create_community_post

创建新的社区文章

• 输入：
  • title (字符串)：文章标题
  • content (字符串)：文章内容
  • author_id (整数)：作者的用户 ID
  • metadata (JSON 对象，可选)：文章元数据

update_community_post

更新社区文章

• 输入：
  • id (整数)：要更新的文章 ID
  • title (字符串)：新标题
  • content (字符串)：新内容
  • metadata (JSON 对象，可选)：新的元数据

delete_community_post

删除社区文章

• 输入：
  • id (整数)：要删除的文章 ID

评论管理

create_comment

创建评论

• 输入：
  • parent_id (整数)：父元素的 ID（文章或评论）
  • content (字符串)：评论内容
  • author_id (整数)：作者的用户 ID
  • metadata (JSON 对象，可选)：评论元数据

update_comment

更新评论

• 输入：
  • id (整数)：要更新的评论 ID
  • content (字符串)：新内容
  • metadata (JSON 对象，可选)：新的元数据

delete_comment

删除评论

• 输入：
  • id (整数)：要删除的评论 ID