@signforge/mcp-server

Senden Sie Dokumente direkt von Claude Desktop, Claude Code, Cursor und anderen KI-Agenten zur elektronischen Signatur – unterstützt durch SignForge, die kostenlose Plattform für elektronische Signaturen.

Funktionsweise

Dieser MCP-Server verbindet KI-Agenten mit der E-Signatur-API von SignForge. Ihr KI-Assistent kann:

Dokumente zur Signatur senden — ein PDF hochladen, einen Unterzeichner angeben und in einem Schritt versenden
Umschläge verwalten — senden, stornieren, löschen und den Status überprüfen
Dokumente herunterladen — signierte PDFs, Prüfzertifikate und ZIP-Archive
Vorlagen verwenden — Umschläge aus wiederverwendbaren Vorlagen mit vorausgefüllten Feldern erstellen
Webhooks verwalten — Echtzeit-Ereignisse für Umschläge abonnieren
Einbettungs-URLs generieren — einbettbare Signaturerlebnisse erstellen

Schnellstart

1. API-Schlüssel abrufen

Registrieren Sie sich unter signforge.io und generieren Sie einen API-Schlüssel in Ihren Entwicklereinstellungen.

2. KI-Client konfigurieren

Wählen Sie unten Ihren Client aus und fügen Sie die Konfiguration hinzu:

Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

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

Speicherort der Konfigurationsdatei:

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

Setzen Sie dann die Umgebungsvariable in Ihrer Shell:

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

Cursor

Fügen Sie dies zu Ihren Cursor-MCP-Einstellungen (.cursor/mcp.json) hinzu:

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

Direkt (npx)

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

3. Client neu starten

Starten Sie Claude Desktop, Claude Code oder Cursor neu, um den neuen MCP-Server zu laden.

Tools

Umschlagverwaltung

Tool	Beschreibung
`create_and_send`	Lädt ein PDF hoch, fügt einen Unterzeichner hinzu und sendet es zur E-Signatur. Akzeptiert einen lokalen Dateipfad oder ein base64-kodiertes PDF.
`check_status`	Überprüft den Status eines Umschlags – zeigt den Signaturfortschritt, Zeitstempel und verfügbare Dokumente an.
`list_envelopes`	Listet Ihre Umschläge mit optionaler Statusfilterung auf (`draft`, `sent`, `completed`, `voided`, `expired`).
`send_envelope`	Sendet einen Umschlagentwurf zur Signatur.
`void_envelope`	Storniert einen aktiven Umschlag mit einem optionalen Grund.
`delete_envelope`	Löscht einen Entwurf oder einen stornierten Umschlag dauerhaft.

Dokument-Downloads

Tool	Beschreibung
`download_signed`	Lädt das signierte PDF eines abgeschlossenen Umschlags als lokale Datei herunter.
`download_certificate`	Lädt das Prüfzertifikat-PDF mit vollständigem Audit-Trail herunter.
`download_archive`	Lädt ein ZIP-Archiv mit signiertem PDF, Zertifikat und allen Dokumenten herunter.

Eingebettete Signatur

Tool	Beschreibung
`get_embed_url`	Generiert eine einbettbare Signatur-URL für In-App-Signaturerlebnisse.

Vorlagen

Tool	Beschreibung
`list_templates`	Listet Ihre wiederverwendbaren Dokumentvorlagen auf.
`create_from_template`	Erstellt einen Umschlag aus einer Vorlage mit optionalen vorausgefüllten Feldwerten. Sofort senden oder als Entwurf speichern.

Webhooks

Tool	Beschreibung
`create_webhook`	Abonniert Umschlagereignisse (gesendet, angesehen, signiert, abgeschlossen, abgelaufen, storniert, abgelehnt).
`list_webhooks`	Listet alle konfigurierten Webhooks auf.
`delete_webhook`	Löscht einen Webhook anhand seiner ID.

Beispielkonversationen

Dokument zur Signatur senden

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.

Status prüfen und herunterladen

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

Vorlage mit vorausgefüllten Feldern verwenden

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

Umschlag-Lebenszyklus verwalten

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.

Webhook einrichten

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!)

Umgebungsvariablen

Variable	Erforderlich	Standard	Beschreibung
`SIGNFORGE_API_KEY`	Ja	—	Ihr SignForge API-Schlüssel. Erhältlich unter signforge.io/dashboard/developers.
`SIGNFORGE_API_URL`

SignForge