Siirry sisältöön

Yhdistä oma tekoälysovellus

Voit yhdistää Kirjapron tekoälysovellukseen, jota jo käytät, kuten Claudeen, ChatGPT:hen tai Mistraliin. Sen jälkeen voit kysyä talouden tilanteesta, laskuista ja raporteista tavallisella kielellä. Halutessasi tekoäly voi myös kirjata ja laskuttaa puolestasi.

Tekoälyliitäntä käyttää avointa standardia nimeltä Mallikontekstiprotokolla (MCP). Muiden sovellusten asetuksissa näet usein tämän nimen.

Tekoäly voi tehdä virheitä. Tarkista kirjaukset aina ennen kuin hyväksyt ne. Tekoälyliitännän saatavuus paketeittain: katso Tilaukset.

OminaisuusEtäyhteysPaikallinen paketti
KäyttöönottoLisäät osoitteen tekoälysovellukseen, ei asennustaNode.js 22+ ja asetustiedosto omalla koneella
KirjautuminenKirjapro-tunnuksilla, hyväksyt yhteyden itseAPI-avaimella
Toiminnot19 lukutoimintoa, kirjoitusoikeudella myös kirjoittavatOletuksena 31 toimintoa, laajana 57
Tietojen muuttaminenKirjoitusoikeudella asiakkaat, laskuluonnokset, maksut, kirjaukset, ostot ja tarjoukset. Erillisellä luvalla myös laskujen ja tarjousten lähetysKirjaukset, laskut, lähetys, maksut ja tarjoukset
SopiiClaude ja muut sovellukset, joihin voi lisätä etäyhteydenClaude Desktop, Claude Code, Cursor, VS Code, Windsurf, Mistral Vibe ja automaatiot

Aloita etäyhteydestä: se kertoo talouden tilanteesta, laskuista ja raporteista, ja kirjoitusoikeudella se myös kirjaa ja tekee laskuluonnoksia. Erillisellä luvalla se voi lähettää laskuja ja tarjouksia. Valitse paikallinen paketti, kun tarvitset laajan valikoiman, esimerkiksi poistot tai toistuvat laskut.

Etäyhteys on helpoin tapa aloittaa. Mitään ei asenneta: lisäät Kirjapron osoitteen tekoälysovellukseen, kirjaudut Kirjaproon ja hyväksyt yhteyden.

Kirjapron yhteysosoite:

https://tifewzsimmyoiepblhld.supabase.co/functions/v1/mcp
  1. Lisää osoite tekoälysovellukseen

    Claudessa avaa Connectors-asetukset ja valitse Add custom connector. Anna nimeksi esimerkiksi Kirjapro ja liitä osoite. Muita asetuksia tai API-avainta ei tarvita.

  2. Kirjaudu Kirjaproon

    Sovellus avaa Kirjapron kirjautumissivun. Kirjaudu tavallisilla Kirjapro-tunnuksillasi. Jos käytät kaksivaiheista tunnistautumista, vahvista se ennen jatkamista.

  3. Tarkista pyyntö ja hyväksy

    Kirjapron hyväksyntäsivu (app.kirjapro.fi/oauth/consent) näyttää sovelluksen nimen, osoitteen, johon sovellus palaa (esimerkiksi Clauden osoite), sekä oikeuden Lukuoikeus valitun yrityksen kirjanpitoon ja luettelon luettavista tiedoista. Valinta Piilota asiakastiedot on valmiiksi päällä, jolloin sovellus ei näe asiakkaiden nimiä ja yhteystietoja (katso Asiakastietojen piilotus). Valinnalla Salli myös kirjoitus sovellus voi myös kirjata ja tehdä laskuluonnoksia (katso Mitä etäyhteys voi kirjoittaa). Valitse se vain sovellukselle, jonka tunnistat ja jonka yhdistämisen aloitit itse. Kirjoitusoikeus on voimassa 90 päivää kerrallaan. Kirjoituksen kanssa näkyvällä valinnalla Salli myös lähetykset ja poistot sovellus voi lisäksi lähettää laskuja ja tarjouksia asiakkaillesi. Ilman sitä tekoäly tekee laskusta luonnoksen, ja sinä lähetät sen itse Kirjaprossa. Valitse yritys ja paina Salli. Estä hylkää pyynnön, eikä mitään yhdistetä.

    Jos olet jo hyväksynyt saman sovelluksen, sivu pyytää vain vahvistuksen: paina Jatka sovellukseen.

  4. Kokeile yhteyttä

    Kysy esimerkiksi “Mikä on yritykseni tulos tältä tilikaudelta?” tai “Mitkä laskut ovat erääntyneet?”. Sovellus voi kysyä luvan ennen ensimmäistä hakua.

