Plug-in Zendesk MCP (préversion)

Le plug-in ZENdesk MCP se connecte en toute sécurité à Zendesk pour récupérer les informations de compte, afficher les tickets affectés, créer et mettre à jour des tickets, et utiliser le contenu du Centre d’aide pris en charge.

Ce connecteur est disponible dans les produits et régions suivants :

Service Classe Régions
Copilot Studio Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Applications logiques Standard Toutes les régions Logic Apps , à l’exception des suivantes :
     - Régions Azure Government
     - Régions Azure Chine
     - Us Department of Defense (DoD)
Power Apps Premium Toutes les régions Power Apps , à l’exception des suivantes :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Name Soutien Zendesk
URL https://support.zendesk.com/hc/en-us
Email support@zendesk.com
Métadonnées du connecteur
Éditeur Zendesk Inc
Website https://www.zendesk.com
Politique de confidentialité https://www.zendesk.com/au/company/agreements-and-terms/privacy-notice/
Categories Gestion de l’entreprise ; Productivité

Plug-in Zendesk MCP

Le plug-in Zendesk MCP connecte Microsoft Copilot expériences aux flux de travail de support Zendesk. Il permet à un utilisateur Zendesk autorisé de rechercher et de passer en revue les tickets de support, d’inspecter leurs conversations et leur historique, de récupérer un article du Guide Zendesk et d’effectuer des actions de ticket prises en charge. Le serveur expose 17 opérations Zendesk plus deux utilitaires d’exécution et de schéma. Les résultats et les actions disponibles suivent les autorisations du compte Zendesk utilisé pour autoriser la connexion.

Prerequisites

  • Un compte Zendesk ayant accès aux tickets appropriés et, pour les actions d’écriture, l’autorisation d’apporter les modifications demandées. Certaines opérations, notamment la recherche Zendesk Support et l’ajout de balises de ticket, nécessitent un compte d’agent.
  • Expérience Microsoft qui prend en charge les serveurs MCP certifiés et permet à l’organisation d’activer le plug-in Zendesk MCP.
  • Autorisation de la connexion Zendesk lorsque vous y êtes invité par l’expérience de Microsoft. Un administrateur peut avoir besoin d’activer le plug-in sous les stratégies de l’organisation.

Configuration de la connexion et autorisation OAuth

Le plug-in utilise le flux de code d’autorisation OAuth 2.0. Il demande l’étendue pour récupérer les read données Zendesk disponibles pour l’utilisateur autorisé et l’étendue write pour créer ou mettre à jour des enregistrements Zendesk que l’utilisateur est autorisé à modifier.

  1. Demandez à votre administrateur Microsoft 365 ou Copilot d’activer le plug-in Zendesk MCP si votre organisation a besoin d’une approbation d’administrateur.
  2. Ajoutez le plug-in dans l’expérience de Microsoft prise en charge et sélectionnez l’option pour vous connecter ou l’autoriser.
  3. Quand vous êtes redirigé vers Zendesk, connectez-vous avec le compte Zendesk que vous souhaitez utiliser et passez en revue l’accès demandé avant de l’approuver.
  4. Après avoir retourné à l’expérience de Microsoft, vérifiez la connexion avec une requête en lecture seule, par exemple la récupération de l’utilisateur actuel ou la description des tickets. La connexion ne peut pas accéder à plus de données ou d’actions Zendesk que le compte autorisé autorise.

Le point de terminaison d’autorisation OAuth est https://mcp.zendesk.com/integrations/mcp/oauth/authorize, et le point de terminaison de jeton est https://mcp.zendesk.com/integrations/mcp/oauth/token. Publisher et les administrateurs de certification doivent configurer l’application OAuth multilocataire inscrite et fournir des Microsoft avec des informations d’identification de compte de test et des instructions de configuration via le processus de soumission sécurisé. Les secrets client OAuth, les informations d’identification de compte de test et les jetons d’accès ou d’actualisation ne doivent pas être ajoutés à ce package ou à la documentation publique.

Opérations prises en charge

