Zendesk MCP

Name: Zendesk MCP
Author: markusvankempen

本地服务

github.com商业与营销020 周前更新

代码仓库访问官网

关于 Zendesk MCP

Zendesk MCP 为使用 Zendesk 的 AI Agent 和支持团队提供 14 种工单工具，包含 TypeScript 和 Python 实现。创建工单时可将实际客户设为请求者，以便正确路由邮件回复。

主要功能

01创建、更新和搜索工单
02分配、关闭和重新打开工单
03读取和添加工单评论
04查询用户和工单指标
05提供 TypeScript 和 Python 服务端

适用场景

01创建并正确标注客户请求者的工单
02分类工单并分配给客服或团队
03查看对话、SLA 时间和近期工单
04回复客户或添加内部工单备注

MCP 相关

MCP 服务向客户端提供 14 种 Zendesk 工单操作，包括创建、搜索、分配、评论和指标查询。支持本地 stdio 和远程 SSE 部署方式。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "markusvankempen-zendesk": {
      "command": "npx",
      "args": [
        "-y",
        "@markusvankempen/zendesk-mcp-server"
      ],
      "env": {
        "ZENDESK_SUBDOMAIN": "<ZENDESK_SUBDOMAIN>",
        "ZENDESK_EMAIL": "<ZENDESK_EMAIL>",
        "ZENDESK_API_TOKEN": "<ZENDESK_API_TOKEN>"
      }
    }
  }
}

启动命令npx -y @markusvankempen/zendesk-mcp-server

需要配置的环境变量

ZENDESK_SUBDOMAINYour Zendesk subdomain (e.g. mycompany for mycompany.zendesk.com)

ZENDESK_EMAILZendesk service account email address used for API authentication

ZENDESK_API_TOKEN密钥Zendesk API token (Admin → Apps and integrations → APIs → Token access)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@markusvankempen/zendesk-mcp-server1.0.2stdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
tags	string	否
subject	string	是
priority	enum	否	urgent \| high \| normal \| low
description	string	是
requester_name	string	否
requester_email	string	是

详细介绍

Zendesk MCP

Zendesk Support 的 Model Context Protocol（MCP）服务 — 将 Cursor、VS Code、Claude Desktop、watsonx Orchestrate 和 IBM Code Engine 中的 AI Agent 连接到 14 个工单工具（创建、搜索、指派、关闭、评论、指标）。安装：npx @markusvankempen/zendesk-mcp-server · pip install zendesk-mcp-server-py

zendesk · mcp · cursor · github-copilot · claude · ai-agents · customer-support · helpdesk · watsonx-orchestrate · typescript · python

通过 Model Context Protocol（MCP）为 AI Agent 提供通用的 Zendesk 集成。提供 TypeScript 和 Python 服务实现，以及适用于 IDE、IBM Code Engine 和 watsonx Orchestrate 的部署示例。

作者： Markus van Kempen
电子邮件： [email protected] · [email protected]
网站： markusvankempen.github.io
再小的错误也值得修复，再奇怪的语法也难不倒我们。

概述

Zendesk MCP 将 14 项支持工单操作作为 MCP 工具公开，让 Cursor、VS Code、Claude Desktop、watsonx Orchestrate 和 IBM Code Engine 中的 AI Agent 能够通过自然语言管理工单。

核心设计解决了请求者归属问题：创建工单时，请求者设为真实客户（而非 API 服务账户），确保 Zendesk 邮件回复能够正确发送。

graph TB
    subgraph clients [MCP Clients]
        Cursor[Cursor / VS Code]
        WxO[watsonx Orchestrate]
        CE[Code Engine / Remote]
    end

    subgraph servers [Servers]
        TS["TypeScript npm"]
        PY["Python FastMCP"]
    end

    ZD[Zendesk REST API v2]

    Cursor -->|stdio| TS
    WxO -->|stdio| PY
    CE -->|SSE| TS
    CE -->|SSE| PY
    TS --> ZD
    PY --> ZD

📖 文档中心 → docs/ · MCP 配置示例 → examples/mcp/ · 公开与私有仓库 → docs/PUBLIC_REPO.md · 贡献指南 → CONTRIBUTING.md · 安全 → docs/SECURITY.md

文档索引

本仓库中所有 Markdown 文件的完整索引。

根目录

文档	说明
README.md	项目概述、快速入门、部署摘要（本文件）
task.md	原始项目需求和参考说明

核心文档（`docs/`）

