Yhdistä AI-avustaja (MCP)

MoneyLightsissa on sisäänrakennettu MCP palvelin, joten AI-avustaja — Claude Desktop, Claude Code, IDE-agentti, mikä tahansa, joka puhuu protokollaa — voi työskennellä organisaatiosi tietojen kanssa pyynnöstä.

Se on sama tunnistus kuin REST API: MCP-yhteys on API-avain, jolla on samat käyttöoikeudet, samat rajoitukset ja sama peruutuspainike. Hallittavaa ei ole erikseen.

Yhdistäminen

Päätepiste on https://api.moneylights.app/mcp (Streamable HTTP). Tyypillinen asiakaskonfiguraatio:

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

Clauden koodilla se on yksi komento:

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

Luo avain Asetukset → API-avaimet ja myönnä sille vain ne käyttöoikeudet, joita avustaja tarvitsee. Kaikki vaatii avaimen, mukaan lukien työkalujen listaaminen.

Mitä avustaja voi tehdä

Työkalulista lasketaan avaimesi käyttöoikeuksista, jokaisessa pyynnössä. Avaimella, jolla ei ole käyttöoikeutta, ei kerrota edes vastaavan työkalun olemassaolosta.

Työkalu	Käyttöoikeus	Mitä se tekee
`get_cashflow_overview`	`cashflow:read`	Kuukausittainen tulo/kulu/netto, avaussaldo, tärkeimmät kategoriat
`get_analytics_overview`	`analytics:read`	Yhteenveto kategorioittain, asiakkain, projekteittain ja henkilöittäin
`list_transactions`	`transactions:read`	Transaktiot, suodatettuna ja sivutettuna, jokaisella asiakirjat linkitettynä
`list_documents`	`documents:read`	Asiakirjat ja niiden poimitut kentät, jokaisella liikkeet linkitettynä
`get_document_file`	`documents:read`	Yhden asiakirjan alkuperäinen tiedosto — PDF tai kuva, jonka sovellus näyttää
`get_pending_distribution`	`profitpulse:read`	Odottavat Safe-to-Spend -jakelut
`list_vendors`	`vendors:read`	Toimittajat, kokonaiskulut
`list_clients`	`clients:read`	Asiakkaat, kokonaisliikevaihto
`list_projects`	`projects:read`	Projektit, kokonaismäärät ja tavoitteet
`upload_document`	`documents:write`	Tiedostot, lasku tai kuitti asiakirjoihisi

Molemmat yhteenvedot lasketaan saman perustan mukaan ja ilmoittavat siitä: jokainen vastaus sisältää basis — ajanjakso, valuutat, käsitellyt tilit (jokainen näkyvä, ellei pyydetty id:n mukaan) ja miten siirtoja organisaation omien tilien välillä käsiteltiin. Oletusarvoisesti ne on poissuljettu tuloista ja kuluista, jalka jalalta, juuri kuten sovelluksen Cashflow-näkymä näyttää; siirrä includeInternalTransfers: true jollekin työkalulle raakaan pankkiliikkeeseen, jonka basis sitten merkitsee sellaiseksi ja jota ei voida verrata oletusarvoiseen. Vertaile lukuja kahden työkalun välillä vain, kun niiden basis vastaa. netCashResult on tulo miinus pankkiliikkeiden kulut — käteistulos, ei kirjanpidon voitto.

Mikä asiakirja liittyy mihin liikkeeseen

Molemmat listat kertovat sen, molemmilta puolilta, kuten sovellus näyttää. Jokaisessa transaktiossa on linkedDocuments ja jokaisessa asiakirjassa on linkedTransactions; jokainen merkintä nimeää toisen puolen ja link:

confirmed — asiakirja on yhdistetty liikkeeseen, mikä lasketaan dokumentoiduksi.
suggested — yhdistäjä ehdottaa paritusta; kukaan ei ole vahvistanut sitä ja liike on edelleen ilman asiakirjaa. Merkinnässä on yhdistäjän score.

Avustaja voi siis kertoa ei laskua laskusta, joka odottaa vahvistusta jo arkistoitu — eikä voi muuttaa mitään, koska tällä yhteydellä ei ole työkalua siihen.

