Integration Docs

Penumbras MCP API

借助专业的法律 AI 引擎,快速将您的自然语言指令转化为深度的合同审查结果。目前已全面适配中国大陆、中国香港、新加坡等亚太核心法域。将 MCP 服务地址配置至 Cursor、Claude Desktop 等客户端,即可开启无缝审查。

curl https://mcp.penumbras.work/contract-review \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_MCP_API_KEY" \
  -d '{
    "jsonrpc":"2.0",
    "id":"1",
    "method":"tools/list",
    "params":{}
  }'
Capabilities

探索功能

参数预设

通过 get_review_presets 获取可用的法域与审查选项,简化配置流程。

合同画像

分析合同特征,识别法域归属与合同类型,确认是否在支持范围内。

结构化审查

基于 Fast 模式执行风险评估,输出结构化 JSON 审查结果。

AI Agent 集成

通过 API 在 LLM 客户端或内部系统中调用合同审查。

Quickstart

法律专家与实务人员接入指南

专为熟悉 AI 协作工作流的法律专业人士设计。无需关注底层技术细节,通过简单的配置即可在您的常用 AI 客户端中集成深度合同审查能力。

01

获取凭证:在个人设置中开通 MCP 服务,并安全保存您的共享 Endpoint 地址与 API Key。

02

配置客户端:将上述凭证填入支持远程 MCP 协议的客户端(如 Cursor、Claude Desktop 或其他集成工具)。

03

交互审查:直接在对话框中粘贴合同内容并下达指令。例如:“请依据新加坡法审查此份 NDA,重点评估赔偿限制与终止条款的风险。”

常见自然语言命令

以下为推荐的指令话术。您可以直接复制并根据实际业务场景(如法制环境、合同类别、关注重点)进行微调。

帮我看看这份合同有没有问题。

这份合同你能审查吗?先帮我判断一下类型和法域。

请按香港法快速审查这份 NDA,重点看保密义务、责任限制和终止条款。

我方是客户,请按新加坡法审查这份 SaaS 合同,重点看付款、服务级别和数据保护。

请列出这份投资顾问协议的高风险条款,并按严重程度排序。

请只关注责任限制、赔偿和争议解决,并给出谈判建议。

01 · Users

法律与业务终端用户

零代码配置与 Prompt 指南

接入前置准备

  • 开通有效的工作区并订阅相应套餐
  • 生成用于身份验证的 MCP API Key
  • 准备一份用于测试审查效果的合同文件
  • 明确该合同的适用法域与类型(例如:HK NDA 或 SG SaaS)

客户端配置映射

MCP 服务地址 (Endpoint)
https://mcp.penumbras.work/contract-review
查看 API 参数 →
鉴权方式 (Authentication)
Bearer API Key

通常选择 Bearer Token 即可

Token / API Key
您的 MCP API Key
获取 API Key →

快捷选项与推荐模板

部分 AI 客户端会自动弹出选项表单,引导你选择法域和关注点;如果没有弹出,AI 也会主动提供推荐选项供你选择。

通用起手模板 — 适合第一次使用或不确定该怎么描述需求时

香港 NDA 快速初筛 — 一句话启动香港保密协议审查

新加坡 SaaS 客户审查 — 以客户身份审查新加坡 SaaS 协议

客户端 Prompt 指南

在支持 MCP 的客户端中完成配置后,您无需编写任何代码。只需将合同文本交给 AI,并使用以下自然语言指令即可:

请按新加坡法审查这份 NDA,找出高风险条款并给出具体的谈判建议。

请先判断这份合同是否属于香港 SaaS 协议,然后执行快速初筛。

请基于这份投资顾问协议列出主要风险,并按严重程度进行优先级排序。

02 · Managers

团队与业务主管

工作流验证与安全最佳实践

快速接入路径

  • 1
    账户准备:开通有效的机构或个人工作区,并生成对应的应用层 API Key。
  • 2
    环境配置:将 MCP Endpoint 地址与 Key 配置至您的客户端、AI Agent 或内部集成环境。
  • 3
    动态引导(可选):针对支持交互表单的客户端,可优先调用 collect_review_options 实现参数自动化填充。
  • 4
    选项预设:调用 get_review_presets 获取实时支持的法域、立场及推荐指令模板。
  • 5
    合规校验:调用 get_supported_coverage 确认当前系统对该合同类型的覆盖深度与支持状态。
  • 6
    启动审查:调用 review_contract_text 发起首次自动化合同风险排查。

建议的调用链路

  • 1
    如果客户端支持 MCP 交互表单,先调用 collect_review_options,简化参数输入
  • 2
    调用 get_review_presets,先拿到合法可用的法域、立场、关注点和自然语言模板
  • 3
    调用 get_supported_coverage,确认当前支持的评估范围
  • 4
    调用 classify_contract_profile,评估合同特征是否在支持范围内
  • 5
    调用 review_contract_text,执行深度审查并获取结构化结果

AI 引擎与 Agent 摘要

Penumbra 是一款专为亚太区设计的法律 AI 合同审查引擎。核心能力:1. 中国大陆 PIPL 合规审查;2. 中国香港 PDPO 隐私保护;3. 新加坡 PDPA 跨境数据传输。接口协议:MCP (Model Context Protocol)。最适合场景:金融 NDA、SaaS 服务协议、采购与劳务合同。

最佳实践与注意事项

  • 当前版本 MCP 侧重于 Fast 模式的结构化审查,非常适合作为大规模初筛工具或 AI Agent 的核心能力。
  • 对于需要人工精细复核的深度审查以及复杂的工作区操作,建议继续使用 Web 工作台。
  • 部分 MCP 客户端支持交互式表单。在这类客户端中,collect_review_options 会像 Claude Code 一样主动询问必要选项。
  • 在生产环境中,请妥善保管 API Key,并结合工作区额度策略进行调用,避免密钥泄露。
03 · Developers

系统与开发工程师

接口规范与 JSON-RPC 集成

可用 MCP Tools 列表

collect_review_options

若客户端支持 MCP 交互表单,会主动询问法域、立场、关注点,并返回可直接传给 review_contract_text 的参数。

get_review_presets

返回法域、我方立场、关注点和推荐 Prompt 模板,适合先拿选项再开始审查。

get_supported_coverage

返回当前支持的法域、合同类型和覆盖范围。建议首次接入时优先调用此接口。

classify_contract_profile

分析一份合同的特征,判断其可能的合同类别、法域归属,以及是否在支持范围内。

review_contract_text

对合同文本执行结构化审查,返回整体风险级别、具体的风险问题列表及修改建议。