Zendesk MCP服务

一个为Zendesk提供支持票证和帮助中心(知识库)工具的模型上下文协议(MCP)服务器,用于Claude Code。

  • by dylan-armstrong-se
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 dylan-armstrong-se/zendesk-mcp-server

使用说明

Zendesk MCP服务器

A. 模型上下文协议(MCP) 用于Zendesk的服务器,同时公开 支持票 和 帮助中心(知识库) 作为Claude Code中的工具。

工具

工具 说明
zendesk_list_categories 列出所有帮助中心类别
zendesk_list_sections 列出类别中的部分
zendesk_list_articles 在某个部分或类别中列出文章(分页)
zendesk_get_article 按ID获取文章的完整内容
zendesk_search_articles 按关键字搜索帮助中心文章
zendesk_get_ticket 按ID获取支持票及其评论
zendesk_search_tickets 使用Zendesk搜索语法搜索门票
zendesk_update_article_draft 更新文章的标题/正文,并将其设置为草稿以供审阅

需求

安装

git clone https://github.com/dylan-armstrong-se/zendesk-mcp-server.git
cd zendesk-mcp-server
npm install

使用克劳德代码注册

claude mcp add \
  -s user \
  -e "ZENDESK_SUBDOMAIN=your-subdomain" \
  -e "ZENDESK_EMAIL=your-email@company.com" \
  -e "ZENDESK_TOKEN=your-api-token" \
  -e "PATH=/usr/local/bin:/usr/bin:/bin" \
  -- zendesk /usr/local/bin/node /path/to/zendesk-mcp-server/index.js

替换 /path/to/zendesk-mcp-server/ 使用克隆仓库的绝对路径。

环境变量

变量 描述
ZENDESK_SUBDOMAIN 您的Zendesk子域名(例如。 acme 为了 acme.zendesk.com)
ZENDESK_EMAIL API用户的电子邮件地址
ZENDESK_TOKEN Zendesk API代币
NODE_EXTRA_CA_CERTS (可选) 自定义CA证书的路径(例如,用于公司代理)

SSL/企业代理

如果您的网络使用TLS拦截代理(例如Zscaler),请添加您的CA证书:

claude mcp add \
  -s user \
  -e "ZENDESK_SUBDOMAIN=your-subdomain" \
  -e "ZENDESK_EMAIL=your-email@company.com" \
  -e "ZENDESK_TOKEN=your-api-token" \
  -e "PATH=/usr/local/bin:/usr/bin:/bin" \
  -e "NODE_EXTRA_CA_CERTS=/path/to/your-ca.pem" \
  -- zendesk /usr/local/bin/node /path/to/zendesk-mcp-server/index.js

使用示例

注册后,在Claude Code中自然使用这些工具:

  • “列出所有帮助中心类别”
  • “在Zendesk知识库中搜索有关OCPP配置的文章”
  • “获取包含所有评论的Zendesk票证12345”
  • “搜索状态为:打开优先级:高的票”
  • “用修订后的内容更新文章12345,并将其设置为草稿”