Zadig 官方 MCP Server 版本更新：接入更稳、调用更准、审计排障更清晰

产品研发持续优化产品研发团队正在持续优化力求带来更流畅的使用体验请持续关注更新。高频诉求与更新方向Zadig 官方 MCP Server 发布后越来越多团队开始在 Agent 中接入 Zadig使用中出现三个高频诉求远程 MCP 服务要更易部署和接入尤其是多人共用、跨客户端访问场景AI 调用构建、工作流等复杂工具时要少填错参数、少现 OpenAPI 报错减少重试和循环调用失败时研发和平台团队要能快速定位问题所在。围绕这些问题本次版本更新聚焦三个方向接入更稳、调用更准、审计排障更清晰。接入优化Streamable HTTP 更顺手以往团队共用 MCP Server 配置麻烦每人需单独配 token跨客户端接入缺乏统一入口权限难控制导致很多团队各自部署增加维护负担。新版本完善了 Streamable HTTP transport可将 MCP Server 作为团队统一服务部署团队成员通过同一 URL 接入带上自己身份 token权限隔离互不影响。具体改进包括默认暴露 /mcp 入口保留旧 SSE 兼容路径平滑迁移支持在请求头或 URL 参数里携带 API Token适配更灵活增加 Origin 校验、请求体大小限制、空闲会话自动回收等保护机制防止意外流量打爆服务。个人本地使用推荐 stdio 模式团队统一接入推荐 Streamable HTTP。调用改进工作流和构建调用更不易失败AI Agent 在工作流和构建调用时易因填错参数导致 API 返回 400 报错进而反复重试。此次更新做了两件事一是新增 zadig_workflow_runner_prepare 工具AI 执行工作流前可调用该工具获取可用 job 列表、可覆盖变量、推荐 params_json 等信息二是构建工具增强本地校验能力调用 API 前检查常见问题将错误拦截在本地。审计增强调用问题快速定位AI 调用失败时难以判断是参数问题、权限问题还是 Zadig API 问题。新版本增强审计能力可按需记录 MCP Tool 调用和 API 出站请求开启后相关信息以 JSON Lines 格式写入日志文件方便查日志定位问题。为兼顾排障与安全审计默认关闭开启后请求体默认记录 hash响应默认不记录。排查结构时可临时开启脱敏模式如需本地短时定位疑难问题可显式开启 raw但 raw 可能包含敏感信息不建议在生产环境长期启用。安装方法注意MCP Server 需要 Zadig 版本为 v4.2.0 或以上方可正常使用安装过程中需输入 Zadig 的访问地址及 API TokenAPI Token 可在 Zadig 平台“账号设置”中获取支持自动写入配置到 Cursor、Claude Code、Trae、VS Code、Codex 等客户端其他支持 MCP 标准的客户端也可手动配置。一键安装Linux / macOS / Windows (WSL) 使用 curl -fsSL https://resources.koderover.com/zadig - mcp/install.sh | shWindows(PowerShell) 使用 irm https://resources.koderover.com/zadig - mcp/install.ps1 | iex。升级或卸载升级到最新版本使用 curl -fsSL https://resources.koderover.com/zadig - mcp/install.sh | sh -s -- --update检查是否有新版本使用 curl -fsSL https://resources.koderover.com/zadig - mcp/install.sh | sh -s -- --check卸载使用 curl -fsSL https://resources.koderover.com/zadig - mcp/install.sh | sh -s -- --uninstall。验证安装是否成功可到对应工具的 MCP Servers 配置中查看。开始使用安装完成后在对应的集成工具中进行调用即可。常见问题1. Streamable HTTP 和 stdio 应该怎么选个人本地使用推荐 stdio简单、直接、无需额外部署服务团队统一接入推荐 Streamable HTTP可将 MCP Server 部署成远程服务通过 /mcp URL 接入不同客户端用 Authorization: Bearer 区分访问身份。2. 工具一直调用失败怎么办可临时开启审计日志查看 MCP Tool 参数和 API 返回信息若参数没问题确认是调用链问题可将完整日志脱敏后提供给 Zadig 团队协助排查。加入 Zadig AI 进化营Zadig MCP Server 目前正处于快速迭代阶段若有新的实用需求、场景需求或建议欢迎持续反馈一起让它变得更好。