Plug-in DO MCP do Zendesk (versão prévia)

O Plug-in DO MCP do Zendesk conecta-se com segurança ao Zendesk para recuperar informações da conta, exibir tíquetes atribuídos, criar e atualizar tíquetes e trabalhar com o conteúdo da Central de Ajuda com suporte.

Esse conector está disponível nos seguintes produtos e regiões:

Service Classe Regions
Copilot Studio Premium Todas as regiões Power Automate exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Azure Governamental regiões
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões Power Apps exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões Power Automate exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Name Suporte Zendesk
URL https://support.zendesk.com/hc/en-us
Email support@zendesk.com
Metadados do conector
Publicador Zendesk Inc
Website https://www.zendesk.com
Política de privacidade https://www.zendesk.com/au/company/agreements-and-terms/privacy-notice/
Categories Gestão de empresas; Produtividade

Plug-in DO MCP do Zendesk

O Plug-in DO MCP do Zendesk conecta Microsoft Copilot experiências a fluxos de trabalho de suporte do Zendesk. Ele permite que um usuário autorizado do Zendesk localize e examine os tíquetes de suporte, inspecione suas conversas e histórico, recupere um artigo do Guia do Zendesk e execute ações de tíquete com suporte. O servidor expõe 17 operações do Zendesk mais dois utilitários de execução e esquema. Os resultados e as ações disponíveis seguem as permissões da conta zendesk usada para autorizar a conexão.

Prerequisites

  • Uma conta do Zendesk com acesso aos tíquetes relevantes e, para ações de gravação, permissão para fazer as alterações solicitadas. Algumas operações, incluindo a pesquisa de suporte do Zendesk e a adição de marcas de tíquete, exigem uma conta de agente.
  • Uma experiência Microsoft que dá suporte a servidores MCP certificados e permite que a organização habilite o Plug-in DO MCP do Zendesk.
  • Autorização da conexão do Zendesk quando solicitada pela experiência de Microsoft. Talvez um administrador precise habilitar o plug-in nas políticas da organização.

Configuração de conexão e autorização do OAuth

O plug-in usa o fluxo de código de autorização do OAuth 2.0. Ele solicita o read escopo para recuperar dados do Zendesk disponíveis para o usuário autorizado e o write escopo para criar ou atualizar registros zendesk que o usuário tem permissão para alterar.

  1. Peça ao administrador do Microsoft 365 ou Copilot para habilitar o Plug-in do MCP do Zendesk se sua organização exigir aprovação do administrador.
  2. Adicione o plug-in na experiência de Microsoft com suporte e selecione a opção para conectá-lo ou autorizá-lo.
  3. Quando redirecionado para o Zendesk, entre com a conta do Zendesk que você deseja usar e examine o acesso solicitado antes de aprová-lo.
  4. Depois de retornar à experiência Microsoft, verifique a conexão com uma solicitação somente leitura, como recuperar o usuário atual ou listar tíquetes. A conexão não pode acessar mais dados ou ações do Zendesk do que a conta autorizada permite.

O ponto de extremidade de autorização OAuth é https://mcp.zendesk.com/integrations/mcp/oauth/authorize, e o ponto de extremidade do token é https://mcp.zendesk.com/integrations/mcp/oauth/token. Publisher e administradores de certificação devem configurar o aplicativo OAuth multilocatário registrado e fornecer Microsoft com credenciais de conta de teste e instruções de configuração por meio do processo de envio seguro. Segredos do cliente OAuth, credenciais de conta de teste e tokens de acesso ou atualização não devem ser adicionados a este pacote ou à documentação pública.

Operações com suporte

