Common Paper Contracts

Common Paper MCP 服务和 AI 插件

用通俗的英语，通过 AI 助手查询、创建和管理你在 Common Paper 中的合同。Common Paper 运行着一个远程 MCP 服务，可与任何 MCP 客户端配合使用，包括 GitHub Copilot、VS Code、Claude、Cursor 和 ChatGPT。

此仓库还将该服务打包为 Claude Cowork、Claude Code、Cursor、Grok Build 和 Gemini CLI 的插件。该插件包含两项内容：

• Common Paper MCP 连接器（https://api.commonpaper.com/mcp）。你通过 OAuth 使用 Common Paper 账户登录，因此无需复制或存储 API 密钥。
• Common Paper 技能，介绍 Common Paper 的运作方式：协议状态、封面页 + 标准条款模型、安全默认设置（每份协议都从草稿开始）、各类协议的模板参数、将合同文本移入自定义条款时不得改动文本的规则，以及面向新账户的引导流程。

对于连接器目前尚未覆盖的少数功能（按公司名称或结束日期筛选、将 Word 文件上传为自定义条款，以及创建全新账户），该技能会改用 Common Paper REST API。

你可以做什么

• 统计和搜索：“我们有多少份已签署的 NDA？”/“我们和 Acme 有合同吗？”
• 发送协议：“从 [email protected] 向 [email protected] 起草一份 NDA”（助手会创建草稿并显示链接，只有在你确认后才会发送）
• **管理协议：**作废、更换收件人、重新发送签名邮件、下载 PDF、获取可分享的链接
• 财务问题：“按交易金额计算，我们金额最大的 CSA 是哪份？”
• 续约：“哪些合同会在未来 90 天内到期？”
• 签署人：“谁签署了与 Microsoft 的交易？”
• **模板：**创建和更新 NDA、CSA、DPA、PSA、Partnership、BAA、LOI、Software License、Design Partner 和 Pilot 模板
• **自定义协议：**发布自定义条款并构建自定义封面页模板
• 入门设置：“设置我的 Common Paper 账户”会通过十个简短问题引导你完成设置，并创建一组入门模板

提示词示例

1. How many signed contracts do we have, and how many are still waiting on the other side?
2. Do we have an active NDA with Northwind? If not, draft one to [email protected] from me.
3. List every agreement that ends in the next 90 days as a table with counterparty, type, and end date.
4. Create a CSA template with Delaware law, a 1x fees liability cap, and net-30 annual invoicing.
5. Set up my Common Paper account.

与任何 MCP 客户端配合使用

• 服务 URL： https://api.commonpaper.com/mcp
• **传输方式：**Streamable HTTP
• **身份验证：**OAuth。支持动态客户端注册的客户端会自动连接，你只需使用 Common Paper 账户登录。无需 API 密钥。

VS Code 和 GitHub Copilot

将以下内容添加到 .vscode/mcp.json：

{
  "servers": {
    "common-paper": {
      "type": "http",
      "url": "https://api.commonpaper.com/mcp"
    }
  }
}

从文件或 MCP 服务列表启动服务，然后在提示时登录 Common Paper。

OpenAI Codex CLI

codex mcp add common-paper --url https://api.commonpaper.com/mcp
codex mcp login common-paper

第一条命令会将服务添加到 ~/.codex/config.toml。第二条命令会打开浏览器，供你登录 Common Paper。

其他助手（ChatGPT、Cursor、Notion、Perplexity 等）的设置方法请参阅将 Common Paper 连接到其他 AI 助手。

安装为插件

该插件在 MCP 服务之上添加了一项技能，包含 Common Paper 工作流和安全默认设置。

Claude Cowork

从插件目录安装 Common Paper，然后在提示时连接并登录 Common Paper。

Claude Code

使用 /plugin 从插件目录安装，或直接将此仓库添加为市场：

claude plugin marketplace add CommonPaper/ai-plugin
claude plugin install commonpaper@commonpaper

然后运行 /mcp，选择 common-paper，并登录 Common Paper。

Cursor

从 Cursor Marketplace 安装 Common Paper，或将此仓库添加到团队 Marketplace（Dashboard > Plugins & MCPs）。然后打开 Customize 页面，在 MCP 服务下找到 common-paper，并登录 Common Paper。

若要试用本地副本，请将此仓库克隆到 ~/.cursor/plugins/local/commonpaper。

Grok Build

