KI-Agenten
obop behandelt KI-Agenten als gleichberechtigte Nutzer, die bewusst eingeschränkt sind. Diese Seite erklärt das Modell; die nächsten Seiten zeigen, wie Sie einen Agenten einrichten.
Das Agentenmodell
Ein Agent ist alles, was mit einem Agent-Token auf obop zugreift: ein MCP-Client wie Claude Desktop oder Cursor, ein Skript, das die REST-API aufruft, oder die Kommandozeile. Agenten arbeiten auf denselben Datensätzen und mit denselben Befehlen wie Menschen. Vier Regeln machen das sicher.
- Eingeschränkter Umfang. Ein Agent-Token trägt eine Liste von Berechtigungsgruppen (seine Scopes). Es kann die Rechte seines Besitzers nur einschränken, nie erweitern. Die Anfrage nach einer Gruppe, die der Besitzer nicht hat, wird abgelehnt.
- Maskiert. Personenbezogene Daten kommen als stabile Platzhalter wie
EMAIL_1zurück. Finanzielle, Personal- und besonders schützenswerte Felder werden zurückgehalten. Ein Agent kann trotzdem über Datensätze nachdenken und Platzhalter zurückgeben, sieht aber nie die echten Werte. Siehe Maskierungs-Tokens. - Vorschlagen, nicht ausführen. Ein Agent kann gewöhnliche Aktionen innerhalb seiner Scopes ausführen, bei allem Unumkehrbaren (eine Rechnung buchen, bezahlen, erstatten, versenden, veröffentlichen, löschen) aber nur etwas vorschlagen. Der Server liefert eine Plan-ID zurück und ändert nichts. Eine Person gibt den Plan frei. Siehe Der Freigabeablauf.
- Dieselbe Tür. REST, MCP und die CLI laufen über einen gemeinsamen Dispatcher, ein Agent hat also genau dieselben Berechtigungen, dieselbe Maskierung und dieselben Freigaben, auf welchem Weg er sich auch verbindet.
Drei Wege der Verbindung
| Schnittstelle | Wann sie passt | Seite |
|---|---|---|
| MCP über stdio | Ein MCP-Client (Claude Desktop, Claude Code, Cursor, VS Code, Windsurf und andere) soll obop als Tools aufrufen. | Über MCP verbinden |
| REST | Ein Skript oder Dienst ruft HTTP-Endpunkte auf. | Die REST-API nutzen |
| CLI | Eine Shell oder ein Cron-Job ruft obop call auf. | Die CLI nutzen |
Einrichtung in fünf Schritten
- Legen Sie fest, was der Agent tun soll und welche Gruppen er dafür braucht. Weniger ist besser.
- Erstellen Sie ein Agent-Token mit genau diesen Scopes.
- Verbinden Sie den Agenten über MCP, REST oder die CLI.
- Probieren Sie einen harmlosen Lesezugriff aus, dann eine Änderung, die eine Freigabe braucht, und geben Sie sie als Person frei.
- Lesen Sie Empfehlungen zur Sicherheit, bevor Sie das Token an etwas weitergeben, das unbeaufsichtigt läuft.
Was es heute gibt und was nicht
- Gebaut: Tokens mit eingeschränktem Umfang, Maskierung und Wiederherstellung, Freigabepläne, MCP über stdio, REST und die CLI.
- Noch nicht gebaut: ein HTTP-Transport (remote) für MCP mit OAuth, weshalb gehostete Instanzen noch nicht über MCP erreichbar sind; eine Oberfläche zum Erstellen oder Widerrufen von Agent-Tokens; eine Liste offener Freigaben in der Oberfläche. Agent-Tokens laufen nicht ab, und einen Befehl zum Widerrufen gibt es noch nicht. Darauf weisen wir erneut hin, wo es relevant ist.
Beispiele für Prompts und Abläufe finden Sie unter Beispiel-Workflows, bei Problemen unter Fehlerbehebung.