Skip to main content
Glama
deenesjakoruzh
signnow

SignNow MCP Server

Official
by signnow
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

Die SignNow REST API ermöglicht es Benutzern, eine nahtlose E-Signatur-Erfahrung für Unterzeichner, Vorbereiter und Absender bereitzustellen. Dokumente vorab ausfüllen, eingebettete, gebrandete Workflows für mehrere Unterzeichner erstellen, Zahlungen anfordern und den Signaturstatus in Echtzeit verfolgen. Stellen Sie sicher, dass das Signieren auf jedem Gerät einfach, sicher und intuitiv ist.

Was Sie mit der SignNow API tun können:

  • Dokumente und Dokumentengruppen zur Signatur in einer rollenbasierten Reihenfolge versenden

  • Wiederverwendbare Vorlagen aus Dokumenten erstellen

  • Dokumentenfelder mit Daten vorab ausfüllen

  • Zahlungen als Teil des Signierprozesses einziehen

  • Die Erfahrung des Dokumentenversands, -signierens oder -bearbeitens in Ihre Website, Anwendung oder ein beliebiges System einbetten

  • Den Signierfortschritt verfolgen und die fertiggestellten Dokumente herunterladen

SignNow MCP-Server

Ein Model Context Protocol (MCP) Server, der KI-Agenten sicheren, strukturierten Zugriff auf SignNow E-Signatur-Workflows bietet — Vorlagen, eingebettetes Signieren, Einladungen, Statusverfolgung und Dokumenten-Downloads — über STDIO oder Streamable HTTP.

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

Inhaltsverzeichnis

Related MCP server: Gmail MCP Server by CData

Funktionen

  • Vorlagen & Gruppen

    • Alle Vorlagen und Vorlagengruppen durchsuchen

    • Dokumente oder Gruppen aus Vorlagen erstellen (inklusive One-Shot-Workflows)

  • Einladungen & eingebettete UX

    • E-Mail-Einladungen und geordnete Empfänger

    • Eingebettete Signier-/Versand-/Editor- Links für In-App-Erlebnisse

  • Status & Abruf

    • Einladungsstatus und Schrittdetails prüfen

    • Finale Dokumente herunterladen (einzeln oder zusammengeführt)

    • Normalisierte Dokument-/Gruppenstruktur für programmgesteuerte Entscheidungen lesen

  • Transportwege

    • STDIO (am besten für lokale Clients)

    • Streamable HTTP (am besten für Docker/Remote)

Schnellstart

Voraussetzungen

  • SignNow-Konto. Erstellen Sie ein kostenloses Entwicklerkonto.

  • SignNow-Anmeldedaten: Sie benötigen Ihre Konto-E-Mail, Ihr Passwort und das Basic Authorization Token der Anwendung. Erste Schritte.

  • Eine aktive SignNow API-Anwendung.

  • Python 3.11+ auf Ihrem System installiert (prüfen mit python3 --version)

  • UVX installiert (prüfen mit uvx --version). Empfohlen für die schnellste Einrichtung.

  • Umgebungsvariablen konfiguriert

  • Wenn Ihr Client Streamable HTTP unterstützt, können Sie die vorab bereitgestellte Server-URL https://mcp-server.signnow.com/mcp verwenden, anstatt sie lokal auszuführen.

Schnellstart (uvx)

Wenn Sie uv verwenden, können Sie den Server ausführen, ohne das Paket zu installieren:

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

1. Umgebungsvariablen einrichten

# 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. Installieren und Ausführen

Option A: Installation von PyPI (Empfohlen)

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

# Run MCP server in standalone mode
sn-mcp serve

Option B: Installation aus dem Quellcode (Entwicklung)

# 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 ist ideal für Desktop-Clients und lokale Tests.

Lokal/Remote (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

Standardmäßig wird der Streamable HTTP MCP-Endpunkt unter /mcp bereitgestellt. Beispiel-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 innerhalb von Containern ist bei vielen Clients unzuverlässig. Bevorzugen Sie HTTP bei der Verwendung von Docker.

Docker Compose

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

# Both services (if defined)
docker-compose up

Konfiguration

Kopieren Sie .env.example → .env und füllen Sie die Werte aus. Alle Einstellungen werden beim Start über pydantic-settings validiert.

Authentifizierungsoptionen

1) Benutzername / Passwort (empfohlen für Desktop-Entwicklungsabläufe)

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

2) OAuth 2.0 (für gehostete/fortgeschrittene Szenarien)

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

