Zendesk MCP

io.github.markusvankempen由 GitHub 账号 markusvankempen 发布v1.0.2更新于 Oct 25, 2026

Zendesk MCP: 14 tools for AI agents — create, search, assign, comment, and close support tickets.

已验证STDIO仅桌面效率与工作流商业与电商

概览

AI 生成的概览

一个本地 MCP 服务器，将 AI 助手接入 Zendesk Support，提供 14 个工具来创建、搜索、更新、评论、分配和关闭工单。

可以做什么
创建和更新工单，支持请求人归属，使回复送达真实客户而非 API 服务账号，并可设置状态、优先级、标签和评论。按查询语句、最近更新、请求人邮箱或管理员全量列表搜索和列出工单。读取工单对话，添加公开回复或内部备注。按邮箱查找用户。关闭、重新打开工单，并分配给组或坐席。获取 SLA 和时效指标。
适用场景
适合让助手处理 Zendesk 客服工作：根据对话起草并提交工单、分诊和分配队列、以内部备注回复，或查看 SLA 指标，而无需切换到 Zendesk 网页界面。
运行要求
通过 stdio 在本地运行，通常用 npx 安装 npm 包或用 pip 安装 Python 包。需要 Zendesk 子域名、服务账号邮箱和 API 令牌，分别通过 ZENDESK_SUBDOMAIN、ZENDESK_EMAIL 和 ZENDESK_API_TOKEN 环境变量提供。需要访问 Zendesk REST API v2 的网络连接。
安装前请注意
需要 Zendesk API 令牌和服务账号凭据，请勿写入提交的文件，优先使用扩展的 OS 钥匙串存储。这些工具会写入真实客服系统：创建和更新工单、发布公开回复或内部备注、关闭、重新打开和重新分配工单，客户可能看到。工单数据会发送到 Zendesk API 以及所连接的 AI 客户端。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Zendesk MCP，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Zendesk MCP

[npm version] [npm downloads] [PyPI] [VS Code Extension] [MCP Registry] [CI] [License]

[Zendesk MCP]

[Add MCP server to Cursor]   [Add MCP server to VS Code]   [Add MCP server to IBM Bob]   [Add MCP server to Antigravity]

Model Context Protocol (MCP) server for Zendesk Support — connect AI agents in Cursor, VS Code, Claude Desktop, watsonx Orchestrate, and IBM Code Engine to 14 ticket tools (create, search, assign, close, comments, metrics). Install: 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

Generic Zendesk integration for AI agents via the Model Context Protocol (MCP). Ships TypeScript and Python server implementations plus deployment examples for IDEs, IBM Code Engine, and watsonx Orchestrate.

Author: Markus van Kempen
Email: [email protected] · [email protected]
Website: markusvankempen.github.io
No bug too small, no syntax too weird.

Overview

Zendesk MCP exposes 14 support-ticket operations as MCP tools so AI agents in Cursor, VS Code, Claude Desktop, watsonx Orchestrate, and IBM Code Engine can manage tickets through natural language.

The core design solves requester attribution: tickets are created with the real customer as requester (not the API service account), so Zendesk email replies route correctly.

mermaid
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

📖 Documentation hub → docs/ · MCP config examples → examples/mcp/ · Public vs private repo → docs/PUBLIC_REPO.md · Contributing → CONTRIBUTING.md · Security → docs/SECURITY.md

Documentation reference

Complete index of every markdown file in this repository.

Root

DocumentDescription
README.mdProject overview, quick starts, deployments summary (this file)
task.mdOriginal project requirements and reference notes

Core documentation (docs/)

DocumentDescription
docs/README.mdDocumentation hub — start here
docs/ide/README.mdIDE setup — local npx + remote Code Engine
docs/reference/ARCHITECTURE.mdSystem design, stdio/SSE/WxO topologies, auth flow
docs/reference/TOOLS.mdAll 14 MCP tools — parameters, returns, examples
docs/guides/SCENARIOS.mdRequester modes, role agents, 17 scenarios, E2E
docs/reference/FILES.mdComplete file inventory
docs/deployments/README.mdDeployment docs index

Package READMEs (packages/)

DocumentDescription
packages/zendesk-mcp-server/README.mdTypeScript/npm server — install, env vars, SSE mode, build from source
packages/zendesk-mcp-server-py/README.mdPython FastMCP server — setup, SSE mode, WxO import pointer

Deployment READMEs (deployments/)

DocumentDescription
deployments/vscode-extension/README.mdVS Code / Cursor / Open VSX extension — commands, settings, publish
deployments/code-engine/README.mdIBM Code Engine — Dockerfiles, SSE endpoints, remote MCP client config
deployments/code-engine/DEPLOYMENT-GUIDE.mdCode Engine — live deploy, test/admin UI, local vs deployed mcp.json
deployments/watsonx-orchestrate/README.mdWxO toolkit deploy, 4 role agents, scenario runner, CLI test commands

Quick navigation by topic

