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.
Kaksi tapaa yhdistää
Osio nimeltä “Kaksi tapaa yhdistää”| Ominaisuus | Etäyhteys | Paikallinen paketti |
|---|---|---|
| Käyttöönotto | Lisäät osoitteen tekoälysovellukseen, ei asennusta | Node.js 22+ ja asetustiedosto omalla koneella |
| Kirjautuminen | Kirjapro-tunnuksilla, hyväksyt yhteyden itse | API-avaimella |
| Toiminnot | 19 lukutoimintoa, kirjoitusoikeudella myös kirjoittavat | Oletuksena 31 toimintoa, laajana 57 |
| Tietojen muuttaminen | Kirjoitusoikeudella asiakkaat, laskuluonnokset, maksut, kirjaukset, ostot ja tarjoukset. Erillisellä luvalla myös laskujen ja tarjousten lähetys | Kirjaukset, laskut, lähetys, maksut ja tarjoukset |
| Sopii | Claude ja muut sovellukset, joihin voi lisätä etäyhteyden | Claude 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.
Yhdistä etäpalvelimeen
Osio nimeltä “Yhdistä etäpalvelimeen”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-
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.
-
Kirjaudu Kirjaproon
Sovellus avaa Kirjapron kirjautumissivun. Kirjaudu tavallisilla Kirjapro-tunnuksillasi. Jos käytät kaksivaiheista tunnistautumista, vahvista se ennen jatkamista.
-
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.
-
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.
Muut sovellukset
Osio nimeltä “Muut sovellukset”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.
Mitä etäyhteys voi lukea
Osio nimeltä “Mitä etäyhteys voi lukea”Yhteys lukee vain sen yrityksen tietoja, jonka valitsit hyväksyessäsi yhteyden. Sillä on 19 lukutoimintoa:
| Toiminto | Mitä se palauttaa |
|---|---|
| Yrityksen perustiedot | Nimi, Y-tunnus, osoite ja maa |
| Tilikaudet | Avoimet ja suljetut tilikaudet päivämäärineen |
| Tilikartta | Tilit tyypin, nimen tai numeron mukaan |
| Talouden kokonaiskuva | Tilikauden tuotot, kulut, tulos, laskutilanne, pankkitilien nimet, IBANit ja saldot sekä myyntisaatavat |
| Myyntisaatavien ikäjakauma | Avoimien 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:sta | Virallinen nimi, osoite ja yhtiömuoto Y-tunnuksella |
| Kirjaukset | Tilikauden kirjaukset vienteineen |
| Pankkitapahtumat (lista ja kirjausehdokkaat) | Pankkitapahtumat sekä tieto siitä, onko tapahtuma jo kirjattu |
| Tuloslaskelma | Tuotot, kulut ja välisummat valitulta aikaväliltä |
| Tase | Vastaavaa ja vastattavaa valitulta päivältä |
| ALV-yhteenveto | OmaVero-kentät ja täsmäytys valitulta aikaväliltä |
| Tarkistukset (Y-tunnus, IBAN ja viitenumero) | Y-tunnuksen ja tilinumeron tarkistus sekä viitenumeron luonti laskunumerosta |
Mitä etäyhteys voi kirjoittaa
Osio nimeltä “Mitä etäyhteys voi kirjoittaa”Kun annat yhteydelle kirjoitusoikeuden, sovellus voi lisäksi:
| Toiminto | Mitä se tekee |
|---|---|
| Luo asiakas | Lisää uuden asiakkaan |
| Luo lasku | Tekee laskuluonnoksen, jonka lähetät Kirjaprossa |
| Päivitä laskun tila | Peruu luonnoksen tai merkitsee lähetetyn laskun erääntyneeksi |
| Kirjaa maksusuoritus | Kirjaa maksun lähetetylle laskulle |
| Luo kirjaus | Kirjaa tositteen vienteineen |
| Kirjaa osto | Kirjaa oston tai kuitin ALV-tietoineen, jolloin vähennys näkyy ALV-ilmoituksella |
| Kohdista tapahtuma | Kirjaa laskun maksun pankkitapahtumasta ja täsmäyttää sen |
| Liitä tapahtuma kirjaukseen | Täsmäyttää pankkitapahtuman jo kirjattuun tositteeseen |
| Luo tarjous | Tekee tarjouksen tai sopimuksen luonnoksen |
| Muunna laskuksi | Tekee hyväksytystä tarjouksesta laskuluonnoksen |
| Lähetä lasku | Lähettää laskuluonnoksen sähköpostilla tai verkkolaskuna ja kirjaa myynnin (vain luvalla lähetyksiin) |
| Lähetä tarjous | Lä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.
Asiakastietojen piilotus
Osio nimeltä “Asiakastietojen piilotus”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.
Laskurivit ja tilien nimet
Osio nimeltä “Laskurivit ja tilien nimet”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.
Kuinka tarkka piilotus on
Osio nimeltä “Kuinka tarkka piilotus on”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.
Yhteyden muuttaminen ja peruminen
Osio nimeltä “Yhteyden muuttaminen ja peruminen”- 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.
Paikallinen paketti
Osio nimeltä “Paikallinen paketti”@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.
Esimerkkejä
Osio nimeltä “Esimerkkejä”Kirjanpito
Osio nimeltä “Kirjanpito”- Luo kirjaus: “Kirjaa vuokramaksu 1 200 € tammikuulta”
- “Kirjaa pankin palvelumaksu 12 € pankkikuluihin”
- Selaa kirjauksia: “Näytä tämän tilikauden kirjaukset vienteineen”
Laskutus ja asiakkaat
Osio nimeltä “Laskutus ja asiakkaat”- 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”
Raportit ja tilannekuva
Osio nimeltä “Raportit ja tilannekuva”- 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”
Tarkistukset
Osio nimeltä “Tarkistukset”- “Onko Y-tunnus 1234567-1 oikein?”
- “Luo viitenumero laskunumeron perusteella”
- “Onko IBAN FI21 1234 5600 0007 85 oikein?”
Mitä paikallinen paketti näkee?
Osio nimeltä “Mitä paikallinen paketti näkee?”Paikallisen paketin kautta tekoäly pääsee käsiksi vain sinun yrityksesi tietoihin:
| Alue | Mitä tekoäly voi tehdä |
|---|---|
| Tilikartta | Hakea ja suodattaa tilejä |
| Kirjaukset | Lukea ja luoda kirjauksia |
| Laskut | Luoda laskuja, lähettää luonnoksia sähköpostilla tai verkkolaskuna, kirjata maksuja ja päivittää tiloja |
| Asiakkaat | Selata ja luoda asiakkaita, hakea tietoja PRH:sta |
| Raportit | Talouden kokonaiskuva, tuloslaskelma, tase, myyntisaatavat, ALV-yhteenveto |
| Pankkitapahtumat | Lukea tapahtumia ja kohdistaa niitä laskuihin |
| Tarjoukset | Luoda, lähettää ja muuntaa laskuiksi |
| Tilikaudet | Nähdä avoimet ja suljetut kaudet |
| Tarkistukset | Y-tunnus, IBAN ja viitenumero |
Oletuksena käytössä on 31 toimintoa ja 11 tietoresurssia (valmista viitetietoa). Laajassa valikoimassa on 57 toimintoa. Katso toiminnot tarkemmin.
Paikallisen paketin käyttöönotto
Osio nimeltä “Paikallisen paketin käyttöönotto”-
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.
-
Lisää yhteys tekoälysovellukseen
Valitse sovelluksesi ja lisää asetus. Korvaa
kp_sinun_avaimesiomalla 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:
- Klikkaa ☰ (valikko) → Settings → Developer → Edit Config
- Tiedosto
claude_desktop_config.jsonavautuu 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ää
kirjaproniiden perään pilkulla erotettuna. Esimerkiksi jos tiedostossa on jofilesystem-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.- Tallenna tiedosto ja sulje Claude Desktop kokonaan (pelkkä ikkunan sulkeminen ei riitä, vaan sulje myös ilmoitusalueen kuvake)
- 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
Lisää yhteys terminaalissa komennolla
claude mcp add. Tämä komento lisää sen kaikkiin projekteihisi:Terminal window claude mcp add --transport stdio --env KIRJAPRO_API_KEY=kp_sinun_avaimesi --scope user kirjapro -- npx -y @kirjapro/mcp-server@latestClaude Code tallentaa asetuksen omaan tiedostoonsa
~/.claude.json. Jos haluat yhteyden vain yhteen projektiin, voit lisätä projektikansioon tiedoston.mcp.json:{"mcpServers": {"kirjapro": {"type": "stdio","command": "npx","args": ["-y", "@kirjapro/mcp-server@latest"],"env": {"KIRJAPRO_API_KEY": "kp_sinun_avaimesi"}}}}Jos projektikansio jaetaan muille, älä tallenna avainta tiedostoon
.mcp.json. Tarkista yhteys komennolla/mcp.Lisää määritys tiedostoon
~/.vibe/config.toml:[[mcp_servers]]name = "kirjapro"transport = "stdio"command = "npx"args = ["-y", "@kirjapro/mcp-server@latest"]env = { KIRJAPRO_API_KEY = "kp_sinun_avaimesi" }Käynnistä Mistral Vibe uudelleen. Yhteyden näet Viben
/mcp-valikosta.Mistral Le Chat ei osaa käynnistää paikallista pakettia, vaan se tarvitsee verkko-osoitteen. Lukemiseen voit kokeilla Le Chatissa etäyhteyttä. Paikallinen paketti toimii Mistral Vibessä.
Pelkkään lukemiseen voit kokeilla ChatGPT:ssä etäyhteyttä. Paikalliseen pakettiin ChatGPT ei yhdisty suoraan. Jos haluat myös kirjata ja laskuttaa, tarvitset OpenAI Secure MCP Tunnelin. Se välittää ChatGPT:n pyynnöt omalla koneellasi käynnissä olevalle Kirjapro-paketille.
- Luo tunnelitunniste OpenAI Platformin tunneliasetuksissa.
- Asenna
tunnel-clientOpenAI Platformin tarjoamasta latauslinkistä. - Suorita macOS- tai Linux-terminaalissa:
Terminal window export KIRJAPRO_API_KEY="kp_sinun_avaimesi"export CONTROL_PLANE_API_KEY="sk-sinun-openai-avaimesi"tunnel-client init \--sample sample_mcp_stdio_local \--profile kirjapro \--tunnel-id tunnel_sinun_tunnisteesi \--mcp-command "npx -y @kirjapro/mcp-server@latest"tunnel-client doctor --profile kirjapro --explaintunnel-client run --profile kirjapro- Pidä
tunnel-client runkäynnissä. - Avaa ChatGPT:n Settings → Plugins, luo developer mode -sovellus ja valitse yhteystyypiksi Tunnel sekä luomasi tunneli.
ChatGPT:n täysi tuki, myös tietoja muuttavat toiminnot, on tällä hetkellä beta-vaiheessa Business-, Enterprise- ja Edu-ympäristöissä. Pro-käyttäjä voi käyttää developer modessa vain luku- ja hakutoimintoja. ChatGPT:n developer mode ja OpenAI Platformin tunnelioikeudet ovat erillisiä käyttöoikeuksia.
Lisää projektikansioon tiedosto
.cursor/mcp.json:{"mcpServers": {"kirjapro": {"command": "npx","args": ["-y", "@kirjapro/mcp-server@latest"],"env": {"KIRJAPRO_API_KEY": "kp_sinun_avaimesi"}}}}Lisää projektikansioon tiedosto
.vscode/mcp.json:{"servers": {"kirjapro": {"command": "npx","args": ["-y", "@kirjapro/mcp-server@latest"],"env": {"KIRJAPRO_API_KEY": "kp_sinun_avaimesi"}}}}VS Code käyttää avainta
"servers"eikä"mcpServers".Windsurf lukee yhteydet omasta tiedostostaan
mcp_config.json, ei projektikansiosta. Avaa tiedosto Cascade-paneelin MCP-kuvakkeesta valinnalla Configure. Tiedosto on yleensä~/.codeium/windsurf/mcp_config.json(Windowsissa%USERPROFILE%\.codeium\windsurf\mcp_config.json). Lisää siihen:{"mcpServers": {"kirjapro": {"command": "npx","args": ["-y", "@kirjapro/mcp-server@latest"],"env": {"KIRJAPRO_API_KEY": "kp_sinun_avaimesi"}}}}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.
-
Kokeile yhteyttä
Kysy tekoälyltä esimerkiksi “Näytä tilikarttani” tai “Montako avointa laskua minulla on?”. Tekoäly hakee tiedot suoraan Kirjaprosta.
Ohje tekoälysovellukselle
Osio nimeltä “Ohje tekoälysovellukselle”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).Valmiit pyynnöt
Osio nimeltä “Valmiit pyynnöt”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 kirjanpito | Hakee yrityksen tiedot, tilauksen ja avoimen tilikauden |
| Kirjaa kuitti tai ostolasku | Kirjaa oston ALV-tietoineen, jotta vähennys menee ALV-ilmoitukselle |
| Tee ja lähetä lasku | Tekee laskuluonnoksen ja lähettää sen, jos yhteys saa lähettää laskuja |
| Täsmäytä pankkitapahtumat | Kohdistaa maksut laskuille ja liittää jo kirjatut tapahtumat kirjauksiinsa |
| Kuukauden tarkistus | Kokoaa talouden tilanteen, avoimet laskut, ALV:n ja tulevat määräpäivät |
| Valmistele ALV-ilmoitus | Kokoaa 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.
Tietoturva
Osio nimeltä “Tietoturva”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.
Vaatimukset
Osio nimeltä “Vaatimukset”- 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
Vianmääritys
Osio nimeltä “Vianmääritys”| Ongelma | Ratkaisu |
|---|---|
| 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 uudelleen | Yhteys on peruttu tai vanhentunut. Yhdistä sovellus uudelleen ja hyväksy yhteys Kirjaprossa |
Etäyhteys: RATE_LIMITED | Käyttöraja täyttyi, eikä hakua tehty. Yritä uudelleen ilmoitetun ajan kuluttua |
Etäyhteys: WRITE_GRANT_EXPIRED | Kirjoitusoikeus päättyi 90 päivän kuluttua. Yhteys voi edelleen lukea. Salli kirjoitus uudelleen: Asetukset → MCP-palvelin → Yhdistetyt sovellukset |
Etäyhteys: WRITE_GRANT_REVOKED | Kirjoitusoikeus päättyi, koska salasana tai kaksivaiheinen tunnistautuminen vaihtui. Peru yhteys ja yhdistä sovellus uudelleen |
Etäyhteys: PRIVACY_SEARCH_DISABLED | Yhteys piilottaa asiakastiedot, joten tekstillä ei voi hakea. Pyydä hakua ilman hakusanaa, esimerkiksi päivämäärillä tai summalla rajattuna |
Etäyhteys: PRIVACY_UNAVAILABLE | Asiakastietojen piilotus ei onnistunut, joten mitään ei näytetty. Yritä hetken kuluttua uudelleen |
| Tekoäly ei näe Kirjapron toimintoja | Käynnistä tekoälysovellus kokonaan uudelleen. Claude Desktopissa sulje myös ilmoitusalueen kuvake |
Could not connect to MCP server tai requires Node.js 22 or newer | Varmista, 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 removed | Vanha 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 format | Tarkista, 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_UNAVAILABLE | Kirjapron kirjautumispalvelu ei vastannut, eikä pyyntöä lähetetty. Paketti yrittää itse uudelleen. Tarkista verkkoyhteys ja yritä hetken kuluttua |
| Asetustiedoston virhe, kaikki yhteydet katoavat | Virheellinen json-tiedosto rikkoo kaikki yhteydet. Tarkista pilkut ja sulkeet, esimerkiksi JSONLint-työkalulla |
npx: command not found | Node.js ei löydy järjestelmän hakupolulta (PATH). macOS: asenna nvm. Windows: asenna Node.js ja käynnistä tekoälysovellus uudelleen |
Lisätietoa edistyneille
Osio nimeltä “Lisätietoa edistyneille”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.
Laaja toimintovalikoima
Osio nimeltä “Laaja toimintovalikoima”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.
Käyttömittauksen poistaminen
Osio nimeltä “Käyttömittauksen poistaminen”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"Etäyhteyden käyttörajat
Osio nimeltä “Etäyhteyden käyttörajat”- 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.
Mitä etäyhteydestä tallennetaan
Osio nimeltä “Mitä etäyhteydestä tallennetaan”- 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).
Tekniset turvarajat
Osio nimeltä “Tekniset turvarajat”- 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.
Paikallisen paketin käyttömittaus
Osio nimeltä “Paikallisen paketin käyttömittaus”- 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.
Muuta
Osio nimeltä “Muuta”- 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.
Seuraavaksi
Osio nimeltä “Seuraavaksi”- Mitä sovellus voi tehdä: kaikki toiminnot ja etäyhteyden lukutoiminnot
- Kysy tekoälyltä: Kirjapron oma tekoälyavustaja
- Hinnoittelu: vertaa paketteja ja hintoja