Z

Zendesk Claude AI 连接器

@koundinya/zd-mcp-server
0 Stars 20 次浏览 koundinya 更新于 2026-08-23

一种服务器实现，它为 Claude AI 提供了通过多种功能与 Zendesk 票务系统交互的能力，包括检索、搜索、创建和更新工单。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "zendesk": {
      "command": "zd-mcp-server",
      "env": {
        "ZENDESK_EMAIL": "your-email@company.com",
        "ZENDESK_SUBDOMAIN": "your-company",
        "ZENDESK_TOKEN": "your-zendesk-api-token"
      }
    }
  }
}

该服务需要配置环境变量：ZENDESK_EMAIL、ZENDESK_SUBDOMAIN、ZENDESK_TOKEN

服务介绍

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

    这将把 TypeScript 文件编译成 dist 目录中的 JavaScript 文件。

  2. 开发时，您可以使用：

    npm run dev

使用 Claude 桌面应用程序安装

  1. 更新 Claude 桌面配置文件 (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 桌面应用程序以使更改生效。

可用的 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 服务器
查看源码 项目主页