DocuSeal über MCP mit Gemini verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → DocuSeal klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

DocuSeal + Gemini

DocuSeal, die Open-Source-Plattform für elektronische Signaturen, in der Cloud (US oder EU) oder selbst gehostet: Vorlagen, Einreichungen und Unterzeichner finden, prüfen, wer unterschrieben hat, signierte PDFs und Abschluss-Events holen, Vorlagen oder einzelne PDFs zur Signatur senden, Unterzeichner ändern und Vorlagen aus PDF, DOCX oder HTML bauen.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

DOCUSEAL_API_URL, DOCUSEAL_API_KEY

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 2 Minuten. Du brauchst ein Konto bei DocuSeal Cloud oder Zugang zu einem selbst gehosteten DocuSeal.

1. Kopiere deinen API-Key: bei DocuSeal Cloud unter https://console.docuseal.com/api (EU-Konten: https://console.docuseal.eu/api), bei einem selbst gehosteten DocuSeal unter Settings > API (https://<your host>/settings/api).
2. Füge ihn in DOCUSEAL_API_KEY ein. Er wird im Header X-Auth-Token gesendet und handelt als der Benutzer, dem er gehört.
3. Setz DOCUSEAL_API_URL: https://api.docuseal.com für die Cloud in den USA, https://api.docuseal.eu für die Cloud in der EU oder https://<your host>/api für eine eigene Instanz (die Adresse, unter der du DocuSeal öffnest, plus /api). Ohne Schrägstrich am Ende.
4. Installiere den Connector und rufe docuseal_list_templates auf, um den Key zu prüfen.

Testmodus: DocuSeal Cloud hat einen Testmodus mit eigenem API-Key, den du in der Konsole umschaltest. Test-Einreichungen sind kostenlos und rechtlich nicht bindend; nimm also den Test-Key, solange du den Connector ausprobierst.

Was er liest:

• Vorlagen mit ihren Rollen, Feldern (Name, Typ, Rolle, Pflichtfeld) und Dokumenten, durchsuchbar nach Name (q), Ordner oder externer ID. Die Feldnamen sind die Schlüssel für vorausgefüllte Werte.
• Einreichungen (Signaturanfragen) mit Status, Vorlage, E-Mail, Rolle und Status jedes Unterzeichners, Ereignisverlauf, kombiniertem Dokument und Link zum Audit-Log. Filter nach Vorlage, Status, Ordner oder Unterzeichner.
• Unterzeichner über alle Einreichungen mit den Zeitpunkten von Versand, Öffnen, Abschluss oder Ablehnung, einem Ablehnungsgrund, den eingegebenen Werten und dem persönlichen Signaturlink embed_src.
• Download-Links der Dokumente einer Einreichung: die signierten PDFs nach Abschluss, vorher die teilweise ausgefüllten, oder mit merge ein zusammengeführtes PDF.
• Abschluss-Events: eines pro Unterzeichner, der fertig ist (form.completed), und eines pro vollständig signierter Einreichung (submission.completed), mit denselben Daten wie ein Webhook, um nachzuholen, was seit einem Zeitpunkt unterschrieben wurde.

Was er schreibt:

• Zur Signatur senden: docuseal_create_submission verschickt eine Vorlage mit einem Unterzeichner pro Rolle; role muss zu den Rollennamen der Vorlage passen, z. B. „First Party“, und values füllt Felder über ihren Feldnamen vor. docuseal_create_submissions_from_emails ist der schnelle Weg für Vorlagen mit nur einem Unterzeichner: eine Einreichung pro E-Mail-Adresse, die Einladungen gehen sofort raus. docuseal_create_submission_from_pdf verschickt ein einzelnes PDF, ohne vorher eine Vorlage zu speichern.
• Nachfassen: docuseal_update_submitter korrigiert Name, E-Mail oder Telefon, füllt Werte vor, verschickt die Einladung mit send_email erneut oder unterschreibt mit completed im Namen des Unterzeichners. docuseal_update_submission benennt eine Einreichung um, ändert das Ablaufdatum oder archiviert und stellt sie wieder her; docuseal_archive_submission archiviert sie, sodass ihre Signaturlinks nicht mehr funktionieren.
• Vorlagen: docuseal_create_template_from_pdf, docuseal_create_template_from_docx, docuseal_create_template_from_html, docuseal_clone_template, docuseal_update_template (umbenennen, in einen Ordner verschieben, Rollen umbenennen, archivieren oder zurückholen) und docuseal_archive_template.

