REST API SignNow позволяет пользователям обеспечить бесшовный процесс электронной подписи для подписантов, составителей и отправителей. Предварительно заполняйте документы, создавайте встроенные брендированные рабочие процессы для нескольких подписантов, запрашивайте платежи и отслеживайте статус подписи в режиме реального времени. Сделайте процесс подписания простым, безопасным и интуитивно понятным на любом устройстве.

Что можно делать с помощью API SignNow:

Отправлять документы и группы документов на подпись в порядке ролей
Создавать повторно используемые шаблоны из документов
Предварительно заполнять поля документов данными
Собирать платежи в рамках процесса подписания
Встраивать процесс отправки, подписания или редактирования документов в ваш веб-сайт, приложение или любую систему учета
Отслеживать прогресс подписания и загружать готовые документы

SignNow MCP Server

Name: SignNow MCP Server
Author: signnow

Сервер протокола контекста моделей (MCP), который предоставляет ИИ-агентам безопасный структурированный доступ к рабочим процессам электронной подписи SignNow — шаблонам, встроенному подписанию, приглашениям, отслеживанию статуса и загрузке документов — через STDIO или Streamable HTTP.

mcp-name: io.github.signnow/sn-mcp-server

Содержание

Related MCP server: Gmail MCP Server by CData

Возможности

Шаблоны и группы
- Просмотр всех шаблонов и групп шаблонов
- Создание документов или групп из шаблонов (включая одношаговые процессы)
Приглашения и встроенный UX
- Приглашения по электронной почте и упорядоченные получатели
- Ссылки на встроенное подписание/отправку/редактор для интеграции в приложения
Статус и получение
- Проверка статуса приглашения и деталей этапов
- Загрузка финальных документов (отдельно или объединенно)
- Чтение нормализованной структуры документа/группы для программных решений
Транспорты
- STDIO (лучше для локальных клиентов)
- Streamable HTTP (лучше для Docker/удаленных серверов)

Быстрый старт

Предварительные требования

Учетная запись SignNow. Создайте бесплатную учетную запись разработчика.
Учетные данные SignNow: Вам понадобятся email, пароль и базовый токен авторизации приложения. Начало работы.
Активное приложение API SignNow.
Python 3.11+ установлен в вашей системе (проверьте через python3 --version)
Установленный UVX (проверьте через uvx --version). Рекомендуется для максимально быстрой настройки.
Настроенные переменные окружения
Если ваш клиент поддерживает Streamable HTTP, вы можете использовать предварительно развернутый URL сервера https://mcp-server.signnow.com/mcp вместо локального запуска.

Быстрый запуск (uvx)

Если вы используете uv, вы можете запустить сервер без установки пакета:

uvx --from signnow-mcp-server sn-mcp serve

1. Настройка переменных окружения

# Create .env file with your SignNow credentials
# You can copy from env.example if you have the source code
# Or create .env file manually with required variables (see Environment Variables section below)

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

Вариант А: Установка из PyPI (рекомендуется)

# Install the package from PyPI
pip install signnow-mcp-server

# Run MCP server in standalone mode
sn-mcp serve

Вариант Б: Установка из исходного кода (разработка)

# 1) Clone & configure
git clone https://github.com/signnow/sn-mcp-server.git
cd sn-mcp-server
cp .env.example .env
# fill in your values in .env

# 2) Install (editable for dev)
pip install -e .

# 3) Run as STDIO MCP server (recommended for local tools & Inspector)
sn-mcp serve

STDIO идеально подходит для настольных клиентов и локального тестирования.

Локально/Удаленно (HTTP)

# Start HTTP server on 127.0.0.1:8000
sn-mcp http

# Custom host/port
sn-mcp http --host 0.0.0.0 --port 8000

# Dev reload
sn-mcp http --reload

По умолчанию конечная точка Streamable HTTP MCP обслуживается по адресу /mcp. Пример URL:

http://localhost:8000/mcp

Docker

# Build
docker build -t sn-mcp-server .

# Run HTTP mode (recommended for containers)
docker run --env-file .env -p 8000:8000 sn-mcp-server sn-mcp http --host 0.0.0.0 --port 8000

