Zendesk MCP 服务器

A 类 示范背景协议 (MCP)服务器 把Zendesk放进你的人工智能助手,因为 谈话的两边。 。 。 .

对于特工:在帮助中心找到答案;草稿、更新和 翻译文章同时保持语言同步;并处理支持 票到尾,包括评论,分解和图像附件.

给顾客: 帮助中心的"提交请求"表,用平话写出 语言:选择请求,回答问题,跟随答复,关闭. 见 最终用户模式。 。 。 .

给您的 Zendesk 管理员: 教给助手如何  团队工作,与 内部语气、词汇、程序和现成工作流程,来自专门 后台,没有调动。 见 背景和定制。 。 。 .

这一切都以平庸的语言发生,不切换应用.

它大概是怎样的 微软 365 副驾驶的 Zendesk 代理 是的,减去一个供应商的领带:它会掉入任何MCP客户端(Claude桌面, Claude Code, Cursor, VS Code, and the rest. 克洛德密码, Cursor, VS Code, and the rest. 克洛德密码, Claude Code, Cursor, VS Code, and the rest. 克洛德密码, Claude Code, Cursor, Cursor, VS Code, and the others. 克洛德密码,克洛德密码,克洛德密码,克洛德密码,克洛德密码,克洛德密码,克洛德密码,克洛德密码,其他密码。 它总是与每个用户的 拥有 Zendesk 权限, 从未共享管理密钥 .

你的助手能做点什么

用自然语言问;助理处理上下文和意图, 然后代表您调用正确的工具.

• 在帮助中心找到答案。 "我该怎么申请软件许可证?" "什么是" 暂停政策?"表面 正确的文章, 匹配的意义 而不是通过关键词.
• 创建、查看和刷新票而不离开对话:打开 a 票,检查其状况,增加公开答复或内部说明,更改 优先权或受让人,标记已解决.
• 总结举报票或速决. 助理拉动 细节和完整的评论线条,并给你一个句子中的要旨.
• 阅读一张票所附的截图和相片. 错误对话框, UI 抓取和产品相片交给你助手自己的模型作为 图像,这样它就可以描述它们,或者在它们显示的东西上采取行动.
• 用简单的语言搜索和分辨你的队列: "给我看看我的公开门票,关于 这周的账单。"
• 起草并维持以知识为基础的条款。 你可以写出新的,或者修改 一个大块块块一次, 所以整个 HTML 机体从来不用 绕道穿出模型.
• 跟着你的团队的游戏本。 您撰写的指令、 提示和技能 管理员可以接触到每个用户的助手,无论他们使用的MCP客户端.
• 作为客户而不是代理人提交并遵从请求. 选择 那种要求 供应商报价,只回答 表格提出的问题, 然后追踪: 被回答什么,你回答什么, 以及是否完成了.

为什么这个服务器

大部分 Zendesk 集成程序运行在一个共享的管理员 API 密钥上, 该密钥可以让每个用户手动 完全进入每张票, 和螺栓在固定的一套工具上。 这个是建的 不一样.

• Per用户认证,仅OAuth. 两种运输方式均使用OAuth 2.1 PKCE: 用户用自己的Zendesk证书签名,所以助理看到并且 碰碰他允许的 相同的范围 直接签入Zendesk。 静态 API 符号是故意的 支助(为什么) (中文(简体) ).
• 两个观众 一个服务器 因为认证是每个用户而不是一个共享的管理员 键,同样的安装服务于您的代理人和客户——最终用户 表面是您打开的命名空间, 使用 API 路径 Zendesk 保留 为请求者。 大部分Zendesk MCP服务器都是由构建而来的代理.
• 以科为主的文章编辑. 将 " 帮助中心 " 的大文章改为: 一次重写一节( 按 h1编号 :h2编号 :h3 页:1 通过助手将完整的HTML正文打乱. 在目标编辑上 切入符数乘以 10 到 100.
• 原生多式附着物. 车票图像作为本地的 MCP 图像返回 内容,所以客户端自己的模型(Claude,GPT,双子座,以谁为准)可以看到 直接像素 。 没有服务器侧视图模型,没有额外的 API 密钥,什么都没有 把你绑在一个供应商。 非图像附件作为文本参考回来, 和两个图像盖都是可配置的.
• 一个工具表面,你可以盖住。 曝光每个操作作为自己的工具,将其分组 成为命名空间的代名词,或者将所有的东西都崩溃成一个单一的统一工具。 你个 也可以通过命名空间过滤或降为只读操作,因此每个上下文 仅装入它需要的表面(参见 工具表面) (中文(简体) ).
• 你的练习船与服务器。 大部分团队手分配一个或一个技能 每个AI客户端的规则文件。 在此管理作者指示、提示和技能 一次,在服务器内, 在后台 保留给Zendesk管理员 每个MCP客户端都会收到它们. 技能回到对客户的提示 别支持他们.
• 两个布置形状, 相同的认证故事,在一个瘦堆上。 在你的笔记本电脑上运行 作为 stdio MCP 服务器,或作为私人远程 MCP 服务器部署到 HTTP,每个客户端携带自己的用户代号;下方,官方MCP 类型脚本 SDK 加 zod,在 Zendesk 支持和帮助中心发言 (指南)APIs.

查看其它地点时:

• 您需要 Zendesk 产品 外部支持和指南( Talk, Explore analytics, 卖. 那些终点没有覆盖.
• 您需要一个共享服务账户, 或是静态的 API- token 认证 。 这个 服务器既不支持,也不通过设计支持(见下文).

此服务器所做的 没有 对

没有 API- token 认证 。 服务器会讲OAuth 2.1 PKCE和 无其他:无 ZENDESK_EMAIL + 键 ZENDESK_API_TOKEN (基本认证)模式,在任意 运输。 这是蓄意的,原因有两个.

1. API 令牌不够安全 . 一个Zendesk API 符号是 包含用户全部权利的长期、静态、共享的秘密 谁发的? 没有每个用户的范围界定,没有短期限,也没有每个用户 同意或撤销。 OAuth 2.1 PCE 向用户发放可撤回的代币 换句话说.
2. API 符号不缩放. 单一的静态证书不能属性 对单个用户的动作,并且不能被颗粒地取消. 还有 使多用户远程部署不安全:在HTTP上,它会暴露 向每个打电话者发放用户的权利.

如果您特别需要 API- token 或服务账户模式( 无标题 CI 带有 一个共享账户,比如,使用另一个支持 Zendesk MCP 服务器之一 这个 少数列于下文 激励和相关项目。 。 。 .

快速启动: 本地( stdio)

默认形状: 一个开发者, 一个 Zendesk 账户, OAuth 2.1 PKCE in the 浏览器. 惠璶 节点.js 22 (单位:千美元) 禅桌 (支助或 套间).

安装

# Run without installing
npx -y @fruggr/zendesk-mcp-server <your-subdomain>

# Or install globally
npm install -g @fruggr/zendesk-mcp-server
zendesk-mcp-server <your-subdomain>

需要签名的 Zendesk OAuth 客户端, 所以先注册一个( 下一节) .

Zendesk OAuth 设置

1. 转到 行政中心 应用程序和集成 API 用户
2. 创建一个 公开 客户端 :
   • 标识符数字 : <your-subdomain>_zendesk (或设置) ZENDESK_OAUTH_CLIENT_ID(中文(简体) )
   • 重定向 URL数字 : http://localhost:27439/callback (修改端口以匹配) OAUTH_CALLBACK_PORT 编号 : --callback-port 如果您超过它; Zendesk 接受多个重定向 URL, 每行一个)

如果客户限制 允许的范围这需要 read 加上 write 除非服务器与 --read-only,它问 用于 read 仅限范围.

第一种工具呼叫服务器启动登录流程:打开浏览器 窗口并返回工具消息中的授权 URL。 呼叫没有阻断 等待登录,所以在浏览器中认证,然后重试请求. 表示符被坚持到一个只有所有者的文件,并在重启时重复使用,所以您 每次您的 MCP 客户端重播服务器时, 不要再次认证( path ) 并覆盖 : OAUTH_TOKEN_FILE) (中文(简体) ). 多个实例可以并排运行——一个读写符和一个 --read-only 一个,说,没有交易证书.

MCP 客户端接线

{
  "mcpServers": {
    "zendesk": {
      "command": "npx",
      "args": ["-y", "@fruggr/zendesk-mcp-server", "<your-subdomain>", "--mode", "single"]
    }
  }
}

claude mcp add zendesk -- npx -y @fruggr/zendesk-mcp-server <your-subdomain> --mode single

{
  "servers": {
    "zendesk": {
      "command": "npx",
      "args": ["-y", "@fruggr/zendesk-mcp-server", "<your-subdomain>", "--mode", "single"]
    }
  }
}

有什么不起作用的吗? 见 解决问题。 。 。 .

快速启动: 远程 (HTTP)

实验. HTTP运输船,但尚未使用 最终对一个真正的Zendesk租户 从每个MCP客户端。 本地标准是 支持的路径.

您也可以部署一个私人远程 MCP 服务器 一个 Zendesk账户. 它是自己的OAuth授权服务器:claude.ai等网络客户端和 ChatGPT 通过 URL 添加并自行注册, 每个用户在 Zendesk 中签名 通过它,没有共享管理员密钥或每个客户的Zendesk设置。 每个 也为它释放出一个硬化的,无边的容器图像 (单位:千美元)ghcr.io/fruggr/zendesk-mcp-server,签名和证明。 指南全文 图像, 将 URL 重定向到您的 Zendesk OAuth 客户端 秘密和捐赠店主, --public-url 在信任的反向代理服务器后 客户端、MCP客户端的接线、CORS以及操作员的工作: 文件/http-unposition.md。 。 。 .

工具表面

工具归为命名空间: 车票, (中文(简体) ), 帮助中心, (中文(简体) ), 用户( U) 组织, (中文(简体) ), 搜索, (中文(简体) ), 连接器首选项 - 这个服务器是自己的 每个用户的设置,如 SLA 警戒阈值,从未写入 Zendesk ——和 请求 - 最终用户表面,可选入,并覆盖在 最终用户模式。服务器注册 它们分为三种模式之一,这样您就可以用上下文预算交换颗粒性:

• all:每个操作作为自己的工具,供有良好工具选择的客户使用;
• namespace (默认):每个命名空间一个代理工具,一个平衡的中间点;
• single: 单人 zendesk 工具,用于工具插槽有限的模型 连接器的首选保留 connector_preferences 旁边的代理).

亲切点 { "operation": "<tool_name>", "params": { … } } 并验证 params 通过最初的策略. --namespace, (中文(简体) ), --tool 财务报告和审定财务报表 --read-only 过滤工具 在此之前 代名词被构建,所以每个代名词只描述 操作,生存.

有一条路可以选择存货--namespace 编号 : --tool, (中文(简体) ), --mode 包裹,和 --read-only 缩小它。 当组合不明显, 别猜了.. --print-tools 拥有服务器的答案 它会曝光,与 不需要证书.

每个工具都有其描述和 read编号 :write 模式 : 文件/mcp工具-参考.md旗帜和 工作实例: 文件/配置。 。 。 .

最终用户模式

上面的观众都是禅桌 代理人。本节涉及 另一个:你的 客户。 。 。 .

在网络上,一个顾客通过帮助中心的"投降a 请求”表格——它们选择一种请求,填入类型要求的字段 为,附上一个文件,然后回来阅读答复。 最终用户模式是 同样的旅程,在他们的助手.

给谁的

一个卖家把他们的客户指向 MCP 服务器,所以支持发生在 那些顾客已经工作了 他们自己安装,签入他们 拥有"帮助中心"的账户 也从未看到任何不属于他们的东西.

打开它

最终用户工具存在于 requests 名称空间,它是 选入页:1 代理安装不应该继承为他人制造的工具,其中一个 (标出已解决的请求)在代理符下完全行不通——Zendesk 接受它,默默无所事事. help_center 值得一起服务 因为一个可以搜索知识库的客户 通常不需要 先开一票.

旗帜, 如何让服务器打印 组合曝光的内容: 文件/配置。 。 。 .

它支持的旅程

• 见有甚么相求. 供应商提供的格式 他们的客户名.
• 学一一所问. 关于该表格的问题,即: 需要,而且为了减少精确的选择——这样助理就可以收集 而不是猜到一个有效载荷.
• 交出来,带有附件.
• 跟着它. 列出他们的要求,读一个 与整个谈话 (每一份答复,并标明支助人员) 标出它何时解决.

对Zendesk帐户的要求

代理方已经不需要的东西 再加上一件事 至少一个 标注在终端用户可见的票单, 因为这是客户选择的 之间。 签入是交互式的,通过浏览器,通过设计——没有 脚本或无头路径到终端用户令牌,这是相同的保护 阻止其他人作为你的客户签字.

全部的先决条件: 文件/配置。 。 。 . 一步步走过,写给一个不工作的人 终端 : 文件/最终用户登机。 。 。 .

顾客不能做的,不该做的

顾客可以做的比经纪人少. 这就是重点,不是空白:

• 只有他们自己的票. 被Zendesk强制,不是我们.
• 无内部注释无论是哪个方向。 只代理笔记从不出现 此表面返回的内容 —— Zendesk 从请求者视图中过滤它们 整个票.
• 没有优先权或类型. 当顾客摆放时,Zendesk会把两者都丢掉; 分队和特工们在一起.
• 只有经纪人拿到票才关闭. 在这之前,Zendesk 不让请求者解决, 所以工具说,而不是假装.
• 票底没有搜索,没有用户浏览,没有视图,没有宏.

背景和定制

助手除了工具之外,还有两种背景:

• 内建: 您的帮助中心的结构( 本地, 类别 ) 带ID、片段、权限组的分区树,所以它使用真实的ID 而不是猜想,是用打来的 细节 : docs/help-center-context.md 页面存档备份,存于互联网档案馆。 。 。 .
• 属于你的: 指令、 提示和技能 /mcp/admin,同一服务器上的第二个连接器。 一个导师 setup 提示 让他们穿过它,并提醒他们 已经建在。 没什么 存储于Zendesk,且不强制工作流程:每组编写自己的. 细节 : 文件/定制。 。 。 .

配置

关于CLI旗帜的完整参考文献(--mode, (中文(简体) ), --namespace, (中文(简体) ), --read-only, (中文(简体) ), --transport, (中文(简体) ), --public-url环境 变量(ZENDESK_SUBDOMAIN, (中文(简体) ), OAUTH_TOKEN_FILE, (中文(简体) ), PUBLIC_URL,则 附件-视觉封顶) 文件/配置每个变量都有自己的 锚,这样你就可以将一个特定的设置深链接起来.

解决问题

浏览器在 OAuth 登录期间没有打开, 已使用回调端口, 有 每次都重新认证,以及 Permission denied 关于《指南》的 终点包括在 文档/故障射击。 。 。 . 重新开始使用 LOG_LEVEL=debug 给整个OAuth流出痕迹.

发展

建立repo,工具链,dev模式以及如何测试 PR 分支 涵盖范围 捐款额B. 结构 和守则式的公约 AGENTS.md。 。 。 .

财务问题

支持哪些Zendesk产品? Zendesk 支持(计程器、用户、组织)和帮助中心/指南 (文章、章节、类别、翻译、标签、内容标签、章节、, 附录)。 谈,探险和销售都超出了范围.

我需要Zendesk管理员API钥匙吗? 不,而服务器不支持一个。 每个用户用自己的认证 证书和服务器完全按照权限行事 (单位:千美元)为什么) (中文(简体) ).

跑过去安全吗 npx? 吗? 通过npm Trusted Publishing(OIDC)从CI发布版本,所以每个版本 携带出处证明 npm 页无秘密 被服务器记录过.

捐款

欢迎拉动请求,包括AI协助的请求,只要人类 作者已读取并验证每行。 指南、作者核对表和 审查工作流程已进入 捐款额。 。 。 .

随后的版本 交换器 自动释放 常规武器委员会历史在 CHANGELOG.md。 。 。 .

激励和相关项目

这个项目的建立涉及:

• 官员 Zendesk API 文档
• mattcoatsworth/ zendesk- mcp- 服务器
• koundinya/zd-mcp-服务器

许可证

麻省理工学院

建造和维护 数字4 更好的 联 合 国 弗格格罗 项目.