Zammad MCP

Zammad + AI - 适用于 ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini，以及任何支持 MCP 的 Agent

非官方。由社区构建的 Claude Code Skill 和 Zammad API MCP 服务。 与 Zammad GmbH 无关联，未获其认可或赞助。

_{完整 Skill 页面 - 安装、使用效果、安全模型。}

将每个 Zammad 工单、文章和知识库操作集成到一个 CLI 和 MCP 服务中，还提供团队管理层（Agent 负载、客户健康状况、积压时长、升级分诊、客户流失风险、反馈挖掘），可处理 Zammad API 无法通过单次调用回答的问题。可与您已在使用的 AI 配合工作——ChatGPT（Plus/Pro+，此连接器重新发布前暂停；请参阅 mcp-install.md）、Claude Desktop、Codex、Claude Code、Claude Cowork 和 GitHub Copilot，还可通过远程方式使用 Microsoft 365 Copilot / Copilot Studio 和 Google Gemini。免费、开源，可在您的笔记本电脑上运行。专为 MSP 所有者打造。无需编写代码。

适用于您的 Agent

安全提示（此连接器重新发布前）。 请勿运行 HTTP 模式 （--transport http），即使在 localhost 上也不行。此版本会检查令牌，但 尚未包含修复版本中的请求大小和时间限制。MCP 工具也可以使用您的凭据 执行更改。请使用默认的 stdio 传输。如果您为远程 Agent 设置了隧道，请将其关闭。修复版本即将推出。

MSP 所有者实际使用的六种 Agent（可自行安装，即刻可用）：

您的 AI Agent	如何安装 Zammad Skill
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 zammad-mcp（无需编辑 JSON）。
ChatGPT（付费套餐）	此连接器重新发布前暂停：ChatGPT 需要其 HTTP 模式，而此版本的该模式虽会检查令牌，但尚无请求大小或时间限制。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 zammad-mcp，然后选择 Agent 模式。

ChatGPT 需要远程 HTTPS 服务，这意味着需要使用此连接器的 HTTP 模式；该模式将在连接器重新发布前暂停使用：此版本的该模式虽会检查令牌，但尚无请求大小或时间限制。请参阅 mcp-install.md 中的安全提示。

也适用于 Microsoft 和 Google 技术栈

安装基数很大，但有一点需要坦诚说明：这属于远程／企业级方案，而不是你刚安装的本地二进制文件。

Agent	所需条件
Microsoft 365 Copilot / Copilot Studio	暂停使用，等待重新打包此连接器：Copilot Studio 需要 HTTP 模式，而此版本中的该模式虽会检查令牌，但尚无请求大小或时间限制。请参阅 mcp-install.md 中的安全说明。
Google Gemini	Gemini CLI 是本地工具，与 Claude Code 一样。Gemini 应用是远程服务，需要使用与 ChatGPT 相同的暂停 HTTP 模式。请参阅 mcp-install.md。

原生支持 Skill 的 Agent（也在此列）： Hermes 和 OpenClaw 可直接读取此 Skill 的 SKILL.md，并且支持 MCP——请参阅下方的安装部分。也可通过 MCP 与 Cursor、Windsurf、Cline、Continue.dev 和 Zed 搭配使用。各工具的完整接入说明：docs/which-agent.md。

要使用多个 Agent？ 一条命令即可为所有 51+ 个受支持的 Agent 安装：npx skills add Servosity/msp-skills@latest（需要 Node.js，然后运行每个 Skill 的安装程序来安装 CLI／MCP 二进制文件）。请参阅 docs/which-agent.md。

60 秒内完成安装

Claude Desktop 最快安装方式——一键安装 .mcpb

Claude Desktop 安装包： .mcpb 可在 macOS（Intel 和 Apple Silicon）、Windows x64 和 Linux x64 上启动。每个工具都会调用配套的 zammad-cli。从 2026-09-18 起发布的版本会在安装包中附带该 CLI；较早的安装包只包含 MCP 服务，因此如果你的安装包缺少配套工具，请先运行下方的路径 A 或路径 B 安装程序（或将 ZAMMAD_CLI_PATH 设置为现有二进制文件的路径）。详情： #331。

下载 Zammad MCP（.mcpb）——然后打开 Claude Desktop > Settings > Extensions 并选择该文件。一键完成，无需 JSON，也无需命令行。（请在发布页面查看所有 Zammad 版本。）

更喜欢 Claude Code 插件？添加一次市场，然后安装——无需列出目录，安装后即可使用：

/plugin marketplace add Servosity/msp-skills
/plugin install zammad@msp-skills

路径 A——向 AI Agent 粘贴一条提示词（推荐）

将以下内容复制到 Claude Code、Codex CLI 或 Claude Cowork：