Yhdistämiseen tarvitset yrityksessä ylläpitäjän tai omistajan roolin. Lisäksi yrityksen tilaukseen pitää sisältyä API-käyttö (sama vaatimus kuin API-avaimilla). Hyväksyntäsivulla näkyvät vain yritykset, jotka täyttävät molemmat ehdot.

Etäyhteys on testattu Clauden omalla yhdistimellä (custom connector). ChatGPT ja Mistral Le Chat tukevat omien ohjeidensa mukaan vastaavia yhteyksiä, joissa kirjaudutaan palveluun, joten samaa osoitetta voi kokeilla myös niissä. Valikot, tilausvaatimukset ja esimerkiksi ylläpitäjän oikeus yhteyden lisäämiseen vaihtelevat sovelluksittain. Katso ohje sovelluksen omasta dokumentaatiosta.

Yhteys lukee vain sen yrityksen tietoja, jonka valitsit hyväksyessäsi yhteyden. Sillä on 19 lukutoimintoa:

ToimintoMitä se palauttaa
Yrityksen perustiedotNimi, Y-tunnus, osoite ja maa
TilikaudetAvoimet ja suljetut tilikaudet päivämäärineen
TilikarttaTilit tyypin, nimen tai numeron mukaan
Talouden kokonaiskuvaTilikauden tuotot, kulut, tulos, laskutilanne, pankkitilien nimet, IBANit ja saldot sekä myyntisaatavat
Myyntisaatavien ikäjakaumaAvoimien saatavien määrät ja summat ikäluokittain
Laskut (lista ja yksittäinen lasku)Laskut ja hyvityslaskut riveineen, maksuineen ja avoimine saldoineen
Asiakkaat (lista ja yksittäinen asiakas)Asiakkaiden yhteystiedot ja laskutilastot (piilotettuina asiakasnumero ja laskutilastot)
Yritystiedot PRH:staVirallinen nimi, osoite ja yhtiömuoto Y-tunnuksella
KirjauksetTilikauden kirjaukset vienteineen
Pankkitapahtumat (lista ja kirjausehdokkaat)Pankkitapahtumat sekä tieto siitä, onko tapahtuma jo kirjattu
TuloslaskelmaTuotot, kulut ja välisummat valitulta aikaväliltä
TaseVastaavaa ja vastattavaa valitulta päivältä
ALV-yhteenvetoOmaVero-kentät ja täsmäytys valitulta aikaväliltä
Tarkistukset (Y-tunnus, IBAN ja viitenumero)Y-tunnuksen ja tilinumeron tarkistus sekä viitenumeron luonti laskunumerosta

Kun annat yhteydelle kirjoitusoikeuden, sovellus voi lisäksi:

ToimintoMitä se tekee
Luo asiakasLisää uuden asiakkaan
Luo laskuTekee laskuluonnoksen, jonka lähetät Kirjaprossa
Päivitä laskun tilaPeruu luonnoksen tai merkitsee lähetetyn laskun erääntyneeksi
Kirjaa maksusuoritusKirjaa maksun lähetetylle laskulle
Luo kirjausKirjaa tositteen vienteineen
Kirjaa ostoKirjaa oston tai kuitin ALV-tietoineen, jolloin vähennys näkyy ALV-ilmoituksella
Kohdista tapahtumaKirjaa laskun maksun pankkitapahtumasta ja täsmäyttää sen
Liitä tapahtuma kirjaukseenTäsmäyttää pankkitapahtuman jo kirjattuun tositteeseen
Luo tarjousTekee tarjouksen tai sopimuksen luonnoksen
Muunna laskuksiTekee hyväksytystä tarjouksesta laskuluonnoksen
Lähetä laskuLähettää laskuluonnoksen sähköpostilla tai verkkolaskuna ja kirjaa myynnin (vain luvalla lähetyksiin)
Lähetä tarjousLähettää tarjouksen vastaanottajille, joista jokainen saa oman linkin (vain luvalla lähetyksiin)

Jokainen muutos kirjataan yrityksen tapahtumalokiin yhteyden tunnisteella, eikä sama pyyntö tallennu kahdesti. Tekoälysovellus voi kysyä vahvistuksen ennen jokaista muutosta. Laskuja ja tarjouksia sovellus voi lähettää vain, jos olet sallinut myös lähetykset. Jos asiakkaan sähköposti- tai verkkolaskuosoite on lisätty tai muutettu yhteyden kautta viimeisen vuorokauden aikana, Kirjapro lähettää vasta, kun osoite on vahvistettu. Vaikka valinnan nimessä mainitaan myös poistot, etäyhteyden oletusvalikoimassa ovat vain lähetykset: poistot ja toistuvat laskut tehdään Kirjaprossa tai paikallisella paketilla. Toimintoluettelosta näet kaikki toiminnot.

