Zendesk MCP 集成设置指南

存储库设置

1. 克隆存储库：
   git clone https://your-repo-url/mcp-experiments.git cd mcp-experiments/zd-mcp-server
2. 安装依赖项：
   npm install
3. 在您的开发环境中配置环境变量：
   export ZENDESK_EMAIL="your-email@example.com" export ZENDESK_TOKEN="your-zendesk-api-token" export ZENDESK_SUBDOMAIN="your-zendesk-subdomain"

构建项目

1. 构建 TypeScript 项目：
   npm run build
   这会将dist目录中的 TypeScript 文件编译为 JavaScript。
2. 对于开发，您可以使用：
   npm run dev

使用 Claude 桌面应用程序安装

1. 更新 Claude Desktop 配置文件（ claude_desktop_config.json ）：
   { "tools": { "zendesk": { "command": "node", "env": { "ZENDESK_EMAIL": "internal@z3nmail.com", "ZENDESK_TOKEN": "your-zendesk-api-token", "ZENDESK_SUBDOMAIN": "your-zendesk-subdomain" }, "args": [ "/path/to/mcp-experiments/zd-mcp-server/dist/index.js" ] } } }
2. 用您的实际 Zendesk 凭据替换环境变量。
3. 更新路径以匹配构建的 index.js 文件的位置。
4. 重新启动 Claude Desktop 应用程序以使更改生效。

可用的 Zendesk 工具

MCP Zendesk 集成提供以下功能：

1. zendesk_get_ticket - 通过 ID 检索票证
2. zendesk_get_ticket_details - 获取票证详细信息（包括评论）
3. zendesk_search - 使用 Zendesk 查询语法搜索票证
4. zendesk_create_ticket - 创建新票据
5. zendesk_update_ticket - 更新工单属性
6. zendesk_add_private_note - 向工单添加内部注释
7. zendesk_add_public_note - 向票证添加公开评论

身份验证设置

1. 在您的 Zendesk 管理中心生成 API 令牌：
   • 转到管理中心 > 应用和集成 > API > Zendesk API
   • 添加 API 令牌并复制
2. 在您的 MCP 配置中使用您的电子邮件地址和 API 令牌

故障排除

• 如果遇到授权错误，请验证您的 API 令牌是否有效
• 确保您的 Zendesk 子域名正确
• 检查环境变量是否设置正确
• 修改后重启 MCP 服务器