将此仓库添加为 Marketplace 并安装插件。--trust 允许 Grok 附加捆绑的 Common Paper 连接器。

grok plugin marketplace add CommonPaper/ai-plugin
grok plugin install commonpaper --trust
grok plugin enable commonpaper

然后在 Grok 提示你连接 common-paper 时登录 Common Paper。

Gemini CLI

gemini extensions install https://github.com/CommonPaper/ai-plugin

然后在 Gemini CLI 中运行 /mcp auth common-paper 并登录 Common Paper。

从独立技能升级

如果你之前安装了 CommonPaper/claude-skill，安装插件后即可将其移除。如果插件需要用于 REST 回退的 API 密钥，它会自动将旧技能保存的密钥复制到 ~/.config/commonpaper/cp-api-token。

要求

• 一个 Common Paper 账户
• 任何支持 OAuth 的 MCP 客户端，或用于插件的 Claude Cowork、Claude Code、Cursor、Grok Build 或 Gemini CLI
• 仅用于 REST 回退：curl 和对 api.commonpaper.com 的网络访问。组织必须启用自定义条款和自定义模板，才能使用这些功能。

安全与隐私

• 服务使用 OAuth。你的助手会以已登录的 Common Paper 用户身份操作，并且只能查看该用户所在组织的信息。
• 使用插件时，助手会在执行任何发送电子邮件或更改已生效协议的操作（发送、作废、重新分配、重新发送、邀请）前征求确认，并默认将协议创建为草稿。
• 如果 REST 回退需要 API 密钥，插件会通过连接器为已登录用户生成密钥（或向你索要密钥），询问是否要为后续会话保留密钥，将其以仅所有者可访问的权限存储在 ~/.config/commonpaper/cp-api-token（若你选择不保留，则会在任务结束时删除），并且绝不会在聊天中打印密钥。
• 转入自定义条款的合同文本会逐字保留。助手会在写入后核验存储的文本，绝不会擅自“修正”拼写错误或标点。
• 隐私政策：https://commonpaper.com/privacy-policy/（问题请联系：[email protected]）

故障排除

问题	解决方法
Common Paper 工具未连接	Cowork：Customize > Connectors > Common Paper > Connect。Claude Code：运行 /mcp，选择 common-paper 并登录。Cursor：打开 Customize 页面，在 MCP 服务下找到 common-paper 并连接。Gemini CLI：运行 /mcp auth common-paper。Codex CLI：运行 codex mcp login common-paper。VS Code：从 .vscode/mcp.json 或 MCP 服务列表启动 common-paper。其他客户端：在客户端的 MCP 设置中连接 https://api.commonpaper.com/mcp。
找不到预期的协议	API 仅涵盖由你的组织发送的协议。不包括你从其他组织收到的协议。
新账户显示“You've reached your plan limit”	通常表示你的电子邮件地址尚未验证。请先完成验证，然后重试。
自定义条款或自定义模板返回 404	你的组织尚未启用此功能。请联系 Common Paper 支持。
REST 回退因网络错误而失败	你的环境无法直接访问 api.commonpaper.com。助手将回退到连接器支持的功能。
在大型账户中按公司名称搜索速度较慢	如果没有 REST 回退，助手必须逐页遍历协议。请允许访问 api.commonpaper.com，以便在服务端进行筛选。

支持

• 帮助中心：Common Paper 和大模型
• Bug 和功能请求：在此代码库中提交 issue
• 如果遇到账户或连接问题，请通过帮助中心联系 Common Paper 支持，并提供你正在使用的客户端名称和错误截图

仓库内容

.claude-plugin/plugin.json          Plugin manifest (Claude, Grok Build)
.claude-plugin/marketplace.json     Lets this repo be added as a marketplace (Claude)
.cursor-plugin/plugin.json          Plugin manifest (Cursor)
.cursor-plugin/marketplace.json     Lets this repo be added as a marketplace (Cursor)
.grok-plugin/marketplace.json       Lets this repo be added as a marketplace (Grok Build)
.mcp.json                           Common Paper MCP connector (Claude, Grok Build)
mcp.json                            Common Paper MCP connector (Cursor)
gemini-extension.json               Extension manifest and connector (Gemini CLI)
registry/server.json                MCP Registry entry (com.commonpaper/contracts)
skills/commonpaper/SKILL.md         Core skill
skills/commonpaper/references/      REST API, templates, custom terms, onboarding details

许可证

MIT