Entwickler & API

"Bring your own AI": eine OpenAPI-dokumentierte REST-API plus ein nativer MCP-Server (Model Context Protocol), damit eigene oder fremde KI-Agenten (z. B. über Claude oder andere MCP-fähige Clients) mit expliziter Erlaubnis auf einzelne Module zugreifen können — ohne dass Regnis selbst eine zentrale KI-Infrastruktur mit Klartextzugriff betreiben müsste.

Sicherheitsprinzipien, die für diese API von Anfang an mitgedacht sind: granulare, zeitlich begrenzte und widerrufbare Scoped Tokens statt Vollzugriff; ein KI-Erstkontakt bekommt zunächst nur Lesezugriff, jede schreibende/löschende Berechtigung braucht separate, explizite Zustimmung; destruktive oder kostenrelevante Aktionen (löschen, versenden, kaufen) laufen nie allein aus einem von der KI verarbeiteten Fremdinhalt heraus, sondern verlangen eine gesonderte Bestätigung; ein eigenes Audit-Log protokolliert ausschließlich KI-initiierte Aktionen.

:::info Aktueller Stand — erste reale Funktions-Scheibe, keine fertige öffentliche API Es gibt heute eine echte, laufende API (privacysuite-api-gateway) mit einer vollständigen OpenAPI-Spezifikation — das ist mehr als ein reiner Ausblick. Aber mit klaren Grenzen:

• Wirklich live und Ende-zu-Ende getestet: Account-/Tarifstatus nachschlagen (support:account:read), Verifizierungsmail erneut senden und Passwort-Reset anstoßen (support:selfservice:trigger), beide über REST (/gw/v1/*) UND über MCP erreichbar, mit gemeinsamer Backend-Logik und vollständigem Audit-Log.
• Bewusst noch nicht verfügbar: Die beiden Ticket-Routen (GET/POST auf /gw/v1/support/tickets/...) liefern aktuell 503 mit todo: true im Antwortkörper — sie warten auf das noch nicht abgeschlossene Zammad-Deployment. Das ist kein Bug, sondern der dokumentierte Zustand.
• Nicht öffentlich erreichbar: Dieser erste Ausbau hat genau einen Konsumenten (eine lokal bei Daniel laufende KI, im selben Tailscale-Netz) und ist nur über die interne Tailscale-IP sowie localhost erreichbar — es gibt noch keinen öffentlichen Caddy-Eintrag für den Gateway selbst. Der interaktive "Try it"-Bereich der Referenz unten wird deshalb für Besucher dieser öffentlichen Doku-Seite nicht funktionieren, auch bei korrektem Token nicht — das ist technisch erwartet, kein Fehler dieser Doku.
• Kein SDK, kein öffentlicher Zugang, kein Termin für eine breitere Freigabe. Weitere Scopes/Endpunkte kommen erst, wenn echte externe MCP-Clients dazukommen. :::

Referenz

Die folgenden Seiten sind automatisch aus der echten OpenAPI-Spezifikation (scaffold/api-gateway/openapi.json) erzeugt — jede Änderung am Code spiegelt sich nach einem Doku-Rebuild hier wider, es gibt keine separat gepflegte, potenziell veraltete Beschreibung.