文档	说明
docs/README.md	文档中心 — 从这里开始
docs/ide/README.md	IDE 设置 — 本地 `npx` + 远程 Code Engine
docs/reference/ARCHITECTURE.md	系统设计、stdio/SSE/WxO 拓扑、身份验证流程
docs/reference/TOOLS.md	全部 14 个 MCP 工具 — 参数、返回值、示例
docs/guides/SCENARIOS.md	请求者模式、角色 Agent、17 个场景、E2E
docs/reference/FILES.md	完整文件清单
docs/deployments/README.md	部署文档索引

软件包 README（`packages/`）

文档	说明
packages/zendesk-mcp-server/README.md	TypeScript/npm 服务 — 安装、环境变量、SSE 模式、从源码构建
packages/zendesk-mcp-server-py/README.md	Python FastMCP 服务 — 设置、SSE 模式、WxO 导入说明

部署 README（`deployments/`）

文档	说明
deployments/vscode-extension/README.md	VS Code / Cursor / Open VSX 扩展 — 命令、设置、发布
deployments/code-engine/README.md	IBM Code Engine — Dockerfile、SSE 端点、远程 MCP 客户端配置
deployments/code-engine/DEPLOYMENT-GUIDE.md	Code Engine — 实时部署、测试/管理界面、本地与已部署的 `mcp.json`
deployments/watsonx-orchestrate/README.md	WxO 工具包部署、4 个角色 Agent、场景运行器、CLI 测试命令

按主题快速导航

主题	从这里开始
IDE 设置（本地 `npx`）	docs/ide/README-local.md
IDE 设置（Code Engine）	docs/ide/README-remote.md
架构与传输方式	docs/reference/ARCHITECTURE.md
工具参数与示例	docs/reference/TOOLS.md
WxO Agent 与测试场景	docs/guides/SCENARIOS.md
文件说明一览	docs/reference/FILES.md
npm / TypeScript 服务	packages/zendesk-mcp-server/README.md
Python / FastMCP 服务	packages/zendesk-mcp-server-py/README.md
IDE 扩展设置	deployments/vscode-extension/README.md
Code Engine 部署	deployments/code-engine/README.md
WxO 部署与 E2E	deployments/watsonx-orchestrate/README.md

仓库布局

zendesk-mcp/
├── docs/                         # Documentation hub
│   ├── README.md                 # Start here
│   ├── ide/                      # IDE setup guides (local + remote)
│   ├── reference/                # ARCHITECTURE, TOOLS, FILES
│   ├── guides/                   # SCENARIOS
│   └── deployments/              # Deployment index
├── packages/
│   ├── zendesk-mcp-server/       # TypeScript MCP server (npm)
│   └── zendesk-mcp-server-py/    # Python MCP server (FastMCP)
├── deployments/
│   ├── vscode-extension/         # VS Code / Cursor / Open VSX extension
│   ├── code-engine/              # IBM Code Engine (SSE) + mcp-client JSON
│   └── watsonx-orchestrate/      # WxO toolkit + 4 role agents
└── .github/workflows/            # CI + npm/marketplace publish

快速开始（TypeScript / npm）

export ZENDESK_SUBDOMAIN=your-subdomain
export [email protected]
export ZENDESK_API_TOKEN=your_token

npx @markusvankempen/zendesk-mcp-server

一键安装： Cursor · VS Code — 然后在 MCP 设置中配置你的 ZENDESK_* 凭据。

复制粘贴设置： Bob · Antigravity（暂未提供安装深链 — 请使用 examples/mcp/）：

添加到你的 IDE 配置中 — 从 examples/mcp/ 复制：

IDE	文件
Cursor	examples/mcp/cursor-local.json → `~/.cursor/mcp.json`
VS Code	examples/mcp/vscode-local.json → `User/mcp.json`
Bob	examples/mcp/bob-local.json
Antigravity	examples/mcp/antigravity-local.json
Claude Desktop	examples/mcp/claude-desktop-local.json

或者使用 VS Code 扩展 — 它会将你的 API 令牌存储在操作系统密钥链中，并自动写入 MCP 配置。请参阅 deployments/vscode-extension/README.md。

推送到 GitHub 前，请运行 npm run check:secrets — 参见 docs/SECURITY.md。

快速开始（Python）

pip install zendesk-mcp-server-py

export ZENDESK_SUBDOMAIN=your-subdomain
export [email protected]
export ZENDESK_API_TOKEN=your_token

zendesk-mcp-server-py

MCP 工具（14 个）

工具	描述
`create_ticket`	创建工单，并正确标注请求者
`get_ticket`	按 ID 获取工单
`update_ticket`	更新状态、优先级、标签或评论
`search_tickets`	Zendesk 搜索查询语法
`list_recent_tickets`	最近更新的工单
`list_all_tickets`	管理员范围内的工单列表
`list_tickets_for_requester`	获取指定请求者邮箱对应的工单
`get_ticket_comments`	查看工单对话
`add_ticket_comment`	添加公开回复或内部备注
`get_user_by_email`	查找 Zendesk 用户
`close_ticket`	将工单标记为已解决
`reopen_ticket`	重新打开已解决/已关闭的工单
`get_ticket_metrics`	SLA / 时间指标
`assign_ticket`	分配给群组或 Agent

