Was ist MCP?

MCP – Model Context Protocol – ist ein offener Standard, mit dem ein KI-Assistent externe Dienste nutzen kann. Ohne MCP kann der Assistent nur Gespräche führen: Er kann Ihnen den Text eines Vertrags schreiben, ihn aber nicht zur Unterschrift senden. Mit MCP erhält er Werkzeuge.

AssinaJá stellt einen offiziellen MCP-Server bereit. Sobald er verbunden ist, können Sie den Assistenten in Alltagssprache bitten, ein Dokument aus einer Ihrer Vorlagen vorzubereiten, Ihnen zu sagen, wer noch nicht unterschrieben hat, oder Ihnen die unterschriebene PDF zu bringen.

Was sich in der Praxis ändert

Die Arbeit rund ums Unterschreiben ist zu einem großen Teil Routine: eine Vorlage nehmen, dieselben Felder mit Daten füllen, die anderswo liegen, die Unterzeichner auswählen, senden und danach nachhalten, wer noch fehlt. Genau diese Lücke schließt MCP.

Sie arbeiten dort, wo Sie schon sind. Wenn Sie in einem Gespräch mit dem Assistenten ein Angebot vorbereiten, geht das Dokument aus genau diesem Gespräch hinaus. Kein Exportieren, kein Tabwechsel, kein erneutes Hochladen der Datei.

Der Assistent liest Ihre Vorlagen. Er greift auf die echten Vorlagen Ihrer Organisation zu – mit den dort festgelegten Unterzeichnern und Ausfüllfeldern –, statt ein Format zu erfinden.

Er beantwortet Fragen, nicht nur Aufträge. „Welche Dokumente warten seit mehr als einer Woche auf eine Unterschrift?“ ist eine Frage, die der Assistent anhand der echten Liste beantwortet.

Es ist dieselbe Engine. Die MCP-Werkzeuge rufen dieselben Dienste wie die öffentliche API auf – es gibt keine zweite Implementierung mit anderen Regeln. Was in der Anwendung verboten ist, bleibt auch hier verboten.

Zwei Arten der Verbindung

Art	Für wen
OAuth	Web-Assistenten: Claude.ai, ChatGPT, Copilot, Grok
Header X-Api-Key	Lokale Werkzeuge und Automatisierungen: Claude Code, Cursor, CI

Web-Assistenten erlauben keine eigenen Header und verwenden daher OAuth. Diese Verbindungen sind unter Claude.ai verbinden und ChatGPT verbinden beschrieben.

Die Serveradresse ist in beiden Fällen dieselbe:

https://app.assinaja.pt/mcp

Lokale Werkzeuge über den Header

Für Claude Code zum Beispiel ist die Verbindung ein einziger Befehl, bei dem der API-Schlüssel im Header übertragen wird:

claude mcp add --transport http assinaja https://app.assinaja.pt/mcp \
  --header "X-Api-Key: ajk_live_..."

Das Sicherheitsmodell

Das ist der Teil, der diese Integration auszeichnet, und es lohnt sich, ihn zu verstehen, bevor Sie irgendetwas verbinden.

Der Assistent greift nie auf Ihr Konto zu

Selbst über OAuth wird kein Zugriff auf Ihr Benutzerkonto ausgestellt, sondern ein Zugriff, der an einen bestimmten API-Schlüssel gebunden ist. Die Autorisierungsseite selbst sagt das:

Dieser KI-Assistent bittet um Zugriff auf Ihre Organisation. Der Zugriff erfolgt über einen API-Schlüssel – der Assistent kann nur das tun, was dieser Schlüssel erlaubt, und greift nie auf Ihr Konto zu.

Darf der Schlüssel nur Dokumente lesen, kann der Assistent genau das – es gibt keinen Weg, auf dem er zum Rest gelangt.

Der Assistent sieht nur, was der Schlüssel erlaubt

Die Filterung erfolgt, bevor der Assistent entscheidet. Fragt er den Server, welche Werkzeuge es gibt, ist die Antwort bereits auf die Berechtigungen des Schlüssels zugeschnitten: Ein Werkzeug außerhalb des Umfangs erscheint nicht in der Liste – es wird nicht erst beim Aufruf abgelehnt.

In der Praxis weiß ein Assistent, der über einen Schlüssel ohne Dokumente – versenden verbunden ist, nicht einmal, dass Veröffentlichen möglich ist.