Area O que você pode fazer
Localizar tíquetes Pesquise registros de suporte do Zendesk com sintaxe de pesquisa do Zendesk, liste tíquetes e recupere um tíquete por ID. Listar tíquetes atribuídos ou solicitados por um usuário especificado.
Examinar um tíquete Leia comentários, registros de auditoria, eventos de log de conversa, incidentes associados e métricas de tíquete.
Identifique o usuário Recupere informações sobre o usuário do Zendesk autenticado no momento.
Trabalhar com o Guia do Zendesk Recupere as propriedades de um artigo do Guia por ID, incluindo, opcionalmente, dados relacionados de autor, seção, categoria e tradução.
Criar tíquetes Crie um tíquete ou envie até 100 tíquetes em um trabalho em segundo plano.
Atualizar tíquetes Atualize um tíquete individual, adicione marcas ou envie atualizações para até 100 tíquetes em um trabalho em segundo plano. As atualizações individuais podem incluir um comentário público ou uma nota interna, dependendo da public configuração e das permissões do usuário.
Seguir uma ação Verifique o status de uma execução iniciada anteriormente e resolva o esquema de entrada de uma ação permitida quando necessário.

Por exemplo, você pode perguntar: "Localizar tíquetes abertos sobre um logon com falha", "Mostrar os comentários e o histórico de auditoria do tíquete 12345", "Quais são as métricas do tíquete 12345?", ou "Elaborar uma resposta pública para o tíquete 12345". Uma criação de tíquete, atualização, comentário, alteração de marca ou ação em massa altera os dados do Zendesk; examine o destino e o conteúdo proposto antes de confirmá-lo em sua experiência de Microsoft.

A operação do InvokeMCP conector é o transporte HTTP streamable usado por Microsoft Copilot Studio para negociação de protocolo MCP, descoberta dinâmica de ferramentas e execução de ferramentas. Ele é marcado como uma operação de transporte avançada em vez de uma ação comercial voltada para o cliente. O teste de certificação deve validar a solicitação de inicialização do MCP no painel de teste do conector personalizado e, em seguida, adicionar o conector a um agente Copilot Studio e exercitar as ferramentas do Zendesk descobertas dinamicamente com a conta de teste fornecida com segurança. O painel teste genérico pode relatar a resposta SSE bruta como uma cadeia de caracteres em relação a um contrato de objeto implícito; uma 200 resposta com Content-Type: text/event-stream e um resultado de inicialização de MCP válido confirma o transporte, enquanto a descoberta de ferramentas de ponta a ponta deve ser validada em Copilot Studio.

Limitações e problemas conhecidos

  • O acesso é limitado às permissões do Zendesk da conta autorizada. Um tíquete ou artigo que a conta não pode acessar pode não ser retornado.
  • A pesquisa de suporte do Zendesk requer a sintaxe de pesquisa do Zendesk e usa paginação de deslocamento. Por exemplo, type:ticket status:open localiza tíquetes abertos. Conjuntos de resultados grandes podem exigir paginação ou uma consulta mais estreita.
  • Este pacote recupera um artigo do Guia do Zendesk por ID. Ele não expõe ferramentas separadas de pesquisa ou estrutura de tópicos do artigo guia.
  • As operações de criação e atualização em massa aceitam no máximo 100 tíquetes por solicitação e são executadas como trabalhos em segundo plano. Verifique o status de conclusão antes de assumir que todas as alterações foram bem-sucedidas.
  • As atualizações de tíquetes podem disparar notificações e regras de negócios do Zendesk. Um comentário público pode ser visível para o solicitante. Adicionar marcas dá suporte a uma opção de atualização segura: use o valor safe_update: true mais recente updated_at do tíquete para detectar alterações simultâneas; um valor obsoleto retorna um conflito.
  • As operações de transporte MCP que podem ser transmitidas são projetadas para agentes de IA e não são expostas como ações comuns no designer de fluxo de Power Automate tradicional.
  • Esse conjunto de ferramentas focado não expõe as operações de configuração administrativa do Zendesk.

Para obter ajuda, entre em contato com o Suporte do Zendesk ou visite o Zendesk. Consulte o Aviso de Privacidade do Zendesk e os Termos de Uso.

Ações

Usar ferramentas do Zendesk

Conecta-se ao servidor DO MCP do Zendesk e disponibiliza suas ferramentas compatíveis.

Usar ferramentas do Zendesk

Conecta-se ao servidor DO MCP do Zendesk e disponibiliza suas ferramentas compatíveis.