Zendesk MCP Server

Zendesk MCP Server

site icon
2025.01.09 6
Python客户支持工单管理交流协作
Zendesk MCP Server 是一个专为 Zendesk 设计的模型上下文协议服务器,提供与 Zendesk 的全面集成。它能够帮助用户检索和管理 Zendesk 的工单和评论,提供专门的提示用于工单分析和响应草稿,并允许完全访问 Zendesk 帮助中心文章作为知识库。
View on GitHub

Overview

基本能力

产品定位

Zendesk MCP Server 旨在通过 MCP 协议提供对 Zendesk 服务的深度集成,优化客户支持流程,提高响应效率。

核心功能

  • 检索和管理 Zendesk 工单及评论
  • 提供工单分析和响应草稿的专用提示
  • 完全访问 Zendesk 帮助中心文章作为知识库

适用场景

  • 客户支持团队需要快速响应工单
  • 需要分析工单内容以提供更精准的解决方案
  • 需要参考帮助中心文章来回答客户问题

工具列表

  1. get_ticket: 通过工单 ID 检索 Zendesk 工单
  2. 输入参数: ticket_id (整数)
  3. get_ticket_comments: 通过工单 ID 检索所有评论
  4. 输入参数: ticket_id (整数)
  5. create_ticket_comment: 在现有工单上创建新评论
  6. 输入参数: ticket_id (整数), comment (字符串), public (布尔值, 可选)

常见问题解答

  • 如何设置 Zendesk 凭证? 在 .env 文件中设置 Zendesk 凭证,参考 .env.example 文件。
  • 如何配置 Claude 桌面版? 在配置文件中添加 mcpServers 部分,指定命令和参数。

使用教程

使用依赖

  1. 确保已安装 Python 和 uv 工具

安装教程

  1. 构建项目: bash uv venv && uv pip install -e . 或简写为: bash uv build
  2. .env 文件中设置 Zendesk 凭证
  3. 在 Claude 桌面版中配置 MCP 服务器: json { "mcpServers": { "zendesk": { "command": "uv", "args": [ "--directory", "/path/to/zendesk-mcp-server", "run", "zendesk" ] } } }

调试方式

  1. 确保服务已正确启动
  2. 使用提供的工具测试功能:
  3. 测试 get_ticket 工具是否能正确检索工单
  4. 测试 get_ticket_comments 工具是否能正确检索评论
  5. 测试 create_ticket_comment 工具是否能正确创建评论

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。