Kun tekoälysovellus on lukenut tiedot Kirjaprosta, niiden jatkokäsittelyyn sovelletaan kyseisen sovelluksen omia ehtoja ja tietosuojakäytäntöjä. Yhdistä vain sovelluksia, joihin luotat.

Kun Piilota asiakastiedot on päällä, Kirjapro poistaa asiakastiedot vastauksista ennen kuin ne lähtevät sovellukselle:

  • Asiakas näkyy asiakasnumerona, esimerkiksi Asiakas C00012. Muu vastapuoli, kuten toimittaja tai pankkitapahtuman maksaja, näkyy tunnisteena.
  • Nimet, Y-tunnukset, sähköpostit, puhelinnumerot, osoitteet ja tilinumerot piilotetaan.
  • Teksti, johon niitä voi kirjoittaa, piilotetaan kokonaan: tositteiden ja pankkitapahtumien selitteet, pankkiviestit, laskujen ja asiakkaiden muistiinpanot, tarjousten tekstit ja liitetietojen tekstit.
  • Kirjapron omissa selitteissä nimen tilalle tulee asiakasnumero tai tunniste, esimerkiksi Asiakassuoritus: Asiakas C00012.
  • Summat, päivämäärät ja Kirjapron numerot näkyvät, joten sovellus voi silti kertoa tuloksesta, laskuista ja saatavista ja laskuttaa asiakasnumerolla.
  • Nimellä tai tekstillä ei voi hakea. Tilin voi hakea numerolla.
  • Asiakkaan nimeä, yhteyshenkilöä tai tyyppiä sovellus ei voi muuttaa.

Tiedot, jotka kirjoitat itse keskusteluun, sovellus näkee aina. Piilotus koskee vain etäyhteyttä. API-avaimella yhdistetty sovellus näkee asiakastiedot.

Laskurivien ja tilien nimet näkyvät sellaisina kuin ne on kirjoitettu, koska tekoäly tarvitsee niitä kirjanpidossa. Niistä piilotetaan asiakasrekisterin nimet, myös taivutettuina (esimerkiksi Virtasen), sekä henkilö- ja yhteystiedot. Muiden kuin asiakkaiden nimet, esimerkiksi toimittajan, näkyvät, jos ne on kirjoitettu riville. Luonnosten, peruttujen laskujen, vanhentuneiden tarjousten ja toistuvien laskupohjien rivien tekstit piilotetaan kokonaan.

Nimet, yhteystiedot ja tunnukset korvataan aina, ja käsin kirjoitetut selitteet ja muistiinpanot piilotetaan kokonaan. Tarkkuus riippuu vain laskurivien ja tilien nimien käsittelystä, jossa Kirjapro etsii asiakasrekisterin nimiä. Kirjapron testiaineistossa tunnistamatta jäi 0,2–1,4 % taivutetuista nimistä, ja 0,5–1,2 % riveistä, joilla ei ollut nimeä, piilotettiin turhaan. Älä siksi kirjoita laskuriveille henkilötietoja, joita et halua sovelluksen näkevän.

  • Kirjaprossa: Asetukset → MCP-palvelin → Yhdistetyt sovellukset. Kytkimellä Piilota asiakastiedot piilotat tai näytät asiakastiedot ilman uutta yhdistämistä. Muutos koskee jo seuraavaa hakua, mutta se ei poista tietoja, jotka sovellus on jo saanut. Kytkimellä Salli kirjoitus annat tai poistat kirjoitusoikeuden. Se on voimassa 90 päivää kerrallaan, ja sitä voi jatkaa samasta kohdasta. Kytkimellä Salli lähetykset ja poistot yhteyden myöntäjä antaa luvan lähettää laskuja ja tarjouksia, ja myöntäjä tai yrityksen ylläpitäjä voi poistaa sen.
  • Kun muutat oikeuksia, osa sovelluksista näyttää uudet toiminnot vasta, kun yhdistät ne uudelleen. Claudessa avaa Connectors → Kirjapro ja valitse Disconnect ja sitten Connect. Claude rekisteröityy silloin uutena sovelluksena, joten listaan tulee uusi yhteys: peru vanha.
  • Asiakastiedot voi tuoda näkyviin vain yhteyden myöntäjä, ja Kirjapro pyytää siihen vahvistuksen. Yrityksen ylläpitäjä voi piilottaa minkä tahansa yrityksen yhteyden asiakastiedot.
  • Peru katkaisee yhteyden. Voit perua itse myöntämäsi yhteyden, ja yrityksen ylläpitäjä voi perua minkä tahansa yrityksen yhteyden. Peruminen koskee jo seuraavaa hakua.
  • Tekoälysovelluksessa: kun poistat yhteyden, sen käyttö loppuu siinä sovelluksessa. Peru yhteys myös Kirjaprossa, jotta myönnetty oikeus poistuu.
  • Yhteys lakkaa toimimasta myös, jos myöntäjä poistetaan yrityksestä tai yrityksen tilaukseen ei enää sisälly API-käyttöä.
  • Sama sovellus voi olla kerrallaan yhdistettynä yhteen yritykseesi. Jos yhdistät sen toiseen yritykseen, aiempi yhteys perutaan.

