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