STDIO внутри контейнеров ненадежен для многих клиентов. При использовании Docker отдавайте предпочтение HTTP.

Docker Compose

# Only the MCP server
docker-compose up sn-mcp-server

# Both services (if defined)
docker-compose up

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

Скопируйте .env.example → .env и заполните значения. Все настройки проверяются через pydantic-settings при запуске.

Варианты аутентификации

1) Имя пользователя / Пароль (рекомендуется для разработки на десктопе)

SIGNNOW_USER_EMAIL=<email>
SIGNNOW_PASSWORD=<password>
SIGNNOW_API_BASIC_TOKEN=<base64 basic token>

2) OAuth 2.0 (для хостинговых/продвинутых сценариев)

SIGNNOW_CLIENT_ID=<client_id>
SIGNNOW_CLIENT_SECRET=<client_secret>
# + OAuth server & RSA settings below

При работе через некоторые настольные клиенты может поддерживаться только имя пользователя/пароль.

Настройки SignNow и OAuth

# SignNow endpoints (defaults shown)
SIGNNOW_APP_BASE=https://app.signnow.com
SIGNNOW_API_BASE=https://api.signnow.com

# Optional direct API token (not required for normal use)
SIGNNOW_TOKEN=<access_token>

# OAuth server (if you enable OAuth mode)
OAUTH_ISSUER=<your_issuer_url>
ACCESS_TTL=3600
REFRESH_TTL=2592000
ALLOWED_REDIRECTS=<comma,separated,uris>

# RSA keys for OAuth (critical in production)
OAUTH_RSA_PRIVATE_PEM=<PEM content>
OAUTH_JWK_KID=<key id>

Управление производственными ключами

Если OAUTH_RSA_PRIVATE_PEM отсутствует в продакшене, при каждом перезапуске будет генерироваться новый ключ RSA, что аннулирует все существующие токены. Всегда предоставляйте постоянный закрытый ключ через управление секретами в продакшене.

Настройка клиента

VS Code — GitHub Copilot (режим агента) / Cursor

Создайте .vscode/mcp.json / .cursor/mcp.json в вашем рабочем пространстве:

STDIO (локально):

{
  "servers": {
    "signnow": {
      "command": "sn-mcp",
      "args": ["serve"],
      "env": {
        "SIGNNOW_USER_EMAIL": "${env:SIGNNOW_USER_EMAIL}",
        "SIGNNOW_PASSWORD": "${env:SIGNNOW_PASSWORD}",
        "SIGNNOW_API_BASIC_TOKEN": "${env:SIGNNOW_API_BASIC_TOKEN}"
      }
    }
  }
}

STDIO (uvx — без локальной установки):

{
  "servers": {
    "signnow": {
      "command": "uvx",
      "args": ["--from", "signnow-mcp-server", "sn-mcp", "serve"],
      "env": {
        "SIGNNOW_USER_EMAIL": "${env:SIGNNOW_USER_EMAIL}",
        "SIGNNOW_PASSWORD": "${env:SIGNNOW_PASSWORD}",
        "SIGNNOW_API_BASIC_TOKEN": "${env:SIGNNOW_API_BASIC_TOKEN}"
      }
    }
  }
}

HTTP (удаленно или Docker):

{
  "servers": {
    "signnow": {
      "type": "http",
      "url": "http://localhost:8000/mcp"
    }
  }
}

Затем откройте чат → режим агента, включите инструменты signnow и используйте их в запросах.

Примечание: Та же конфигурация применяется в Cursor — добавьте ее в настройках MCP (STDIO или HTTP). Для STDIO вы также можете использовать uvx, как показано выше.

Claude Desktop

Используйте расширения для рабочего стола или ручную настройку MCP (Developer → Edit config).

Шаги:

Откройте Claude Desktop → Developer → Edit config
Добавьте новую запись сервера в mcpServers
Сохраните и перезапустите Claude Desktop

Примеры:

STDIO (локальная установка):

{
  "mcpServers": {
    "signnow": {
      "command": "sn-mcp",
      "args": ["serve"],
      "env": {
        "SIGNNOW_USER_EMAIL": "${env:SIGNNOW_USER_EMAIL}",
        "SIGNNOW_PASSWORD": "${env:SIGNNOW_PASSWORD}",
        "SIGNNOW_API_BASIC_TOKEN": "${env:SIGNNOW_API_BASIC_TOKEN}"
      }
    }
  }
}

