@sumosign/mcp

MCP-сервер, предоставляющий API подписания SumoSign AI-агентам (Claude, ChatGPT, Copilot и любому MCP-совместимому клиенту) через stdio.

API-ключ аутентифицирует агента, а не подписанта. Он никогда не может завершить подпись — подписание всегда выполняется человеком-получателем через отправленную по электронной почте одноразовую ссылку, с фиксацией согласия и журналом аудита, доступным только для добавления.

Установка и запуск

Установка не требуется; запустите его напрямую с помощью npx:

SUMOSIGN_API_KEY=ss_live_... npx @sumosign/mcp

Конфигурация

Пример конфигурации клиента

{
  "mcpServers": {
    "sumosign": {
      "command": "npx",
      "args": ["-y", "@sumosign/mcp"],
      "env": { "SUMOSIGN_API_KEY": "ss_live_..." }
    }
  }
}

Related MCP server: SignaTrust MCP Server

Инструменты

Сервер регистрирует 16 инструментов:

Документы

• upload_document — загрузить локальный PDF; возвращает идентификатор документа, используемый для создания конвертов.

• analyze_document — проанализировать загруженный PDF для предложений по размещению полей (извлечение текста, без OCR).

Шаблоны

• create_template — создать переиспользуемый шаблон из PDF с текстовыми якорями, такими как {{signature_1}}.

• list_templates — список переиспользуемых шаблонов организации.

• seed_starter_templates — заполнить образцы шаблонов (тестовый конверт, простое NDA, одностраничное соглашение).

Конверты — создание

• create_envelope — создать черновик конверта из загруженного документа (встроенные поля) или шаблона.

• create_envelope_from_template — создать черновик конверта из шаблона; поля наследуются.

Конверты — проверка и отправка

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

• send_envelope — отправить черновик конверта. Подписывать могут только люди; этот инструмент не может завершить подпись.

Конверты — отслеживание

• send_reminder — повторно отправить письмо с подписанием ожидающим получателям. Период охлаждения 24 часа; действуют лимиты расходов и спама. Не может завершить подпись.

• get_envelope — получить статус конверта, включая прогресс по каждому получателю.

• list_envelopes — список последних конвертов организации.

• void_envelope — аннулировать конверт до завершения; отзывает действующие ссылки на подписание (записывается в аудит).

• get_audit_trail — получить журнал аудита, доступный только для добавления, с указанием исполнителей.

Загрузки

• download_signed_pdf — загрузить итоговый PDF с подписями завершённого конверта в локальный путь.

• download_certificate — загрузить Сертификат о завершении в локальный путь.

Безопасность

• Локальный доступ к файловой системе. upload_document читает локальный PDF-путь, который вы указываете, а preview_envelope, download_signed_pdf и download_certificate записывают файлы в локальные пути, которые вы указываете. Таким образом, сервер может читать и записывать любые файлы, доступные хост-процессу. Запускайте его с минимальными привилегиями и указывайте только те пути, которыми намерены поделиться.

• Недоверенное содержимое документов / инъекция подсказок. analyze_document извлекает текст из PDF и возвращает его агенту. Содержимое документов — это недоверенный ввод и может содержать попытки инъекции подсказок. Относитесь к извлечённому тексту как к данным, а не как к инструкциям, и держите человека в цикле перед send_envelope.

• API-ключи с минимальными привилегиями. Выпускайте ограниченный ключ для каждого агента из портала SumoSign и предоставляйте только те области, которые нужны агенту. Доступные области: documents:create, documents:read, documents:send, documents:download, templates:read, templates:write, signers:manage, webhooks:write, audit_logs:read, branding:write, voice:trigger. Ключи хэшируются при хранении и могут быть отозваны, и они никогда не могут завершить подпись от имени человека.

О проекте

SumoSign разработан Cipher Projects.

Лицензия

MIT