Plug-in Zendesk MCP (anteprima)

Il plug-in Zendesk MCP si connette in modo sicuro a Zendesk per recuperare le informazioni sull'account, visualizzare i ticket assegnati, creare e aggiornare i ticket e lavorare con il contenuto supportato del Centro assistenza.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Service Classe Regions
Copilot Studio Premium Tutte le aree Power Automate ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica Standard Tutte le aree di App per la logica , ad eccezione delle seguenti:
     - aree Azure per enti pubblici
     - Aree di Azure Cina
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps Premium Tutte le aree Power Apps ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate Premium Tutte le aree Power Automate ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Contatto
Name Supporto per Zendesk
URL https://support.zendesk.com/hc/en-us
Email support@zendesk.com
Metadati del connettore
Editore Zendesk Inc
Website https://www.zendesk.com
Informativa sulla privacy https://www.zendesk.com/au/company/agreements-and-terms/privacy-notice/
Categorie Gestione aziendale; Produttività

Plug-in Zendesk MCP

Il plug-in Zendesk MCP connette Microsoft Copilot esperienze ai flussi di lavoro di supporto di Zendesk. Consente a un utente zendesk autorizzato di trovare ed esaminare i ticket di supporto, esaminare le conversazioni e la cronologia, recuperare un articolo della Guida zendesk ed eseguire azioni di ticket supportate. Il server espone 17 operazioni Zendesk e due utilità di esecuzione e schema. I risultati e le azioni disponibili seguono le autorizzazioni dell'account Zendesk usato per autorizzare la connessione.

Prerequisites

  • Un account Zendesk con accesso ai ticket pertinenti e, per le azioni di scrittura, autorizzazione per apportare le modifiche richieste. Alcune operazioni, tra cui la ricerca di Zendesk Support e l'aggiunta di tag ticket, richiedono un account agente.
  • Un'esperienza Microsoft che supporta server MCP certificati e consente all'organizzazione di abilitare il plug-in Zendesk MCP.
  • Autorizzazione della connessione Zendesk quando richiesto dall'esperienza di Microsoft. Un amministratore potrebbe dover abilitare il plug-in nei criteri dell'organizzazione.

Configurazione della connessione e autorizzazione OAuth

Il plug-in usa il flusso del codice di autorizzazione OAuth 2.0. Richiede all'ambito read di recuperare i dati zendesk disponibili per l'utente autorizzato e l'ambito write per creare o aggiornare i record Zendesk che l'utente può modificare.

  1. Chiedere all'amministratore Microsoft 365 o Copilot di abilitare il plug-in Zendesk MCP se l'organizzazione richiede l'approvazione dell'amministratore.
  2. Aggiungere il plug-in nell'esperienza di Microsoft supportata e selezionare l'opzione per connettersi o autorizzarla.
  3. Quando si viene reindirizzati a Zendesk, accedere con l'account Zendesk che si vuole usare ed esaminare l'accesso richiesto prima di approvarlo.
  4. Dopo aver restituito l'esperienza di Microsoft, verificare la connessione con una richiesta di sola lettura, ad esempio recuperare l'utente corrente o elencare i ticket. La connessione non può accedere a più dati o azioni zendesk rispetto all'account autorizzato consentito.

L'endpoint di autorizzazione OAuth è https://mcp.zendesk.com/integrations/mcp/oauth/authorizee l'endpoint del token è https://mcp.zendesk.com/integrations/mcp/oauth/token. Publisher e gli amministratori di certificazione devono configurare l'applicazione OAuth multi-tenant registrata e fornire Microsoft con credenziali dell'account di test e istruzioni di configurazione tramite il processo di invio sicuro. I segreti client OAuth, le credenziali dell'account di test e i token di accesso o aggiornamento non devono essere aggiunti a questo pacchetto o alla documentazione pubblica.

Operazioni supportate

