Zammad MCP by usefulapi

usefulapi 的 Zammad MCP

在 Claude、Cursor 或任何 MCP 客户端中使用 Zammad——搜索和阅读工单及其文章，查找客户和组织，还可执行四种明确标注的写入操作：添加内部备注、回复一封电子邮件、更新工单和新建工单。 托管服务，无需本地安装：使用你自己的 Zammad 地址（Zammad Cloud 或可自托管实例）和个人访问令牌进行连接。

在线端点： https://zammad.usefulapi.io/mcp · 主页： https://usefulapi.io/zammad

连接

• Claude（claude.ai、Desktop）：打开 Customize → Connectors，点击 + Add → Add custom connector，然后粘贴 https://zammad.usefulapi.io/mcp。
• Claude Code： claude mcp add --transport http zammad https://zammad.usefulapi.io/mcp，然后运行 /mcp 登录。
• VS Code： 添加到 VS Code。
• Cursor 和其他客户端： 将此 URL 添加为远程 MCP 服务：

{
  "mcpServers": {
    "zammad": {
      "url": "https://zammad.usefulapi.io/mcp"
    }
  }
}

只添加 URL。请勿在客户端配置中添加 Authorization 标头或 API 密钥：服务端会通过 OAuth 为你登录，登录页面会要求你提供 Zammad 凭据。

分步设置指南、凭据查找位置和常见问题：https://usefulapi.io/zammad/

工具

工具	类型	功能
zammad_get_me	读取	获取当前用户
zammad_search_tickets	读取	搜索工单
zammad_list_tickets	读取	列出工单
zammad_get_ticket	读取	获取工单
zammad_list_ticket_articles	读取	列出工单文章
zammad_get_ticket_article	读取	获取工单文章
zammad_list_ticket_tags	读取	列出工单标签
zammad_list_ticket_states	读取	列出工单状态
zammad_list_ticket_priorities	读取	列出工单优先级
zammad_list_groups	读取	列出组
zammad_search_users	读取	搜索用户
zammad_get_user	读取	获取用户
zammad_search_organizations	读取	搜索组织
zammad_list_organizations	读取	列出组织
zammad_get_organization	读取	获取组织
zammad_add_internal_note	写入	添加内部备注
zammad_reply_to_ticket	写入	回复工单（会向客户发送电子邮件）
zammad_update_ticket	写入	更新工单
zammad_create_ticket	写入	创建工单
zammad_usage_status	元数据	使用情况状态（免费套餐用量计量）
zammad_request_feature	元数据	申请缺少的功能
zammad_upgrade	元数据	升级到 Pro（无限*）
zammad_cancel_subscription	元数据	取消 Pro 订阅

read 工具为只读；write 工具会修改数据（客户端应先征求确认）；meta 工具用于报告用量、管理订阅或提交功能申请。

定价

套餐	价格	限额
免费	$0	每月 50 次工具调用
Pro（按用户计费）	$9/mo 或 $90/yr（免费 2 个月）	无限制*

*Pro 在此服务端的公平使用限额为每月 10,000 次工具调用。如需更多，请联系 [email protected]。

Pro 仅适用于此服务端。使用 zammad_upgrade 订阅（它会返回 Stripe Checkout 链接）。可随时使用 zammad_cancel_subscription 取消：Pro 将持续至已付费周期结束，当前周期不予退款；在此之前运行 zammad_upgrade 可撤销取消操作。也可联系 [email protected]。

许可证

MIT © usefulapi。与 Zammad 无关联，也未获其认可。