Zammad
Un servidor MCP potente y listo para producción para Zammad, el sistema de tickets y helpdesk de código abierto.
Documentación
Instala y usa el servidor Zammad MCP de código abierto para Claude, Cursor y clientes MCP con herramientas de tickets tipadas, control de acceso seguro y configuración de token de API de Zammad.
Servidor Zammad MCP
El servidor Zammad MCP es un servidor Model Context Protocol (MCP) gratuito y de código abierto para Zammad. Conecta Claude Desktop, Cursor y otros clientes MCP a tu helpdesk de Zammad para que los agentes de IA puedan buscar tickets, resumir conversaciones, redactar respuestas e inspeccionar usuarios, organizaciones, grupos y metadatos del sistema mediante herramientas tipadas.
Esta página es el centro principal de documentación del servidor Zammad MCP. Úsala si quieres instalar zammad-mcp-server, conectarlo a Claude o Cursor, compararlo con las funciones de IA nativas de Zammad o entender si MCP es la capa de integración adecuada para la automatización de tu helpdesk.
- Licencia: MIT
- Paquete:
zammad-mcp-serveren PyPI - Código fuente: github.com/Softoft-Orga/zammad-mcp-server
- Caso de uso principal: asistentes de IA externos que trabajan con Zammad a través de la API REST de Zammad
- Compatibilidad con Zammad: 6.0+ mediante API REST — consulta la matriz a continuación
Compatibilidad de versiones de Zammad
El paquete MCP (zammad-mcp-server) tiene su propia versión independiente de Zammad. Una misma versión de PyPI funciona con todas las filas siguientes; apunta ZAMMAD_URL a tu instancia.
| Zammad | Estado | Notas |
|---|---|---|
| 7.1 | Probado (principal) | Predeterminado en el stack de desarrollo Docker incluido |
| 7.0 | Probado | PostgreSQL requerido en el lado de Zammad |
| 6.5.x | Compatible | Última línea 6.x |
| 6.0 – 6.4.x | Compatible | Línea principal mínima compatible |
| < 6.0 | No compatible |
Stack de desarrollo local: clona zammad-mcp-server/docker, copia .env.example → .env y configura ZAMMAD_VERSION (7.1, 7.0, 6.5 o 6.3). Detalles completos: COMPATIBILITY.md en GitHub.
Usa get_server_info después de health_check para confirmar la versión de Zammad conectada.
¿Para quién es?
| Rol | Uso típico |
|---|---|
| Administradores de Zammad | Probar IA en tickets sin crear una integración de API personalizada |
| Líderes de soporte | Búsqueda de tickets, resúmenes y borradores de respuestas más rápidos mediante Claude o Cursor |
| Ingenieros de IA / automatización | Herramientas MCP estándar en lugar de scripts REST puntuales |
| Consultores | Configuración repetible de Zammad + MCP para entornos de clientes |
Instalar el servidor Zammad MCP
Para la mayoría de los clientes MCP locales, la vía más rápida es uvx:
uvx zammad-mcp-server
También puedes instalarlo de forma permanente:
pip install zammad-mcp-server
uv tool install zammad-mcp-server
El servidor necesita una URL de Zammad y un token de acceso personal. Comienza con la Guía de inicio rápido para ver capturas del flujo de token de Zammad y luego añade el servidor a Claude Desktop o Cursor.
Cómo encaja esto en el panorama de 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 de Zammad 7.1 — resúmenes integrados, asistente de escritura y agentes de IA dentro de la interfaz de Zammad.
- Servidor Zammad MCP (este proyecto) — conecta clientes MCP externos (Claude Desktop, Cursor, tus propios agentes) a Zammad.
- Open Ticket AI Runtime — inferencia local con modelos de clasificación entrenados a medida mediante el plugin conector OTAI de Zammad (consulta Integración Zammad + OTAI).
Los tres pueden coexistir. MCP es la vía más rápida para «hablar con mi helpdesk desde Claude».
Qué puedes hacer con Zammad MCP
El servidor Zammad MCP expone Zammad como herramientas estructuradas en lugar de llamadas REST directas. Los flujos de trabajo habituales incluyen:
| Flujo de trabajo | Capacidad MCP |
|---|---|
| Clasificar tickets abiertos | Buscar tickets por estado, grupo, cliente, prioridad o consulta |
| Resumir conversaciones largas | Obtener artículos de tickets y ejecutar el prompt integrado de resumen de tickets |
| Redactar respuestas de soporte | Generar borradores de comunicación con el cliente para revisión humana |
| Inspeccionar clientes | Consultar usuarios y organizaciones vinculados a un ticket |
| Auditar el acceso de agentes | Listar herramientas habilitadas y denegar operaciones destructivas con variables de entorno |
| Comprobar el estado del sistema | Ejecutar health_check e inspeccionar la versión de Zammad conectada |
Características principales
- Más de 30 herramientas MCP para tickets, artículos, usuarios, organizaciones y grupos
- Control de acceso mediante variables de entorno (permitir/denegar por categoría, lista de denegación de herramientas, alcance por grupo)
- Múltiples modos de autenticación — token de API (recomendado), OAuth2, autenticación básica
- Opciones de instalación —
pip,uvx, Docker, transporte SSE para clientes remotos - Prompts integrados — resumen de tickets, comunicación con el cliente, análisis de escalados
- URI de recursos —
zammad://ticket/{id},zammad://user/{id},zammad://states
Mapa de documentación
| Página | Qué aprenderás |
|---|---|
| Guía de inicio rápido | Instalar y ejecutar health_check en minutos |
| Configuración de Claude y Cursor | Configuración del cliente MCP |
| Configuración | Variables de entorno y políticas de acceso |
| Referencia de herramientas | Todas las herramientas MCP por categoría |
| Seguridad | Tokens, privilegio mínimo, lista de verificación de producción |
| Implementación | Docker, SSE y notas de producción |
Servidor Zammad MCP frente a alternativas
| Opción | Mejor ajuste | Diferencia |
|---|---|---|
| Servidor Zammad MCP | Equipos que quieren que Claude, Cursor o agentes personalizados trabajen con Zammad | Clientes MCP externos, herramientas tipadas, control de acceso basado en token de API |
| IA nativa de Zammad 7.1 | Equipos que quieren asistencia de IA directamente dentro de la interfaz de Zammad | Integrada en Zammad, pero no es un puente MCP general para agentes externos |
| Scripts REST personalizados | Automatizaciones internas puntuales | Flexible, pero cada script debe gestionar autenticación, esquemas, errores y seguridad |
| Open Ticket AI Runtime | Clasificación y enrutamiento de tickets en producción con modelos privados | Automatización en segundo plano con modelos entrenados a medida, no un cliente MCP interactivo |
Elige el servidor Zammad MCP cuando la intención sea «conectar mi asistente de IA a Zammad ahora». Elige Open Ticket AI Runtime cuando necesites enrutamiento autónomo de colas, clasificación o modelos personalizados entrenados con tus datos históricos de tickets.
Preguntas frecuentes
¿El servidor Zammad MCP es de código abierto?
Sí. El servidor tiene licencia MIT y se publica como zammad-mcp-server en PyPI con el código fuente en GitHub.
¿Funciona con Claude Desktop y Cursor?
Sí. Tanto Claude Desktop como Cursor pueden iniciar el servidor Zammad MCP con uvx zammad-mcp-server y pasar ZAMMAD_URL más ZAMMAD_HTTP_TOKEN a través de la configuración de MCP.
¿Necesito derechos de administrador en Zammad?
No para todos los flujos de trabajo. La mayoría de los flujos de soporte necesitan un token de acceso personal con acceso a tickets. Las herramientas de nivel administrador requieren permisos correspondientes en Zammad y deben delimitarse con cuidado.
¿Puede el servidor MCP eliminar tickets?
Las herramientas destructivas se pueden denegar mediante MCP_DENIED_TOOLS. Para entornos de producción y asistentes compartidos, deniega las operaciones de eliminación a menos que tengas un proceso de revisión sólido.
¿Qué versiones de Zammad son compatibles?
Consulta la matriz de compatibilidad en GitHub. En resumen: se admite 6.0+; 7.0 y 7.1 están probadas. El stack de desarrollo incluido usa 7.1 por defecto y acepta ZAMMAD_VERSION en docker/.env para 7.0, 6.5 o 6.3.
¿Es esto lo mismo que las funciones de IA nativas de Zammad?
No. La IA nativa de Zammad se ejecuta dentro de la interfaz de Zammad. El servidor Zammad MCP es una capa de integración para clientes MCP externos como Claude, Cursor y agentes personalizados.
Más información
- Tutorial: Servidor Zammad MCP — configuración y uso (blog)
- Repositorio: Softoft-Orga/zammad-mcp-server
- Paquete:
zammad-mcp-serveren PyPI
Próximos pasos
- Sigue la Guía de inicio rápido.
- Refuerza el acceso con Seguridad antes del uso en producción.
- ¿Necesitas modelos personalizados entrenados con tus colas? Explora Open Ticket AI para Zammad.