@kirjapro/mcp-server-paketti toimii omassa käyttöympäristössäsi ja tarjoaa kaikki toiminnot, myös tietoja muuttavat. Tarvitset Node.js 22:n tai uudemman sekä tekoälysovelluksen, joka osaa käynnistää paketin. Paketti ottaa yhteyden Kirjaproon verkon kautta ja tunnistautuu API-avaimella.

Mitä paikallisella paketilla voi tehdä?

Osio nimeltä “Mitä paikallisella paketilla voi tehdä?”

Valikoissa navigoinnin ja kenttien täyttämisen sijaan voit pyytää tekoälyä:

“Kohdista tämän viikon pankkitapahtumat avoimiin laskuihin”

“Luo lasku asiakkaalle Yritys Oy: konsultointipalvelu 2 000 €, maksuehto 14 päivää”

“Lähetä lasku 1042 asiakkaalle sähköpostilla”

“Näytä tuloslaskelma tältä tilikaudelta”

“Paljonko myyntisaatavia on yli 60 päivää erääntyneinä?”

Tekoäly ymmärtää pyyntösi, hakee tarvittavat tiedot Kirjaprosta ja tekee kirjaukset puolestasi. ALV-erittely ja kahdenkertainen kirjaus hoituvat automaattisesti.

  • Luo kirjaus: “Kirjaa vuokramaksu 1 200 € tammikuulta”
  • “Kirjaa pankin palvelumaksu 12 € pankkikuluihin”
  • Selaa kirjauksia: “Näytä tämän tilikauden kirjaukset vienteineen”
  • Luo lasku: “Luo lasku 3 tunnin konsultoinnista á 120 €”
  • Lähetä luonnoslasku sähköpostilla tai verkkolaskuna: “Lähetä lasku 1042 verkkolaskuna”
  • Kirjaa maksu: “Merkitse lasku 1042 maksetuksi”
  • Lisää asiakas: “Lisää uusi asiakas: Yritys Oy, Y-tunnus 1234567-1”
  • Hae yritystiedot: “Hae PRH:sta yrityksen 1234567-1 tiedot”
  • Tuloslaskelma ja tase yhdellä pyynnöllä
  • “Mikä on yritykseni taloustilanne juuri nyt?”
  • “Kuinka nopeasti asiakkaat maksavat laskunsa?”
  • ALV-yhteenveto: “Näytä ALV-erittely OmaVero-kentittäin tältä kuulta”
  • “Onko Y-tunnus 1234567-1 oikein?”
  • “Luo viitenumero laskunumeron perusteella”
  • “Onko IBAN FI21 1234 5600 0007 85 oikein?”

Paikallisen paketin kautta tekoäly pääsee käsiksi vain sinun yrityksesi tietoihin:

AlueMitä tekoäly voi tehdä
TilikarttaHakea ja suodattaa tilejä
KirjauksetLukea ja luoda kirjauksia
LaskutLuoda laskuja, lähettää luonnoksia sähköpostilla tai verkkolaskuna, kirjata maksuja ja päivittää tiloja
AsiakkaatSelata ja luoda asiakkaita, hakea tietoja PRH:sta
RaportitTalouden kokonaiskuva, tuloslaskelma, tase, myyntisaatavat, ALV-yhteenveto
PankkitapahtumatLukea tapahtumia ja kohdistaa niitä laskuihin
TarjouksetLuoda, lähettää ja muuntaa laskuiksi
TilikaudetNähdä avoimet ja suljetut kaudet
TarkistuksetY-tunnus, IBAN ja viitenumero