STDIO (uvx — без локальной установки):

{
  "mcpServers": {
    "signnow": {
      "command": "uvx",
      "args": ["--from", "signnow-mcp-server", "sn-mcp", "serve"],
      "env": {
        "SIGNNOW_USER_EMAIL": "${env:SIGNNOW_USER_EMAIL}",
        "SIGNNOW_PASSWORD": "${env:SIGNNOW_PASSWORD}",
        "SIGNNOW_API_BASIC_TOKEN": "${env:SIGNNOW_API_BASIC_TOKEN}"
      }
    }
  }
}

HTTP (удаленно или Docker):

{
  "mcpServers": {
    "signnow": {
      "type": "http",
      "url": "http://localhost:8000/mcp"
    }
  }
}

Затем включите сервер в чате Claude и начните использовать инструменты.

Glama (хостинговый MCP)

Разверните и запустите этот сервер на Glama с минимальной настройкой:

Шаги:

Откройте страницу сервера на Glama: sn-mcp-server on Glama
Нажмите красную кнопку "Deploy Server"
В переменных окружения укажите:
- SIGNNOW_USER_EMAIL
- SIGNNOW_PASSWORD
- SIGNNOW_API_BASIC_TOKEN
- (другие переменные можно оставить по умолчанию)
Создайте токен доступа в Glama и скопируйте URL конечной точки. Он будет выглядеть так:

https://glama.ai/endpoints/{someId}/mcp?token={glama-mcp-token}

Используйте этот URL HTTP MCP в любом клиенте, поддерживающем транспорт HTTP (например, конфигурация JSON в VS Code/Cursor или пример HTTP для Claude Desktop выше).

MCP Inspector (тестирование)

Отлично подходит для визуального изучения инструментов и схем.

# Start Inspector (opens UI on localhost)
npx @modelcontextprotocol/inspector

# Connect (STDIO): run your server locally and attach
sn-mcp serve

# Or connect (HTTP): use http://localhost:8000/mcp

Вы можете перечислять инструменты, вызывать их с аргументами JSON и проверять ответы.

Инструменты

Каждый инструмент описан кратко; используйте MCP-клиент (например, Inspector) для просмотра точных схем JSON.

list_all_templates — Список шаблонов и групп шаблонов с упрощенными метаданными. Поддерживает пагинацию limit/offset (по умолчанию: 50 элементов на страницу).
list_documents — Просмотр ваших документов, групп документов и их статусов. Поддерживает пагинацию limit/offset (по умолчанию: 50 элементов на страницу).
create_from_template — Создание документа или группы из шаблона/группы.
send_invite — Приглашения по электронной почте (документы или группы), поддерживаются упорядоченные получатели.
create_embedded_invite — Сессия встроенного подписания без отправки по электронной почте.
create_embedded_sending — Встроенный опыт "отправки/управления".
create_embedded_editor — Ссылка на встроенный редактор для размещения/настройки полей.
send_invite_from_template — Одношаговый процесс: создание из шаблона и приглашение.
create_embedded_sending_from_template — Одношаговый процесс: шаблон → встроенная отправка.
create_embedded_editor_from_template — Одношаговый процесс: шаблон → встроенный редактор.
create_embedded_invite_from_template — Одношаговый процесс: шаблон → встроенное подписание.
get_invite_status — Текущий статус приглашения/этапы для документа или группы.
get_document_download_link — Прямая ссылка на скачивание (объединенный вывод для групп).
get_signing_link — Получение ссылки на подписание для документа или группы документов.
get_document — Нормализованная структура документа/группы со значениями полей.
update_document_fields — Предварительное заполнение текстовых полей в отдельных документах.
upload_document — Загрузка документа из локального пути (file_path), публичного URL (file_url) или вложения ресурса MCP (resource_uri). Для file_path разрешенный путь должен оставаться внутри настроенной безопасной базовой директории (по умолчанию — домашняя директория пользователя); пути вне этой базы не проходят проверку. Поддерживаются: PDF, DOC, DOCX, PNG, JPG, JPEG. Макс. 40 МБ. Возвращает document_id, filename, source.
send_invite_reminder — Отправка напоминания о подписании ожидающим подписантам документа или группы документов.
signnow_skills — Запрос к библиотеке навыков SignNow. Опустите skill_name, чтобы перечислить все доступные навыки с описаниями; укажите skill_name (например, signnow101), чтобы получить полный текст в формате Markdown. Используйте signnow101, чтобы узнать типы сущностей SignNow, типы приглашений и сопоставления инструментов.
- Пример режима списка: {"skills": [{"name": "signnow101", "description": "Справочник концепций SignNow 101... (описание сокращено для краткости)"}]}
- Пример режима получения: {"name": "signnow101", "body": "# SignNow 101 — Справочник концепций\n..."}

