Zendesk MCP 插件 (预览版)
Zendesk MCP 插件安全地连接到 Zendesk,以检索帐户信息、查看分配的票证、创建和更新票证,以及处理受支持的帮助中心内容。
此连接器在以下产品和区域中可用:
| Service | Class | 区域 |
|---|---|---|
| Copilot Studio | 高级 | 除以下各项外的所有 Power Automate 区域 : - 美国政府 (GCC) - 美国政府 (GCC High) - 由世纪互联运营的中国云 - 美国国防部(DoD) |
| 逻辑应用程序 | 标准 | 除以下各项外的所有 逻辑应用区域 : - Azure 政府区域 - Azure 中国区域 - 美国国防部(DoD) |
| Power Apps | 高级 | 除以下各项外的所有 Power Apps 区域 : - 美国政府 (GCC) - 美国政府 (GCC High) - 由世纪互联运营的中国云 - 美国国防部(DoD) |
| Power Automate | 高级 | 除以下各项外的所有 Power Automate 区域 : - 美国政府 (GCC) - 美国政府 (GCC High) - 由世纪互联运营的中国云 - 美国国防部(DoD) |
| 联系人 | |
|---|---|
| Name | Zendesk 支持 |
| URL | https://support.zendesk.com/hc/en-us |
| support@zendesk.com |
| 连接器元数据 | |
|---|---|
| Publisher | Zendesk Inc |
| 网站 | https://www.zendesk.com |
| 隐私策略 | https://www.zendesk.com/au/company/agreements-and-terms/privacy-notice/ |
| Categories | 业务管理;生产力 |
Zendesk MCP 插件
Zendesk MCP 插件将Microsoft Copilot体验连接到 Zendesk 支持工作流。 它允许授权的 Zendesk 用户查找和查看支持票证、检查其对话和历史记录、检索 Zendesk 指南文章并执行支持的票证操作。 服务器公开 17 个 Zendesk 操作以及两个执行和架构实用工具。 结果和可用操作遵循用于授权连接的 Zendesk 帐户的权限。
Prerequisites
- 有权访问相关票证的 Zendesk 帐户,对于写入操作,有权进行请求的更改。 某些操作(包括 Zendesk 支持搜索和添加票证标记)需要代理帐户。
- 支持经过认证的 MCP 服务器的Microsoft体验,并允许组织启用 Zendesk MCP 插件。
- Microsoft体验提示时,Zendesk 连接的授权。 管理员可能需要在组织的策略下启用插件。
连接设置和 OAuth 授权
该插件使用 OAuth 2.0 授权代码流。 它请求 read 范围以检索可供授权用户使用的 Zendesk 数据,以及 write 创建或更新允许用户更改的 Zendesk 记录的范围。
- 如果组织需要管理员批准,请让Microsoft 365或Copilot管理员启用 Zendesk MCP 插件。
- 在受支持的Microsoft体验中添加插件,然后选择连接或授权该插件的选项。
- 重定向到 Zendesk 时,请使用要使用的 Zendesk 帐户登录,并在批准之前查看请求的访问权限。
- 返回到Microsoft体验后,请验证与只读请求的连接,例如检索当前用户或列出票证。 连接无法访问比授权帐户允许的更多 Zendesk 数据或操作。
OAuth 授权终结点是 https://mcp.zendesk.com/integrations/mcp/oauth/authorize,令牌终结点为 https://mcp.zendesk.com/integrations/mcp/oauth/token。 Publisher和认证管理员必须配置已注册的多租户 OAuth 应用程序,并通过安全提交过程提供Microsoft测试帐户凭据和配置说明。 不得将 OAuth 客户端机密、测试帐户凭据和访问或刷新令牌添加到此包或公共文档。
支持的操作
| Area | 你能做什么 |
|---|---|
| 查找票证 | 使用 Zendesk 搜索语法、列出票证和按 ID 检索票证的 Zendesk 支持记录。 列出指定用户分配或请求的票证。 |
| 查看票证 | 读取注释、审核记录、对话日志事件、关联事件和票证指标。 |
| 标识用户 | 检索有关当前经过身份验证的 Zendesk 用户的信息。 |
| 使用 Zendesk 指南 | 按 ID 检索指南文章的属性,可以选择包括相关作者、节、类别和翻译数据。 |
| 创建票证 | 在后台作业中创建一个票证或提交最多 100 个票证。 |
| 更新票证 | 在后台作业中更新单个票证、添加标记或提交最多 100 张票证的更新。 根据设置和用户的权限, public 单个更新可以包括公开评论或内部注释。 |
| 遵循操作 | 检查以前启动的执行的状态,并在需要时解析允许操作的输入架构。 |
例如,可以询问:“查找有关登录失败的公开票证”、“显示票证 12345 的注释和审核历史记录”、“票证 12345 的指标是多少?”或“为票证 12345 起草公共答复”。 票证创建、更新、注释、标记更改或批量操作更改 Zendesk 数据;在Microsoft体验中确认目标内容和建议的内容之前,请查看它。
连接器InvokeMCP的操作是Microsoft Copilot Studio用于 MCP 协议协商、动态工具发现和工具执行的可流式传输 HTTP 传输。 它被标记为高级传输操作,而不是面向客户的业务操作。 认证测试应在自定义连接器测试窗格中验证 MCP 初始化请求,然后将连接器添加到Copilot Studio代理,并使用安全提供的测试帐户练习动态发现的 Zendesk 工具。 泛型测试窗格可以将原始 SSE 响应报告为针对隐式对象协定的字符串;200具有Content-Type: text/event-stream有效 MCP 初始化结果的响应确认传输,而应在Copilot Studio中验证端到端工具发现。
已知问题和限制
- 访问权限仅限于授权帐户的 Zendesk 权限。 可能无法返回帐户无法访问的票证或项目。
- Zendesk 支持搜索需要 Zendesk 搜索语法并使用偏移分页。 例如,
type:ticket status:open查找打开的票证。 大型结果集可能需要分页或更窄的查询。 - 此包按 ID 检索 Zendesk Guide 文章。 它不公开单独的指南文章搜索或大纲工具。
- 批量创建和更新操作接受每个请求最多 100 个票证,并作为后台作业运行。 假设所有更改都成功之前,请检查其完成状态。
- 票证更新可能会触发 Zendesk 业务规则和通知。 请求者可以看到公共评论。 添加标记支持安全更新选项:使用票证的最新
updated_at值safe_update: true检测并发更改;过期值返回冲突。 - 可流式 MCP 传输操作专为 AI 代理设计,在传统的Power Automate流设计器中不会公开为普通操作。
- 此重点工具集不公开 Zendesk 管理配置操作。
支持和法律
如需帮助,请联系 Zendesk 支持 部门或访问 Zendesk。 请参阅 Zendesk 隐私声明 和 使用条款。
操作
| 使用 Zendesk 工具 |
连接到 Zendesk MCP 服务器并使其支持的工具可用。 |
使用 Zendesk 工具
连接到 Zendesk MCP 服务器并使其支持的工具可用。