Oletuksena käytössä on 31 toimintoa ja 11 tietoresurssia (valmista viitetietoa). Laajassa valikoimassa on 57 toimintoa. Katso toiminnot tarkemmin.

  1. Luo API-avain Kirjaprossa

    Valitse ensin oikea yritys, sillä avain on yrityskohtainen. Siirry sitten Asetukset → MCP-palvelin → Luo uusi avain. Avaimen luomiseen tarvitset yrityksen omistajan tai ylläpitäjän oikeudet. Kopioi avain talteen, sillä se näytetään vain kerran. Avaimen käyttö ei ohita yrityksen käyttöoikeustarkistuksia.

  2. Lisää yhteys tekoälysovellukseen

    Valitse sovelluksesi ja lisää asetus. Korvaa kp_sinun_avaimesi omalla avaimellasi. Esimerkit käyttävät pakettia @kirjapro/mcp-server@latest: paketti päivittyy, kun sovellus käynnistää palvelimen uudelleen, ja käynnissä oleva istunto pitää versionsa.

    Avaa Claude Desktop ja avaa sen asetustiedosto:

    1. Klikkaa ☰ (valikko) → Settings → Developer → Edit Config
    2. Tiedosto claude_desktop_config.json avautuu tekstieditorissa

    Jos tiedosto on tyhjä tai sisältää vain {}, korvaa koko sisältö:

    {
    "mcpServers": {
    "kirjapro": {
    "command": "npx",
    "args": ["-y", "@kirjapro/mcp-server@latest"],
    "env": {
    "KIRJAPRO_API_KEY": "kp_sinun_avaimesi"
    }
    }
    }
    }

    Jos tiedostossa on jo muita yhteyksiä, lisää kirjapro niiden perään pilkulla erotettuna. Esimerkiksi jos tiedostossa on jo filesystem-yhteys:

    {
    "mcpServers": {
    "filesystem": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem"]
    },
    "kirjapro": {
    "command": "npx",
    "args": ["-y", "@kirjapro/mcp-server@latest"],
    "env": {
    "KIRJAPRO_API_KEY": "kp_sinun_avaimesi"
    }
    }
    }
    }

    Huomaa pilkku edellisen yhteyden sulkevan }-merkin jälkeen. Ilman sitä tiedosto rikkoutuu, ja kaikki Claude Desktopin lisäyhteydet lakkaavat toimimasta.

    1. Tallenna tiedosto ja sulje Claude Desktop kokonaan (pelkkä ikkunan sulkeminen ei riitä, vaan sulje myös ilmoitusalueen kuvake)
    2. Avaa Claude Desktop uudelleen

    Jos “Edit Config” ei näy, voit avata tiedoston suoraan:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json

    Jos käytät Claude Codea, voit pyytää sitä lisäämään asetuksen puolestasi: “Lisää Kirjapro MCP-palvelin”. Kirjoita API-avain tiedostoon itse jälkikäteen. Älä jaa avainta keskustelussa.

  3. Kokeile yhteyttä

    Kysy tekoälyltä esimerkiksi “Näytä tilikarttani” tai “Montako avointa laskua minulla on?”. Tekoäly hakee tiedot suoraan Kirjaprosta.

Kirjapro antaa tekoälysovellukselle ohjeet jo yhdistettäessä. Sovellus tietää silloin, että kirjanpitosi on Kirjaprossa, ja hoitaa kirjanpitoon liittyvät pyynnöt Kirjapron toiminnoilla, vaikka et mainitsisi Kirjaproa.

Kaikki sovellukset eivät käytä näitä ohjeita. Jos sovellus vastaa kirjanpitokysymyksiin omasta päästään tai haluat perustaa kirjanpitoa varten oman projektin tai avustajan, liitä alla oleva teksti sovelluksen pysyviin ohjeisiin. Niitä ovat esimerkiksi Clauden projektin ohjeet, ChatGPT:n mukautetut ohjeet tai projektin ohjeet ja Mistral Le Chatin agentin ohjeet.

Kirjanpitoni on Kirjaprossa, ja se on yhdistetty tähän sovellukseen.
- Hoida kaikki yritykseni kirjanpitoon, laskutukseen, tarjouksiin, pankkiin, ALV:hen ja raportteihin liittyvä Kirjapron työkaluilla. Hae yrityksen luvut Kirjaprosta, älä arvioi niitä itse.
- Tarkista ensin yritys ja avoin tilikausi.
- Kirjaa kuitit ja ostolaskut ostokirjauksena, jotta ALV menee ilmoitukselle.
- Jos jokin ei onnistu Kirjapron työkaluilla (liitteet, pankkiyhteys, liitetiedot), ohjaa minut Kirjapron sovellukseen.
- Kerro lopuksi, mitä Kirjaprossa muuttui (tositteet, laskunumerot).

Yleisimpiin töihin Kirjapro tarjoaa valmiita pyyntöjä. Claudessa valitset ne viestikentän valikosta Kirjapro-yhteyden kohdalta. Kaikki sovellukset eivät näytä valmiita pyyntöjä.