Area Cosa puoi fare
Trova biglietti Cercare i record di Zendesk Support con la sintassi di ricerca zendesk, elencare i ticket e recuperare un ticket in base all'ID. Elencare i ticket assegnati o richiesti da un utente specificato.
Esaminare un ticket Leggere commenti, record di controllo, eventi del log delle conversazioni, eventi imprevisti associati e metriche dei ticket.
Identificare l'utente Recuperare informazioni sull'utente Zendesk attualmente autenticato.
Usare la Guida di Zendesk Recuperare le proprietà di un articolo della Guida in base all'ID, includendo facoltativamente i dati correlati autore, sezione, categoria e traduzione.
Creare ticket Creare un ticket o inviare fino a 100 ticket in un processo in background.
Aggiornare i ticket Aggiornare un singolo ticket, aggiungere tag o inviare aggiornamenti per un massimo di 100 ticket in un processo in background. I singoli aggiornamenti possono includere un commento pubblico o una nota interna, a seconda dell'impostazione public e delle autorizzazioni dell'utente.
Seguire un'azione Controllare lo stato di un'esecuzione avviata in precedenza e risolvere lo schema di input di un'azione consentita quando necessario.

Ad esempio, è possibile chiedere: "Trovare ticket aperti relativi a un account di accesso non riuscito", "Mostra i commenti e la cronologia di controllo per il ticket 12345", "Quali sono le metriche per il ticket 12345?" o "Bozza di una risposta pubblica per il ticket 12345". Una creazione, un aggiornamento, un commento, una modifica di tag o un'azione in blocco modifica i dati di Zendesk; esaminare il contenuto di destinazione e proposto prima di confermarlo nell'esperienza di Microsoft.

L'operazione del InvokeMCP connettore è il trasporto HTTP streamable usato da Microsoft Copilot Studio per la negoziazione del protocollo MCP, l'individuazione dinamica degli strumenti e l'esecuzione degli strumenti. È contrassegnato come un'operazione di trasporto avanzata anziché un'azione aziendale rivolta ai clienti. I test di certificazione devono convalidare la richiesta di inizializzazione MCP nel riquadro test del connettore personalizzato, quindi aggiungere il connettore a un agente Copilot Studio ed esercitare gli strumenti Zendesk individuati dinamicamente con l'account di test fornito in modo sicuro. Il riquadro test generico può segnalare la risposta SSE non elaborata come stringa rispetto a un contratto di oggetto implicito; Una 200 risposta con Content-Type: text/event-stream e un risultato di inizializzazione MCP valido conferma il trasporto, mentre l'individuazione degli strumenti end-to-end deve essere convalidata in Copilot Studio.

Problemi noti e limitazioni

  • L'accesso è limitato alle autorizzazioni zendesk dell'account autorizzato. Un ticket o un articolo a cui l'account non può accedere potrebbe non essere restituito.
  • La ricerca di Zendesk Support richiede la sintassi di ricerca zendesk e usa l'impaginazione offset. Ad esempio, type:ticket status:open trova i ticket aperti. I set di risultati di grandi dimensioni possono richiedere il paging o una query più stretta.
  • Questo pacchetto recupera un articolo della Guida zendesk in base all'ID. Non espone strumenti di ricerca o struttura separati degli articoli della Guida.
  • Le operazioni di creazione e aggiornamento bulk accettano al massimo 100 ticket per richiesta ed eseguite come processi in background. Controllare lo stato di completamento prima di presupporre che tutte le modifiche abbiano avuto esito positivo.
  • Gli aggiornamenti dei ticket possono attivare le regole e le notifiche di Zendesk business. Un commento pubblico può essere visibile al richiedente. L'aggiunta di tag supporta un'opzione di aggiornamento sicuro: usare il valore più recente updated_at del ticket con safe_update: true per rilevare le modifiche simultanee. Un valore non aggiornato restituisce un conflitto.
  • Le operazioni di trasporto MCP streamable sono progettate per gli agenti di intelligenza artificiale e non vengono esposte come azioni normali nella finestra di progettazione tradizionale dei flussi di Power Automate.
  • Questo set di strumenti incentrato non espone le operazioni di configurazione amministrativa di Zendesk.

Per assistenza, contattare il supporto tecnico zendesk o visitare Zendesk. Vedere l'Informativa sulla privacy e le Condizioni per l'utilizzo di Zendesk.

Azioni

Usare gli strumenti di Zendesk

Si connette al server MCP Zendesk e rende disponibili gli strumenti supportati.

Usare gli strumenti di Zendesk

Si connette al server MCP Zendesk e rende disponibili gli strumenti supportati.