Area Ce que vous pouvez faire
Rechercher des tickets Recherchez des enregistrements Zendesk Support avec la syntaxe de recherche Zendesk, répertoriez les tickets et récupérez un ticket par ID. Répertorier les tickets attribués ou demandés par un utilisateur spécifié.
Passer en revue un ticket Lisez les commentaires, les enregistrements d’audit, les événements de journal des conversations, les incidents associés et les métriques de ticket.
Identifier l’utilisateur Récupérez des informations sur l’utilisateur Zendesk actuellement authentifié.
Utiliser le Guide Zendesk Récupérez les propriétés d’un article Guide par ID, y compris éventuellement l’auteur, la section, la catégorie et les données de traduction connexes.
Créer des tickets Créez un ticket ou envoyez jusqu’à 100 tickets dans un travail en arrière-plan.
Mettre à jour les tickets Mettez à jour un ticket individuel, ajoutez des balises ou envoyez des mises à jour pour jusqu’à 100 tickets dans un travail en arrière-plan. Les mises à jour individuelles peuvent inclure un commentaire public ou une note interne, en fonction du public paramètre et des autorisations de l’utilisateur.
Suivre une action Vérifiez l’état d’une exécution démarrée précédemment et résolvez le schéma d’entrée d’une action autorisée si nécessaire.

Par exemple, vous pouvez demander : « Rechercher des tickets ouverts sur une connexion ayant échoué », « Afficher les commentaires et l’historique d’audit du ticket 12345 », « Quelles sont les métriques du ticket 12345 ? » ou « Rédiger une réponse publique pour le ticket 12345 ». Une création, une mise à jour, un commentaire, une modification de balise ou une action en bloc modifie les données Zendesk ; passez en revue la cible et le contenu proposé avant de le confirmer dans votre expérience de Microsoft.

L'opération du InvokeMCP connecteur est le transport HTTP Streamable utilisé par Microsoft Copilot Studio pour la négociation de protocole MCP, la découverte d'outils dynamiques et l'exécution d'outils. Il est marqué comme une opération de transport avancée plutôt qu’une action métier orientée client. Les tests de certification doivent valider la demande d’initialisation MCP dans le volet test du connecteur personnalisé, puis ajouter le connecteur à un agent Copilot Studio et exercer les outils Zendesk découverts dynamiquement avec le compte de test fourni en toute sécurité. Le volet test générique peut signaler la réponse SSE brute sous forme de chaîne par rapport à un contrat d’objet implicite ; une 200 réponse avec Content-Type: text/event-stream et un résultat d’initialisation MCP valide confirme le transport, tandis que la découverte d’outils de bout en bout doit être validée dans Copilot Studio.

Problèmes connus et limitations

  • L’accès est limité aux autorisations Zendesk du compte autorisé. Un ticket ou un article auquel le compte ne peut pas accéder peut ne pas être retourné.
  • La recherche Zendesk Support nécessite la syntaxe de recherche Zendesk et utilise la pagination de décalage. Par exemple, type:ticket status:open recherche des tickets ouverts. Les jeux de résultats volumineux peuvent nécessiter une pagination ou une requête plus étroite.
  • Ce package récupère un article zendesk Guide par ID. Il n’expose pas d’outils distincts de recherche d’articles du Guide ou d’outils hiérarchiques.
  • Les opérations de création et de mise à jour en bloc acceptent au maximum 100 tickets par demande et s’exécutent en tant que travaux en arrière-plan. Vérifiez leur état d’achèvement avant de supposer que toutes les modifications ont réussi.
  • Les mises à jour de ticket peuvent déclencher des règles et des notifications d’entreprise Zendesk. Un commentaire public peut être visible par le demandeur. L’ajout de balises prend en charge une option de mise à jour sécurisée : utilisez la dernière updated_at valeur du ticket pour safe_update: true détecter les modifications simultanées ; une valeur obsolète retourne un conflit.
  • Les opérations de transport MCP streamables sont conçues pour les agents IA et ne sont pas exposées comme des actions ordinaires dans le concepteur de flux Power Automate traditionnel.
  • Cet ensemble d’outils ciblé n’expose pas les opérations de configuration administrative zendesk.

Pour obtenir de l’aide, contactez zendesk Support ou visitez Zendesk. Consultez la déclaration de confidentialité zendesk et les conditions d’utilisation.

Actions

Utiliser les outils Zendesk

Se connecte au serveur ZENdesk MCP et rend ses outils pris en charge disponibles.

Utiliser les outils Zendesk

Se connecte au serveur ZENdesk MCP et rend ses outils pris en charge disponibles.