PyyntöMitä se tekee
Aloita kirjanpitoHakee yrityksen tiedot, tilauksen ja avoimen tilikauden
Kirjaa kuitti tai ostolaskuKirjaa oston ALV-tietoineen, jotta vähennys menee ALV-ilmoitukselle
Tee ja lähetä laskuTekee laskuluonnoksen ja lähettää sen, jos yhteys saa lähettää laskuja
Täsmäytä pankkitapahtumatKohdistaa maksut laskuille ja liittää jo kirjatut tapahtumat kirjauksiinsa
Kuukauden tarkistusKokoaa talouden tilanteen, avoimet laskut, ALV:n ja tulevat määräpäivät
Valmistele ALV-ilmoitusKokoaa ALV-ilmoituksen kentät valitsemaltasi kaudelta. Ilmoituksen annat itse OmaVerossa

Jos yhteys ei saa tehdä jotakin vaihetta, esimerkiksi kirjata lukuoikeudella, pyyntö neuvoo tekemään sen Kirjapron sovelluksessa.

Molemmissa yhteystavoissa tekoäly näkee vain yhden yrityksen tiedot, ja tietokanta tarkistaa käyttöoikeuden jokaisessa pyynnössä.

Etäyhteys

  • Kirjautuminen tehdään Kirjaprossa. Tekoälysovellus ei näe salasanaasi eikä tarvitse API-avainta.
  • Yhteydellä on lukuoikeus, ja kirjoitusoikeuden annat erikseen 90 päiväksi kerrallaan. Yhteys sidotaan hyväksynnässä valittuun yritykseen.
  • Jos vaihdat salasanasi tai kaksivaiheisen tunnistautumisesi, kirjoitusoikeus päättyy ja sovellus voi vain lukea, kunnes yhdistät sen uudelleen.
  • Asiakastiedot ovat oletuksena piilossa. Valinnan voi muuttaa asetuksista.
  • Sovelluksen saama tunniste ei kelpaa Kirjapron muihin toimintoihin.
  • Peruttu yhteys lakkaa toimimasta seuraavassa pyynnössä.

Paikallinen paketti

  • Yhteys toimii API-avaimella, jonka voit poistaa käytöstä milloin tahansa.
  • Avaimesi perutaan automaattisesti, kun vaihdat salasanan tai poistat kaksivaiheisen tunnistautumisen. Yrityksen omistajat saavat sähköpostin jokaisesta uudesta avaimesta.
  • Avainta ei tallenneta selkotekstinä.
  • Sama kirjoitus ei tallennu kahteen kertaan.

Käsittele API-avainta kuten salasanaa. Älä tallenna sitä julkiseen paikkaan.

  • Tilaus: Yrittäjä- tai Räätälöity-paketti
  • Etäyhteys: ylläpitäjän tai omistajan rooli yrityksessä sekä tekoälysovellus, johon voi lisätä etäyhteyden (testattu Claudella)
  • Paikallinen paketti: Node.js 22 tai uudempi sekä sovellus, kuten Claude Code, Claude Desktop, Mistral Vibe, ChatGPT (Secure MCP Tunnelin kautta), Cursor, VS Code tai Windsurf