→ 完整工具参考（含参数和示例）

部署

场景	目录	传输方式	文档
VS Code / Cursor / Open VSX	`deployments/vscode-extension/`	通过 `npx` 使用 stdio	README
IBM Code Engine	`deployments/code-engine/`	SSE	README
watsonx Orchestrate	`deployments/watsonx-orchestrate/`	stdio 子进程	README · 场景

watsonx Orchestrate — 角色 Agent

Agent	角色
`zendesk_end_user_agent`	自助服务 — 创建、列出和评论自己的工单
`zendesk_support_agent`	分析员 — 分类、调查、查看指标、分配工单
`zendesk_admin_agent`	管理员 — 队列概览、SLA、分配工单
`zendesk_mcp_agent`	通才 — 使用所有工具进行原型设计

cd deployments/watsonx-orchestrate
./deploy_and_test.sh                              # full deploy + E2E
RUN_LIVE=1 ./run_agent_scenarios.sh               # 17 role scenarios

请求者归属（关键设计）

sequenceDiagram
    autonumber
    actor User
    participant WxO as WxO Agent
    participant MCP as MCP Server
    participant ZD as Zendesk

    User->>WxO: "Create a ticket — account locked"
    Note over WxO: wxo_email_id available
    WxO->>MCP: create_ticket(requester_email=wxo_email_id)
    MCP->>ZD: Find/create user + create ticket
    ZD-->>MCP: ticket_id=42, requester=real customer
    MCP-->>WxO: JSON result
    WxO-->>User: "Ticket #42 created"

连接凭据（ZENDESK_*）用于验证 API。用户身份（wxo_email_id）由 Agent 映射到工具参数中 — MCP 服务不会直接获取 WxO 会话上下文。

→ 完整场景文档

开发

npm install
npm run build          # TypeScript server + VS Code extension
npm run build:server   # TypeScript server only
npm run build:extension

凭据

切勿提交 .env 文件或 API 令牌。

部署方式	密钥存储
IDE 扩展	VS Code `SecretStorage`（操作系统钥匙串）
Code Engine	`ibmcloud ce` 密钥 / 环境变量
WxO	`orchestrate connections set-credentials`
本地开发	`packages/zendesk-mcp-server-py/.env`

变量	用途
`ZENDESK_SUBDOMAIN`	租户前缀（`mycompany` → `mycompany.zendesk.com`）
`ZENDESK_EMAIL`	用于 API 身份验证的服务账户邮箱
`ZENDESK_API_TOKEN`	Zendesk API 令牌

参考实现

从 WxO-ToolBox/vsc/test_tools/zendesk_mcp_server 提取并进行通用化处理。血缘映射请参阅 docs/reference/FILES.md。

→ 所有文档 · task.md（原始需求）

主题和关键词

zendesk · zendesk-api · zendesk-mcp · zendesk-support · zendesk-tickets · mcp · mcp-server · model-context-protocol · cursor · claude · claude-desktop · github-copilot · vscode · vscode-extension · open-vsx · ai-agent · ai-agents · tool-calling · function-calling · llm-tools · customer-support · customer-service · helpdesk · help-desk · service-desk · support-tickets · ticketing · crm · watsonx · watsonx-orchestrate · ibm-cloud · ibm-code-engine · typescript · python · fastmcp · stdio · sse · npx · npm-package · automation

作者： Markus van Kempen
邮箱： [email protected] · [email protected]
网站： markusvankempen.github.io
再小的 Bug 也不放过，再奇怪的语法也难不倒我。

公开分发仓库 — 不包含服务端源代码。请通过 npx -y @markusvankempen/zendesk-mcp-server 或 pip install zendesk-mcp-server-py 安装。关于私有开发工作流，请参阅 docs/PUBLIC_REPO.md。

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

Zendesk MCP

关于 Zendesk MCP

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

Zendesk MCP

概述

文档索引

根目录

核心文档（docs/）

软件包 README（packages/）

部署 README（deployments/）

按主题快速导航

仓库布局

快速开始（TypeScript / npm）

快速开始（Python）

MCP 工具（14 个）

部署

watsonx Orchestrate — 角色 Agent

请求者归属（关键设计）

开发

凭据

参考实现

参与贡献

许可证

链接

作者的更多项目

主题和关键词

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？

核心文档（`docs/`）

软件包 README（`packages/`）

部署 README（`deployments/`）