KI-Anbindung (MCP)

Receipts Space kann als lokaler KI-Server auftreten. So durchsuchen und beantworten Assistenten wie Claude, Cursor oder VS Code Fragen zu deinen Belegen - direkt auf deinem Mac, ohne dass deine Daten in die Cloud gehen.

Warum ist das nützlich?

KI-Assistenten sind stark darin, Fragen in normaler Sprache zu beantworten - aber nur, wenn sie an die passenden Daten kommen. Genau das macht diese Funktion: Sie verbindet deinen KI-Assistenten mit deiner Beleg-Bibliothek. Statt selbst zu suchen, zu filtern und zu addieren, fragst du einfach:

• “Wie viel habe ich letztes Quartal bei meinem Hosting-Anbieter ausgegeben?”
• “Fasse mir die letzte Rechnung von der Autowerkstatt zusammen.”
• “Welche Belege in der Kategorie Bürobedarf sind noch nicht bezahlt?”
• “Suche alle Restaurant-Quittungen über 50 Euro aus dem Juni.”

Der Assistent durchsucht dann deine Belege, liest bei Bedarf den erkannten Text (OCR) und beantwortet die Frage - inklusive Rechnen, Zusammenfassen und Gegenüberstellen.

Das Besondere: Das geschieht lokal auf deinem Mac. Es wird kein Beleg in eine fremde Cloud hochgeladen, damit die KI ihn “sehen” kann. Der Assistent greift nur auf die Daten zu, die er für die konkrete Frage braucht.

Was der Assistent kann

Die Anbindung stellt vier Lese-Werkzeuge bereit:

• Belege suchen - mit der gewohnten Receipts-Suchsyntax, nach Text, Kontakt, Kategorie, Schlagwort, Datum oder Betrag, zusätzlich gefiltert nach bezahlt/unbezahlt, Ausgabe/Einnahme oder markiert. Jede Suche liefert außerdem eine fertige Summe (Ausgaben und Einnahmen) über alle Treffer - so muss der Assistent Beträge nicht selbst zusammenzählen und die Summe bleibt auch bei vielen Treffern korrekt.
• Beleg lesen - alle Angaben eines Belegs samt erkanntem Text (OCR).
• Datei abrufen - die angehängte PDF oder das Bild eines Belegs.
• Namen nachschlagen - die vorhandenen Kategorie-, Kontakt- und Schlagwort-Namen, damit der Assistent die echten Bezeichnungen kennt und nicht raten muss.

Es gibt bewusst keine Werkzeuge zum Ändern, Importieren oder Löschen. Der Assistent kann deine Bibliothek nur lesen, nie verändern.

Datenschutz und Sicherheit

Was dich schützt:

• Nur lokal. Der Server ist ausschließlich auf deinem eigenen Rechner erreichbar (127.0.0.1/localhost). Aus dem Internet oder dem lokalen Netzwerk ist er nicht erreichbar.
• Nur mit Token. Jede Anfrage braucht einen geheimen Zugriffs-Token. Ohne gültigen Token wird sie abgewiesen. Den Token kannst du jederzeit in den Einstellungen neu erzeugen (bestehende Verbindungen müssen dann neu eingerichtet werden).
• Nur Lesen. Es gibt keine Werkzeuge, die Belege ändern, importieren oder löschen.
• Nur, wenn du willst. Die Funktion ist standardmäßig aus und startet nur, wenn du sie ausdrücklich einschaltest.
• Nachvollziehbar. Jeder Zugriff erscheint im sichtbaren Protokoll der App: wenn sich ein KI-Werkzeug verbindet und bei jeder einzelnen Suche oder gelesenen Datei - jeweils mit den verwendeten Parametern. So siehst du jederzeit, was abgefragt wurde (siehe Protokoll einsehen).

Der KI-Assistent selbst kann - je nach Anbieter - Teile deiner Frage und der gefundenen Beleg-Daten an seinen eigenen Cloud-Dienst senden, um zu antworten. Was Receipts Space liefert, bleibt lokal; was dein KI-Assistent danach damit macht, hängt von diesem Assistenten ab. Wähle also einen Assistenten, dessen Datenschutz du vertraust, und frag im Zweifel keine besonders sensiblen Belege ab.

