BoldSign über MCP mit Gemini verbinden

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

BoldSign + Gemini

E-Signaturen mit BoldSign in der Region USA, EU, Kanada oder Australien: Dokumente finden und sehen, wer unterschrieben hat, signierte PDFs und Audit-Trails herunterladen, Dateien oder Vorlagen zur Unterschrift senden, erinnern, verlängern, Unterzeichner tauschen und Felder vorbelegen sowie Vorlagen, Absenderidentitäten, Kontakte, Teams, Nutzer, Brands und API-Credits einsehen.

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:

BOLDSIGN_API_URL, BOLDSIGN_API_KEY

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 2 Minuten. Du brauchst einen BoldSign-Tarif mit API oder ein kostenloses Sandbox-Konto.

1. Melde dich bei BoldSign an (https://app.boldsign.com, EU-Konten https://app-eu.boldsign.com) und öffne im linken Menü API, dann API Key.
2. Klicke auf Generate API Key, wähle Sandbox (kostenlos, Dokumente mit Wasserzeichen, 50 Anfragen pro Stunde) oder Live, setze bei Bedarf ein Ablaufdatum und kopiere den Schlüssel in BOLDSIGN_API_KEY. Er wird im Header X-API-KEY gesendet und hat alle Berechtigungen.
3. Setze BOLDSIGN_API_URL auf die API-Adresse der Region deines Kontos, ohne Schrägstrich am Ende: https://api.boldsign.com (USA), https://api-eu.boldsign.com (EU), https://api-ca.boldsign.com (Kanada) oder https://api-au.boldsign.com (Australien). Die Adresse im Browser nach der Anmeldung verrät die Region: app-eu ist EU, app-ca Kanada, app-au Australien, einfach app USA.
4. Installiere den Connector und führe boldsign_list_documents aus, um Schlüssel und Region zu prüfen.

Dokumente finden und sehen, wer unterschrieben hat:

• boldsign_list_documents listet Dokumente, die du gesendet oder erhalten hast, die neuesten zuerst, mit Status, Absender, Status jedes Unterzeichners, CC, Labels und Daten. Filtern kannst du nach Text, status (WaitingForMe, WaitingForOthers, NeedAttention, Completed, Declined, Revoked, Expired, Draft, Scheduled), transmit_type (Sent, Received, Both), einem Zeitraum für Versand- oder Ablaufdatum, Labels, Brands sowie Absender- oder Unterzeichner-E-Mail.
• boldsign_list_team_documents zeigt die Dokumente deines Teams (Team-Admins: der Teams, die sie verwalten), filterbar nach Team und Nutzer. boldsign_list_behalf_documents zeigt Dokumente, die im Namen anderer über eine Absenderidentität gesendet wurden, oder die andere in deinem Namen gesendet haben.
• boldsign_get_document liest ein Dokument vollständig: Dateien, jeden Unterzeichner mit Reihenfolge, Status, angesehen, Authentifizierung und Feldwerten, CC, den Ereignisverlauf, Ablauf, Erinnerungseinstellungen und eine eventuelle Begründung für Widerruf oder Ablehnung.

Signierte Dateien: boldsign_download_document liefert das signierte PDF, sobald das Dokument abgeschlossen ist, sonst den aktuellen Stand; mehrere Dateien kommen als ein zusammengefügtes PDF oder mit dem Format Individually als ZIP. boldsign_download_audit_log liefert das Audit-Trail-PDF mit jedem Ereignis (gesendet, angesehen, unterschrieben, abgelehnt), Zeit, E-Mail und IP-Adresse. Bei Dokumenten, die im Namen anderer gesendet wurden, gibst du die E-Mail der Absenderidentität in on_behalf_of an.

Zur Unterschrift senden:

• Aus einer Vorlage: boldsign_list_templates, dann boldsign_get_template für die Rollen-Indizes und Feld-IDs, dann boldsign_send_from_template mit einem Eintrag in roles pro Rolle (roleIndex, signerName, signerEmail, optional existingFormFields zum Vorbelegen). Weggelassene Rollen behalten den Standard-Unterzeichner der Vorlage; role_removal_indices entfernt Rollen aus diesem Dokument.
• Eine Datei: boldsign_send_document nimmt PDF-, Word- oder Bilddateien als öffentliche URLs in file_urls (BoldSign lädt sie herunter) oder als Base64-Data-URIs in files, nie beides. Jeder Unterzeichner hat name, emailAddress, optional signerOrder, signerType (Signer, Reviewer oder InPersonSigner) und formFields (Signature, Initial, CheckBox, TextBox, DateSigned, RadioButton, Dropdown, Name, Email, jeweils mit Seite und bounds). Statt Felder zu platzieren, kannst du Text-Tags im Dokument nutzen (use_text_tags) oder BoldSign vorhandene Formularfelder und leere Linien in Felder umwandeln lassen (auto_detect_fields).
• Beide nehmen Titel und Nachricht, CC, Unterschriftsreihenfolge, Ablauf (standardmäßig Days, 60 Tage; Hours oder SpecificDateTime), automatische Erinnerungen, ein Brand, Labels und on_behalf_of für eine Absenderidentität mit Status Verified. disable_emails verschickt keine E-Mails; boldsign_get_embedded_sign_link liefert dann pro Unterzeichner einen direkten Unterschriftslink, auf Wunsch zeitlich begrenzt und mit Weiterleitungsadresse. boldsign_send_draft sendet ein als Entwurf gespeichertes Dokument.
• Der Versand läuft asynchron: Die Antwort enthält sofort die documentId, und kurz danach zeigt boldsign_get_document, ob es rausging (ein fehlgeschlagener Versand steht im Verlauf).

Senden ist echt: Senden, Erinnern, Unterzeichner tauschen und Absenderidentitäten anlegen schickt E-Mails an echte Menschen, ein Live-Dokument ist rechtsverbindlich und kann API-Credits verbrauchen. Die KI zeigt dir Datei oder Vorlage, Unterzeichner und Nachricht und sendet erst nach deinem klaren Ja.

Nachfassen: boldsign_remind_document erinnert alle offenen Unterzeichner oder nur die angegebenen E-Mails. boldsign_extend_expiry verschiebt den Ablauf eines laufenden Dokuments: ein Datum yyyy-MM-dd bei Ablauf in Tagen, eine Stundenzahl bei Ablauf in Stunden, ein ISO-8601-Zeitpunkt bei festem Ablauf. boldsign_change_recipient ersetzt einen Unterzeichner, der noch nicht unterschrieben hat, mit einer Begründung im Audit-Trail. boldsign_prefill_fields setzt Feldwerte, bevor die Unterzeichner sie ausfüllen (Feld-IDs aus boldsign_get_document).

Konto: Absenderidentitäten mit boldsign_list_sender_identities, boldsign_get_sender_identity und boldsign_create_sender_identity (BoldSign schickt der Person eine Freigabeanfrage per E-Mail; nutzbar ist die Identität, sobald ihr Status Verified ist, mögliche Status sind Pending, Verified und Denied). Kontakte mit boldsign_list_contacts, boldsign_get_contact, boldsign_create_contacts und boldsign_update_contact. Teams, Nutzer (Rolle Admin, TeamAdmin oder Member, Status Active oder Invited) und Brands sind nur lesbar. boldsign_get_api_credits zeigt das Credit-Guthaben und den Verbrauch.

Bei der Installation deaktiviert: boldsign_revoke_document (stoppt die Unterschrift und nennt den Unterzeichnern den Grund; das Dokument lässt sich nicht fortsetzen) und boldsign_delete_document (verschiebt es in den Papierkorb oder löscht es mit delete_permanently endgültig). Beides lässt sich nicht rückgängig machen, deshalb schaltet ein Workspace-Admin sie ein, wenn das Team sie braucht.

Datenformate: IDs sind GUID-Strings (documentId, templateId). Daten wie createdDate, activityDate und expiryDate sind Unix-Zeitstempel in Sekunden; Filter nehmen ISO 8601 (2026-10-01T00:00:00Z). Der Dokumentstatus ist InProgress, Completed, Declined, Expired, Revoked, Draft oder Scheduled, der Unterzeichnerstatus NotCompleted, Completed, Declined, Revoked oder Expired. Vorlagenrollen sind ab 1 nummeriert. Feld-bounds (x, y, width, height) werden von der linken oberen Ecke der Seite gemessen, Feld-IDs bestehen nur aus Buchstaben, Ziffern und Unterstrichen.

Blättern: Listen-Tools nehmen page (ab 1) und page_size (1 bis 100, Standard 10) und liefern pageDetails mit totalRecordsCount und totalPages sowie die Einträge in result (results bei Teams). Ab 10.000 Dokumenten übergibt die KI den cursor des letzten Dokuments als next_cursor.

Limits: 2.000 Anfragen pro Stunde und Konto bei Live, 50 bei Sandbox, API-Schlüssel und OAuth zusammengezählt. Sandbox-Dokumente tragen ein Wasserzeichen. Bei Credit-basierten Tarifen verbraucht jedes über die API gesendete Dokument Credits.

Häufige Fehler: 401 bedeutet einen falschen oder abgelaufenen Schlüssel oder einen Schlüssel, der gegen die Adresse einer anderen Region läuft. 403 bedeutet, dass der Tarif keine API enthält oder der Nutzer den Eintrag nicht sehen darf. 400 kommt mit einer Meldung bei ungültigen Eingaben, etwa einem unbekannten Rollen-Index, einer fehlenden Unterzeichner-E-Mail oder einer Datei, die BoldSign nicht lesen kann. 429 bedeutet, dass das Stundenlimit erreicht ist; warte bis X-RateLimit-Reset.

Der Connector legt keine Vorlagen an und bearbeitet keine, verwaltet keine Webhooks, legt keine Teams, Nutzer oder Brands an und löscht keine Kontakte.

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 BoldSign-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche Dokumente warten noch auf Unterschriften anderer, und wer genau hat noch nicht unterschrieben?“
• „Hat [email protected] die NDA unterschrieben, die wir am Montag geschickt haben? Zeig mir den Ereignisverlauf.“
• „Lade das signierte PDF und den Audit-Trail des Dienstleistungsvertrags mit Acme herunter.“
• „Schick unsere Vorlage für den Freelancer-Vertrag an [email protected] als Auftragnehmer. Zeig mir Rollen und Nachricht vor dem Senden.“
• „Erinnere die offenen Unterzeichner des Mietvertrags und verlängere den Ablauf bis zum 30. November.“

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