zammad-mcp

MCP server para acessar a API do Zammad https://chamados.pop-rr.rnp.br.

Tools expostas

zammad_ticket_create/zammad_ticket_update aceitam tanto o nome (group, state, priority) quanto o id (group_id, state_id, priority_id) — o Zammad resolve nomes nesses campos automaticamente. Em article.internal/internal (add_article e create), o default é true (nota interna, não visível ao cliente) independente de type — para enviar um e-mail ao cliente, informe internal: false explicitamente.

Related MCP server: zammad-mcp

Configuração

Forneça o token por ZAMMAD_TOKEN_FILE (arquivo/secret montado) ou por ZAMMAD_TOKEN (env) — a imagem materializa o env num arquivo no start. unset ZAMMAD_TOKEN no entrypoint tira o valor do ambiente do processo, mas não o esconde de docker inspect/Portainer quando fornecido como env var na stack (é metadado do container, não do processo) — se isso for uma preocupação, use secret de swarm (ZAMMAD_TOKEN_FILE apontando para um arquivo montado) em vez de env var.

Build & Run (local, stdio)

npm install
npm run build
npm test
ZAMMAD_URL=https://sua-instancia.example.com ZAMMAD_TOKEN_FILE=$(pwd)/.token node dist/index.js

Docker (streamable-HTTP via supergateway)

A imagem embute o servidor + supergateway, expondo o MCP em :8000/mcp.

docker build -t ghcr.io/marcelofmatos/zammad-mcp:local .
docker run --rm -p 8000:8000 \
  -e ZAMMAD_URL=https://sua-instancia.example.com \
  -e ZAMMAD_TOKEN=xxxxxxxx \
  ghcr.io/marcelofmatos/zammad-mcp:local
# health: curl localhost:8000/health   |   MCP: http://localhost:8000/mcp

Imagens publicadas no GHCR pelo workflow Release and build (dispatch manual; versiona SemVer via tags e dá push em ghcr.io/marcelofmatos/zammad-mcp).

Deploy no bot Apolo (PoP-RR)

Roda como serviço zammad-poprr na stack mcp-servers-anton (rede anton-mcp), registrado no mcp.json do bot como:

"zammad-poprr": { "type": "http", "url": "http://zammad-poprr:8080/mcp" }

Detalhes completos (compose do serviço, envs da stack, passos de deploy) na spec local em docs/superpowers/specs/2026-07-26-zammad-mcp-design.md (não versionada neste repositório).