Zendesk API MCP Server

基本能力

产品定位

Zendesk API MCP Server 是一个用于与 Zendesk API 交互的 MCP 服务器，提供全面的工具和资源来管理 Zendesk 的各种产品。

核心功能

• 完整的 Zendesk API 功能覆盖
• 管理工单、用户、组织等的工具
• 访问 Zendesk API 文档的资源
• 使用 Zendesk API 令牌进行安全认证

适用场景

• 客户支持系统集成
• 工单管理系统开发
• 用户和组织管理自动化
• 帮助中心内容管理

工具列表

Tickets

• list_tickets: 列出 Zendesk 中的工单
• get_ticket: 通过 ID 获取特定工单
• create_ticket: 创建新工单
• update_ticket: 更新现有工单
• delete_ticket: 删除工单

Users

• list_users: 列出 Zendesk 中的用户
• get_user: 通过 ID 获取特定用户
• create_user: 创建新用户
• update_user: 更新现有用户
• delete_user: 删除用户

Organizations

• list_organizations: 列出 Zendesk 中的组织
• get_organization: 通过 ID 获取特定组织
• create_organization: 创建新组织
• update_organization: 更新现有组织
• delete_organization: 删除组织

Groups

• list_groups: 列出 Zendesk 中的代理组
• get_group: 通过 ID 获取特定组
• create_group: 创建新代理组
• update_group: 更新现有组
• delete_group: 删除组

Macros

• list_macros: 列出 Zendesk 中的宏
• get_macro: 通过 ID 获取特定宏
• create_macro: 创建新宏
• update_macro: 更新现有宏
• delete_macro: 删除宏

Views

• list_views: 列出 Zendesk 中的视图
• get_view: 通过 ID 获取特定视图
• create_view: 创建新视图
• update_view: 更新现有视图
• delete_view: 删除视图

Triggers

• list_triggers: 列出 Zendesk 中的触发器
• get_trigger: 通过 ID 获取特定触发器
• create_trigger: 创建新触发器
• update_trigger: 更新现有触发器
• delete_trigger: 删除触发器

Automations

• list_automations: 列出 Zendesk 中的自动化
• get_automation: 通过 ID 获取特定自动化
• create_automation: 创建新自动化
• update_automation: 更新现有自动化
• delete_automation: 删除自动化

Search

• search: 在 Zendesk 数据中搜索

Help Center

• list_articles: 列出帮助中心文章
• get_article: 通过 ID 获取特定帮助中心文章
• create_article: 创建新帮助中心文章
• update_article: 更新现有帮助中心文章
• delete_article: 删除帮助中心文章

Talk

• get_talk_stats: 获取 Zendesk Talk 统计信息

Chat

• list_chats: 列出 Zendesk Chat 对话

常见问题解答

• 如何获取 Zendesk API 令牌？ 需要在 Zendesk 账户设置中生成 API 令牌。
• 如何配置 .env 文件？ 需要提供 Zendesk 子域名、邮箱和 API 令牌。

使用教程

使用依赖

• Node.js 14 或更高版本
• 具有 API 访问权限的 Zendesk 账户

安装教程

1. 克隆仓库
2. 安装依赖： npm install
3. 创建 .env 文件并填写 Zendesk 凭据： ZENDESK_SUBDOMAIN=your-subdomain [email protected] ZENDESK_API_TOKEN=your-api-token

调试方式

• 启动服务器： npm start
• 开发模式（自动重启）： npm run dev
• 使用 MCP Inspector 测试服务器： npm run inspect

许可证

该项目遵循 MIT 开源许可条款。