Bei der Ausführung über einige Desktop-Clients wird möglicherweise nur Benutzer/Passwort unterstützt.

SignNow & OAuth-Einstellungen

# 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>

Produktions-Schlüsselverwaltung

Wenn OAUTH_RSA_PRIVATE_PEM in der Produktion fehlt, wird bei jedem Neustart ein neuer RSA-Schlüssel generiert, wodurch alle vorhandenen Token ungültig werden. Stellen Sie in der Produktion immer einen persistenten privaten Schlüssel über die Geheimnisverwaltung bereit.

Client-Einrichtung

VS Code — GitHub Copilot (Agent Mode) / Cursor

Erstellen Sie .vscode/mcp.json / .cursor/mcp.json in Ihrem Arbeitsbereich:

STDIO (lokal):

{
  "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 — keine lokale Installation):

{
  "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 (remote oder Docker):

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

Öffnen Sie dann Chat → Agent mode, aktivieren Sie die signnow-Tools und verwenden Sie diese in Prompts.

Hinweis: Die gleiche Konfiguration gilt in Cursor — fügen Sie sie unter den MCP-Einstellungen hinzu (STDIO oder HTTP). Für STDIO können Sie auch uvx wie oben gezeigt verwenden.

Claude Desktop

Verwenden Sie Desktop-Erweiterungen oder die manuelle MCP-Konfiguration (Developer → Edit config).

Schritte:

  1. Öffnen Sie Claude Desktop → Developer → Edit config

  2. Fügen Sie einen neuen Servereintrag unter mcpServers hinzu

  3. Speichern und starten Sie Claude Desktop neu

Beispiele:

STDIO (lokale Installation):

{
  "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 — keine lokale Installation):

{
  "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 (remote oder Docker):

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

Aktivieren Sie dann den Server im Chat von Claude und beginnen Sie mit der Nutzung der Tools.

Glama (gehostetes MCP)

Stellen Sie diesen Server auf Glama mit minimalem Aufwand bereit und führen Sie ihn aus:

Schritte:

  1. Öffnen Sie die Serverseite auf Glama: sn-mcp-server auf Glama

  2. Klicken Sie auf den roten Button "Deploy Server"

  3. Geben Sie in den Umgebungsvariablen Folgendes an:

    • SIGNNOW_USER_EMAIL

    • SIGNNOW_PASSWORD

    • SIGNNOW_API_BASIC_TOKEN

    • (andere Variablen können auf den Standardwerten belassen werden)

  4. Erstellen Sie ein Zugriffstoken in Glama und kopieren Sie die Endpunkt-URL. Sie sieht wie folgt aus:

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

Verwenden Sie diese HTTP-MCP-URL in jedem Client, der HTTP-Transport unterstützt (z. B. VS Code/Cursor JSON-Konfiguration oder das Claude Desktop HTTP-Beispiel oben).

MCP Inspector (Testen)

Großartig, um Tools & Schemas visuell zu erkunden.

# 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

Sie können Tools auflisten, sie mit JSON-Argumenten aufrufen und Antworten untersuchen.

Tools

Jedes Tool ist prägnant beschrieben; verwenden Sie einen MCP-Client (z. B. Inspector), um die genauen JSON-Schemas anzuzeigen.

  • list_all_templates — Listet Vorlagen & Vorlagengruppen mit vereinfachten Metadaten auf. Unterstützt limit/offset-Paginierung (Standard: 50 Elemente pro Seite).

  • list_documents — Durchsuchen Sie Ihre Dokumente, Dokumentengruppen und Status. Unterstützt limit/offset-Paginierung (Standard: 50 Elemente pro Seite).

  • create_from_template — Erstellen Sie ein Dokument oder eine Gruppe aus einer Vorlage/Gruppe.

  • send_invite — E-Mail-Einladungen (Dokumente oder Gruppen), geordnete Empfänger werden unterstützt.

  • create_embedded_invite — Eingebettete Signiersitzung ohne E-Mail-Zustellung.

  • create_embedded_sending — Eingebettete "Versand-/Verwaltungs"-Erfahrung.

  • create_embedded_editor — Eingebetteter Editor-Link zum Platzieren/Anpassen von Feldern.

  • send_invite_from_template — One-Shot: Aus Vorlage erstellen und einladen.

  • create_embedded_sending_from_template — One-Shot: Vorlage → eingebetteter Versand.

  • create_embedded_editor_from_template — One-Shot: Vorlage → eingebetteter Editor.

  • create_embedded_invite_from_template — One-Shot: Vorlage → eingebettetes Signieren.

  • get_invite_status — Aktueller Einladungsstatus/Schritte für Dokument oder Gruppe.

  • get_document_download_link — Direkter Download-Link (zusammengeführte Ausgabe für Gruppen).

  • get_signing_link — Erhalten Sie einen Signierlink für ein Dokument oder eine Dokumentengruppe.

  • get_document — Normalisierte Dokument-/Gruppenstruktur mit Feldwerten.

  • update_document_fields — Textfelder in einzelnen Dokumenten vorab ausfüllen.

  • upload_document — Laden Sie ein Dokument von einem lokalen Dateipfad (file_path), einer öffentlichen URL (file_url) oder einem MCP-Ressourcenanhang (resource_uri) hoch. Für file_path muss der aufgelöste Pfad innerhalb des konfigurierten sicheren Basisverzeichnisses bleiben (standardmäßig das Home-Verzeichnis des Benutzers); Pfade außerhalb dieser Basis schlagen bei der Validierung fehl. Unterstützt: PDF, DOC, DOCX, PNG, JPG, JPEG. Max. 40 MB. Gibt document_id, filename, source zurück.

  • send_invite_reminder — Senden Sie eine Signiererinnerung an ausstehende Unterzeichner für ein Dokument oder eine Dokumentengruppe.

  • signnow_skills — Fragen Sie die gebündelte SignNow-Skill-Bibliothek ab. Lassen Sie skill_name weg, um alle verfügbaren Skills mit Beschreibungen aufzulisten; geben Sie skill_name an (z. B. signnow101), um den vollständigen Markdown-Text abzurufen. Verwenden Sie signnow101, um SignNow-Entitätstypen, Einladungstypen und Tool-Mappings zu lernen.

    • Beispiel für Listenmodus: {"skills": [{"name": "signnow101", "description": "SignNow 101 Konzepte Referenz... (Beschreibung zur Kürze abgeschnitten)"}]}

    • Beispiel für Abrufmodus: {"name": "signnow101", "body": "# SignNow 101 — Konzepte Referenz\n..."}

Tipp: Beginnen Sie mit signnow_skills (ohne Argumente), um verfügbare Skills zu entdecken, dann list_all_templates → create_from_template → create_embedded_* / send_invite, dann get_invite_status und get_document_download_link.

FAQ / Tipps

  • STDIO vs Docker? Bevorzugen Sie STDIO für die lokale Entwicklung; innerhalb von Docker verwenden Sie HTTP.

  • Sandbox vs Produktion? Beginnen Sie mit den Sandbox-/Entwickler-Anmeldedaten von SignNow; die Produktion erfordert ein korrektes OAuth und einen persistenten RSA-Privatschlüssel.

  • Wo sehe ich die genauen Tool-Schemas? Verwenden Sie den MCP Inspector oder die Ansicht "Tool-Details" Ihres Clients.

  • Wo sind Beispiele? Siehe examples/ in diesem Repository für Starter-Integrationen.

Beispiele

Das Verzeichnis examples/ enthält funktionierende Beispiele, wie der SignNow MCP-Server in gängige KI-Agenten-Frameworks integriert werden kann:

  • LangChain - Integration mit LangChain-Agenten unter Verwendung von langchain-mcp-adapters

  • LlamaIndex - Integration mit LlamaIndex-Agenten unter Verwendung von llama-index-tools-mcp

  • SmolAgents - Integration mit dem SmolAgents-Framework unter Verwendung nativer MCP-Unterstützung

Jedes Beispiel demonstriert, wie man:

  • Den MCP-Server als Subprozess startet

  • MCP-Tools in frameworkspezifische Tool-Formate konvertiert

  • Agenten erstellt, die SignNow-Funktionalität nutzen können

  • Die Konfiguration der Umgebungsvariablen handhabt

Um ein Beispiel auszuführen:

# 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

Nützliche Ressourcen

Beispiel-Apps

Entdecken Sie sofort einsatzbereite Beispiel-Apps, um das Vorbereiten, Signieren und Versenden von Dokumenten aus Ihrer Software mithilfe der SignNow API schnell zu testen.

Probieren Sie die Beispiel-Apps aus.

API-Dokumentation

Finden Sie technische Details zu SignNow API-Anfragen, Parametern, Codebeispielen und möglichen Fehlern. Erfahren Sie mehr über die API-Funktionalität in detaillierten Anleitungen und An

Install Server
A
security – no known vulnerabilities
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/signnow/sn-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server