OngelmaRatkaisu
Etäyhteys: hyväksyntäsivulla ei ole yritystäTarvitset yrityksessä ylläpitäjän tai omistajan roolin, ja tilaukseen pitää sisältyä API-käyttö
Etäyhteys: CREDENTIAL_INVALID tai sovellus pyytää kirjautumaan uudelleenYhteys on peruttu tai vanhentunut. Yhdistä sovellus uudelleen ja hyväksy yhteys Kirjaprossa
Etäyhteys: RATE_LIMITEDKäyttöraja täyttyi, eikä hakua tehty. Yritä uudelleen ilmoitetun ajan kuluttua
Etäyhteys: WRITE_GRANT_EXPIREDKirjoitusoikeus päättyi 90 päivän kuluttua. Yhteys voi edelleen lukea. Salli kirjoitus uudelleen: Asetukset → MCP-palvelin → Yhdistetyt sovellukset
Etäyhteys: WRITE_GRANT_REVOKEDKirjoitusoikeus päättyi, koska salasana tai kaksivaiheinen tunnistautuminen vaihtui. Peru yhteys ja yhdistä sovellus uudelleen
Etäyhteys: PRIVACY_SEARCH_DISABLEDYhteys piilottaa asiakastiedot, joten tekstillä ei voi hakea. Pyydä hakua ilman hakusanaa, esimerkiksi päivämäärillä tai summalla rajattuna
Etäyhteys: PRIVACY_UNAVAILABLEAsiakastietojen piilotus ei onnistunut, joten mitään ei näytetty. Yritä hetken kuluttua uudelleen
Tekoäly ei näe Kirjapron toimintojaKäynnistä tekoälysovellus kokonaan uudelleen. Claude Desktopissa sulje myös ilmoitusalueen kuvake
Could not connect to MCP server tai requires Node.js 22 or newerVarmista, että Node.js 22 tai uudempi on asennettu: kirjoita terminaaliin node --version. Node.js 20:n tuki päättyi 30.4.2026, eikä paketti 0.18.0:sta alkaen käynnisty sillä
Legacy auth … was removedVanha kirjautumistapa (SUPABASE_ACCESS_TOKEN, ALLOW_LEGACY_AUTH) poistui versiossa 0.18.0. Käytä API-avainta (KIRJAPRO_API_KEY)
Missing authentication configuration tai Invalid KIRJAPRO_API_KEY formatTarkista, että env-kohdassa on koko API-avain ja että se alkaa kp_
CREDENTIAL_INVALID tai API key authentication failed (401)Avain on väärin kopioitu, peruttu tai vanhentunut. Luo uusi avain: Asetukset → MCP-palvelin, ja käynnistä tekoälysovellus uudelleen
API_ENTITLEMENT_REQUIRED tai API key authentication failed (403)Avaimen luojan pitää olla yhä yrityksen jäsen, ja hänen omaan tai yrityksen omistajan tilaukseen pitää sisältyä API-käyttö (Asetukset → Tilaus). Jos avaimen luojan tunnus on poistettu, luo uusi avain. Käynnistä sen jälkeen tekoälysovellus uudelleen. Paketti tarkistaa tilauksen myös itse tunnin välein ja vastaa siihen asti samalla virheellä; versiosta 0.23.2 alkaen se käynnistyy myös ilman API-käyttöä, jotta tekoälysovellus voi kertoa syyn
SERVER_VERSION_UNSUPPORTED tai API key authentication failed (426)Paketti on liian vanha. Käytä uusinta versiota (npx -y @kirjapro/mcp-server@latest) ja käynnistä tekoälysovellus uudelleen
AUTH_UNAVAILABLEKirjapron kirjautumispalvelu ei vastannut, eikä pyyntöä lähetetty. Paketti yrittää itse uudelleen. Tarkista verkkoyhteys ja yritä hetken kuluttua
Asetustiedoston virhe, kaikki yhteydet katoavatVirheellinen json-tiedosto rikkoo kaikki yhteydet. Tarkista pilkut ja sulkeet, esimerkiksi JSONLint-työkalulla
npx: command not foundNode.js ei löydy järjestelmän hakupolulta (PATH). macOS: asenna nvm. Windows: asenna Node.js ja käynnistä tekoälysovellus uudelleen

Tämä osio on niille, jotka haluavat säätää paikallista pakettia tai tietää tarkemmin, mitä yhteydestä tallennetaan.

Paikallinen paketti toimii omalla koneellasi paikallisena stdio-palvelimena: tekoälysovellus käynnistää sen ja keskustelee sen kanssa suoraan, ilman verkkopalvelinta.

Oletuksena paketti näyttää 31 arjen ydintoimintoa (core). Jos tarvitset esimerkiksi toistuvien laskujen, ostolaskujen tai kirjauspohjien toiminnot, lisää asetuksen env-kohtaan:

"KIRJAPRO_MCP_SURFACE": "full"

Laajassa valikoimassa (full) on 57 toimintoa. Suosittelemme oletusta, koska tekoälyn on helpompi valita oikea toiminto suppeammasta joukosta.

Paikallinen paketti lähettää Kirjaprolle oletuksena rajattua teknistä käyttötietoa toimintavarmuuden, turvallisuuden ja toimintojen kehittämiseksi. Jos et halua mittausta, lisää env-kohtaan:

