---
title: Verbinde deinen Assistenten mit CashCtrl
description: Buchungen, Kontakte und Belege aus CashCtrl direkt im Chat. Dein Assistent liest und bereitet vor, du gibst frei.
kategorie: Buchhaltung
typ: Anbindung
aufwand: ca. 30 Minuten
systeme: [CashCtrl]
repo: https://github.com/wir-drei-digital/cash-ctrl-cli
release: https://github.com/wir-drei-digital/cash-ctrl-cli/releases/latest
operationen: 376
trifft_auf: [CashCtrl]
order: 2
date: 2026-08-22
---

## Was das bringt

> «Wie sehen die letzten Buchungen aus?»

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

Er liest Buchungen, Kontakte, Rechnungen und Offerten direkt aus deinem CashCtrl. Und er bereitet Neues vor: einen Kontakt nach einem Telefonat, eine Buchung als Entwurf. 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 CashCtrl-Konto mit PRO-Plan. Nur der PRO-Plan hat Zugriff auf die API - ohne PRO-Plan funktioniert diese Anbindung nicht. Der API-User wird unter _Einstellungen > Benutzer & Rollen_ angelegt.

## 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_cashctrl/` an, zum Beispiel `06_cashctrl/`. Ersetze `0X` durch die gewählte Nummer. Lege sie nicht unter `workflows/cashctrl/` 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 CashCtrl-Aufgaben. Verwende darin den tatsächlichen Ordnernamen, zum Beispiel:

```markdown
| **CashCtrl**: Buchungen, Rechnungen oder Kontakte nachschlagen | [`06_cashctrl/`](06_cashctrl/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: CashCtrl-Anbindung

Zweck: (mit dem Nutzer ausfüllen: wofür vor allem? Buchungen, Kontakte, Rechnungen?)

## Regeln

- Lesen ist erlaubt. Anlegen und Ändern nur nach Freigabe im Chat.
- Der API-Key liegt in der lokalen Konfiguration des CLI, nie im Chat, nie in Git.
- Beträge und Kontaktdaten stammen aus CashCtrl oder vom Nutzer, nie geschätzt.
- Versand- und Lösch-Operationen (z. B. Rechnung per Mail verschicken, Papierkorb leeren) 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/cash-ctrl-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 `cashctrl` in den PATH.

Alternative, falls eine Go-Toolchain da ist: `go install github.com/wir-drei-digital/cash-ctrl-cli/cmd/cashctrl@latest`

Prüfe die Installation mit `cashctrl commands --json` - kommt eine Liste von Befehlen zurück, ist die Installation da.

### Schritt 3: API-User anlegen

CashCtrl braucht dafür einen eigenen API-User. Leg ihn unter _Einstellungen > Benutzer & Rollen > Hinzufügen > API-User_ an - seine Rolle entscheidet, was der Key später darf. Tipp: gib ihm bewusst eine eingeschränkte Rolle, nicht die volle Administratorrolle.

Notiere dabei zwei Werte: die Organisations-Subdomain (das `myorg` in `https://myorg.cashctrl.com`) und den API-Key, den CashCtrl beim Anlegen anzeigt.

Zum gefahrlosen Ausprobieren: kopiere die Organisation zuerst in eine Test-Organisation (_Einstellungen > Organisationen > Kopieren_) und leg den API-User dort an.

Wichtig: Der Nutzer tippt den API-Key nie in den Chat. `cashctrl init` fragt ihn direkt im Terminal ab und speichert ihn lokal mit 0600-Rechten.

### Schritt 4: cashctrl init ausführen

Lass den Nutzer `cashctrl init` im Terminal ausführen. Der Wizard fragt nach Organisations-Subdomain und API-Key, speichert beides mit 0600-Rechten und prüft sie gleich mit einem einzigen Lese-Aufruf.

### Schritt 5: Verifikation

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

```sh
cashctrl auth verify
```

Der Befehl prüft die Zugangsdaten mit einem echten, unschädlichen Lese-Aufruf gegen die API. Alle verfügbaren Operationen findest du mit `cashctrl commands --json`. Kommt eine Antwort ohne Fehler zurück, steht die Anbindung. Trag in der `CONTEXT.md` das Einrichtungsdatum nach. Arbeitest du in einem ICM, setz den Status der CashCtrl-Zeile im Haupt-Router auf `aktiv`.

## Was du danach kannst

- «Wie sehen die letzten Buchungen aus?»
- «Leg einen Kontakt für Muster AG an, ich diktiere die Angaben.» Der Assistent baut den Entwurf, du gibst frei.
- «Welche Rechnungen sind noch offen?»

## Wichtig zu wissen

- Die API gibt es nur im PRO-Plan. Ohne PRO-Plan funktioniert diese Anbindung nicht.
- Der API-Key kann alles ausführen, was die Rolle des API-Users erlaubt. Wähle deshalb eine eingeschränkte Rolle. Wird der Key widerrufen oder ersetzt, führst du `cashctrl init` erneut aus.
- Versand- und Lösch-Operationen 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.