TopicStart here
IDE setup (local npx)docs/ide/README-local.md
IDE setup (Code Engine)docs/ide/README-remote.md
Architecture & transportsdocs/reference/ARCHITECTURE.md
Tool parameters & examplesdocs/reference/TOOLS.md
WxO agents & test scenariosdocs/guides/SCENARIOS.md
Every file explaineddocs/reference/FILES.md
npm / TypeScript serverpackages/zendesk-mcp-server/README.md
Python / FastMCP serverpackages/zendesk-mcp-server-py/README.md
IDE extension setupdeployments/vscode-extension/README.md
Code Engine deploydeployments/code-engine/README.md
WxO deploy & E2Edeployments/watsonx-orchestrate/README.md

Repository layout

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

Quick start (TypeScript / npm)

bash
export ZENDESK_SUBDOMAIN=your-subdomainexport [email protected]export ZENDESK_API_TOKEN=your_token
npx @markusvankempen/zendesk-mcp-server

One-click install: Cursor · VS Code — then set your ZENDESK_* credentials in MCP settings.

Copy-paste setup: Bob · Antigravity (no install deeplink yet — use examples/mcp/):

Add to your IDE config — copy from examples/mcp/:

IDEFile
Cursorexamples/mcp/cursor-local.json → ~/.cursor/mcp.json
VS Codeexamples/mcp/vscode-local.json → User/mcp.json
Bobexamples/mcp/bob-local.json
Antigravityexamples/mcp/antigravity-local.json
Claude Desktopexamples/mcp/claude-desktop-local.json

Or use the VS Code extension — it stores your API token in OS keychain and writes MCP config automatically. See deployments/vscode-extension/README.md.

Before pushing to GitHub, run npm run check:secrets — see docs/SECURITY.md.

Quick start (Python)

bash
pip install zendesk-mcp-server-py
export ZENDESK_SUBDOMAIN=your-subdomainexport [email protected]export ZENDESK_API_TOKEN=your_token
zendesk-mcp-server-py

MCP tools (14)

ToolDescription
create_ticketCreate ticket with correct requester attribution
get_ticketGet ticket by ID
update_ticketUpdate status, priority, tags, or comment
search_ticketsZendesk search query syntax
list_recent_ticketsRecently updated tickets
list_all_ticketsAdmin-wide ticket listing
list_tickets_for_requesterTickets for a requester email
get_ticket_commentsRead ticket conversation
add_ticket_commentAdd public reply or internal note
get_user_by_emailLook up Zendesk user
close_ticketMark ticket solved
reopen_ticketReopen solved/closed ticket
get_ticket_metricsSLA / timing metrics
assign_ticketAssign to group or agent

→ Full tool reference with parameters & examples

Deployments

ScenarioDirectoryTransportDocs
VS Code / Cursor / Open VSXdeployments/vscode-extension/stdio via npxREADME
IBM Code Enginedeployments/code-engine/SSEREADME
watsonx Orchestratedeployments/watsonx-orchestrate/stdio subprocessREADME · Scenarios

watsonx Orchestrate — role agents

AgentRole
zendesk_end_user_agentSelf-service — create/list/comment on own tickets
zendesk_support_agentAnalyst — triage, investigate, metrics, assign
zendesk_admin_agentAdmin — queue overview, SLA, assignment
zendesk_mcp_agentGeneralist — all tools, prototyping
bash
cd deployments/watsonx-orchestrate./deploy_and_test.sh                              # full deploy + E2ERUN_LIVE=1 ./run_agent_scenarios.sh               # 17 role scenarios

Requester attribution (key design)

mermaid
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"

Connection credentials (ZENDESK_*) authenticate the API. User identity (wxo_email_id) is mapped by the agent into tool arguments — the MCP server never sees WxO session context directly.

→ Full scenarios documentation

Development

bash
npm installnpm run build          # TypeScript server + VS Code extensionnpm run build:server   # TypeScript server onlynpm run build:extension

Credentials

Never commit .env files or API tokens.

DeploymentSecret storage
IDE extensionVS Code SecretStorage (OS keychain)
Code Engineibmcloud ce secrets / env vars
WxOorchestrate connections set-credentials
Local devpackages/zendesk-mcp-server-py/.env
VariablePurpose
ZENDESK_SUBDOMAINTenant prefix (mycompany → mycompany.zendesk.com)
ZENDESK_EMAILService account email for API auth
ZENDESK_API_TOKENZendesk API token

Reference implementation

Extracted and generalized from WxO-ToolBox/vsc/test_tools/zendesk_mcp_server. See docs/reference/FILES.md for lineage mapping.

→ All documentation · task.md (original requirements)

Contributing

See CONTRIBUTING.md and CODE_OF_CONDUCT.md.

License

Apache License 2.0

Links

More from the author

Part of the open-source toolkit at markusvankempen.github.io — alongside WxO Agent MCP, Maximo MCP Server, Code Engine MCP Server, and WxO Builder MCP Server.

Topics & keywords

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

Author: Markus van Kempen
Email: [email protected] · [email protected]
Website: markusvankempen.github.io
No bug too small, no syntax too weird.

Public distribution repo — server source is not included. Install via npx -y @markusvankempen/zendesk-mcp-server or pip install zendesk-mcp-server-py. See docs/PUBLIC_REPO.md for the private dev workflow.

来源：README.md，提交 02aaebe

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分