关于 Zendesk MCP Server KON
Zendesk MCP Server KON 将 Zendesk 接入支持 MCP 的 AI 应用，供用户搜索并总结工单、帮助文章和社区讨论。OAuth 登录后还可编辑工单及创建社区帖子或评论，社区写入需预览并经本地一次性批准。
主要功能
- 01搜索工单、帮助文章和社区讨论
- 02总结工单并起草回复
- 03OAuth 登录后更新工单
- 04创建社区帖子和评论
- 05社区写入需预览与本地批准
适用场景
- 01查找近期未解决工单
- 02总结工单并拟写回复
- 03查找退款相关帮助文章
- 04发布社区内容或评论
MCP 相关
它作为 MCP 服务连接 Zendesk，并向支持 MCP 的 AI 应用提供内容搜索、读取和受控写入能力。
配置
本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。
详细介绍
Zendesk MCP
将 Zendesk 连接到 Codex 等 AI 应用，以便查找和总结工单、帮助文章及社区讨论。
- “查找近期未解决的工单。”
- “总结这张工单并起草回复。”
- “查找有关退款的帮助文章。”
新安装后，OAuth 登录即可更新工单，以及创建社区帖子或评论。发布社区内容前，始终需要预览并进行一次本地审批；破坏性操作、冒充他人操作和外部上传操作默认保持禁用。
开始之前
- 你需要一个 Zendesk 账号和支持 MCP 的 AI 应用。本指南使用 Codex。
- 安装 Git 和 uv。uv 会为你运行此工具。
- 请在电脑的终端中运行命令，而不是在 AI 聊天中运行。在 macOS 上，打开 Terminal。
- 请向管理员索取你的 Zendesk 子域名和 OAuth 客户端标识符。
以下浏览器登录方式支持 macOS 和 Linux。 在 Windows 上，请使用 API 令牌设置。
快速安装
此方式直接使用经过测试的源代码版本；不会克隆存储库，也不会安装永久的 zendesk 命令。提交 SHA 用于固定服务端源代码版本。要更新，请替换为经过审核的较新 SHA。
1. 登录 Zendesk
将两个示例值替换为管理员提供的值：
your-company：对于your-company.zendesk.com，只使用your-company，不要使用完整地址或自定义帮助中心域名。your-client-id：你的 OAuth 客户端标识符，不是电子邮件地址或 API 令牌。
uvx --from 'git+https://github.com/nicekon/zendesk-mcp-server-kon.git@457e674525a1e6bf40ef699b1cc433bfed3ea800' zendesk login --subdomain your-company --client-id your-client-id
在打开的浏览器中登录并允许访问。你无需复制代码，也无需启动单独的服务。 连接信息会保存在你的电脑上，因此你不必每次都登录。
管理员：准备首次连接
在 Zendesk 中创建一个公共 OAuth 客户端，并注册以下准确的重定向地址：
http://127.0.0.1:3000/oauth/callback
将子域名和客户端标识符分享给用户，不要分享客户端密钥。
默认登录会请求搜索所需的读取权限，以及默认工单和社区功能所需的 tickets:write 和 hc:write。搜索所需的 read 权限也允许读取用户角色所能访问的其他数据。
请参阅高级设置，了解其他配置。
2. 检查连接
uvx --from 'git+https://github.com/nicekon/zendesk-mcp-server-kon.git@457e674525a1e6bf40ef699b1cc433bfed3ea800' zendesk check --probe
请在结果中查找 "ok": true、"configured": true 和 "verified_user"。
如遇错误，请参阅下表。切勿将令牌或密码粘贴到聊天中。
3. 连接 Codex
codex mcp add zendesk_mcp -- uvx --from 'git+https://github.com/nicekon/zendesk-mcp-server-kon.git@457e674525a1e6bf40ef699b1cc433bfed3ea800' zendesk
codex mcp list
如果出现 zendesk_mcp，则表示已注册。重新打开 Codex，并在新对话中询问“检查我的 Zendesk 连接”。
如果无法使用注册命令，或你使用的是其他应用，请参阅应用连接设置。
备选方案：从源代码安装
仅在开发或需要进行本地修改而必须使用本地检出版本时，才使用此方式：
git clone https://github.com/nicekon/zendesk-mcp-server-kon.git
cd zendesk-mcp-server-kon
uv tool install .
使用源代码安装时，请使用 zendesk，而不是上文的 uvx --from ... zendesk 命令。如果找不到 zendesk，请运行 uv tool update-shell 并打开新的终端。
故障排除
| 问题 | 检查内容 |
|---|---|
找不到 uvx | 安装 uv，然后打开新的终端。 |
从源代码安装后找不到 zendesk | 运行 uv tool update-shell，然后打开新的终端。 |
| 登录无法完成 | 检查浏览器中的授权页面。如果已超时，请重新登录。 |
401 或 authentication_failed | 重新登录。对于 API 令牌，请检查子域名、电子邮件和令牌。 |
403 或 permission_denied | 请管理员检查你是否有权使用该功能。 |
not_configured 或 unsupported | 可能需要额外配置或更换 Zendesk 方案。 |
| 编辑操作被阻止 | 检查是否设置了 ZENDESK_WRITE_MODE=read_only。ZENDESK_ENABLE_PUBLIC_WRITES=false 会阻止社区帖子和评论，但不会阻止普通工单编辑。 |
oauth_relogin_required | 此 OAuth 连接创建时未包含当前启用功能所需的作用域。请使用相同的功能设置再次运行 zendesk login；令牌绝不会自动更改。 |
某些功能需要额外设置。功能是否可用取决于你的 Zendesk 方案和用户权限。 图片上传仍存在尚未解决的真实账户权限问题。
更多信息
许可证：Apache-2.0
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。