合同AI MCP 与 Skills 使用

腾讯电子签提供了合同AI智能能力，支持通过 MCP Server 和 Skills 两种方式接入 AI 工具（如 CodeBuddy、WorkBuddy 等），实现合同审查、合同对比等智能操作。

一、合同AI MCP

简介

MCP Server（Model Context Protocol Server）是腾讯电子签提供的 API 服务网关，将电子签 API 注册为 MCP 工具，使支持 MCP 协议的 AI 客户端能够直接调用接口。通过 MCP，您可以在 CodeBuddy、WorkBuddy 等工具中使用自然语言完成合同AI相关操作。

MCP Server 的完整部署与使用说明请参考：腾讯电子签 MCP Server 使用指南

合同AI接口配置

在使用 MCP Server 调用合同AI能力时，需要在 config.yaml 配置文件的 api.loading_apis 中增加以下合同AI相关接口：

api:
  service: ess
  loading_apis:
    # 文件上传
    - UploadFiles
    # 合同审查
    - CreateBatchContractReviewTask
    - DescribeContractReviewTask
    - DescribeEnterpriseContractReviewChecklists
    - ExportContractReviewResult
    - CreateContractReviewWebUrl
    - DescribeContractReviewWebUrl

    # 信息提取
    - CreateBatchInformationExtractionTask
    - DescribeInformationExtractionTask
    - CreateInformationExtractionWebUrl
    - DescribeInformationExtractionWebUrl
    - CreateLMInformationExtractionTaskFieldFeedback
    - DescribeLMInformationExtractionTaskFieldFeedback

    # 合同对比
    - CreateContractComparisonTask
    - DescribeContractComparisonTask
    - ExportContractComparisonTask
    - CreateContractDiffTaskWebUrl
    - DescribeContractDiffTaskWebUrl

    # 风险识别反馈
    - CreateRiskIdentificationTaskFeedback
    - DescribeRiskIdentificationTaskFeedback

提示

建议仅按需加载所需接口，避免加载过多导致 Token 消耗过大或触发 "TOO LARGE" 错误。
如果仅需合同审查能力，可只配置审查相关接口；如果仅需合同对比，可只配置对比相关接口。

在codebuddy配置 mcp

使用示例

配置完成后，即可在 AI 工具中通过自然语言使用合同AI能力，例如：

合同审查："帮我审查这份合同，文件路径是 /path/to/contract.pdf"
合同对比："帮我对比这两份合同的差异，原版是 old.pdf，新版是 new.pdf"
信息提取："帮我提取这份合同中的关键信息"
查看审查清单："查看企业已配置的合同审查清单"

mcp使用效果：点击查看

二、Skills 方式使用合同AI

简介

Skills 是腾讯电子签提供的另一种 AI 集成方式，以 Skill 包的形式为 AI Agent（如 CodeBuddy、Claude Code）提供合同审查、合同对比等能力。相比 MCP，Skills 提供了更高层级的封装，可以通过简单的对话指令一键完成端到端的合同智能操作。

项目仓库：github.com/tencentess/ess-skills

Skills 列表

Skill	说明	适用场景
contract-review	合同审查工作流：上传 PDF → AI 风险识别 → 输出风险报告	一键完成端到端合同审查
contract-comparison	合同对比工作流：上传两份文件 → 差异分析 → 输出对比报告	支持 PDF、Word 等格式对比
contract-atoms	7 个原子操作命令	需要精细控制流程的场景

安装

CodeBuddy 安装

bash toolkit/install.sh --tool=codebuddy

Claude Code 安装

bash toolkit/install.sh --tool=claude

默认安装到当前项目目录，加 --target=personal 安装到个人全局目录。

远程一键安装（无需克隆仓库）

macOS / Linux：

curl -fsSL https://raw.githubusercontent.com/tencentess/ess-skills/main/toolkit/install-remote.sh | bash

Windows (PowerShell)：