"KIRJAPRO_TELEMETRY": "false"
  • Yksi yhteys voi tehdä enintään 60 hakua minuutissa, kerralla enintään 20.
  • Yrityksen kaikki etäyhteyden tunnisteet voivat tehdä yhteensä enintään 180 hakua minuutissa, kerralla enintään 60. Uudet yhteydet eivät kasvata yrityksen kokonaisrajaa.
  • Kun raja ylittyy, hakua ei tehdä. Kirjapro kertoo, kuinka monen sekunnin kuluttua voit yrittää uudelleen.
  • Yksittäisen haun aikaraja on 10 sekuntia. Raskaammilla hauilla se on pidempi: kirjauksilla, tuloslaskelmalla ja taseella 15 sekuntia, talouden kokonaiskuvalla 20 sekuntia.
  • Yhteyden tiedot: sovelluksen nimi ja tunniste, myöntäjä, yritys, valinnat sekä yhdistämis- ja perumisaika. Yhdistäminen, valintojen muutokset ja peruminen kirjataan yrityksen tapahtumalokiin.
  • Jokaisesta pyynnöstä tekninen lokirivi: pyynnön tunniste, tila, kesto, kanava ja yhteyden tunniste sekä haun kohdalla toiminnon nimi, lopputulos ja virhekoodi. Kirjapron lokiriveille ei kirjata hakujen argumentteja, tuloksia, kirjautumistunnisteita, IP-osoitteita, yrityksen tai käyttäjän tunnisteita eikä rahamääriä.
  • Käyttörajan laskurit: yhteys- ja yrityskohtainen laskuri ilman kirjanpitotietoja. Vuorokauden käyttämättömänä ollut laskuri poistetaan seuraavan haun yhteydessä.
  • Käyttömittaus: jokaisesta toiminnosta samat metatiedot kuin paikallisessa paketissa, kuten toiminnon nimi, kesto, lopputulos ja vastauksen koko, mutta ei argumentteja eikä tuloksia. KIRJAPRO_TELEMETRY-asetus ei koske etäyhteyttä, mutta mittausta voi vastustaa (tietosuojaseloste, kohta 9).
  • Etäyhteydessä Kirjapro vaihtaa sovelluksen tunnisteen jokaisessa pyynnössä lyhytikäiseen lukutunnisteeseen.
  • Paikallisen paketin API-avain vaihdetaan automaattisesti lyhytikäiseen tunnistautumiseen (1 tunti). Avaimesta tallennetaan vain hajautusarvo. Toistuvia tunnistautumisia rajoitetaan, mutta varsinainen suoja on avaimen pituus: avainta ei voi käytännössä arvata.
  • Kirjoitus suoritetaan vain tietokannan vahvistaman atomisen toistoneston jälkeen.
  • Jokainen tietoja muuttava toiminto saa yksilöllisen UUID v4 -idempotenssiavaimen. Täsmälleen sama pyyntö palautetaan avaimella uudelleen 24 tunnin ajan. Tämän ajan ulkopuolella toistoa ei luvata turvalliseksi.
  • Jos aiemman kirjoituksen lopputulosta ei voida varmistaa, paketti ei tee kirjausta automaattisesti uudelleen. Tekoäly ohjataan tarkistamaan tulos lukutoiminnolla tai Kirjaprossa.
  • Laajan valikoiman eräkirjaukset avautuvat oletuksena esikatseluna ja tallennetaan vain kokonaan tai ei lainkaan. Osittaista erätallennusta ei ole. Yhdessä erässä voi olla enintään 500 vientiriviä, laskuissa ja tarjouksissa enintään 100 riviä. Vientien summat ovat kokonaisia senttejä.
  • Tositenumero on yrityksen oma juokseva numero. Kun sitä ei anneta, Kirjapro antaa seuraavan numeron. Toimittajan kuitin numero kirjoitetaan selitteeseen.
  • Muuttavat toiminnot, kuten asiakkaan tai laskun tilan päivitys, on merkitty työkalulistassa tietoja korvaaviksi. Toistuvan laskun luonti ja muutos on merkitty ulkoiseksi vaikutukseksi, koska pohja voi lähettää laskut asiakkaalle itse.
  • Suuret vastaukset rajataan: pääkirjaa selataan enintään 100 rivin sivuina, jotka sidotaan ensimmäisen sivun luontiaikarajaan. Koko kauden saldoyhteenveto lasketaan erikseen.
  • Mittaukseen tallennetaan yrityksen ja API-avaimen sisäiset tunnisteet, toiminnon nimi, paketin versio, tekoälysovelluksen eli asiakasohjelman nimi ja versio, kesto, onnistumis- tai virheluokka, tavumäärät, esikatselu-, erä- ja idempotenssitiedot sekä vastausrajan tila.
  • Mittaus kattaa myös virheelliset argumentit, tuntemattomat toimintopyynnöt ja vastausrakenteen tarkistusvirheet. Tuntemattoman toiminnon nimeä ei tallenneta, vaan se korvataan yleisellä luokalla.
  • Mittaukseen ei lähetetä toimintojen argumentteja, tuloksia, kehotteita, asiakas- tai tositenimiä eikä rahamääriä. Raakatiedot poistetaan 90 päivän kuluttua, ja mittauksen voi poistaa käytöstä asetuksella KIRJAPRO_TELEMETRY=false.
  • Mittauksesta kieltäytyminen estää metatietojen lähetyksen. Paikallinen 200 KiB:n vastausraja säilyy käytössä, jotta suuri tulos ei täytä tekoälyn kontekstia.
  • Selaimen WebMCP on erillinen mahdollinen ominaisuus, jota paketti ei toteuta.
  • Kirjaprolla ei ole yleistä ulkoisille järjestelmille tarkoitettua taloushallinto-REST-API:a. Julkinen OpenAPI-kuvaus koskee vain sivuston discovery-resursseja. Agentit ja integraatiot kokoaa julkiset tietolähteet.

Katso täydellinen käsittelykuvaus tietosuojaselosteesta.