Wat een assistent kan doen
Muntar heeft een eigen MCP-server. MCP is de manier waarop een AI-assistent met een programma praat: de assistent ziet een lijst met tools en roept die aan. Koppel je een assistent aan Muntar, dan kan hij je cijfers opvragen en, met de juiste rechten, boekingen voorbereiden.
Koppelen gaat het makkelijkst door in te loggen vanuit de app zelf: zie Een AI-app koppelen. Een app die alleen een vaste sleutel kan meesturen, koppel je met een API-key uit het scherm “AI-koppelingen” (zie API-keys en MCP). De rechten die je aanvinkt bepalen wat de assistent mag aanroepen.
Wat hij kan lezen
Link naar de kop “Wat hij kan lezen”Met de scope “Lezen” kan een assistent bij:
- je entiteiten, met hun soort en het aantal rekeningen en categorieën eronder
- je rekeningen, met soort, valuta, alle gekoppelde IBAN’s en of het geld vrij opneembaar is
- je categorieën per entiteit, ook de gearchiveerde, met hoeveel geboekte regels, klaargezette importregels en regels erop staan
- je netto vermogen op een peildatum, per entiteit en samengeteld, eventueel met een uitsplitsing per rekening
- je transacties, gepagineerd en te filteren op entiteit, rekening, categorie, periode en zoekterm
- je vrij inzetbaar vermogen, met de buffer, de reserves en een eventueel tekort erbij
- je imports, en van een import de regels met de categorieën die erbij passen. Het IBAN van de tegenpartij, het saldo en de brontekst uit het bankbestand komen daarbij niet mee.
Daarnaast liggen er drie naslagstukken klaar die de assistent zelf kan opvragen: een uitleg van het datamodel, een uitleg van de afspraken over bedragen, datums en id’s, en een korte samenvatting per entiteit.
Waar een antwoord een id noemt, staat de naam ernaast. Zo hoeft een assistent nooit te gokken welke rekening bij welk id hoort.
Wat hij kan vastleggen
Link naar de kop “Wat hij kan vastleggen”Een assistent schrijft nooit in één stap in je boeken. Een import loopt in vier stappen:
- Voorbeeld. Hij leest het bankbestand en vertelt wat erin zit: welke bron, hoeveel regels, wat de saldocheck zegt en welke regels al eerder geïmporteerd zijn. Er wordt niets opgeslagen.
- Klaarzetten. Hij zet de nieuwe regels klaar voor beoordeling. Nog steeds geen boeking.
- Beoordelen. Per regel komt vast te staan wat het is: een uitgave met een categorie, een overboeking naar een eigen rekening, of een regel die niet geboekt wordt. Dat doe jij in het reviewscherm, of je assistent, zie hieronder. Nog steeds geen boeking.
- Boeken. Pas hier gaat het naar je boeken. Alle regels moeten eerst beoordeeld zijn; staat er nog iets open, dan weigert Muntar met een uitleg in plaats van half te boeken.
Losse boekingen kan hij ook vastleggen, via dezelfde zes sjablonen als het scherm: uitgave, inkomen, overboeking, kapitaalstorting, koop van een belegging en waardering.
Een geboekte import kan hij in zijn geheel terugdraaien. Dat gebeurt met tegenboekingen: het origineel blijft staan, er komt een spiegelbeeld naast.
Een bestand met meerdere rekeningen
Link naar de kop “Een bestand met meerdere rekeningen”Sommige bestanden bevatten meerdere rekeningen achter elkaar: een QIF uit een boekhoudprogramma, of een bankexport met meerdere IBAN’s. Je assistent vraagt dan eerst het overzicht op: per rekening uit het bestand hoeveel regels, welke periode, en of Muntar al een bestaande rekening voorstelt. Dat overzicht legt hij je voor, en zet daarna per rekening een import klaar: bestaande rekeningen koppelt hij, nieuwe maakt hij aan. Er wordt bij het overzicht niets opgeslagen; pas daarna komen de koppelingen en de imports er echt. Het beoordelen en boeken gaat daarna zoals bij elke import.
Categorieën voorstellen bij een import
Link naar de kop “Categorieën voorstellen bij een import”Een assistent kan de categorieën van een klaargezette import voor je invullen, ook als je die import zelf in het scherm hebt klaargezet. Hij zoekt de import op, leest de regels die nog een categorie nodig hebben en zet per regel een voorstel met hoe zeker hij is. Daar is geen AI-provider in Muntar voor nodig: de assistent is zelf de AI. Is een regel geld naar of van een eigen rekening, zoals je pensioen of je beleggingsrekening, dan stelt hij een overboeking voor in plaats van een categorie. Een terugbetaling van een winkel kan hij op de oorspronkelijke uitgave zetten, en een voorschot dat later met je inkomen terugkomt op dat inkomen. Zie Terugbetalingen en verrekening.
In het reviewscherm zie je die voorstellen met de bron “Assistent” en een percentage, bijvoorbeeld “Assistent 87%”. Je accepteert ze, past ze aan of negeert de regel, en daarna boek je de import zoals altijd. Een regel die je al beoordeeld hebt, laat de assistent staan.
De regels die de assistent leest, gaan naar de AI achter die assistent. Dat staat los van de keuze “Cloud-provider toestaan” bij de AI-instellingen: die gaat alleen over de provider die Muntar zelf aanroept.
De beoordeling afmaken
Link naar de kop “De beoordeling afmaken”Je assistent kan verder gaan dan voorstellen. Hij kan per regel vastleggen wat het is: het soort, de categorie, de eigen rekening aan de andere kant, een aantekening en de status (geaccepteerd, genegeerd of weer open). Tot 1000 regels per keer, dus een afschrift van een heel jaar gaat in een handvol aanroepen.
Een regel die jij al beoordeeld hebt, laat hij niet zomaar staan of vallen: raakt zijn aanroep zo’n regel, dan zet hij hem toch om, en staat dat in het logboek met hoeveel regels het ging. Zolang hij alleen regels raakt die nog open staan, overschrijft hij niets van jou.
Voor de rest zijn er twee knoppen in toolvorm. Hij kan de openstaande regels in één keer accepteren, waarbij regels die nog een categorie nodig hebben bewust blijven staan, of ze in één keer negeren, zodat de rest van de import wel geboekt kan worden. Allebei raken ze nooit een regel die al beoordeeld is.
Een klaargezette import kan hij ook weggooien. De regels van die import zijn dan nog niet geboekt, dus je saldi veranderen niet en hetzelfde bestand kun je daarna opnieuw klaarzetten. Heb je het beginsaldo van die import al apart geboekt, dan blijft die ene boeking wel staan; het logboek noemt dat erbij.
Een geboekte regel corrigeren
Link naar de kop “Een geboekte regel corrigeren”Staat een boeking eenmaal in je boeken, dan wordt hij nooit aangepast en nooit verwijderd. Je assistent kan hem wel corrigeren, op twee manieren.
Staat een uitgave of inkomst in de verkeerde categorie, dan boekt hij de oude regel tegen en legt hij een nieuwe vast met hetzelfde bedrag, dezelfde datum en de nieuwe categorie. Hetzelfde als de knop “Categorie wijzigen” in het transactieoverzicht. Bij een overboeking, een kapitaalstorting of een koop kan dat niet: die hebben geen categorie om te wijzigen.
Klopt de boeking helemaal niet, dan boekt hij er een tegenboeking bij. Het origineel blijft staan, met het spiegelbeeld ernaast, en samen zijn ze per saldo nul. Hoort de boeking bij een kapitaalstorting tussen twee entiteiten, dan gaat de gespiegelde helft mee tegen. Voor een hele import is er de aparte tool die de batch in zijn geheel terugdraait.
Categorieën beheren
Link naar de kop “Categorieën beheren”Past een regel in geen bestaande categorie, dan kan de assistent er een categorie bij maken, op het hoogste niveau of onder een bestaande categorie. Hij kan een bestaande categorie ook een andere naam geven, onder een andere groep zetten, laten opgaan in een andere categorie, verwijderen of archiveren, en een gearchiveerde categorie terugzetten. De boekingen en regels op een categorie blijven bij verplaatsen, hernoemen en samenvoegen gewoon staan; bij verwijderen alleen als de categorie leeg is. Een categorie die Muntar zelf gebruikt kan hij hernoemen en verplaatsen, maar niet verwijderen, archiveren of laten opgaan in een andere categorie. Omdat dit alles je categorieboom verandert, komt elke wijziging met de naam en, waar dat helpt om te zien wat er gebeurde, de aantallen in het logboek te staan, zodat je hem kunt terugzetten.
Rekeningen en IBAN’s beheren
Link naar de kop “Rekeningen en IBAN’s beheren”Een assistent kan ook je rekeningen inrichten: een rekening aanmaken onder een entiteit, hem hernoemen en archiveren. Alle zeven soorten kunnen, dus ook overig bezit: koop je een auto, dan maakt hij daar een bezitsrekening voor, en wordt de bankregel een overboeking naar die rekening in plaats van een uitgave.
Een IBAN kan hij koppelen en weer loskoppelen. Ook een beleggingsrekening mag er een dragen, want een broker betaalt vaak uit vanaf een rekening op jouw naam. Wat hij niet hoort te doen is een gedeelde stortings-IBAN van een pensioenfonds of een broker aan jouw rekening hangen; dat nummer is van die partij, en voor zulke betalingen is een regel de juiste weg.
Regels beheren
Link naar de kop “Regels beheren”Regels die een geïmporteerde transactie automatisch indelen kan hij opsommen, aanmaken, wijzigen en verwijderen. Een regel wijst naar een categorie of naar een eigen rekening; dat laatste maakt van de transactie een overboeking. Een net gemaakte regel kan hij meteen loslaten op een import die al klaarstaat; dat verandert alleen de voorstellen bij regels die nog openstaan.
Toestemming en het logboek
Link naar de kop “Toestemming en het logboek”Muntar vraagt zelf geen bevestiging voor een schrijvende tool: de toestemming geef je op het moment dat je je AI-app aan Muntar koppelt, bij je client zelf. Claude vraagt daar per tool om je akkoord (“Always allow” of eenmalig toestaan); zo’n client bepaalt dus zelf of en hoe vaak hij het je nog vraagt voordat hij een tool aanroept. Muntar zelf legt geen extra stap ertussen.
Wat wel blijft: elke schrijvende tool zet een regel in het logboek, met de naam van de tool, de aantekening dat een AI-agent het deed, en wat er stond en wat er kwam. Zo zie je achteraf precies wat je assistent deed, en kun je het terugdraaien:
- Een geboekte import draai je terug met
muntar_undo_import: de originele boekingen blijven staan, er komen tegenboekingen naast. - Een losse boeking draai je terug met
muntar_reverse_entry: dezelfde regels met omgekeerd teken. - Een saldocorrectie draai je terug met
muntar_undo_balance_correction: die haalt de correctie zelf weg, in plaats van hem tegen te boeken. - Een categoriewissel op een al geboekte regel zet je terug door
muntar_recategorize_entrynog een keer aan te roepen, nu met de oorspronkelijke categorie. - Een regel of categorie (aanmaken, hernoemen, verplaatsen, samenvoegen, verwijderen, archiveren, terugzetten) pas je aan met dezelfde tool, met de vorige naam of plek uit het logboek erbij.
Gaat het om een hele import, een categorie met veel regels of een rekening, dan staan de aantallen die het raakt gewoon in het logboek en in het antwoord dat de tool teruggeeft, zoals bij samenvoegen: “Boodschappen (211 geboekte regels, 3 regels) samenvoegen in Eten › Supermarkt”.
Valt de verbinding weg terwijl je assistent een schrijvende tool aanroept, dan kan hij de aanroep veilig herhalen: een sleutel die de handeling identificeert zorgt dat Muntar nooit dubbel boekt. Zie Waarom je niet dubbel boekt hieronder.
Waarom je niet dubbel boekt
Link naar de kop “Waarom je niet dubbel boekt”Elke aanroep die je boeken raakt draagt een sleutel die de handeling identificeert. Valt de verbinding weg en probeert je assistent het opnieuw, dan herkent Muntar dezelfde handeling. Bij het boeken van een import en bij een losse boeking krijgt hij het antwoord van de eerste poging terug, zonder tweede boeking. Bij het terugdraaien van een import krijgt hij de melding dat die batch niet meer op geboekt staat, en bij het corrigeren van één geboekte regel de melding dat die regel al is tegengeboekt. In geen van beide gevallen komt er een tweede tegenboeking bij.
De tools die geen boeking maken hebben zo’n sleutel niet nodig: een voorstel, een beoordeling of een koers nog een keer wegschrijven vervangt wat er stond, het komt er niet een tweede keer bij.
Wat je achteraf kunt terugzien
Link naar de kop “Wat je achteraf kunt terugzien”Elke schrijvende aanroep laat een spoor achter in het logboek, met de naam van de gebruikte tool en de aantekening dat een AI-agent het deed. Zo is achteraf te zien welke boeking uit een gesprek kwam en welke je zelf in het scherm maakte.
Wat er gebeurt als een waarde niet klopt
Link naar de kop “Wat er gebeurt als een waarde niet klopt”Een assistent levert bedragen, datums en codes als tekst aan, en Muntar is streng in die vorm. Een punt is altijd het decimaalteken, een komma en een duizendtalscheiding bestaan niet, en meer decimalen dan de kolom draagt is een weigering en geen afronding. Gaat er iets mis, dan stopt de aanroep voordat er iets is opgeslagen en krijgt de assistent een zin te zien die het veld, de ontvangen waarde en de toegestane vorm noemt, zodat hij het zelf kan herstellen.
Elke weigering, en elke onverwachte fout, komt in de probleemwachtrij te staan. Daar kijk je terug wat er misging, en een assistent kan die wachtrij zelf lezen en een regel afvinken zodra de oorzaak weg is.
Foutmeldingen
Link naar de kop “Foutmeldingen”Een foutmelding van een tool komt in de taal van de werkruimte, Nederlands of Engels. Die taal ligt vast vanaf het moment dat de werkruimte ontstond: de taal waarin je toen registreerde of de werkruimte aanmaakte. Er is nog geen scherm om die taal achteraf te wijzigen. De tekst noemt wat er misging en wat de assistent nu kan doen, zodat hij zelf verder kan zonder de aanroep in de verkeerde taal te herhalen.
Wat een assistent niet kan
Link naar de kop “Wat een assistent niet kan”- Meer dan zijn scopes toestaan. Een key zonder “Schrijven” kan geen boeking vastleggen.
- Meer dan zijn rol toestaat. API-keys aanmaken, de AI-provider omzetten of entiteiten aanmaken blijft voorbehouden aan de eigenaar. Zie Rollen.
- Bestanden van de server lezen. Een import komt binnen als geplakte tekst, tot 5 MB per keer; grotere exports splits je op. Een pad naar een bestand op de server is geen geldige bron; die weg staat uit.
- Onbeperkt aanroepen doen. Er geldt een grens van 120 verzoeken per minuut per agent, plus een ruimere grens per IP-adres.
- Iets van een andere werkruimte zien. De key bepaalt de werkruimte, en elke vraag blijft daarbinnen.