---
title: Verbinde deinen Assistenten mit KLARA
description: Artikel, Kunden und Rechnungen aus KLARA direkt im Chat. Dein Assistent liest und bereitet vor, du gibst frei.
kategorie: Buchhaltung
typ: Anbindung
aufwand: ca. 30 Minuten
systeme: [KLARA]
repo: https://github.com/wir-drei-digital/klara-cli
release: https://github.com/wir-drei-digital/klara-cli/releases/latest
operationen: 93
trifft_auf: [KLARA]
order: 3
date: 2026-08-22
---

## Was das bringt

> «Ist die Rechnung für Muster AG schon bezahlt?»

Bis jetzt heisst das: KLARA öffnen, klicken, suchen. Mit dieser Anbindung fragst du deinen Assistenten.

Er liest Artikel, Kunden, Rechnungen und Buchhaltung direkt aus deinem KLARA. Und er bereitet Neues vor: eine Rechnung als Entwurf, einen Kunden nach einem Erstgespräch. Angelegt wird erst, wenn du freigibst.

## Voraussetzungen

- 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.

## Anleitung für deinen Assistenten

### Schritt 1: ICM-Ordner und Router ergänzen

Prüfe zuerst, ob du in einem ICM mit einem Router `CONTEXT.md` arbeitest. Falls ja:

1. Lies den Router und prüfe, welche nummerierten Workflow-Ordner bereits bestehen.
2. 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.
3. Erstelle im neuen Ordner eine `CONTEXT.md` mit den Regeln unten.
4. Ergänze im Haupt-Router `CONTEXT.md` eine verlinkte Zeile für typische KLARA-Aufgaben. Verwende darin den tatsächlichen Ordnernamen, zum Beispiel:

```markdown
| **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:

```markdown
# 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.

### Schritt 2: 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.

### Schritt 3: 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.

### Schritt 4: 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.

### Schritt 5: Verifikation

Mach einen Lese-Aufruf und zeig dem Nutzer das Ergebnis:

```sh
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`.

## Was du danach kannst

- «Welche Artikel haben wir im Sortiment?»
- «Leg eine Rechnung für Muster AG an: zwei Positionen, ich diktiere.» Der Assistent baut den Entwurf, du gibst frei.
- «Welche Kunden haben wir seit Juni neu erfasst?»

## Wichtig zu wissen

- Welche Rechte ein KLARA-Zugang hat, hängt vom bereitgestellten Credential und vom Konto ab. Behandle API-Key und Login wie ein Passwort. Prüfe zuerst mit einem Lese-Aufruf, was der Zugang tatsächlich erlaubt, und frag KLARA nach einer eingeschränkten Variante.
- Versand- und Lösch-Operationen (z. B. Rechnung verschicken, Datensatz löschen) verweigert das CLI ohne `--force`. Das ist Absicht: verschicken und löschen bleiben bewusste Entscheide.
- Dein Assistent macht Fehler wie ein neuer Mitarbeiter. Darum gilt: anlegen ja, aber du gibst frei.