产品研发团队正在持续优化，力求带来更流畅的使用体验，请持续关注更新。
Zadig 官方 MCP Server 发布后，越来越多团队开始在 Agent 中接入 Zadig，在真实使用中，我们也看到三个高频诉求：
远程 MCP 服务要更容易部署和接入，尤其是多人共用、跨客户端访问的场景。
AI 调用构建、工作流这类复杂工具时，要尽量少填错参数，少出现 OpenAPI 报错，减少重试和循环。
当调用失败时，研发和平台团队要能快速定位：是 AI 调用的参数错了、权限不够，还是 Zadig API 返回异常。
围绕这些问题，本次版本更新聚焦三个方向：接入更稳、调用更准、审计排障更清晰。
# 一、团队共用 MCP Server？Streamable HTTP 现在更顺手了
以前如果团队想共用一个 MCP Server，配置是个麻烦事——每人要单独配 token、跨客户端接入缺乏统一入口、权限也不好控制。很多团队因此干脆各自部署，增加了不少维护负担。
新版本完善了 Streamable HTTP transport，现在你可以把 MCP Server 作为团队统一服务来部署。部署一次，团队成员通过同一个 URL 接入，各自带上自己的身份 token，权限隔离互不影响。
具体改进包括：
默认暴露
/mcp入口，同时保留旧 SSE 兼容路径，平滑迁移不费力。支持在请求头或 URL 参数里携带 API Token，对不同客户端的适配更灵活。
还加了 Origin 校验、请求体大小限制、空闲会话自动回收等保护机制，防止意外流量打爆服务。
个人本地使用继续推荐 stdio 模式，简单直接；团队统一接入推荐 Streamable HTTP，减少重复配置。
# 二、工作流和构建调用，现在更不容易失败了
这是最让 AI Agent 头疼的部分——填错了 job_name、变量名对不上、构建模块没选对，API 直接返回 400，AI 不知道哪里出了问题，开始反复重试，越试越乱。
这次做了两件事。
第一，新增了 zadig_workflow_runner_prepare 工具。AI 在真正执行工作流之前，可以先调用这个只读工具，根据真实的 workflow 配置拉取可用的 job 列表、可覆盖的变量、推荐的 params_json。相当于在真正跑工作流之前，先拿到一份"参考答案"，知道哪些参数是合法的、哪些 job 存在、哪个变量需要填什么格式。
第二，构建工具增强了本地校验能力。调用 API 之前，会先检查 payload_json 是不是合法 JSON、模板模式有没有漏掉 target_services、infrastructure 枚举值对不对这些常见问题。把错误拦截在本地，而不是等到 API 返回 400 再来排查。
# 三、调用出问题了？审计日志让你快速定位
有时候 AI 确实会调用失败，但排查起来很难说清楚是 AI 参数填错了、权限不够、还是 Zadig API 本身的问题。
新版本增强了审计能力，可以按需记录 MCP Tool 的调用和 API 出站请求。开启后，谁调的、调的哪个工具、传了什么参数、API 返回了什么状态、耗时多久——这些信息都以 JSON Lines 格式写入日志文件，遇到问题不用靠猜，直接查日志定位。
为了兼顾排障与安全，审计默认关闭；开启后请求体默认记录 hash，响应默认不记录。需要排查结构时，可以临时开启脱敏模式：
MCP_AUDIT_ENABLED=true
MCP_AUDIT_PATH=audit.jsonl
MCP_AUDIT_BODY_MODE=redacted
MCP_AUDIT_RESPONSE_MODE=redacted
如需本地短时定位疑难问题，也可以显式开启 raw：
MCP_AUDIT_BODY_MODE=raw
MCP_AUDIT_RESPONSE_MODE=raw
注意：raw 可能包含用户信息、构建参数、工作流变量、服务配置或日志内容，仅建议本地短时排查使用，不建议在生产环境长期启用
# 安装方法
注意：
MCP Server 需要 Zadig 版本为 v4.2.0 或以上方可正常使用。
安装过程中输入 Zadig 的访问地址及 API Token（API Token 可在 Zadig 平台“账号设置”中获取）。
支持自动写入配置到以下客户端：Cursor、Claude Code、Trae、VS Code、Codex。其他支持 MCP 标准的客户端也可选择手动配置。
一键安装
#Linux / macOS / Windows (WSL)
curl -fsSL https://resources.koderover.com/zadig-mcp/install.sh | sh
# Windows(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 <token> 区分访问身份。
# 2. 工具一直调用失败怎么办？
可以临时开启审计日志，查看 MCP Tool 参数和 API 返回信息，如果参数没问题，确认是调用链的问题可以把完整日志脱敏后提供给 Zadig 团队协助排查。
# 加入 Zadig AI 进化营
Zadig MCP Server 目前正处于快速迭代阶段，如果你有新的实用需求、场景需求或者建议，欢迎持续反馈，一起让它变得更好。
👉 扫码加入交流群（备注“MCP”），一起探索 AI + Zadig 的无限可能。
