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 服务器