当前位置：首页 > news >正文

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

news 2026/7/20 21:39:53

产品研发持续优化

产品研发团队正在持续优化，力求带来更流畅的使用体验，请持续关注更新。

高频诉求与更新方向

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 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 ` 区分访问身份。

2. 工具一直调用失败怎么办？可临时开启审计日志，查看 MCP Tool 参数和 API 返回信息，若参数没问题，确认是调用链问题可将完整日志脱敏后提供给 Zadig 团队协助排查。