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 服务器
Reactive Resume
amruthpillaiA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
39.5K
Handl
Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.
Volley.sh
VolleyA good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi
Blender
ahujasidOpen-source MCP to use Blender with any LLM
23.6K
Screenpipe
screenpipeYC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context
22.0K
评论