Liike voi sisältää useita vahvistettuja asiakirjoja. Asiakirja linkittää enintään yhteen liikkeeseen, joten osittain maksettu lasku näyttää vain sen liikkeen, johon se on yhdistetty. Asiakirja, joka on edelleen Processing, ei vielä sisällä linkkejä; None tarkoittaa, ettei ole.

Käyttöoikeudet ovat edelleen voimassa: linkin kaukainen puoli kuvataan (toimittaja ja numero, tai kuvaus ja määrä) vain avaimelle, joka voi lukea myös sen resurssin. Yhdellä käyttöoikeudella saat toisen puolen id:n, linkin tyypin ja pisteet — riittävästi tietääksesi, että liike on dokumentoitu, ei mitä lasku sanoo.

Alkuperäisen lukeminen

get_document_file ottaa documentId arvon list_documents-komennosta ja palauttaa tallennetun tiedoston itse — saman PDF:n tai kuvan, jonka sovellus avaa — upotettuna resurssina sen MIME-tyypin (application/pdf, image/jpeg, …) kanssa, asiakirjan id:n, tiedoston nimen ja koon vieressä — tiedostot jopa 10MB, sama yläraja kuin latauksessa. Näin avustaja tarkistaa, tuleeko ero laskusta, siitä, mitä on poimittu tai liikkeestä, johon se on yhdistetty, ilman mitään vientiä. Se on lukemista: mikään asiakirjassa, sen poimituissa kentissä tai sen linkeissä ei muutu. Asiakirjaa, joka ei ole sinun, ei yksinkertaisesti löydy.

Asiakirjojen arkistointi

upload_document on ainoa työkalu, joka kirjoittaa, ja se on valittu tähän rooliin tarkoituksella: se vain lisää. Avustaja lähettää tiedoston (PDF tai kuva, jopa 10MB) ja MoneyLights käsittelee sen samalla putkistolla kuin lataus sovelluksessa — tallennettuna, sen kentät poimittuna (toimittaja, päivämäärä, numero, määrät) ja automaattisesti yhdistettynä pankkisiirtoihisi.

Saman tiedoston lähettäminen kahdesti ei koskaan monista tietojasi: uudelleenlataus tallennetaan merkittynä kopiona, joka osoittaa alkuperäiseen. Kaikki, mitä avustaja arkistoi, on näkyvissä — ja poistettavissa — sovelluksessa.

Kaikki muut kirjoitustoiminnot (asiakkaiden luominen, transaktioiden luokittelu, kirjekuorien konfigurointi…) pysyvät sovelluksessa tarkoituksella: nämä toimet edellyttävät ihmisen vahvistusta.

Kuratoidut kehykset

Palvelin tarjoaa myös valmiita aloituspisteitä — kuukausittaisen kassavirran arvion, toimittajan kulutusanalyysin, puuttuvien asiakirjojen siivouksen — lueteltuna vain kun avaimesi voi käyttää kaikkia tarvittavia työkaluja. Käytä niitä sellaisenaan tai muokkaa vapaasti.

Turvallisuus

Avustaja on sidottu avaimen rajoituksiin, tarkistetaan jokaisessa pyynnössä. Alenna tai poista avaimen luoja, ja avustaja rajoittuu tai lopettaa seuraavassa kutsussa.
Taloustiedot sisältävät vieraita kirjoittamaa tekstiä — maksureferenssit, sähköpostitse lähetetyt asiakirjat. Työkalujen tulokset toimitetaan merkittyjen rajojen sisällä, joka käskee mallia käsittelemään niitä tietona, ei koskaan ohjeina. Käsittele tätä lieventävänä toimenpiteenä, ei takuuna, ja rajoita avaimia tiukasti.
Poistaaksesi avustajan, peruuta sen avain Asetuksissa → API-avaimet. Välitön, aina saatavilla.

Anna jokaiselle avustajalle oma avain — yksi asiakasta kohti tarkoittaa, että voit katkaista yhden ilman, että se häiritsee muita.