API ВЕГА
English

MCP-сервер Common Paper и плагины для AI

Запрашивайте информацию о договорах в Common Paper, создавайте и управляйте ими с помощью AI-ассистента на обычном английском языке. 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: статусы договоров, модель Cover Page + Standard Terms, безопасные настройки по умолчанию (каждый договор сначала создаётся как черновик), параметры шаблонов для каждого типа договора, правила переноса текста договора в пользовательские условия без изменений, а также пошаговый процесс настройки новых учётных записей.

Для некоторых функций, которые пока не поддерживает коннектор (фильтрация по названию компании или дате окончания, загрузка файлов Word в качестве пользовательских условий и создание новой учётной записи), навык использует REST API Common Paper.

Что можно делать

  • Подсчитывать и искать: «Сколько у нас подписанных NDA?» / «Есть ли у нас договор с Acme?»

  • Отправлять договоры: «Создай черновик NDA для jane@example.com от имени ben@company.com» (ассистент создаст черновик и покажет ссылку, а отправит документ только после вашего подтверждения)

  • Управлять договорами: аннулировать договор, переназначить получателя, повторно отправить письмо для подписания, скачать PDF, получить ссылку для совместного доступа

  • Задавать вопросы о финансах: «Какой CSA у нас самый крупный по сумме сделки?»

  • Отслеживать продление: «Срок действия каких договоров истекает в ближайшие 90 дней?»

  • Уточнять сведения о подписантах: «Кто подписал договор с Microsoft?»

  • Работать с шаблонами: создавать и обновлять шаблоны NDA, CSA, DPA, PSA, Partnership, BAA, LOI, Software License, Design Partner и Pilot

  • Создавать пользовательские договоры: публиковать пользовательские условия и создавать пользовательские шаблоны титульных страниц

  • Настраивать учётную запись: команда «Настрой мою учётную запись Common Paper» проведёт вас через десять коротких вопросов и создаст начальный набор шаблонов

Примеры запросов

  • Сколько у нас подписанных договоров и сколько ещё ждут ответа другой стороны?

  • Есть ли у нас действующий NDA с Northwind? Если нет, создай его для sam@northwind.com от моего имени.

  • Выведи в виде таблицы все договоры, срок действия которых заканчивается в ближайшие 90 дней. Укажи контрагента, тип и дату окончания.

  • Создай шаблон CSA с правом штата Делавэр, лимитом ответственности в размере 1x от суммы вознаграждения и ежегодной оплатой с отсрочкой 30 дней.

  • Настрой мою учётную запись Common Paper.

Использование с любым 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 или напрямую добавьте этот репозиторий как marketplace:

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

Затем выполните команду /mcp, выберите common-paper и войдите в Common Paper.

Cursor

Установите Common Paper из Cursor Marketplace или добавьте этот репозиторий в командный marketplace (Dashboard > Plugins & MCPs). Затем откройте страницу Customize, найдите common-paper в разделе MCP servers и войдите в 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

Затем войдите в Common Paper, когда Grok предложит подключить common-paper.

Gemini CLI

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

Затем выполните в Gemini CLI команду /mcp auth common-paper и войдите в Common Paper.

Переход с отдельного навыка

Если вы ранее установили CommonPaper/claude-skill, после установки плагина его можно удалить. Если плагину понадобится API-ключ для резервного обращения к REST API, он автоматически скопирует ключ, сохранённый старым навыком, в ~/.config/commonpaper/cp-api-token.

Требования

  • Учётная запись Common Paper

  • Любой MCP-клиент с поддержкой OAuth или, для использования плагина, Claude Cowork, Claude Code, Cursor, Grok Build либо Gemini CLI

  • Только для резервного обращения к REST API: curl и доступ к сети для подключения к api.commonpaper.com. Чтобы пользоваться пользовательскими условиями и шаблонами, эти функции должны быть включены для вашей организации.

Безопасность и конфиденциальность

  • Сервер использует OAuth. Ассистент действует от имени вошедшего пользователя Common Paper и имеет доступ только к данным его организации.

  • При использовании плагина ассистент запрашивает подтверждение перед отправкой писем и изменением действующих договоров (отправкой, аннулированием, переназначением, повторной отправкой или приглашением). По умолчанию договоры создаются как черновики.

  • Если для резервного обращения к REST API понадобится API-ключ, плагин создаст его для вошедшего пользователя с помощью коннектора (или попросит вас предоставить ключ), уточнит, нужно ли сохранить его для будущих сеансов, и запишет в ~/.config/commonpaper/cp-api-token, установив разрешения только для владельца. Если вы решите не сохранять ключ, плагин удалит его по завершении задачи. Ключ никогда не отображается в чате.

  • Текст договора, перенесённый в пользовательские условия, сохраняется посимвольно. После записи ассистент проверяет сохранённый текст и не исправляет опечатки или пунктуацию самостоятельно.

  • Политика конфиденциальности: https://commonpaper.com/privacy-policy/ (вопросы: privacy@commonpaper.com)

Устранение неполадок

ПроблемаРешение
Инструменты Common Paper не подключеныCowork: Customize > Connectors > Common Paper > Connect. Claude Code: выполните /mcp, выберите common-paper и войдите. Cursor: откройте страницу Customize, найдите common-paper в разделе MCP servers и подключитесь. Gemini CLI: выполните /mcp auth common-paper. Codex CLI: выполните codex mcp login common-paper. VS Code: запустите common-paper из .vscode/mcp.json или списка MCP-серверов. Другие клиенты: подключите https://api.commonpaper.com/mcp в настройках MCP-клиента.
Не найден ожидаемый договорAPI предоставляет доступ только к договорам, отправленным вашей организацией. Договоры, полученные от другой организации, не включены.
На новой учётной записи появилось сообщение «You've reached your plan limit»Обычно это означает, что адрес электронной почты ещё не подтверждён. Подтвердите его и повторите попытку.
Ошибка 404 при работе с пользовательскими условиями или шаблонамиЭта функция не включена для вашей организации. Обратитесь в службу поддержки Common Paper.
При резервном обращении к REST API возникает сетевая ошибкаВаша среда не может напрямую подключиться к api.commonpaper.com. В этом случае ассистент использует функции, поддерживаемые коннектором.
Поиск по названию компании в большой учётной записи выполняется медленноБез резервного обращения к REST API ассистенту приходится перебирать договоры постранично. Разрешите сетевой доступ к api.commonpaper.com, чтобы фильтрация выполнялась на сервере.

Поддержка

  • Справочный центр: Common Paper и LLM

  • Сообщения об ошибках и запросы на новые функции: создайте 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