在此 Agent 工作区中安装来自 Servosity/msp-skills 的 Zammad Skill 和 MCP 服务。如果此工作区使用 POSIX shell（macOS、Linux、WSL 或 Bash），请运行 bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/zammad/install.sh)。如果使用 Windows PowerShell，请运行 iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/zammad/install.ps1 | iex。然后按照 README 完成身份验证，并运行 zammad-cli --help 进行探索。

任何能够运行 shell 的 Agent 都可以使用同一条提示词。

路径 B——自行运行安装程序

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/zammad/install.ps1 | iex

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/zammad/install.sh)

安装程序会将 zammad-cli（CLI）和 zammad-mcp（MCP 服务）都安装到用户的 bin 路径中。Claude Code、Codex 和 Cowork 会通过此目录中的 SKILL.md 发现该 Skill。

验证：

zammad-cli --version

升级到最新版本

安装程序始终会获取当前版本——重新运行即可升级：

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/zammad/install.sh)

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/zammad/install.ps1 | iex

Claude Desktop .mcpb 用户：下载最新的 .mcpb（见本节顶部），然后在 Settings > Extensions 中重新选择该文件。Claude Code 插件用户：/plugin update zammad@msp-skills。

添加到 Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot 或其他 MCP 客户端

安装程序运行后，请参阅 mcp-install.md 和 docs/which-agent.md，了解各 Agent 的接入方法——每个 Agent 都有一个独立章节，其中包括 GitHub Copilot 的 servers 键，以及 Microsoft 365 Copilot / Copilot Studio 的远程接入方式。Claude Desktop 的 Settings > Extensions 面板是最简单的接入方式；偏好编辑 JSON 的用户可在 mcp-install.md 中查看 MCP 配置块。

安装到 Hermes

在 Hermes CLI 中：

hermes skills install servosity/msp-skills/skills/zammad --force

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/zammad --force

Hermes 原生支持 MCP，因此也可以直接使用 zammad-mcp 服务——安装方式和环境变量都相同。

安装到 OpenClaw

向 OpenClaw Agent 发送以下内容（复制即可）：

从 https://github.com/servosity/msp-skills/tree/main/skills/zammad 安装 zammad 技能。该技能定义了如何通过 openclaw: frontmatter 块安装其必需的 CLI（zammad-cli）。

OpenClaw 尚未普遍开放；frontmatter 接入配置已预先提供，会在 OpenClaw 发布时立即启用。

身份验证

设置 CLI 所需的凭据（从你的 Zammad 门户获取）：

ZAMMAD_API_TOKEN=<value> zammad-cli doctor

运行任何会访问数据的操作前，doctor 会确认凭据是否有效。即使凭据被拒绝，它也会以状态码 0 退出，因此脚本应添加 --fail-on error。

此技能的功能

团队常问的问题	命令
当前支持团队中谁的工作负荷过重？	zammad-cli agent-load --json
每个 Agent 的队列是在增长还是缩减？	zammad-cli agent-trend --weeks 4 --json
哪些客户遇到了困难，需要优先关注？	zammad-cli customer-health --at-risk --json
哪些工单的未结时间过长？	zammad-cli overdue --days 3 --json
哪些客户表达了不满，应当升级处理？	zammad-cli escalate --json
哪些账户有流失趋势，原因是什么？	zammad-cli churn-risk --json
客户在提出什么需求（功能、定价、合规）？	zammad-cli feedback-scan --bucket pricing --json
查找并阅读未结工单（使用 organization_id:N 将范围限定到某个客户）	zammad-cli tickets search --query "state:open" --json
记录备注或搜索知识库	zammad-cli ticket note 12345 --body "..." --internal · zammad-cli kb search "restore" --json

完整命令参考：guide.md。有关 AI Agent 操作约定（--agent、--dry-run，以及何时应在修改数据前确认），请参阅 AGENTS.md。

与众不同之处

大多数 Zammad 集成和 MCP 服务都会将每个问题转发为实时 API 调用。查询单条记录时，这样做没问题。但规模一大就行不通了，例如你想问“团队中谁在处理所有未结工单时负担过重”，或“本季度哪些客户的对话积压时间最长、情绪最激烈”——Zammad API 没有单一端点可以回答这类问题。

此技能会将 Zammad 同步到一个支持全文搜索的本地 SQLite 镜像中。汇总类问题只需执行一次本地 SQL 联接：响应迅速、无需联网，而且 AI 看到的是答案，而非原始数据。agent-load、churn-risk 和 feedback-scan 等复合命令会联接工单、文章、组织和用户数据——这是无状态 API 封装器无法做到的。

解决的痛点

r/msp 上关于工单工具反复出现的抱怨都一样：仪表板会告诉你队列里有什么，却从不汇总所有工单的数据——每位客服的工作量、哪些客户不断重新打开工单、哪些客户账户正悄悄走向流失。因此，每周都要把工单导出到电子表格，再手动整理出这些答案；而真正能预测客户流失的两种信号——客户听起来已经不耐烦，以及埋在文章讨论串里的功能、定价和合规需求——直到客户已经流失才会浮现。