Einen Assistenten autorisieren und widerrufen

Über OAuth öffnet der Assistent die Autorisierungsseite von AssinaJá – {Assistent} mit AssinaJá verbinden –, und die Autorisierung hat zwei Schritte:

1. Schritt 1 von 2 — wählen Sie den API-Schlüssel. Die Liste zeigt nur aktive, noch gültige Schlüssel von Organisationen, deren Inhaber Sie sind. Gibt es keinen, sagt die Seite:

   Sie haben keinen aktiven API-Schlüssel.

   Erstellen Sie im Backoffice unter Einstellungen → API-Schlüssel einen Schlüssel und versuchen Sie die Verbindung erneut.

2. Schritt 2 von 2 — bestätigen Sie die Berechtigungen, die Sie erteilen. Hier steht, was der Schlüssel erlaubt. Eine Berechtigung ohne eigene Bezeichnung auf dieser Seite erscheint mit ihrem technischen Code – zum Beispiel analytics:read oder documents:signurls. Zugriff erlauben schließt ab:

   Mit Ihrer Bestätigung wird protokolliert, dass Sie {Assistent} zur Nutzung dieses Schlüssels berechtigt haben. Sie können den Zugriff jederzeit entziehen, indem Sie den Schlüssel unter Einstellungen → API-Schlüssel sperren oder löschen.

Die Autorisierung wird nicht gespeichert: Jede neue Verbindung durchläuft beide Schritte und wird gesondert protokolliert.

Widerrufen wird über den Schlüssel, nicht über den Assistenten: unter Einstellungen → Entwickler → API-Schlüssel mit Sperren – „Ein gesperrter Schlüssel authentifiziert nicht mehr, bis er wieder aktiviert wird.“ – oder Löschen, was endgültig ist. Die Wirkung ist sofort; siehe Der Entzug des Zugriffs wirkt sofort.

Die Zustimmung wird protokolliert

Autorisieren ist kein Klick, der verloren geht. Gespeichert wird, wer autorisiert hat, welcher Schlüssel, welcher Assistent, welche Berechtigungen, wann und von welcher Adresse aus. Dieses Protokoll sehen Sie unter Einstellungen → Entwickler → API-Schlüssel, im Abschnitt Für KI-Assistenten freigegeben:

Protokoll der Einwilligungen (Nachweis). Um einem Assistenten den Zugriff zu entziehen, sperren oder löschen Sie den Schlüssel.

Der Entzug des Zugriffs wirkt sofort

Der Schlüssel wird bei jeder Anfrage neu geprüft. Wird er gesperrt, läuft er ab oder wird er gelöscht, verliert der Assistent sofort den Zugriff – es muss kein Sitzungsende abgewartet werden.

Das ist auch die Antwort auf den unangenehmsten Fall: Wenn Sie einer Verbindung misstrauen, sperren Sie den Schlüssel und sehen Sie, was nicht mehr funktioniert. Sperren lässt sich rückgängig machen.

Regeln, die der Server dem Assistenten auferlegt

Der Server sendet Sicherheitsanweisungen, die der Assistent erhält, bevor er handelt: Die Unterzeichnercodes gehören zur Vorlage und dürfen nie erfunden werden; das Veröffentlichen versendet sofort E-Mails und lässt sich nicht rückgängig machen, deshalb verlangt es eine ausdrückliche Bestätigung im Gespräch; und eine fehlgeschlagene Erstellung wird nie blind wiederholt, denn ein zweiter Aufruf erzeugt ein zweites Dokument und eine zweite Welle von E-Mails.

Nutzungsgrenze

60 Anfragen pro Minute pro Zugangsdaten, für alle Werkzeuge – auch für die, die nur lesen. Es ist derselbe Zähler wie bei den Routen der öffentlichen API zum Erstellen von Dokumenten: Ein System, das denselben Schlüssel über den Header X-Api-Key in der API und im MCP verwendet, teilt sich diese 60. Die übrigen Routen der öffentlichen API haben eine eigene Grenze von 300 Anfragen pro Minute, die für MCP nicht gilt.

Was der Assistent tun kann

Welche Werkzeuge verfügbar sind, hängt von den im Schlüssel markierten Berechtigungen ab. Die Namen rechts sind die, die Sie im Assistenten sehen; die Werkzeugtitel gibt es nicht auf Deutsch, der Assistent zeigt sie auf Englisch.

