What authentication methods does the Zammad MCP Server support?
It supports three methods: API token (recommended, via `ZAMMAD_HTTP_TOKEN`), OAuth2 token (`ZAMMAD_OAUTH2_TOKEN`), and username/password (`ZAMMAD_USERNAME`/`ZAMMAD_PASSWORD`).
Z
Zammad MCP Server
@Softoft-Orga
基本信息
关于 Zammad MCP Server
A production-ready Model Context Protocol (MCP) server for Zammad, the open-source helpdesk and ticket system. It gives Claude, Cursor, and other MCP clients structured access to tickets, users, organizations, groups, and system metadata with configurable access control.
Zammad MCP Server 配置
使用下面的配置,将此服务器添加到你的 MCP 客户端。
{
"mcpServers": {
"zammad": {
"command": "uvx",
"args": [
"zammad-mcp-server"
],
"env": {
"ZAMMAD_URL": "https://your-zammad-instance.example.com",
"ZAMMAD_HTTP_TOKEN": "your_api_token",
"MCP_DENIED_TOOLS": "delete_ticket,delete_user,delete_organization"
}
}
}
}Zammad MCP Server 工具
26Check the health of the Zammad MCP Server and its connection to Zammad. Returns: Health status information including server status and connection details.
Get information about the Zammad server. Returns: Server version, configuration, and status information.
Get a list of all tools accessible to the current session. Returns: List of tools with their categories and permission levels.
Get a specific ticket by ID.
Search for tickets with various filters.
Create a new ticket.
Update an existing ticket.
Delete a ticket.
Get all articles (messages) for a ticket.
Add a new article to an existing ticket.
Get ticket statistics.
Get all available ticket states. Returns: List of available ticket states with their properties.
Get all available ticket priorities. Returns: List of available priority levels.
Get a user by ID.
Search for users.
Create a new user.
Update a user.
Delete a user.
Get the currently authenticated user. Returns: Current user details.
Get an organization by ID.
Search for organizations.
Create a new organization.
Update an organization.
Delete an organization.
Get a group by ID.
List all groups. Returns: List of all groups.
概览
What is Zammad MCP Server?
The Zammad MCP Server is a production-ready Model Context Protocol (MCP) server for Zammad, the open-source helpdesk and ticket system. It gives AI assistants such as Claude structured, type-safe access to Zammad ticket management, users, organizations, groups, and system tools, enabling natural‑language helpdesk automation.
How to use Zammad MCP Server?
Install via pip (pip install zammad-mcp-server) or with uv/uvx. Create a .env file with ZAMMAD_URL and ZAMMAD_HTTP_TOKEN. Run as zammad-mcp-server (stdio transport) or with --transport sse for remote clients. Configure in Claude Desktop / Cursor by adding the command and environment variables to claude_desktop_config.json or the MCP settings.
Key features of Zammad MCP Server
- Comprehensive API coverage for tickets, users, organizations, groups
- Advanced access control with category‑ and tool‑level permissions
- Supports API tokens, OAuth2, and basic authentication
- Built with FastMCP, Pydantic, and modern Python practices
- Smart caching for static data (groups, states, priorities)
- Type-safe with full runtime validation and 90%+ test coverage
Use cases of Zammad MCP Server
- Natural‑language ticket creation, search, and updates from an AI assistant
- Automated customer communication drafting and escalation analysis
- Admin operations like user management and organization maintenance
- Real‑time health checks and server information retrieval
- Secure, policy‑governed helpdesk access for external MCP clients
常见问题
How does access control work?
Access control is configured via environment variables: `MCP_ALLOWED_CATEGORIES` restricts which tool categories are available, `MCP_DENIED_TOOLS` blocks specific dangerous tools (e.g., `delete_ticket`), and `MCP_ALLOWED_GROUPS` limits operations to certain Zammad groups. Permission levels are DENIED, READ_ONLY, WRITE, or ADMIN.
What transports does the server support?
The server supports stdio transport (for local MCP clients like Claude Desktop) and SSE transport (for remote clients) using the `--transport sse` flag.
What dependencies are required to run the Zammad MCP Server?
Python 3.11 or newer, and the FastMCP library (2.0+). It is installed as a PyPI package and can be run directly with `uvx` without explicit installation.
How does this server differ from Zammad’s native AI features?
Zammad 7 includes built‑in AI summaries and writing assistance inside its UI. The Zammad MCP Server connects **external** MCP clients (Claude Desktop, Cursor, custom agents) to Zammad, enabling natural‑language interaction from outside the helpdesk. Both can coexist.
其他 分类下的更多 MCP 服务器
N
Next Generation Movers: free moving quotes (remote MCP)
Next Generation MoversFree moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40
EverArt
modelcontextprotocolModel Context Protocol Servers
88.1K
Health by Dr Brad
Dr Brad StanfieldHealth by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one
Activepieces
activepiecesAI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
23.2K
DeepMark
DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.
评论