Der schnellste Weg
Lies https://wirdrei.digital/workflows/klara-anbinden.md und richte diesen Workflow bei mir ein. Frag mich nach den Angaben, die dir fehlen. Hol meine Freigabe ein, bevor du Dateien änderst, Software installierst, Zugangsdaten speicherst oder eine externe Aktion auslöst.
Was du brauchst
Ein Assistent mit Zugriff auf Dateien und Programme, zum Beispiel Claude Code, Codex oder opencode. Ein normaler Browser-Chat reicht nicht.
Ein KLARA-Konto und ein Zugang, den KLARA für die API-Nutzung deiner Firma freigegeben hat. Das CLI unterstützt einen API-Key und, falls für dein Konto erlaubt, den KLARA-Login.
Die Anleitung
Die folgenden Schritte richten sich an deinen Assistenten. Du kannst mitlesen und gibst
Änderungen frei.
ICM-Ordner und Router ergänzen
Prüfe zuerst, ob du in einem ICM mit einem Router CONTEXT.md arbeitest. Falls ja:
- Lies den Router und prüfe, welche nummerierten Workflow-Ordner bereits bestehen.
- Wähle die nächste freie zweistellige Nummer. Lege die Anbindung direkt im ICM als
0X_klara/ an, zum Beispiel 06_klara/. Ersetze 0X durch die gewählte Nummer. Lege sie nicht unter workflows/klara/ ab.
- Erstelle im neuen Ordner eine
CONTEXT.md mit den Regeln unten.
- Ergänze im Haupt-Router
CONTEXT.md eine verlinkte Zeile für typische KLARA-Aufgaben. Verwende darin den tatsächlichen Ordnernamen, zum Beispiel:
| **KLARA**: Rechnungen, Artikel oder Kunden nachschlagen | [`06_klara/`](06_klara/CONTEXT.md) | in Einrichtung |
Arbeitest du nicht in einem ICM, frag den Nutzer, wo die Regeln der Anbindung liegen sollen. Bau nicht ungefragt eine ICM-Struktur auf.
Die CONTEXT.md der Anbindung beginnt so:
# Workflow: KLARA-Anbindung
Zweck: (mit dem Nutzer ausfüllen: wofür vor allem? Artikel, Kunden, Fakturierung?)
## Regeln
- Lesen ist erlaubt. Anlegen und Ändern nur nach Freigabe im Chat.
- Der API-Zugang liegt in der lokalen Konfiguration des CLI, nie im Chat, nie in Git.
- Beträge und Kundendaten stammen aus KLARA oder vom Nutzer, nie geschätzt.
- Versand- und Lösch-Operationen (z. B. Rechnung verschicken, Datensatz löschen) nur nach ausdrücklicher Freigabe.
Frag den Nutzer nach dem Zweck und lass ihn die Regeln bestätigen, bevor du den Zugang einrichtest.
CLI installieren
Lade von https://github.com/wir-drei-digital/klara-cli/releases/latest das Binary für sein System (macOS und Linux als .tar.gz für amd64 und arm64, Windows als .zip). Prüfe den Download gegen checksums.txt, entpacke das Archiv und lege klara in den PATH.
Alternative, falls eine Go-Toolchain da ist: go install github.com/wir-drei-digital/klara-cli/cmd/klara@latest
Prüfe die Installation mit klara commands --json - kommt eine Liste von Befehlen zurück, ist die Installation da.
Zugang wählen
Klär mit dem Nutzer und bei Bedarf mit KLARA, welcher Zugang für seine Firma freigegeben ist:
- API-Key - verwende ihn, wenn KLARA einen Key für die Firma bereitgestellt hat.
- KLARA-Login - verwende ihn nur, wenn KLARA und die internen Regeln des Nutzers diesen Zugang für die Anbindung erlauben. Das CLI speichert die Sitzung lokal und versucht, sie bei Bedarf zu erneuern.
Wichtig: Der Nutzer tippt Passwort oder Key nie in den Chat. klara init fragt beides direkt im Terminal ab und speichert es lokal mit 0600-Rechten.
klara init ausführen
Lass den Nutzer klara init im Terminal ausführen. Der Wizard fragt, welcher Zugang gewünscht ist, sammelt ihn ein und prüft ihn gleich mit einem einzigen Lese-Aufruf.
Verifikation
Mach einen Lese-Aufruf und zeig dem Nutzer das Ergebnis:
klara articles list --limit 10
Alle verfügbaren Operationen findest du mit klara commands --json. Kommt eine Liste zurück, steht die Anbindung. Trag in der CONTEXT.md das Einrichtungsdatum nach. Arbeitest du in einem ICM, setz den Status der KLARA-Zeile im Haupt-Router auf aktiv.