• zammad-cli agent-load - 现在有哪些客服工作过载，各自的未结、待处理和积压工单数量。
• zammad-cli overdue --days 3 - 所有超期未结的工单，按优先级加权，最严重的排在最前。
• zammad-cli escalate - 客户收到的消息中带有不满语气的活跃工单，并显示匹配到的文本。
• zammad-cli churn-risk - 有流失趋势的客户账户，列出评分及原因。
• zammad-cli feedback-scan --bucket pricing - 按类别整理客户反复提出的需求，并列出来源工单。

更完整的说明请参阅 pain-point.md。

常见问题

这适用于 ChatGPT 吗？

当前版本不适用。ChatGPT（Plus、Pro、Team、Business、Enterprise 和 Education 套餐；Free 套餐目前尚不支持 Developer Mode）只能连接通过 HTTPS 提供服务的远程 MCP 服务，这意味着必须以 HTTP 模式运行 Zammad MCP 服务。当前版本的 HTTP 模式会检查令牌，但尚未限制请求大小或处理时间，因此在连接器重新发布之前，请勿运行该模式，也不要将其置于隧道之后；mcp-install.md 中的安全说明解释了原因。在此之前，请使用 Claude Desktop、Claude Code 或 Codex。

这适用于 Codex、Cursor、Windsurf、Cline、Copilot 或 Gemini 吗？

适用——它们都支持 MCP。跨工具安装命令见上方的对照表，详细说明见 docs/which-agent.md。

我需要懂编程吗？

不需要。推荐的安装方式是在 Claude Code 或 Codex 中粘贴一句话——你的 Agent 会读取 SKILL.md 并完成安装。备用方式是在每种操作系统上运行一行安装命令（bash 或 PowerShell）。这两种方式都不需要编写代码。你只需输入一次 Zammad 凭据。

我的 Zammad 数据安全吗？

数据会保留在你的设备上。CLI 和 MCP 服务都是本地二进制程序。SQLite 镜像存放在你用户账户下的目录中。AI Agent 只能看到 CLI 返回的内容——通常是查询结果，而不是原始批量数据。凭据从环境或 Agent 的配置中读取；MSP Skills 不会将其打包进此代码库，也不会将其传输到任何地方。

它适用于我自托管或托管的 Zammad 实例吗？

两者都适用。使用 ZAMMAD_URL 指向任意 Zammad 实例（例如 https://support.yourcompany.com），并在 ZAMMAD_API_TOKEN 中设置个人访问令牌；该令牌在 Profile → Token Access 下创建。没有任何内容被硬编码到特定实例。

这与 Zammad 内置的 AI 功能有何不同？

Zammad 的 AI（工单摘要、写作助手）在单个工单内工作。此工具则会分析整个服务台——团队工作量、积压工单时长、客户健康状况、流失信号和反馈主题——并将结构化 JSON 交给你已在使用的 AI Agent。

升级、流失和反馈信号是 AI 情感分析吗？

不是。它们是透明的关键词和时间启发式规则，用于找出相关工单，并展示匹配到的文本，供你的 AI 或人工判断。它们只标记可能符合条件的工单并展示依据，不会自行断定结论。

费用是多少？

免费。采用 Apache-2.0 许可证。你只需为自己使用的 AI Agent（Claude、ChatGPT、Codex 等）付费，费用由 AI 提供商收取，而不是由我们收取。

安全模型

等级	示例	建议的 Agent 策略
读取	agent-load、agent-trend、customer-health、overdue、escalate、churn-risk、feedback-scan、tickets search/get、articles by-ticket、kb browse/search/get、search、sync	允许
写入（常规）	ticket note、tickets create/update、articles create、tags add/remove、organizations create/update、users create/update、kb answer-create/publish/internal、kb category-create	使用 --dry-run 预览，然后经审核后写入
破坏性操作 / 配置	tickets delete、kb answer-delete	仅允许人在环监督

最有力的控制措施是授予 Zammad 凭据的权限范围——CLI 只能执行凭据获准执行的操作。完整详情（包括如何收紧权限）请参阅 governance.md。

状态

已在实际环境中验证。Servosity（维护者）已在其生产租户上确认。还有更多 MSP 在每周 Build Sessions 中实际运行它。请在 compoundingteams.com/build-sessions RSVP。

---

标准。 符合开放的 Agent Skills 规范（Anthropic，2025 年 12 月；支持 40 多种 Agent）。兼容 MCP——可与任何支持 MCP 的 Agent 配合使用，包括 Hermes。已为 OpenClaw 做好准备（frontmatter 已预先配置，等待 OpenClaw 发布）。

由 Servosity 维护。采用 Apache-2.0 许可证。使用 CLI Printing Press 构建。最后更新：2026-07-11。