在 2026 年 7 月的 Momentum London 2026 上DocuSign 发布了面向智能体时代的能力组合Iris 助手、Agent Studio、MCP ServerGlobal Open Beta与正式可用的 Agreement Manager APIGA。对想把合同能力嵌入业务系统的工程师来说更值得关注的不是某个新界面而是 DocuSign 把 MCP 与 REST 并列作为智能体集成面的设计思路。本文用一段配置加一段调用示例讲清三件事MCP 与 REST 分别适合什么场景、如何用 Agreement Manager API 批量摄取协议、以及如何让 Iris 把合同读成结构化数据再交给业务智能体。为什么是 MCP两种集成面DocuSign 提供两条集成路径理解边界是实战前提REST API适合确定性的代码优先工作流如批量上传、轮询状态、监听 webhook输入输出明确脚本调用更直接。MCP Server为 AI agent 运行时工具调用设计。当智能体需在对话中临时决定调用哪个能力如找出这份 NDA 的缔约方和到期日MCP 把 DocuSign 能力暴露成可被大模型发现和调用的工具。官方已为多个主流连接器提供适配包括 Anthropic Claude、Google Gemini、Microsoft Copilot、GitHub Copilot 等。一、接入 MCP Server基础配置接入本质是一份客户端配置告诉 agent 运行时 DocuSign 工具在哪、怎么鉴权。下面是一份示意配置endpoint 用 example.com 占位{ mcpServers: { docusign: { // 传输方式DocuSign MCP Server 支持 SSE 流式传输 transport: sse, // MCP 接入地址占位实际请使用你的网关或 DocuSign 提供的端点 url: https://mcp.example.com/docusign/sse, // 鉴权头建议在运行时从环境变量注入不要硬编码 token headers: { Authorization: Bearer ${DOCUSIGN_MCP_TOKEN} }, // 可选限定智能体可调用的工具范围做权限收敛控制 enabledTools: [ search_agreements, extract_fields, get_obligations ] } } }接入后agent 运行时即可看到 DocuSign 暴露的工具由模型决定何时调用无需写死调用分支。让智能体自己决定调哪个工具是探索性的运行时行为REST 更适合明确知道要做什么的确定性流程两者互补而非替代。二、用 Agreement Manager API 批量摄取协议当协议分散在 Salesforce、Google Drive、SharePoint 或遗留系统中时先要把它们统一摄取进 Agreement Manager。这是典型批量确定性任务用 REST 更直接。下面用伪代码endpoint 用 example.com 占位演示批量摄取import requests # 1. 获取认证 tokenDocuSign 采用 OAuth示例使用 JWT 流程 token get_docusign_token() # 2. 构造批量摄取 job来源可以是 salesforce / google_drive / sharepoint / legacy payload { source: salesforce, documents: [ {name: MSA-2026.pdf, uri: https://yourapp.com/contracts/MSA-2026.pdf}, {name: NDA-Acme.pdf, uri: https://yourapp.com/contracts/NDA-Acme.pdf} ] } # 3. 提交 job服务端返回 jobId用于后续 job 级 / 文档级状态跟踪 resp requests.post( https://api.example.com/agreement-manager/v1/ingest/jobs, jsonpayload, headers{Authorization: fBearer {token}} ) job_id resp.json()[jobId] # 4. 轮询或监听 webhook 获取进度协议更新 / 删除 / Iris 提取完成时实时通知 # 建议生产环境使用 webhook避免频繁轮询消耗配额Agreement Manager API 关键能力批量摄取支持从 Salesforce、Google Drive、SharePoint、遗留系统同时导入也支持云端上传。状态跟踪提供 job 级与文档级两层状态便于展示排队/处理中/完成进度。Webhooks协议更新、删除、Iris 提取完成时实时推送可驱动下游动作如到期提醒。批量摄取输入输出完全确定脚本化、可重放REST 表达力与可控性更强也更易重试与审计。三、让智能体读懂合同Iris 提取协议进入 Agreement Manager 后Iris 可提取结构化数据关键字段、各方义务、重要日期、缔约方及条款历史。这一步把非结构化 PDF 变成业务系统能消费的字段。MCP 模式下智能体可自然发起总结这份 MSA 里甲方的付款义务和违约条款这类请求底层由 Iris 完成提取再由 agent 组织成业务语言。REST 模式下也可通过 Agreement Manager API 拉取结果喂给规则引擎或数据库。建议把 Iris 提取结果落库作为风控、续约提醒、合规检查的数据底座。四、实战场景把合同智能体嵌进业务系统定时或事件触发用 REST 把新签合同批量摄取进 Agreement Manager。Iris 自动提取字段与义务结果写入 CRM / 数据中台。业务同学在 Copilot / Claude 里通过 MCP 直接问华东区还有哪些 NDA 本月到期智能体实时回答。协议状态变化通过 webhook 推回系统触发审批流或提醒。这种REST 做管道、MCP 做智能交互的分工兼顾批量处理的可靠性与按需查询的灵活性。五、踩坑与优秀实践不要把 MCP 当 REST 用能预先确定步骤的批量 / 定时任务优先 REST可控、可审计、易重试。鉴权别硬编码MCP token、REST client secret 从环境变量或密钥服务注入。优先 webhook 而非轮询状态变化实时感知轮询作兜底。权限收敛用 enabledTools 收敛智能体可调用的工具。可量化的收益参考DocuSign 公开披露的客户实践中一些效果数据值得关注均来自官方案例与第三方报告Deloitte 报告指出端到端协议平台中使用 AI 驱动工作流的企业投资回报相较未使用者高出近 30%。Experian 将合同周期从约 10 天缩短至数小时。Perceptyx 的 NDA 周转速度提升约 99%。Aon 在其协议平台迁移了超过 4 亿份文档。落地效果因流程成熟度而异建议试点阶段先度量自身基线再做对比。官方文档开始动手前建议先过一遍官方文档确认端点与当前 GA / Beta 状态DocuSign 开发者中心https://developers.docusign.comMCP Server 文档https://developers.docusign.comAgreement Manager API 文档https://developers.docusign.comDocuSign 官网https://www.docusign.com上海华万专注为企业提供SaaS产品的一站式选型与集成服务。国内产品线涵盖腾讯会议、企业微信、腾讯电子签等腾讯生态产品国际产品线包括Microsoft Teams、Zoom、DocuSign等协作与签约工具。从需求诊断、产品选型到系统部署、API集成与长期运维华万为企业量身定制落地路径覆盖售前咨询、方案设计、部署实施与售后服务全流程。目前已服务制造、零售、教育、金融等多个行业的中小企业客户。