API & MCP

Zweck

Jede Fähigkeit dieses Systems ist über die Schnittstelle erreichbar — nicht als Zugabe, sondern als Bauprinzip. Die Oberfläche ist ein Client der API, kein Vorrecht. Es gibt keine Funktion, die es „nur in der UI" gibt.

Der praktische Nutzen: Was Sie heute von Hand tun, kann morgen ein Programm, eine Automation oder eine KI tun — ohne dass jemand dafür etwas nachbauen muss.

Funktionsumfang

• REST-API unter /api/v1 mit automatisch erzeugter OpenAPI-Beschreibung. Fehler folgen einem

einheitlichen Format, statt sich je Endpunkt zu unterscheiden.

• Öffentliche Kennung ist die ULID — eine sortierbare Kennung, die nicht die Zahl der Datensätze

verrät und sich fälschungssicher raten lässt.

• Rechte gelten unverändert. Dieselben Prüfungen wie in der Oberfläche greifen an der

Schnittstelle, objektbezogen. Es gibt keinen Weg, der die Rechteprüfung umgeht.

• MCP-Anbindung: Die Operationen werden aus der OpenAPI-Beschreibung als KI-Werkzeuge

exportiert. Eine KI arbeitet damit über dieselben Endpunkte wie jeder andere Client — mit denselben Rechten und derselben Protokollierung.

• Zugriff über Token, die die Rechte ihres Benutzers ausüben und jederzeit widerrufbar sind.

Zusammenspiel

Die API ist die gemeinsame Grundlage, auf der die anderen Bereiche aufsetzen: die Automations-Engine ruft dieselben Operationen auf, die KI-Plattform erreicht sie über MCP, und Integrationen binden fremde Systeme an. Jede dieser Nutzungen hinterlässt ihre Spur in der Nachvollziehbarkeit — mit dem Unterschied, ob ein Mensch, eine KI oder eine Automation gehandelt hat.

Grenzen

• Kein Weg an den Rechten vorbei. Ein Token kann nie mehr als der Benutzer, an dem es hängt.

Wer über die API mehr sehen will, braucht mehr Rechte — nicht einen anderen Zugang.

• Einige Bootstrap-Strecken erscheinen bewusst nicht im MCP-Katalog — Anmeldung, öffentliche

Formulare, Webhook-Empfänger. Ihr verwaltender Gegenpart ist jeweils als reguläre Operation vorhanden.

• Die API ist versioniert. Änderungen am Wire-Format sind ein angekündigter Schnitt, keine

Nebenwirkung eines Updates.

platform.api · Gilt ab Version 0.5.0