@signforge/mcp-server

Отправляйте документы на электронную подпись напрямую из Claude Desktop, Claude Code, Cursor и других ИИ-агентов — на базе SignForge, бесплатной платформы для электронной подписи.

Что это делает

Этот MCP-сервер подключает ИИ-агентов к API электронной подписи SignForge. Ваш ИИ-ассистент может:

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

• Управлять конвертами — отправлять, аннулировать, удалять и проверять статус

• Скачивать документы — подписанные PDF, сертификаты аудита и ZIP-архивы

• Использовать шаблоны — создавать конверты из многоразовых шаблонов с предварительно заполненными полями

• Управлять вебхуками — подписываться на события конвертов в реальном времени

• Генерировать URL для встраивания — создавать встраиваемые интерфейсы для подписания

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

1. Получите ваш API-ключ

Зарегистрируйтесь на signforge.io и создайте API-ключ в разделе Developer Settings.

2. Настройте ваш ИИ-клиент

Выберите ваш клиент ниже и добавьте конфигурацию:

Claude Desktop

Добавьте в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "signforge": {
      "command": "npx",
      "args": ["-y", "@signforge/mcp-server"],
      "env": {
        "SIGNFORGE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Расположение файла конфигурации:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Code

claude mcp add signforge -- npx -y @signforge/mcp-server

Затем установите переменную окружения в вашем терминале:

export SIGNFORGE_API_KEY="your-api-key-here"

Cursor

Добавьте в настройки MCP Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "signforge": {
      "command": "npx",
      "args": ["-y", "@signforge/mcp-server"],
      "env": {
        "SIGNFORGE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Напрямую (npx)

SIGNFORGE_API_KEY="your-api-key-here" npx -y @signforge/mcp-server

3. Перезапустите ваш клиент

Перезапустите Claude Desktop, Claude Code или Cursor, чтобы подключить новый MCP-сервер.

Инструменты

Управление конвертами

Скачивание документов

Встраиваемое подписание

Шаблоны

Вебхуки

Примеры диалогов

Отправка документа на подпись

You: Send my NDA at ~/Documents/nda.pdf to jane@example.com (Jane Smith) for signature.

AI: I'll send that NDA for signature now.

[Uses create_and_send tool]

Done! I've created and sent the envelope:
- Envelope ID: a1b2c3d4-...
- Status: sent
- Jane Smith (jane@example.com) will receive a signing link via email.

Проверка статуса и скачивание

You: Has Jane signed the NDA yet?

AI: Let me check.

[Uses check_status tool]

Yes! Jane signed it on April 7 at 2:15 PM. The envelope is now completed.

You: Great, download the signed copy and the audit certificate.

[Uses download_signed tool]
[Uses download_certificate tool]

Done! Files saved:
- Signed PDF: ~/Documents/nda-signed.pdf
- Audit Certificate: ~/Documents/nda-certificate.pdf

Использование шаблона с предварительно заполненными полями

You: Send our standard consulting agreement to bob@acme.com.
     Pre-fill the company name as "Acme Corp" and the start date as "May 1, 2026".

AI: I'll create that from your consulting agreement template.

[Uses list_templates tool — finds "Consulting Agreement" template]
[Uses create_from_template tool — with prefill_fields and send_immediately: true]

Done! Envelope created and sent:
- Title: Consulting Agreement
- Recipient: bob@acme.com
- Pre-filled: company = "Acme Corp", start_date = "May 1, 2026"
- Status: sent

Управление жизненным циклом конверта

You: List my sent envelopes.

[Uses list_envelopes tool with status: "sent"]

You: Void the contract for Project Alpha — the deal fell through.

[Uses void_envelope tool with reason]

You: Now delete it.

[Uses delete_envelope tool]

Done — envelope voided and deleted.

Настройка вебхука

You: Set up a webhook to notify my server when documents are signed or completed.

[Uses create_webhook tool]

Webhook created:
- URL: https://api.yourapp.com/webhooks/signforge
- Events: envelope.signed, envelope.completed
- Secret: whsec_abc123... (save this for signature verification!)

Переменные окружения

Режим песочницы (Sandbox)

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

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

"SIGNFORGE_API_KEY environment variable is required" Убедитесь, что вы установили SIGNFORGE_API_KEY в конфигурации вашего MCP-клиента. См. инструкции по настройке выше.

"SignForge API error (401)" Ваш API-ключ недействителен или истек. Создайте новый на signforge.io/dashboard/developers.

"SignForge API error (403)" У вашего API-ключа нет прав на эту операцию. Проверьте области доступа (scopes) вашего ключа.

"SignForge API error (429)" Вы достигли лимита запросов. Подождите немного и попробуйте снова.

Сервер не отображается в Claude Desktop

1. Убедитесь, что JSON конфигурации валиден (нет лишних запятых)

2. Полностью перезапустите Claude Desktop (выйти + открыть снова)

3. Проверьте логи MCP-сервера в консоли разработчика Claude Desktop

Ссылки

• SignForge — Бесплатная платформа для электронной подписи

• API Documentation — Полная документация API

• GitHub — Исходный код

• MCP Protocol — Спецификация протокола Model Context Protocol

Лицензия

MIT