Zum Inhalt
Novadesko Dokumentation
Handbuch Demo
Deutsch
App öffnen

Bestätigungen, Protokoll und Limits

Wie aus einer Vorschau eine Aktion wird, das Einmal-Bestätigungstoken, das Audit-Protokoll und die Aufruflimits.

Aktualisiert am 23.10.2026 Diese Seite bearbeiten In der vollständigen Dokumentation öffnen

Kein Werkzeug ändert Daten direkt: Werkzeuge prepare_* erstellen eine Vorschau, der Nutzer entscheidet.

Vorschau und Bestätigung

Typische Antwort eines Werkzeugs prepare_*:

{
  "status": "preview_ready",
  "action": "...",
  "summary": "...",
  "preview": "...",
  "preview_url": "https://web.novadesko.com/ai-connector/preview/...",
  "preview_url_expires_in_minutes": 30,
  "confirmation_token": "ndk_...",
  "next_step": "..."
}
  • Die KI zeigt die Vorschau und den Link preview_url (signierte Seite, PDF für Dokumente).
  • Sie ruft confirm_action mit dem Token erst nach einem ausdrücklichen Ja des Nutzers auf. Der Nutzer kann auch auf der Vorschauseite bestätigen oder abbrechen, wenn er bei Novadesko angemeldet ist.
  • Das Token ist einmalig, an Nutzer, Unternehmen und Kanal gebunden und läuft nach 30 Minuten ab. Der Vorschauinhalt ist fixiert (SHA-256-Fingerabdruck): bestätigt wird genau das Gezeigte.
  • Die Aktion läuft über dieselben Controller wie die Web-App: gleiche Validierungen, gleiche Nummerierung. Die Rechnungsnummer wird bei Bestätigung vergeben.
  • Um eine Vorschau zu ändern, ruft die KI das Werkzeug prepare_* erneut auf: eine neue Vorschau entsteht. list_pending_actions listet die wartenden.

Die Werkzeuge tragen die MCP-Annotationen readOnlyHint und destructiveHint: confirm_action ist als destruktiv markiert, daher fragen die meisten Clients zusätzlich selbst nach.

Prüfungen bei jedem Aufruf

  1. Werkzeug bekannt und in diesem Kanal erlaubt;
  2. der Nutzer ist noch Mitglied des Unternehmens (und kein Kundenportal-Konto);
  3. Scope gewährt;
  4. Limits;
  5. Argumente: Unternehmens- oder Nutzer-IDs entfernt, dann striktes Schema;
  6. Funktion im Tarif enthalten;
  7. Ausführung, dann Eintrag im Protokoll.

Von Lesezugriffen gelieferte Daten werden als nicht vertrauenswürdig markiert, und Tags, die einen Werkzeugaufruf nachahmen könnten, werden neutralisiert: ein manipulierter Kundenname oder eine Notiz kann die KI nicht steuern.

Limits

LimitWert
Werkzeugaufrufe pro Verbindung120 pro Minute
Werkzeugaufrufe pro Unternehmen (alle Kanäle)400 pro Minute
Bestätigungen pro Verbindung30 pro Stunde
HTTP-Anfragen an den MCP-Endpunkt (pro Token)600 pro Minute
Token und Widerruf (pro IP und Client)120 pro Minute
Client-Registrierung (pro IP)120 pro Minute
Metadaten (pro IP)600 pro Minute

Darüber liefert das Werkzeug ein Fehlerergebnis (isError: true) mit der Meldung « Zu viele Aufrufe, in N Sekunden erneut versuchen » (auf Französisch); HTTP-Limits liefern 429.

Audit-Protokoll

Jeder Aufruf wird mit Datum, Ereignis (Lesen, Vorschau, Bestätigung, Abbruch), Werkzeug, Zusammenfassung, Status (ok, abgelehnt, verweigert...) und Plattform (claude, chatgpt, gemini, nova) protokolliert. Der Nutzer sieht das Protokoll jeder Integration in Novadesko. Die Gespräche selbst werden von Novadesko weder empfangen noch gespeichert.

Siehe auch