Совет: Начните с signnow_skills (без аргументов), чтобы узнать доступные навыки, затем list_all_templates → create_from_template → create_embedded_* / send_invite, затем get_invite_status и get_document_download_link.

FAQ / советы

STDIO или Docker? Предпочитайте STDIO для локальной разработки; внутри Docker используйте HTTP.
Песочница или продакшн? Начните с учетных данных песочницы/разработчика SignNow; для продакшена требуется правильный OAuth и постоянный закрытый ключ RSA.
Где увидеть точные схемы инструментов? Используйте MCP Inspector или представление "сведения об инструменте" в вашем клиенте.
Где примеры? См. examples/ в этом репозитории для стартовых интеграций.

Примеры

Директория examples/ содержит рабочие примеры того, как интегрировать SignNow MCP Server с популярными фреймворками ИИ-агентов:

LangChain - Интеграция с агентами LangChain с использованием langchain-mcp-adapters
LlamaIndex - Интеграция с агентами LlamaIndex с использованием llama-index-tools-mcp
SmolAgents - Интеграция с фреймворком SmolAgents с использованием нативной поддержки MCP

Каждый пример демонстрирует, как:

Запустить сервер MCP как подпроцесс
Преобразовать инструменты MCP в форматы инструментов, специфичные для фреймворка
Создать агентов, которые могут использовать функциональность SignNow
Настроить переменные окружения

Чтобы запустить пример:

# Make sure you have the required dependencies installed
pip install langchain-openai langchain-mcp-adapters  # for LangChain example
pip install llama-index-tools-mcp                   # for LlamaIndex example  
pip install smolagents                              # for SmolAgents example

# Set up your .env file with SignNow credentials and LLM configuration
# Then run the example
python examples/langchain/langchain_example.py
python examples/llamaindex/llamaindex_example.py
python examples/smolagents/stdio_demo.py

Полезные ресурсы

Примеры приложений

Изучите готовые к использованию примеры приложений, чтобы быстро протестировать подготовку, подписание и отправку документов из вашего ПО с помощью API SignNow.

Попробуйте примеры приложений.

Документация API

Найдите технические детали запросов API SignNow, параметры, примеры кода и возможные ошибки. Узнайте больше о функциональности API в подробных руководствах и сценариях использования.

Прочитайте документацию API.

SignNow API Helper MCP

Подключите ваш ИИ для доступа к документации API, генерации кода для сложных рабочих процессов подписания и автоматического устранения ошибок интеграции. [Доступ к API Helper MCP](https://github

SignNow MCP Server

SignNow MCP Server

Содержание

Возможности

Быстрый старт

Предварительные требования

Быстрый запуск (uvx)

1. Настройка переменных окружения

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

Вариант А: Установка из PyPI (рекомендуется)

Вариант Б: Установка из исходного кода (разработка)

Локально/Удаленно (HTTP)

Docker

Docker Compose

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

Варианты аутентификации

Настройки SignNow и OAuth

Управление производственными ключами

Настройка клиента

VS Code — GitHub Copilot (режим агента) / Cursor

Claude Desktop

Glama (хостинговый MCP)

MCP Inspector (тестирование)

Инструменты

FAQ / советы

Примеры

Полезные ресурсы

Примеры приложений

Документация API

SignNow API Helper MCP

Resources

Tools

Latest Blog Posts

MCP directory API