Servidor MCP
O Zammad tem seu próprio servidor para o Model Context Protocol (MCP). Conecte a ele um cliente de IA que você já usa, por exemplo um aplicativo de chat ou uma ferramenta de programação, e leia, encontre e atualize seus tickets a partir dali. O servidor faz parte de toda instalação: você não instala nem executa nada além disso.
Se o servidor aceita conexões é uma decisão do seu administrador. Se uma conexão com https://zammad.example.com/mcp falhar, pergunte ao seu administrador se o servidor está ativado.
Conectar um cliente de IA
A conexão exige um token de acesso pessoal e o endereço do servidor no seu cliente.
Criar um token de acesso pessoal
O cliente se conecta com um token de acesso pessoal da sua conta. Abra seu perfil e a seção Token access dele (veja configurações pessoais) e crie um token com a permissão ticket.agent, para que o cliente possa trabalhar com tickets. Você pode dar uma data de expiração ao token. Copie o token que o Zammad mostra quando o token é criado.
Adicionar o Zammad ao seu cliente
Adicione o Zammad ao cliente como servidor MCP. O cliente precisa do transporte MCP Streamable HTTP e da capacidade de enviar um cabeçalho fixo Authorization: Bearer em toda requisição. Suportar só o transporte não basta. Uma configuração assim pede as mesmas três informações:
- o endereço do servidor: o domínio pelo qual você abre o Zammad, seguido de
/mcp, como emhttps://zammad.example.com/mcp - o transporte, Streamable HTTP
- o token, enviado como cabeçalho HTTP em toda requisição:
Authorization: Bearer {your_token}
Clientes que leem uma configuração JSON, como muitos fazem, recebem o Zammad como servidor com o endereço e o cabeçalho. Substitua zammad.example.com pelo domínio com que você abre o Zammad e {your_token} pelo token que você copiou:
{
"mcpServers": {
"zammad": {
"type": "http",
"url": "https://zammad.example.com/mcp",
"headers": {
"Authorization": "Bearer {your_token}"
}
}
}
}WARNING
O token funciona como a sua senha. Não o coloque em um arquivo de configuração que outras pessoas possam ler ou que acabe em um repositório. Mantenha o arquivo privado, ou use a referência a um segredo armazenado, se o seu cliente oferecer suporte.
Outros clientes pedem as mesmas três informações em seu próprio formato. Quando a conexão funcionar, um primeiro pedido como "Mostre meus tickets atribuídos" mostra se o cliente alcança o Zammad.
O Zammad só responde no endereço para o qual está configurado, aquele com que você abre o Zammad. Se a conexão falhar, confira se o cliente usa exatamente esse endereço.
O que o cliente pode fazer
O cliente conectado trabalha com as suas permissões: ele pode fazer exatamente o que o token e a sua conta podem fazer, nada além disso, e registra as alterações dele como feitas por você. Um usuário sem permissão de agente, como um cliente, não recebe nenhuma ferramenta do servidor. A lista completa das ferramentas, com o acesso e os limites de cada uma, está na referência ferramentas do servidor MCP.
- Abrir um ticket pelo número, pelo ID ou por um link colado, e ler as mensagens, notas internas, anexos, histórico e rascunho compartilhado dele.
- Ler o cliente e a organização de um ticket.
- Encontrar tickets por palavras e por nomes, como o cliente, a organização, o estado, o responsável, o grupo ou a prioridade de um ticket.
- Listar suas próprias visões gerais e os tickets delas, e ordenar as listas, por exemplo por criação ou última atualização, para que o cliente possa começar pelo ticket mais antigo.
- Pesquisar usuários, organizações e a base de conhecimento.
- Ler o texto de arquivos anexados a uma mensagem: arquivos de texto de até 10 MB; os demais arquivos voltam como um link para download.
- Alterar atributos de ticket, definir tags e adicionar notas internas.
- Salvar e enviar rascunhos compartilhados, e vincular tickets e respostas da base de conhecimento.
- Criar tickets e escrever mensagens.
Mensagens, notas e rascunhos podem ser escritos em texto simples ou em HTML. O Zammad remove do HTML a marcação insegura. SMS, Telegram, WhatsApp e Facebook aceitam apenas texto simples; HTML é recusado nesses canais. Não é possível enviar arquivos pelo cliente: se quiser enviar um, adicione-o à mensagem no próprio Zammad.
Quando um ticket pede contabilização de tempo, o cliente pergunta o tempo a você e o registra. Você também pode dizer que não vai contabilizar tempo, e o Zammad então registra a mensagem sem tempo contabilizado.
Aprovação de mensagens enviadas
Quando o cliente consegue exibir, o Zammad pede que você aprove uma mensagem antes que ela chegue a um cliente. O pedido de aprovação mostra o texto completo da mensagem, os destinatários e a visibilidade, e o Zammad só envia depois que você aceita.
Se você recusar, o Zammad não envia nada e não altera nada no ticket. O cliente pode então oferecer salvar o texto como rascunho compartilhado do ticket, onde o grupo permitir rascunhos compartilhados, para que você o envie pelo próprio Zammad.
Um cliente que não consegue exibir o formulário de aprovação depende da sua própria aprovação da chamada de ferramenta, como faz para toda alteração, e o Zammad não pergunta uma segunda vez. O Zammad ainda quer o seu "sim" para duas alterações: substituir um rascunho compartilhado já salvo e fechar um ticket cujo checklist está incompleto. Mantenha ativada no seu cliente a aprovação de chamadas de ferramenta, porque um cliente que as executa sem perguntar envia uma mensagem sem nenhuma confirmação adicional.