用途：通过 zendesk CLI 和 MCP 服务器执行 Zendesk Support 操作，覆盖工单管理、搜索、批量导出、用户、组织、知识库文章与 MCP 集成。
配置：凭据优先级为 CLI 参数 > 环境变量 > 配置文件（~/.zendesk.json 或 .zendesk.json）。环境变量包括 ZENDESK_SUBDOMAIN、ZENDESK_EMAIL（默认取 git config user.email）、ZENDESK_TOKEN（也接受 ZENDESK_API_KEY）。全局参数示例：zendesk --subdomain foo --email me@foo.com --token TOKEN。
输出格式：集合命令默认 Markdown 表格，支持 --json、--jsonl（流式，适合管道和大结果集）、--pretty。单资源命令默认 Markdown，支持 --json。
主要能力：工单查看、列表（按状态、指派人、请求者、排序、分页过滤）、搜索（Zendesk 查询语法，如 status:open、assignee:me、created>2024-01-01、tags:escalated）、评论、附件；增量批量导出（支持 --output、--include-comments、--progress、--verbose、--start-time、--exclude-deleted、--resume、--limit、--concurrency、--per-page）；用户与组织查询；工单字段与标签列表；知识库文章搜索与查看；附件元数据获取与下载。
MCP：运行 zendesk mcp stdio 启动服务器，可在 Claude Code 配置中接入。MCP 工具包括 get_ticket、get_tickets、create_ticket、update_ticket、search_tickets、get_ticket_comments、create_ticket_comment、get_ticket_attachments、download_attachment、get_ticket_fields、get_ticket_field、get_user、get_users、get_organization、get_organizations、search_articles、get_article、get_articles_by_section、list_tags。创建/更新工单支持 custom_fields，字段 ID 为数字字符串，可用 zendesk field list 发现。
适用场景：工单排查、按条件检索、批量导出后用 DuckDB 分析、解析用户/组织上下文、发现自定义字段、知识库查询。
限制：导出含评论时受速率限制约 600 请求/分钟；--per-page 最大 1000；导出结果按最新优先排序。其他未在资料中说明的功能、收费或平台支持暂未提供。