使用说明
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 |
更新文章的标题/正文,并将其设置为草稿以供审阅 |
需求
- Node.js 18+
- 具有API访问权限的Zendesk帐户
- Zendesk API代币(如何创建一个)
安装
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,并将其设置为草稿”