Alle Tools sind bei der Installation aktiv, auch die versendenden, und das Versenden ist echt: Eine neue Einreichung schickt den Unterzeichnern eine E-Mail, außer send_email ist false; completed: true unterschreibt für jemanden, und Archivieren macht Signaturlinks ungültig. Die KI zeigt dir Vorlage oder Dokument, die Unterzeichner mit ihren Rollen und die Nachricht und sendet erst nach einem klaren Ja.

Dateien und Felder: documents[].file nimmt eine öffentliche URL, die DocuSeal herunterlädt, oder Base64-Inhalt. Felder kommen aus Text-Tags im Dokument, etwa {{Full Name;role=Signer;type=text}}, {{Sign here;role=Signer;type=signature}} oder {{Date;role=Signer;type=date}}, oder aus fields mit genauen areas (page, x, y, w, h als Anteil der Seite). Zu den Typen gehören text, signature, initials, date, number, image, checkbox, select, radio, file, stamp, payment und phone. HTML-Vorlagen nutzen Tags wie <signature-field name="Signature" role="Signer"></signature-field>; DOCX-Vorlagen können [[variables]] für dynamische Dokumente verwenden.

Datenformate: IDs sind Ganzzahlen. Zeiten sind ISO 8601 mit Zeitzone. Der status einer Einreichung ist pending, completed, declined oder expired; der status eines Unterzeichners ist awaiting (wegen der Signaturreihenfolge noch nicht eingeladen), sent, opened, completed oder declined. Dokument-URLs sind nur zeitweise gültig, lade die Dateien also bald herunter.

Blättern: Listen liefern data und pagination mit count, next und prev, neueste zuerst, standardmäßig 10 Einträge und mit limit bis zu 100. Die KI übergibt pagination.next als after für die nächste, ältere Seite und hört auf, wenn next null ist. Die Abschluss-Event-Tools blättern genauso nach Abschlusszeit in Unix-Sekunden.

Häufige Fehler: 401 „Not authenticated“ bedeutet einen falschen oder fehlenden API-Key oder einen Key der US-Cloud am EU-Host und umgekehrt. 403 heißt, der Benutzer des Keys darf den Eintrag nicht sehen, 404 eine unbekannte ID. 422 kommt mit einer error-Meldung bei ungültigen Eingaben: unbekannter Rollenname, fehlende E-Mail, archivierte Vorlage, Vorlage ohne Felder oder unlesbare Datei. 429 heißt, das Rate Limit ist erreicht. Bei einer eigenen Instanz bedeutet 404 bei jedem Aufruf, dass /api in DOCUSEAL_API_URL fehlt.

Der Connector archiviert Vorlagen und Einreichungen, löscht sie aber nie, und er verwaltet keine DocuSeal-Benutzer, Kontoeinstellungen oder Webhook-Abos.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die DocuSeal-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche Einreichungen der NDA-Vorlage sind noch offen, und wer hat noch nicht unterschrieben?“
• „Schick die Vorlage „Arbeitsvertrag“ an [email protected] als First Party und füll ihren Namen und das Eintrittsdatum vor. Zeig mir vor dem Senden alles.“
• „Was wurde seit Montag unterschrieben? Liste jeden Unterzeichner mit Dokument und Abschlusszeit.“
• „Hol die signierten Dokumente der Einreichung 4521 als ein zusammengeführtes PDF, zusammen mit dem Link zum Audit-Log.“
• „Der Unterzeichner [email protected] hat die Einladung nicht geöffnet: Korrigiere seine Adresse auf [email protected] und schick sie erneut.“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden