Katseline, mitteametlik projekt — kasutamine omal vastutusel
Lase tehisintellektil raamatupidamise rutiin ära teha.
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.
Mis see on
Sild AI ja e-arveldaja vahel
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.
Räägi tavakeeles
„Impordi LHV väljavõte ja sobita arvetega.“ Ei mingit eksporti-importi ega menüüde otsimist.
Assistent näitab eelvaadet
Kõik pakettoperatsioonid käivad esmalt dry-run-režiimis — näed täpselt, mida tehakse, enne kui midagi muutub.
Sina kinnitad
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
Võimalused
Igapäevane raamatupidamisrutiin loomuliku vestlusega — lõplik otsus jääb sinu teha.
Ostuarved PDF-ist ja pildilt
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.
Pangaimport (CAMT.053)
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.
Wise'i tehingud
Impordi Wise'i tehingute CSV — sissetulevad ja väljaminevad maksed, teenustasud eraldatakse omaette kanneteks korrektse kuluarvestuse jaoks.
Pangaridade sobitamine
Seob laekumised ja maksed õigete arvetega. Ülekannete tuvastamisel ettevaatlik — kahtluse korral jätab kinnitamata, mitte ei oleta.
Kuu lõpp ja aruanded
Kuu lõpu kontroll-loend, kasumiaruanne, bilanss, nõuete ja kohustuste vananemine — kuupäevavahemiku järgi, valitud seisuga.
Eesti maksud
Dividendipakett 22/78 tulumaksuga, jaotamata kasumi ja netovara kontroll (ÄS § 157).
Lightyeari investeeringud
Loob kanded Lightyeari tehingutest, dividendidest ja intressidest ning arvutab kapitalikasumi FIFO-aruande põhjal.
Raamatupidamise „inbox“
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.
Müügiarved
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:
Kõik 15 töövoogu (MCP-promptid)
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.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
Viimane sõna jääb sinule
Pärisandmetega töötab vaid siis, kui sina lubad — ja jätab jälje.
Dry-run vaikimisi
Pangaimport, Wise, Lightyear, kviitungipakid ja autokinnitus näitavad esmalt eelvaadet. Kirjeid muudetakse alles pärast sinu selget kinnitust.
Auditilogi
Iga muutev tegevus kirjutatakse Markdown-logisse (logs/{firma}.audit.md) — lühike tegevuslause, selge väljade tabel, kontod, summad ja vajadusel dimensioonid.
OCR on liivakastis
Skannitud arvete tekst pakitakse turvapiiridesse, et pahatahtlik dokument ei saaks su assistendile peidetud käske anda (prompt injection'i kaitse).
Lokaalne ja kitsas
Dokumendid loetakse vaikimisi lokaalselt. Server suhtleb väljapoole vaid e-arveldaja API-ga ja sinu valitud AI-mudeliga — ja äriregistriga, kui tarnijat otsid.
Järgib varasemaid kandeid
Uurib enne, kuidas sarnased kanded on varem tehtud, ja teeb siis samamoodi. KM-käsitlust ta ise välja ei mõtle.
Mitu ettevõtet
Mitu API-võtit kõrvuti, lülitumine ühe käsuga. Ettevõtte vahetamisel tühjendatakse vahemälu, et andmed ei seguneks.
Oluline — kasutamine omal vastutusel
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
Käima saab umbes 5 minutiga
Vajad e-arveldaja kontot, MCP-toega AI-assistenti ja Node.js 18+.
Võta e-arveldajast API-võti
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.
Lisa MCP server
Enamik AI-assistente oskab serveri ise paika panna — ütle lihtsalt: „Lisa e-arveldaja MCP server, 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 120 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.
Impordi võti ja alusta
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