irm https://raw.githubusercontent.com/tencentess/ess-skills/main/toolkit/install-remote.ps1 -OutFile install-remote.ps1; powershell -ExecutionPolicy Bypass -File .\install-remote.ps1

指定参数安装：

powershell -ExecutionPolicy Bypass -File .\install-remote.ps1 -Tool claude -Target personal

也可以在agent对话中直接安装：

凭证配置

使用 Skills 前需要配置腾讯电子签凭证，共需三个参数：

参数	说明	获取方式
`secret_id`	腾讯云 API 密钥 SecretId	前往腾讯云 API 密钥管理创建或查看
`secret_key`	腾讯云 API 密钥 SecretKey	同上，与 SecretId 成对获取
`user_id`	经办人/操作人编号 (UserId)	登录电子签控制台 → 组织管理 → 组织架构，查询员工 UserId

密钥安全提示：SecretId / SecretKey 是企业身份凭证，请妥善保管，切勿泄露或提交到代码仓库。
详细说明：密钥获取 | UserId 获取

方式一：配置文件（推荐）

macOS / Linux：

mkdir -p ~/.tsign && cat > ~/.tsign/config.yaml << 'EOF'
credentials:
  secret_id: "AKIDxxxxxxxx"
  secret_key: "xxxxxxxx"
operator:
  user_id: "yDwJxxx"
env: "online"
EOF

Windows (PowerShell)：

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.tsign" | Out-Null
@"
credentials:
  secret_id: "AKIDxxxxxxxx"
  secret_key: "xxxxxxxx"
operator:
  user_id: "yDwJxxx"
env: "online"
"@ | Set-Content "$env:USERPROFILE\.tsign\config.yaml" -Encoding UTF8

更多配置方式参考：环境变量方式

运行命令时若未检测到凭证，会自动引导创建。

合同审查（contract-review）

一键完成合同审查的全流程：上传 PDF → 创建审查任务 → 等待 AI 分析 → 获取风险报告。

使用方式：

在 AI 助手中直接对话即可，例如：

"帮我审查这份合同 /path/to/contract.pdf"
"用严格模式审查合同"

注意

合同审查为长耗时任务（通常 1~10 分钟），请耐心等待，不要中途取消。

合同对比（contract-comparison）

一键完成合同对比的全流程：上传两份文件 → 差异分析 → 输出对比报告，支持 PDF、Word 等格式。

使用方式：

在 AI 助手中直接对话即可，例如：

"帮我对比这两份合同 old.pdf 和 new.pdf"
"对比合同差异并导出 PDF 报告"

注意

合同对比为长耗时任务（通常 1~10 分钟），请耐心等待，不要中途取消。

原子操作（contract-atoms）

当您需要对合同审查或对比流程进行精细控制时，可以使用原子操作命令。

审查相关命令

命令	说明	关键参数
`review-create`	创建审查任务	`--resource-ids`（必填）、`--policy-type`、`--checklist-id`
`review-query`	查询审查结果	`--task-id`（必填）
`review-export`	导出审查结果	`--task-id`（必填）、`--file-type`（1=批注文件，2=Excel）
`review-checklists`	查看企业审查清单	无需参数

对比相关命令

命令	说明	关键参数
`compare-create`	创建对比任务	`--origin-file-id`（必填）、`--diff-file-id`（必填）
`compare-query`	查询对比结果	`--task-id`（必填）
`compare-export`	导出对比报告	`--task-id`（必填）、`--export-type`（0=PDF，1=Excel）

一、合同AI MCP​

简介​

合同AI接口配置​

使用示例​

二、Skills 方式使用合同AI​

简介​

Skills 列表​

安装​

CodeBuddy 安装​

Claude Code 安装​

远程一键安装（无需克隆仓库）​

凭证配置​

方式一：配置文件（推荐）​

合同审查（contract-review）​

合同对比（contract-comparison）​

原子操作（contract-atoms）​

审查相关命令​

对比相关命令​

效果演示​