Siirry sisältöön
Kirjapro

MCP-palvelin

Kirjapro on ensimmäinen suomalainen taloushallinto-ohjelmisto, jonka voi yhdistää suoraan MCP-yhteensopivaan tekoälyavustajaan. Yhteyden ansiosta voit hoitaa kirjanpitoa, laskutusta ja raportointia keskustelemalla, ilman klikkailua ja lomakkeiden täyttöä.

Yhteys perustuu Anthropicin kehittämään avoimeen MCP-standardiin, joka antaa tekoälylle turvallisen pääsyn Kirjapron tietoihin.

Mallikontekstiprotokolla on uutta teknologiaa, joka standardisoi tekoälyn ja tietokannan välisen yhteyden, tekoäly valitsee ja suorittaa oikeat toiminnot itsenäisesti pyyntösi perusteella. MCP-palvelinta kehitetään aktiivisesti ja uusia toimintoja lisätään jatkuvasti. Koska teknologia on vielä nuorta, tekoäly voi tehdä virheitä, tarkista kirjausten oikeellisuus aina ennen hyväksymistä.

Missä yhteys toimii?

Osio nimeltä “Missä yhteys toimii?”

Nykyinen @kirjapro/mcp-server-paketti käynnistyy omassa käyttöympäristössäsi paikallisena stdio-palvelimena. Tarvitset Node.js 20:n tai uudemman sekä asiakasohjelman, joka osaa käynnistää paikallisen MCP-prosessin. Paketti käyttää verkkoyhteyttä Kirjaproon. Pelkkää etäpalvelimen URL-osoitetta hyväksyvä asiakas ei voi käyttää pakettia suoraan. Mahdollinen tunneli on erillinen asiakasohjelman järjestely.

Kirjaprolla ei ole julkaistua HTTP-pohjaista etä-MCP-palvelua eikä yleistä ulkoisille järjestelmille tarkoitettua taloushallinto-REST-API:a. Julkinen OpenAPI-kuvaus koskee vain sivuston discovery-resursseja. Selaimen WebMCP on näistä erillinen mahdollinen ominaisuus, jota tämä paketti ei toteuta. Agentit ja integraatiot kokoaa julkiset tietolähteet.

Mitä tällä voi tehdä?

Osio nimeltä “Mitä tällä voi tehdä?”

Sen sijaan, että navigoisit valikoissa ja täyttäisit kenttiä, voit pyytää tekoälyavustajaa:

“Kirjaa toimistotarvikkeiden osto 150 € Gigantista”

“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älyavustaja ymmärtää pyyntösi, hakee tarvittavat tiedot Kirjaprosta ja tekee kirjaukset puolestasi. ALV-erittely, kahdenkertainen kirjaus ja kaikki yksityiskohdat hoituvat automaattisesti.

Esimerkkejä

Osio nimeltä “Esimerkkejä”

Kirjanpito

Osio nimeltä “Kirjanpito”
  • Luo kirjauksia suomeksi: “Kirjaa vuokramaksu 1 200 € tammikuulta”
  • “Kirjaa käteismyynti 500 € ALV 25,5 %”
  • Selaa kirjauksia: “Näytä tämän tilikauden kirjaukset vienteineen”

Laskutus ja asiakkaat

Osio nimeltä “Laskutus ja asiakkaat”
  • Luo laskuja: “Luo lasku 3 tunnin konsultoinnista á 120 €”
  • Lähetä luonnoslasku sähköpostilla tai verkkolaskuna: “Lähetä lasku 1042 verkkolaskuna”
  • Kirjaa maksuja: “Merkitse lasku 1042 maksetuksi”
  • Luo asiakkaita: “Lisää uusi asiakas: Yritys Oy, Y-tunnus 1234567-8”
  • Hae yritystietoja: “Hae PRH:sta yrityksen 1234567-8 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-8 oikein?”
  • “Luo viitenumero laskunumeron perusteella”
  • “Onko IBAN FI21 1234 5600 0007 85 oikein?”

Mitä tekoälyavustaja näkee?

Osio nimeltä “Mitä tekoälyavustaja näkee?”

Kun yhdistät Kirjapron tekoälyavustajaan, se pääsee käsiksi vain sinun yrityksesi tietoihin:

AlueMitä tekoälyavustaja 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 laskuihin
TarjouksetLuoda, lähettää ja muuntaa laskuiksi
TilikaudetNähdä avoimet ja suljetut kaudet
TarkistuksetY-tunnus, IBAN ja viitenumero

Oletusarvoinen core-pinta sisältää 29 toimintoa ja 11 tietoresurssia. Laaja full-pinta sisältää 55 toimintoa. Katso ydintoiminnot yksityiskohtaisesti.

Käyttöönotto

