Zendesk MCP Plugin (Pré-visualização)
O Zendesk MCP Plugin liga-se de forma segura ao Zendesk para obter informações da conta, visualizar tickets atribuídos, criar e atualizar tickets, e trabalhar com o conteúdo suportado do Centro de Ajuda.
Este conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões Power Automate exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões Azure Government - 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 (CCG) - 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 (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contact | |
|---|---|
| Name | Suporte Zendesk |
| URL | https://support.zendesk.com/hc/en-us |
| support@zendesk.com |
| Metadados do conector | |
|---|---|
| Publisher | 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 Empresarial; Produtividade |
Zendesk MCP Plugin
O Zendesk MCP Plugin liga as experiências do Microsoft Copilot aos fluxos de trabalho de suporte Zendesk. Permite a um utilizador autorizado da Zendesk encontrar e rever tickets de suporte, inspecionar as suas conversas e histórico, recuperar um artigo do Zendesk Guide e tomar ações de tickets suportadas. O servidor expõe 17 operações Zendesk, além de duas utilidades de execução e esquema. Os resultados e as ações disponíveis seguem as permissões da conta Zendesk usada para autorizar a ligação.
Prerequisites
- Uma conta Zendesk com acesso aos tickets relevantes e, para ações de escrita, permissão para fazer as alterações solicitadas. Algumas operações, incluindo a pesquisa de Suporte Zendesk e a adição de etiquetas de tickets, exigem uma conta de agente.
- Uma experiência Microsoft que suporta servidores MCP certificados e permite à organização ativar o Plugin Zendesk MCP.
- Autorização da ligação Zendesk quando solicitado pela experiência Microsoft. Um administrador pode precisar de ativar o plugin nas políticas da organização.
Configuração de ligação e autorização OAuth
O plugin utiliza o fluxo de código de autorização OAuth 2.0. Solicita o read âmbito para recuperar dados Zendesk disponíveis para o utilizador autorizado e o write âmbito para criar ou atualizar registos Zendesk que o utilizador pode alterar.
- Peça ao seu administrador do Microsoft 365 ou do Copilot para ativar o Plugin Zendesk MCP caso a sua organização precise de aprovação do administrador.
- Adiciona o plugin na experiência Microsoft suportada e seleciona a opção para o ligar ou autorizar.
- Quando for redirecionado para o Zendesk, inicie sessão com a conta Zendesk que pretende usar e reveja o acesso solicitado antes de o aprovar.
- Depois de regressar à experiência Microsoft, verifique a ligação com um pedido de apenas leitura, como recuperar o utilizador atual ou listar tickets. A ligação não pode aceder a mais dados ou ações Zendesk do que a conta autorizada permite.
O endpoint de autorização OAuth é https://mcp.zendesk.com/integrations/mcp/oauth/authorize, e o endpoint do token é https://mcp.zendesk.com/integrations/mcp/oauth/token. Os administradores de Publisher e certificação devem configurar a aplicação OAuth multitenant registada e fornecer à Microsoft credenciais da conta de teste e instruções de configuração através do processo seguro de submissão. Segredos de cliente OAuth, credenciais de conta de teste e tokens de acesso ou atualização não devem ser adicionados a este pacote nem à documentação pública.
Operações suportadas
| Area | O que pode fazer |
|---|---|
| Encontrar bilhetes | Pesquise registos de Suporte Zendesk com sintaxe de pesquisa Zendesk, liste tickets e recupere um ticket por ID. Liste os tickets atribuídos ou solicitados por um utilizador específico. |
| Analise um bilhete | Leia comentários, registos de auditoria, eventos do registo de conversas, incidentes associados e métricas de tickets. |
| Identificar o utilizador | Recupere informações sobre o utilizador Zendesk atualmente autenticado. |
| Trabalhar com o Zendesk Guide | Recuperar as propriedades de um artigo de Guia por ID, incluindo opcionalmente autores relacionados, secções, categorias e dados de tradução. |
| Criar bilhetes | Crie um ticket ou submeta até 100 tickets num trabalho em segundo plano. |
| Bilhetes de atualização | Atualize um ticket individual, adicione tags ou submeta atualizações para até 100 tickets num trabalho em segundo plano. As atualizações individuais podem incluir um comentário público ou uma nota interna, dependendo da public definição e das permissões do utilizador. |
| Seguir uma ação | Verifique o estado de uma execução previamente iniciada e resolva o esquema de entrada de uma ação permitida quando necessário. |
Por exemplo, pode perguntar: "Encontre tickets abertos sobre um login falhado", "Mostre os comentários e o histórico de auditoria do ticket 12345", "Quais são as métricas para o ticket 12345?", ou "Rediga uma resposta pública para o ticket 12345." A criação de um ticket, atualização, comentário, alteração de etiqueta ou ação em massa altera dados Zendesk; reveja o conteúdo alvo e proposto antes de o confirmar na sua experiência Microsoft.
A operação do InvokeMCP conector é o transporte HTTP Streamable usado pelo Microsoft Copilot Studio para negociação de protocolos MCP, descoberta dinâmica de ferramentas e execução de ferramentas. É identificada como uma operação avançada de transporte, em vez de uma ação empresarial voltada para o cliente. Os testes de certificação devem validar o pedido de inicialização do MCP no painel de teste do conector personalizado, depois adicionar o conector a um agente do Copilot Studio e exercitar as ferramentas Zendesk descobertas dinamicamente com a conta de teste fornecida de forma segura. O painel genérico de Teste pode reportar a resposta SSE bruta como uma cadeia contra um contrato de objeto implícito; uma 200 resposta com Content-Type: text/event-stream e um resultado válido de inicialização MCP confirma o transporte, enquanto a descoberta de ferramentas de ponta a ponta deve ser validada no Copilot Studio.
Problemas e limitações conhecidos
- O acesso é limitado às permissões Zendesk da conta autorizada. Um bilhete ou artigo ao qual a conta não possa aceder pode não ser devolvido.
- A pesquisa de Suporte Zendesk requer a sintaxe de pesquisa Zendesk e utiliza paginação deslocada. Por exemplo,
type:ticket status:openencontra bilhetes abertos. Grandes conjuntos de resultados podem exigir paginação ou uma consulta mais restrita. - Este pacote recupera um artigo do Zendesk Guide por ID. Não expõe ferramentas separadas de pesquisa de artigos ou esboços de Guia.
- Operações de criação e atualização em massa aceitam no máximo 100 tickets por pedido e executam como trabalhos em segundo plano. Verifique o estado de conclusão antes de assumir que todas as alterações foram bem-sucedidas.
- As atualizações de tickets podem ativar regras de negócio e notificações do Zendesk. Um comentário público pode ser visível para o solicitante. Adicionar etiquetas suporta uma opção de atualização segura: usar o valor mais recente
updated_atdo ticket comsafe_update: truepara detetar alterações simultâneas; um valor obsoleto devolve um conflito. - As operações de transporte MCP streamable são concebidas para agentes de IA e não são expostas como ações comuns no designer tradicional de fluxo do Power Automate.
- Este conjunto de ferramentas focado não expõe as operações de configuração administrativa do Zendesk.
Apoio e jurídico
Para obter ajuda, contacte o Suporte Zendesk ou visite a Zendesk. Consulte o Aviso de Privacidade e os Termos de Utilização da Zendesk.
Ações
| Use as ferramentas Zendesk |
Liga-se ao servidor Zendesk MCP e disponibiliza as suas ferramentas suportadas. |
Use as ferramentas Zendesk
Liga-se ao servidor Zendesk MCP e disponibiliza as suas ferramentas suportadas.