Berechtigung des Schlüssels	Der Assistent kann dann
Vorlagen – lesen	List templates · Get template details
Dokumente – lesen	List documents · Get document details · Get document overview · Download document file
Dokumente – Signaturlinks	Get signing links
Dokumente – erstellen	Create document · Create document from template · Create document from Word template · Create upload link · Get upload link status
Dokumente – versenden	Publish draft and notify signers
Dokumente – archivieren/löschen	Archive document · Delete document
Organisation – lesen	Get organization · Get subscriptions and plan features
Analytics – lesen	Analytics overview · Usage metrics · Metric over time · Metric breakdown · Signing funnel · Adoption and seats · Metric catalog

Der Assistent kann gleichzeitiges Unterschreiben anfordern – und ignoriert werden

Beim Erstellen eines Dokuments kann ein Assistent verlangen, dass alle Unterzeichner gleichzeitig eingeladen werden. Das wird nur berücksichtigt, wenn die Organisation es unter Einstellungen → Organisation → Richtlinien → Signaturen erlaubt.

Erlaubt sie es nicht, führt die Anfrage nicht zu einem Fehler: Das Dokument geht trotzdem nacheinander raus, und erst die Antwort enthält den tatsächlichen Wert. Deshalb weisen die Werkzeuge den Assistenten an, diesen Wert zu lesen, bevor er Ihnen sagt, wer die E-Mail wann erhält – versichert er Ihnen „alle haben sie jetzt erhalten“, ohne ihn gelesen zu haben, kann er sich irren. Siehe Richtlinien der Organisation konfigurieren.

Veröffentlichen ist die Berechtigung, die Sie sich zweimal überlegen sollten

Publish draft and notify signers versendet E-Mails und ist unwiderruflich. Erstellen und Veröffentlichen sind bewusst getrennte Berechtigungen: Ein Schlüssel mit erstellen, aber ohne versenden lässt den Assistenten alles vorbereiten und zwingt einen Menschen, den Knopf zu drücken. Die empfohlene Kombination für die erste Verbindung steht unter Einen API-Schlüssel erstellen.

Dateien auf Ihrem Computer

Der Assistent kann keine Dateien von Ihrer Festplatte holen. Braucht er eine, erstellt er einen Übergabelink – Sie öffnen ihn, laden die Datei hoch, und er macht weiter. Siehe Eine Datei an einen Assistenten übergeben.

Die Grenzen

Analytics sind standardmäßig ausgeschaltet. Ob ein Assistent die Zahlen der Organisation lesen darf, ist eine eigene Entscheidung, unter Einstellungen → Organisation → Richtlinien → Automatisierung, im Abschnitt KI-Zugriff auf Analytics:

Ob per MCP verbundene Assistenten die Zahlen dieser Organisation abfragen dürfen. Standardmäßig deaktiviert. Gewährt nie Zugriff auf Dokumente, Inhalte oder Schlüssel – nur auf aggregierte Kennzahlen, und jede Abfrage wird im Prüfpfad protokolliert.

Es braucht beides

Die Richtlinie schaltet das Lesen für die Organisation frei; die Berechtigung Analytics – lesen schaltet es für einen bestimmten Schlüssel frei. Fehlt eines davon, erscheinen die sieben Werkzeuge gar nicht in der Liste, die der Assistent sieht – sie schlagen nicht beim Aufruf fehl, sie sind unsichtbar.

Das ist Absicht: Ein Assistent kann nicht anfordern, wovon er nicht weiß, dass es existiert.

Ein Assistent kann sich irren. Die richtigen Dokumente zu lesen und falsch zusammenzufassen ist ein möglicher Fehler, und MCP behebt ihn nicht. Prüfen Sie in der Anwendung, was wichtig ist, bevor Sie senden.

Was er tut, geschieht in Ihrem Namen. Die Dokumente werden in Ihrer Organisation erstellt und verbrauchen Ihre Kontingente.

Siehe auch

• Claude.ai mit AssinaJá verbinden
• ChatGPT mit AssinaJá verbinden
• Einen API-Schlüssel erstellen
• Richtlinien der Organisation konfigurieren – die Einstellung, durch die von KI erstellte Dokumente als Entwurf beginnen