Zammad
Um servidor MCP (Model Context Protocol) poderoso e pronto para produção para o Zammad - o sistema de helpdesk e tickets de código aberto.
Documentação
Instale e use o servidor Zammad MCP de código aberto para Claude, Cursor e clientes MCP com ferramentas de ticket tipadas, controle de acesso seguro e configuração de token da API do Zammad.
Zammad MCP Server
O Zammad MCP Server é um servidor gratuito e de código aberto do Model Context Protocol (MCP) para o Zammad. Ele conecta o Claude Desktop, o Cursor e outros clientes MCP ao seu helpdesk Zammad, permitindo que agentes de IA pesquisem tickets, resumam conversas, redijam respostas e inspecionem usuários, organizações, grupos e metadados do sistema por meio de ferramentas tipadas.
Esta página é o hub principal de documentação do servidor Zammad MCP. Use-a se quiser instalar o zammad-mcp-server, conectá-lo ao Claude ou ao Cursor, compará-lo com os recursos nativos de IA do Zammad ou entender se o MCP é a camada de integração certa para a automação do seu helpdesk.
- Licença: MIT
- Pacote:
zammad-mcp-serverno PyPI - Código-fonte: github.com/Softoft-Orga/zammad-mcp-server
- Caso de uso principal: assistentes de IA externos trabalhando com o Zammad via API REST do Zammad
- Compatibilidade com Zammad: 6.0+ via API REST — veja a matriz abaixo
Compatibilidade de versões do Zammad
O pacote MCP (zammad-mcp-server) tem versionamento independente do Zammad. Uma única versão no PyPI funciona com todas as linhas abaixo; aponte o ZAMMAD_URL para a sua instância.
| Zammad | Status | Observações |
|---|---|---|
| 7.1 | Testado (principal) | Padrão no stack de desenvolvimento Docker incluído |
| 7.0 | Testado | PostgreSQL necessário no lado do Zammad |
| 6.5.x | Compatível | Última linha 6.x |
| 6.0 – 6.4.x | Compatível | Linha principal mínima suportada |
| < 6.0 | Não suportado |
Stack de desenvolvimento local: clone o zammad-mcp-server/docker, copie .env.example → .env e defina ZAMMAD_VERSION (7.1, 7.0, 6.5 ou 6.3). Detalhes completos: COMPATIBILITY.md no GitHub.
Use get_server_info após health_check para confirmar a versão do Zammad conectada.
Para quem é este projeto?
| Papel | Uso típico |
|---|---|
| Administradores do Zammad | Pilotar IA em tickets sem construir uma integração de API personalizada |
| Líderes de suporte | Consulta de tickets, resumos e rascunhos de respostas mais rápidos via Claude ou Cursor |
| Engenheiros de IA / automação | Ferramentas MCP padrão em vez de scripts REST avulsos |
| Consultores | Configuração repetível de Zammad + MCP para ambientes de clientes |
Instale o Zammad MCP Server
Para a maioria dos clientes MCP locais, o caminho mais rápido é uvx:
uvx zammad-mcp-server
Você também pode instalá-lo permanentemente:
pip install zammad-mcp-server
uv tool install zammad-mcp-server
O servidor precisa de uma URL do Zammad e de um token de acesso pessoal. Comece pelo Quick Start para ver capturas de tela do fluxo de token do Zammad e, em seguida, adicione o servidor ao Claude Desktop ou Cursor.
Como isso se encaixa no cenário Zammad + IA
flowchart LR
subgraph native [Zammad 7.1 native AI]
Z7[Summaries and writing assistant inside Zammad UI]
end
subgraph mcp [Zammad MCP Server]
MCP[Claude Desktop Cursor custom agents]
end
subgraph otai [Open Ticket AI Runtime]
RT[Custom trained models on-prem routing]
end
Zammad[(Zammad REST API)]
Z7 --> Zammad
MCP --> Zammad
RT --> Zammad
- IA nativa do Zammad 7.1 — resumos integrados, assistente de escrita e agentes de IA dentro da interface do Zammad.
- Zammad MCP Server (este projeto) — conecta clientes MCP externos (Claude Desktop, Cursor, seus próprios agentes) ao Zammad.
- Open Ticket AI Runtime — inferência on-premise com modelos de classificação treinados sob medida por meio do plugin conector OTAI do Zammad (veja integração Zammad + OTAI).
Os três podem coexistir. O MCP é o caminho mais rápido para "falar com meu helpdesk a partir do Claude".
O que você pode fazer com o Zammad MCP
O servidor Zammad MCP expõe o Zammad como ferramentas estruturadas em vez de chamadas REST brutas. Os fluxos de trabalho comuns incluem:
| Fluxo de trabalho | Capacidade do MCP |
|---|---|
| Triagem de tickets abertos | Pesquisar tickets por estado, grupo, cliente, prioridade ou consulta |
| Resumir conversas longas | Buscar artigos do ticket e executar o prompt integrado de resumo de ticket |
| Redigir respostas de suporte | Gerar rascunhos de comunicação com o cliente para revisão humana |
| Inspecionar clientes | Consultar usuários e organizações conectados a um ticket |
| Auditar acesso de agentes | Listar ferramentas habilitadas e negar operações destrutivas com variáveis de ambiente |
| Verificar estado do sistema | Executar health_check e inspecionar a versão do Zammad conectada |
Principais recursos
- Mais de 30 ferramentas MCP para tickets, artigos, usuários, organizações e grupos
- Controle de acesso por meio de variáveis de ambiente (permitir/negar por categoria, lista de negação de ferramentas, escopo de grupo)
- Múltiplos modos de autenticação — token de API (recomendado), OAuth2, autenticação básica
- Opções de instalação —
pip,uvx, Docker, transporte SSE para clientes remotos - Prompts integrados — resumo de ticket, comunicação com o cliente, análise de escalonamento
- URIs de recursos —
zammad://ticket/{id},zammad://user/{id},zammad://states
Mapa da documentação
| Página | O que você vai aprender |
|---|---|
| Quick Start | Instalar e executar o health_check em minutos |
| Claude & Cursor Setup | Configuração do cliente MCP |
| Configuration | Variáveis de ambiente e políticas de acesso |
| Tools Reference | Todas as ferramentas MCP por categoria |
| Security | Tokens, privilégio mínimo, checklist de produção |
| Deployment | Docker, SSE e notas de produção |
Zammad MCP Server vs alternativas
| Opção | Melhor para | Diferença |
|---|---|---|
| Zammad MCP Server | Equipes que querem que Claude, Cursor ou agentes personalizados trabalhem com o Zammad | Clientes MCP externos, ferramentas tipadas, controle de acesso baseado em token de API |
| IA nativa do Zammad 7.1 | Equipes que querem assistência de IA diretamente na interface do Zammad | Integrada ao Zammad, mas não é uma ponte MCP geral para agentes externos |
| Scripts REST personalizados | Automações internas pontuais | Flexível, mas cada script precisa lidar com autenticação, esquemas, erros e segurança |
| Open Ticket AI Runtime | Classificação e roteamento de tickets em produção com modelos privados | Automação em segundo plano com modelos treinados sob medida, não um cliente MCP interativo |
Escolha o Zammad MCP Server quando a intenção for "conectar meu assistente de IA ao Zammad agora". Escolha o Open Ticket AI Runtime quando precisar de roteamento autônomo de filas, classificação ou modelos personalizados treinados com seus dados históricos de tickets.
Perguntas frequentes
O Zammad MCP Server é de código aberto?
Sim. O servidor é licenciado sob MIT e publicado como zammad-mcp-server no PyPI, com código-fonte no GitHub.
Ele funciona com Claude Desktop e Cursor?
Sim. Tanto o Claude Desktop quanto o Cursor podem iniciar o Zammad MCP Server com uvx zammad-mcp-server e passar ZAMMAD_URL mais ZAMMAD_HTTP_TOKEN pela configuração do MCP.
Preciso de direitos de administrador no Zammad?
Não para todos os fluxos de trabalho. A maioria dos fluxos de suporte precisa de um token de acesso pessoal com acesso a tickets. Ferramentas de nível administrativo exigem permissões correspondentes no Zammad e devem ser escopadas com cuidado.
O servidor MCP pode excluir tickets?
Ferramentas destrutivas podem ser negadas por meio de MCP_DENIED_TOOLS. Para ambientes de produção e assistentes compartilhados, negue operações de exclusão a menos que você tenha um processo de revisão robusto.
Quais versões do Zammad são suportadas?
Veja a matriz de compatibilidade no GitHub. Em resumo: 6.0+ é suportado; 7.0 e 7.1 são testados. O stack de desenvolvimento incluído usa 7.1 por padrão e aceita ZAMMAD_VERSION em docker/.env para 7.0, 6.5 ou 6.3.
Isso é o mesmo que os recursos nativos de IA do Zammad?
Não. A IA nativa do Zammad é executada dentro da interface do Zammad. O Zammad MCP Server é uma camada de integração para clientes MCP externos, como Claude, Cursor e agentes personalizados.
Saiba mais
- Tutorial: Zammad MCP Server — configuração e uso (blog)
- Repositório: Softoft-Orga/zammad-mcp-server
- Pacote:
zammad-mcp-serverno PyPI
Próximos passos
- Siga o guia Quick Start.
- Reforce o acesso com Security antes do uso em produção.
- Precisa de modelos personalizados treinados com suas filas? Explore o Open Ticket AI para Zammad.