Vor dem Erfassen überprüfen
Prüfen Sie zunächst die aktuelle Zusammenfassung; Ledger-Einträge sind Finanzdaten, und ein doppelter Eintrag ist schwieriger nachzuvollziehen als ein fehlender.
ledger({ action: "summary", months: 1 })Öffentliches MCP-Tool
ledger
Zweck
Verwalten Sie regulierte Finanztransaktionen und Erinnerungen an die Verlängerung externer Dienste über den Ledger-Dispatcher mit strukturierten Zusammenfassungen und Auditgrenzen.
Wann zu verwenden
- Eine Ausgabe oder eine andere unterstützte Transaktion mit Betrag, Währung, Datum und Händlerkontext erfassen.
- Autorisierte Ledger-Einträge mit Datums-, Kategorie-, Währungs- oder Projektfiltern auflisten, zusammenfassen oder überblicken.
- Abonnement-Erneuerungserinnerungen erstellen oder verwalten und deren Überprüfungszyklus optional mit TODOs verknüpfen.
Wann NICHT zu verwenden
- Verwenden Sie kein generisches remember für Finanzdatensätze; ledger wahrt den Finanzdatenvertrag.
- Leiten Sie keine währungsübergreifende Gesamtsumme ab; Zusammenfassungen halten Währungen getrennt, wenn eine Aggregation unsicher ist.
- Aktualisieren oder löschen Sie einen Datensatz nicht ohne die erforderliche exakte ID/Version und Benutzerautorisierung.
- Die REST-API akzeptiert einen breiteren Feldsatz als das öffentliche MCP-Tool; siehe /docs/api/memory für Scope-, Bucket-, Team- und Provenienzfilter.
Erforderlicher Scope
- Leseaktionen erfordern memory:read; Transaktions- und Abonnementmutationen erfordern memory:write auf der öffentlichen Chat-Oberfläche.
- Die authentifizierte Eigentümer-, Team- und Scope-Grenze regelt jeden Ledger-Eintrag und jede Erinnerungsoperation.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
action | add_expense | list | summary | overview | update_transaction · erforderlich | Vom Aufrufer ausgewählte Ledger-Operation. Es werden nur diese fünf Literalwerte akzeptiert. |
item / amount / transaction_type / currency | string / number | Kernfelder der Transaktion; Betrag und Währung sind für finanzielle Schreibvorgänge erforderlich. |
transaction_date / category / merchant / payment_method / note | string | Optionale Transaktionsklassifizierungs-, Datums- und Notizfelder. |
query / date_from / date_to / min_amount / max_amount | string / number | Listen- und Zusammenfassungsfilter. |
transaction_id / expected_version / patch | string / integer / object | Exaktes Aktualisierungsziel, optimistische Nebenläufigkeitsversion und zulässige Aktualisierungsfelder. |
owner_timezone / project_id | string | Datumsinterpretation und autorisierte Projekt- oder Teamgrenze. |
limit / offset / months | integer / boolean · Standard: 20 / 0 / 6 / false | Paginierung, Zusammenfassungshorizont und Steuerung strukturierter Ausgaben. |
Rückgabeschema
Die strukturierte Ausgabe enthält die angeforderte Transaktion, Zusammenfassungsgruppen oder Übersicht sowie eine benutzerseitige Textzusammenfassung. Widget-Aufrufer können Aktualisierungsmetadaten erhalten; vertrauliche Daten sind niemals Teil des Antwortvertrags.
Beispiele
ledger({
action: "add_expense",
item: "Domain renewal",
amount: 18.00,
currency: "USD",
transaction_date: "2026-08-21",
category: "software"
})ledger({ action: "summary", months: 1 })Fehler
- Autorisierungsfehler: Dem Token fehlt memory:read für Lesevorgänge oder memory:write für Mutationen.
- Validierungsfehler: Erforderliche Transaktionsfelder, Datumsformate, Währung oder Aktionswerte sind ungültig.
- Nebenläufigkeitsfehler: Eine Aktualisierung weist eine veraltete expected_version auf oder die genaue Transaktion wurde nicht gefunden.
- Aggregationsgrenze: Datensätze in unterschiedlichen Währungen werden separat gemeldet, anstatt eine fehlerhafte Gesamtsumme zu erzeugen.
Zugehörige Tools
Quelle: MCP-Referenz