Osio nimeltä “Käyttöönotto”

  1. Luo API-avain Kirjaprossa

    Siirry Asetukset → API-avaimet → Luo uusi avain. Avaimen luonti vaatii yrityksen omistajan tai ylläpitäjän oikeudet. Kopioi avain talteen, sillä se näytetään vain kerran. Avain on yrityskohtainen: valitse oikea yritys ennen avaimen luontia. Avaimen käyttö ei ohita yrityksen käyttöoikeustarkistuksia.

  2. Lisää yhteys MCP-asiakasohjelmaan

    Avaa Claude Desktop ja siirry asetustiedostoon:

    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"],
          "env": {
            "KIRJAPRO_API_KEY": "kp_sinun_avaimesi"
          }
        }
      }
    }

    Jos sinulla on jo muita MCP-palvelimia, lisää kirjapro pilkun jälkeen olemassa olevien palvelimien perään. Esim. jos tiedostossa on jo filesystem-palvelin:

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

    Huomaa pilkku edellisen palvelimen sulkevan } jälkeen, ilman sitä JSON hajoaa ja kaikki MCP-yhteydet lakkaavat toimimasta.

    1. Tallenna tiedosto ja sulje Claude Desktop kokonaan (pelkkä ikkunan sulkeminen ei riitä, 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

    Oletuksena palvelin näyttää 29 arjen ydintoimintoa. Jos tarvitset esimerkiksi toistuvien laskujen, ostolaskujen tai kirjauspohjien koko työkaluluettelon, lisää samaan env-lohkoon:

    "KIRJAPRO_MCP_SURFACE": "full"

    Full-pinta sisältää 55 toimintoa. Core on suositeltu oletus, koska rajatumpi työkalujoukko helpottaa tekoälyä valitsemaan oikean toiminnon.

    MCP-palvelin lähettää Kirjaprolle oletuksena rajattua teknistä käyttötietoa toimintavarmuuden, turvallisuuden ja työkalupinnan kehittämiseksi. Jos et halua mittausta, lisää samaan env-lohkoon:

    "KIRJAPRO_TELEMETRY": "false"

  3. Kokeile yhteyttä

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

Turvarajat ja käyttömittaus

Osio nimeltä “Turvarajat ja käyttömittaus”
  • Jokainen tietoja muuttava toiminto saa yksilöllisen UUID v4 -idempotenssiavaimen. Täsmälleen sama pyyntö palautetaan avaimella uudelleen 24 tunnin ajan; tämän rajatun ajan ulkopuolella toistoa ei luvata turvalliseksi.
  • Jos aiemman kirjoituksen lopputulosta ei voida varmistaa, palvelin ei tee kirjausta automaattisesti uudelleen. Tekoäly ohjataan tarkistamaan tulos lukutoiminnolla tai Kirjapron käyttöliittymässä.
  • Full-pinnan 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ä.
  • Suuret vastaukset rajataan: pääkirjaa selataan enintään 100 rivin sivuina, jotka sidotaan ensimmäisen sivun luontiaikarajaan. Koko kauden saldoyhteenveto lasketaan erikseen.
  • Tekniseen mittaukseen tallennetaan yrityksen ja API-avaimen sisäiset tunnisteet, työkalun nimi, palvelin- ja asiakasohjelmaversio, kesto, onnistumis- tai virheluokka, tavumäärät sekä esikatselu-, erä-, idempotenssi- ja vastausrajatiedot.
  • 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ä työkalun 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.

Katso täydellinen käsittelykuvaus tietosuojaselosteesta.

Tietoturva

Osio nimeltä “Tietoturva”
  • Yhteys toimii API-avaimella, joka voidaan poistaa käytöstä milloin tahansa
  • Tekoälyavustaja näkee vain sinun yrityksesi tiedot, muiden yritysten tietoihin ei pääse
  • API-avain vaihdetaan automaattisesti lyhytikäiseen tunnistautumiseen (1 tunti)
  • Avainta ei tallenneta selkotekstinä, vain hajautusarvo tallennetaan
  • Pyyntöjä rajoitetaan: enintään 10 tunnistautumista minuutissa
  • Kirjoitus suoritetaan vain tietokannan vahvistaman atomisen toistoneston jälkeen

Vaatimukset

Osio nimeltä “Vaatimukset”
  • Tilaus: Yrittäjä-, Kasvu-, Tilitoimisto- tai Räätälöity-paketti
  • Node.js: versio 20 tai uudempi
  • MCP-asiakasohjelma: Claude Code, Claude Desktop, Mistral Vibe, ChatGPT Secure MCP Tunnelin kautta, Cursor, VS Code tai Windsurf

Vianmääritys

Osio nimeltä “Vianmääritys”
OngelmaRatkaisu
Tekoälyavustaja ei näe Kirjapron toimintojaKäynnistä käyttämäsi MCP-asiakasohjelma kokonaan uudelleen. Claude Desktopissa sulje myös ilmoitusalueen kuvake
Could not connect to MCP serverVarmista, että Node.js 20+ on asennettu: node --version terminaalissa
KIRJAPRO_API_KEY is requiredTarkista, että env-lohkossa on oikea API-avain ja avain alkaa kp_
JSON-virhe, kaikki palvelimet katoavatVirheellinen JSON rikkoo kaikki MCP-yhteydet. Tarkista pilkut ja sulkeet. Kokeile JSONLint-työkalua
npx: command not foundNode.js ei ole järjestelmän PATH:ssa. macOS: asenna nvm, Windows: asenna Node.js ja käynnistä MCP-asiakasohjelma uudelleen

Seuraavaksi

Osio nimeltä “Seuraavaksi”