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
Email 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 记录的范围。

  1. 如果组织需要管理员批准,请让Microsoft 365或Copilot管理员启用 Zendesk MCP 插件。
  2. 在受支持的Microsoft体验中添加插件,然后选择连接或授权该插件的选项。
  3. 重定向到 Zendesk 时,请使用要使用的 Zendesk 帐户登录,并在批准之前查看请求的访问权限。
  4. 返回到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 服务器并使其支持的工具可用。