Ühenda AI assistent (MCP)

MoneyLights’il on sisseehitatud MCP server, nii et AI assistent — Claude Desktop, Claude Code, IDE agent, mis iganes, mis räägib protokollist — saab sinu organisatsiooni andmetega töötada soovi korral.

See on sama mandaadi kui REST API: MCP ühendus on API võti, sama ulatusega, sama piirangute ja sama tühistamisnupuga. Midagi eraldi haldamiseks ei ole.

Ühendamine

Lõpp-punkt on https://api.moneylights.app/mcp (Streamable HTTP). Tüüpiline kliendi konfiguratsioon:

{
  "mcpServers": {
    "moneylights": {
      "url": "https://api.moneylights.app/mcp",
      "headers": { "X-API-Key": "ml_sk_..." }
    }
  }
}

Claude Code’iga on see üks käsk:

claude mcp add --transport http moneylights https://api.moneylights.app/mcp \
  --header "X-API-Key: ml_sk_..."

Loo võti Seaded → API võtmed ja anna sellele ainult need ulatused, mida assistent vajab. Kõik vajab võtit, sealhulgas tööriistade loetlemine.

Mida assistent teha saab

Tööriistade loetelu arvutatakse sinu võtme ulatustest, igal päringul. Võti ilma ulatuseta ei saa kunagi isegi teada, et vastav tööriist eksisteerib.

Tööriist	Ulatus	Mida see teeb
`get_cashflow_overview`	`cashflow:read`	Kuu sissetulekud/kulud/neto, avamisbalanss, peamised kategooriad
`get_analytics_overview`	`analytics:read`	Kategooriate, kliendi, projekti ja isiku kaupa koondatud andmed
`list_transactions`	`transactions:read`	Tehingud, filtreeritud ja leheküljed, igaühel on seotud dokumendid
`list_documents`	`documents:read`	Dokumendid ja nende väljavõetud väljad, igaühel on seotud liikumised
`get_document_file`	`documents:read`	Ühe dokumendi originaalfail — PDF või pilt, mida rakendus näitab
`get_pending_distribution`	`profitpulse:read`	Ootel Safe-to-Spend jaotused
`list_vendors`	`vendors:read`	Tarnijad, koos kogukuludega
`list_clients`	`clients:read`	Kliendid, koos kogutuludega
`list_projects`	`projects:read`	Projektid, koos kogude ja sihtidega
`upload_document`	`documents:write`	Failid arve või kviitungina sinu dokumentidesse

Mõlemad ülevaated arvutatakse sama aluse pealt ja ütlevad nii: iga vastus sisaldab basis — periood, valuutad, kaetud kontod (iga nähtav, välja arvatud juhul, kui küsitakse id järgi), ja kuidas ülekandeid organisatsiooni enda kontode vahel käsitleti. Vaikimisi on need välja jäetud sissetulekutest ja kuludest, jalg-jala haaval, täpselt nagu rakenduse Cashflow vaade neid näitab; edasta includeInternalTransfers: true mõlemale tööriistale toore panga liikumise jaoks, mida basis siis sellisena märgib ja mida ei saa võrrelda vaikimisi. Võrdle numbreid kahe tööriista vahel ainult siis, kui nende basis vastab. netCashResult on sissetulek miinus kulud panga liikumistest — rahaline tulemus, mitte raamatupidamislik kasum.

Milline dokument käib millise liikumisega

Mõlemad loetelud ütlevad seda, mõlemalt poolt, nii nagu rakendus seda näitab. Iga tehing sisaldab linkedDocuments ja iga dokument sisaldab linkedTransactions; iga kirje nimetab teise poole ja link:

confirmed — dokument on seotud liikumisega, mis loetakse dokumenteerituks.
suggested — sobitaja pakub paaristamist; keegi ei ole seda kinnitanud ja liikumisel puudub endiselt selle dokument. Kirje sisaldab sobitaja score.

Seega saab assistent eristada ei ühtegi arvet arvest, mis ootab kinnitamist juba esitatud — ja ei saa seda muuta, kuna sellel ühendusel ei ole selleks tööriista.

Liikumisel võib olla mitu kinnitatud dokumenti. Dokument on seotud maksimaalselt ühe liikumisega, seega arve, mis on makstud mitmes osas, näitab ainult liikumist, millega see oli seotud. Dokument, mis on veel Processing, ei oma veel linke; None tähendab, et linke ei ole.

Ulatused kehtivad endiselt: lingi kauge pool on kirjeldatud (tarnija ja number, või kirjeldus ja summa) ainult võtme jaoks, mis saab seda ressurssi lugeda. Ühe ulatusega saad teise poole id, lingi tüübi ja skoori — piisavalt, et teada, et liikumine on dokumenteeritud, mitte seda, mida arve ütleb.

Originaali lugemine

get_document_file võtab documentId list_documents-ist ja tagastab salvestatud faili ise — sama PDF või pilt, mida rakendus avab — kui manustatud resursi koos selle MIME tüübiga (application/pdf, image/jpeg, …), dokumenti id, faili nime ja suurusega — failid kuni 10MB, sama piirang nagu üleslaadimisel. Nii kontrollib assistent, kas erinevus tuleneb arvest, sellest, mis on väljavõetud või liikumisest, millega see oli seotud, ilma midagi eksportimata. See on lugemine: dokument, selle väljavõetud väljad või selle lingid ei muutu. Dokument, mis ei ole sinu, ei leidu lihtsalt.

Dokumentide esitamine

upload_document on ainus tööriist, mis kirjutab, ja see valiti selle rolli jaoks teadlikult: see ainult lisab. Assistent saadab faili (PDF või pilt, kuni 10MB) ja MoneyLights viib selle läbi sama toru nagu rakenduses üleslaadimine — salvestatud, selle väljad on väljavõetud (tarnija, kuupäev, number, summad) ja automaatselt sobitatud sinu panga tehingutega.

Sama faili saatmine kaks korda ei dubleeri sinu andmeid: uuesti üleslaadimine registreeritakse kui lipuga dubleerimine, mis osutab originaalile. Kõik, mida assistent esitab, on nähtav — ja kustutatav — rakenduses.

Iga teine kirjutamine (kliendi loomine, tehingute ümberklassifitseerimine, ümbrike seadistamine…) jääb rakendusse teadlikult: need toimingud eeldavad, et inimene kinnitab need.

Kuraatoritud käsud

Server pakub ka valmis alguspunktide — kuu sularahavoo ülevaade, tarnija kulude analüüs, puuduvate dokumentide puhastus — loetletud ainult siis, kui sinu võti saab käivitada iga tööriista, mida nad vajavad. Kasuta neid sellisena või muuda vabalt.

Turvalisus

Assistent on piiratud võtmega, mida kontrollitakse iga päringu korral. Alanda või eemalda võtme looja ja assistent kitsendab või peatab järgmise kõne korral.
Finantsandmed sisaldavad tekstisõnumeid, mille on kirjutanud võõrad — makse viidatud, e-posti teel saadetud dokumendid. Tööriista tulemused edastatakse märgitud piiri sees, öeldes mudelile, et käsitleda neid andmetena, mitte juhistena. Kohtle seda kui leevendust, mitte garantiid, ja piira võtmeid rangelt.
Assistentide lahtiühendamiseks tühista nende võti Seaded → API võtmed. Kohene, alati saadaval.

Anna igale assistendile oma võti — üks kliendi kohta tähendab, et saad ühe katkestada, ilma et see segaks ülejäänud.