Aktivieren

1. Öffne Receipts Space und eine Bibliothek.
2. Gehe zu Einstellungen > MCP Server.
3. Schalte “Enable MCP server (experimental)” ein.
4. Der Status wechselt auf “Running on port 28282” (Standard-Port, änderbar).

Sobald der Server läuft, zeigt die Einstellungsseite die URL, den Token und einen fertigen Einrichtungs-Baustein für den gewählten Assistenten - jeweils mit einem Kopier-Knopf.

Einrichten (Beispiele)

Wähle in den Einstellungen unter Setup deinen Assistenten aus und kopiere den vorbereiteten Baustein. Die folgenden Beispiele zeigen, wie das aussieht. <token> steht dabei für deinen persönlichen Token aus den Einstellungen.

Claude Code

Im Terminal:

claude mcp add --transport http receipts \
  http://127.0.0.1:28282/mcp \
  --header "Authorization: Bearer <token>"

Danach prüft /mcp in Claude Code die Verbindung.

Cursor

In ~/.cursor/mcp.json (global) oder .cursor/mcp.json (pro Projekt):

{
  "mcpServers": {
    "receipts": {
      "url": "http://127.0.0.1:28282/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

VS Code (GitHub Copilot)

In der User-mcp.json (Befehlspalette: “MCP: Open User Configuration”) oder projektlokal in .vscode/mcp.json:

{
  "servers": {
    "receipts": {
      "type": "http",
      "url": "http://127.0.0.1:28282/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

Claude Desktop

Claude Desktop spricht lokal nur den stdio-Transport. Die Anbindung geht über die Standard-Brücke mcp-remote (setzt ein installiertes Node.js/npx voraus). In ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "receipts": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "http://127.0.0.1:28282/mcp",
        "--header", "Authorization: Bearer <token>"
      ]
    }
  }
}

Danach Claude Desktop neu starten.

Anderer Client

Jeder Assistent, der Streamable HTTP mit Bearer-Token spricht, lässt sich verbinden. Nötig sind nur:

• URL: http://127.0.0.1:28282/mcp
• Header: Authorization: Bearer <token>

So könnte ein Gespräch aussehen

Du: Wie viel habe ich dieses Jahr für Software-Abos ausgegeben?

Assistent: Schaut nach, welche Kategorie passt (findet “Software”), sucht die Belege des Jahres in dieser Kategorie, addiert die Beträge und nennt dir die Summe samt Liste der Posten.

Du: Fasse mir die letzte Rechnung von meinem Steuerberater zusammen.

Assistent: Sucht den Kontakt, nimmt den neuesten Beleg, liest den erkannten Text und gibt dir eine kurze Zusammenfassung mit Datum, Betrag und Leistungen.

Grenzen

• Es wird immer die aktuell geöffnete Bibliothek verwendet. Bei mehreren offenen Bibliotheken ist das die aktive.
• Nur Lesen - keine Änderungen, kein Import, kein Löschen.
• Der Server nutzt einen festen Port. Ist er belegt, zeigt der Status einen Fehler - dann in den Einstellungen einen anderen Port wählen.

Protokoll einsehen

Jeder Zugriff über die KI-Anbindung wird im Logbuch der App festgehalten und mit #mcp gekennzeichnet - so bleibt transparent, welches Werkzeug wann was gelesen hat. Du siehst dort:

• wenn sich ein KI-Werkzeug verbindet, z. B. #mcp Claude Code 1.2.3 connected
• jede Suche und jeden gelesenen Beleg samt Parametern, z. B. #mcp search_receipts query="Hotel", limit=10 oder #mcp get_receipt uid="..."

Hilfe bei Problemen

• Status “Failed”: Der Port ist wahrscheinlich belegt. Wähle einen anderen Port.
• Der Assistent bekommt eine 401-Meldung: Der Token stimmt nicht. Token neu kopieren oder neu erzeugen und die Einrichtung aktualisieren.
• “No receipts library is currently open”: Öffne in der App eine Bibliothek.

Bei weiteren Fragen hilft unser Support-Team gerne weiter.