Katseline, mitteametlik projekt — kasutamine omal vastutusel
e-arveldaja MCP server ühendab sinu AI-assistendi otse Eesti e-arveldajaga (RIK). Arved PDF-idest ja piltidest, pangaimport, kuu lõpp ja Eesti maksud — tavakeeles. Sina vaatad üle ja kinnitad.
Uudised
Olulisemad muudatused ja parandused. Tööriist on aktiivses arenduses.
Tööriist hoiatab nüüd, kui sama pangamakse on raamatus juba olemas — ükskõik mis teed pidi see sisse tuli — ja kontrollib pangaväljavõtte lõppsaldo klappimist raamatupidamisega. Ise midagi ära ei kustuta — annab ainult märku.
Versioonis 0.22.0 võisid laekumised (sh sissemaksed ja tagasimaksed) kirjenduda hoopis raha väljakandmisena. Parandatud versioonis 0.22.1. Viga sai puudutada ainult neid, kes juhtusid öösel vastu 20. juulit, umbes kl 22:30–04:15 (Eesti aeg) oma pangaväljavõtteid importima.
Kahtluse korral võrdle e-arveldaja pangakonto saldot päris saldoga; erinevuse korral impordi mõjutatud väljavõtted uuesti.
Mis see on
e-arveldaja on Eesti riigi raamatupidamistarkvara (RIK). MCP server on väike vahelüli, mis ühendab selle sinu tehisintellekti-assistendiga — olgu selleks Claude, ChatGPT/Codex, Gemini, Cursor või mõni teine.
Tulemus: sa räägid oma assistendiga tavakeeles ja tema teeb e-arveldajas töö ära — loeb arveid PDF-idest ja piltidest, impordib pangaväljavõtteid, sobitab makseid, teeb müügiarveid, koostab aruandeid ja arvutab makse. Sina jääd otsustajaks; assistent teeb rutiini. Töötab nii käibemaksukohustuslastega kui ka mittekohustuslastega.
Päris kõike see siiski ei tee. Igapäevarutiini server katab, aga osa toiminguid — näiteks käibedeklaratsiooni (KMD), TSD-d ja muud Maksu- ja Tolliametiga (EMTA) seonduvat — tee endiselt e-arveldaja veebikeskkonnas.
Server on tasuta ja avatud lähtekoodiga (Apache 2.0). Kood ja kogu dokumentatsioon on GitHubis.
„Impordi LHV väljavõte ja sobita arvetega.“ Ei mingit eksporti-importi ega menüüde otsimist.
Kõik pakettoperatsioonid käivad esmalt dry-run-režiimis — näed täpselt, mida tehakse, enne kui midagi muutub.
Kanded tehakse alles pärast sinu nõusolekut. Iga muudatus läheb loetavasse Markdown-auditilogisse.
Miks ma selle tegin
Algus oli klassikaline „scratching my own itch“ — tahtsin Wise'i ja Lightyeari impordi ning arvete sisestuse endale lihtsamaks teha. Sealt kasvas asi suuremaks.
Nüüd hakkab valmis saama. Kõike see ei tee — käibe- ja TSD-deklaratsioonid jäävad endiselt e-arveldaja veebi kanda — aga teeb päris palju: loeb PDF-id ja pildid arvetena sisse, impordib pangaväljavõtteid, seob kõik kokku, teeb müügiarveid ning kontrollib piirmäärasid ja raamatupidamisreegleid, kus oskab. Ja saad tavakeeles uurida, kuidas su firmal läheb.
Ise majandan sellega paari oma mikrofirmat ja olen juba päris rahul. Liiga palju testitud see veel pole, nii et kontrolli alati üle. Kui teed e-arveldajaga oma mikrofirma raamatupidamist, usun, et on omajagu abiks.
Mida ta oskab
Igapäevane raamatupidamisrutiin loomuliku vestlusega — lõplik otsus jääb sinu teha.
OCR loeb arve PDF-ist või pildilt (JPG/PNG), tuvastab tarnija äriregistrist, täidab KM-määra ja konto varasemate kannete põhjal, loob ostuarve ja seob selle pangamaksega. OCR võib eksida, nii et kontrolli väljad üle.
Impordi LHV, Swedbanki, SEB, Coopi või Luminori väljavõte. Kordusimport säilitab CAMT-i viite ja vastaspoole konto info ka siis, kui API eraldi väljad kaotab, ning leiab duplikaadid kindlamalt.
Impordi Wise'i tehingute CSV — sissetulevad ja väljaminevad maksed, teenustasud eraldatakse omaette kanneteks korrektse kuluarvestuse jaoks.
Seob laekumised ja maksed õigete arvetega. Ülekannete tuvastamisel ettevaatlik — kahtluse korral jätab kinnitamata, mitte ei oleta.
Kuu lõpu kontroll-loend, kasumiaruanne, bilanss, nõuete ja kohustuste vananemine — kuupäevavahemiku järgi, valitud seisuga.
Dividendipakett 22/78 tulumaksuga, jaotamata kasumi ja netovara kontroll (ÄS § 157).
Loob kanded Lightyeari tehingutest, dividendidest ja intressidest ning arvutab kapitalikasumi FIFO-aruande põhjal.
Skannib töökausta ja ütleb, mida saab teha automaatselt, mis vajab üht otsust ja mis raamatupidaja pilku. Tagastab soovitatud järgmise sammu, ülevaateküsimused ja kinnituse eelvaated.
Koosta ja saada müügiarveid, halda kliente, artikleid ja arvete seeriaid. Sissetulevad maksed seob hiljem pangaimport ise arvetega.
Neid ei pea pähe õppima — assistent valib su soovi põhjal ise õige töövoo. Aga kui tahad näha, mis kõik olemas on:
accounting-inboxAlusta siit: skannib kausta, tuvastab sisendid ja pakub järgmised ohutud sammud.book-invoiceOstuarve PDF-ist: loe, valideeri, tuvasta tarnija, eelvaade, loo, lae üles, kinnita.receipt-batchKviitungipakk: loo ja lae üles projekti ostuarved (kinnitus eraldi).import-camtCAMT.053 väljavõte: eelvaade, kanded pärast kinnitust.import-wiseWise'i CSV eelvaade: teenustasud, duplikaadid, vahelejätud.reconcile-bankSobita pangaread arvetega, seejärel autokinnitus või käsitsi ülevaatus.classify-unmatchedRühmita sobitamata pangaread, eelvaade, rakenda pärast kinnitust.month-end-closeKuu lõpp: kontroll-loend, proovibilanss, kasumiaruanne, bilanss.company-overviewFinantsülevaade: bilanss, kasumiaruanne, nõuded, kohustused.vat-registration-thresholdKontrolli 40 000 € käibemaksukohustuse piiri (finants-, kindlustus- ja kinnisvaratulu eraldi).new-supplierLoo tarnija äriregistri otsinguga.lightyear-bookingKanna Lightyeari tehingud ja väljamaksed CSV-st.resolve-accounting-reviewTee ülevaatuskirjest konkreetne tegevusplaan.prepare-accounting-review-actionValmista ette lahendatud kirje järgmine tegevus.setup-credentialsKontrolli ja impordi API-võti failist apikey.txt.setup-e-arveldajaSelgita API-võtme seadistust seadistusrežiimis.Usaldus ja privaatsus
Pärisandmetega töötab vaid siis, kui sina lubad — ja jätab jälje.
Pangaimport, Wise, Lightyear, kviitungipakid ja autokinnitus näitavad esmalt eelvaadet. Kirjeid muudetakse alles pärast sinu selget kinnitust.
Iga muutev tegevus kirjutatakse Markdown-logisse (logs/{firma}.audit.md) — lühike tegevuslause, selge väljade tabel, kontod, summad ja vajadusel dimensioonid.
Skannitud arvete tekst pakitakse turvapiiridesse, et pahatahtlik dokument ei saaks su assistendile peidetud käske anda (prompt injection'i kaitse).
Dokumendid loetakse vaikimisi lokaalselt. Server suhtleb väljapoole vaid e-arveldaja API-ga ja sinu valitud AI-mudeliga — ja äriregistriga, kui tarnijat otsid.
Uurib enne, kuidas sarnased kanded on varem tehtud, ja teeb siis samamoodi. KM-käsitlust ta ise välja ei mõtle.
Mitu API-võtit kõrvuti, lülitumine ühe käsuga. Ettevõtte vahetamisel tühjendatakse vahemälu, et andmed ei seguneks.
See on katseline ja mitteametlik projekt — testitud, aga mitte üleliia palju. See ei ole seotud RIK-iga ega e-arveldaja teenusega ega ole nende poolt heaks kiidetud. Tarkvara töötab pärisandmetega ning võib luua, muuta, kinnitada ja kustutada raamatupidamiskirjeid. Kontrolli alati tulemused üle. Autor ei vastuta andmekao ega valede kannete eest.
Tehniline seadistus
Vajad e-arveldaja kontot, MCP-toega AI-assistenti ja Node.js 18+.
Logi sisse e-arveldajasse → Seadistused → Üldised seadistused → Lisa uus juurdepääsuluba. Lisa oma avalik IP-aadress ja salvesta. Laadi alla fail apikey.txt. Ära kunagi lisa seda faili gitti.
Enamik AI-assistente oskab serveri ise paika panna — ütle lihtsalt: „Lisa e-arveldaja MCP server siia projekti, pakett on npm-is: e-arveldaja-mcp.“
Kui eelistad käsitsi — Claude Code'is piisab ühest reast:
Muudes klientides (Cursor, Windsurf, Cline, Gemini CLI, Codex CLI, Antigravity) lisa sama oma MCP-seadistusse — või lase assistendil fail ise luua:
Soovitus — lisa server projektipõhiselt. e-arveldaja MCP toob iga vestluse algul mudeli konteksti vaikimisi 123 tööriista; see on püsiv token-kulu igas seansis. Lisa server seetõttu ainult sinna kausta, kus raamatupidamist teed. claude mcp add teeb seda vaikimisi — server kehtib ainult selles projektis. Väldi globaalset paigaldust (-s user): muidu laeksid kõik tööriistad konteksti igas projektis, ka raamatupidamisega mitteseotutes, ja kulutaksid asjata tokeneid. Teistes klientides eelista samuti projektisisest seadistust (nt Cursoris .cursor/mcp.json) globaalse asemel.
Konteksti saab kärpida kasutamata tööriistagruppe välja lülitades: EARVELDAJA_DISABLE_LIGHTYEAR=1, EARVELDAJA_DISABLE_TAX_TOOLS=1, EARVELDAJA_DISABLE_REFERENCE_ADMIN=1, EARVELDAJA_DISABLE_ANNUAL_REPORT=1, EARVELDAJA_DISABLE_SALES=1 ja EARVELDAJA_DISABLE_PRODUCTS=1. Ostupoolele keskendunud seadistus jääb kõigi kärbetega ligikaudu 80 tööriista juurde; vajadusel saab peidetud detailsed tööriistad tagasi tuua muutujaga EARVELDAJA_EXPOSE_GRANULAR_TOOLS=1.
Pane apikey.txt töökausta. Server tunneb selle ära ja pakub importi — või ütle assistendile: „Impordi mu API-võti failist apikey.txt.“ Seejärel proovi: „Skanni see kaust ja ütle, mida saab automaatselt teha.“
Töötab nende klientidega
Tahad enne päris andmeid proovida? Sea EARVELDAJA_SERVER=demo ja server töötab e-arveldaja demoserveris.
Vajad abi seadistamise või kohandamisega? Kirjuta Indrekule.
Korduma kippuvad küsimused
import_opening_balances). Server kontrollib, et deebet ja kreedit klapivad, näitab eelvaadet (dry-run) ja salvestab alles pärast sinu kinnitust. Edaspidi arvestab algbilanssi automaatselt kontojääkides, proovibilansis, bilansis, kasumiaruandes, aastaaruandes ja dividendide § 157 kontrollis. See samm on vabatahtlik — ka ilma selleta töötab kõik, lihtsalt ilma algsaldodeta.