# 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](https://modelcontextprotocol.io/), 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ä.

Huomio

MCP-yhteys on käytettävissä Yrittäjä - ja Kasvu -paketeissa.

## Missä yhteys toimii?

[Osio nimeltä “Missä yhteys toimii?”](#missä-yhteys-toimii)

Nykyinen [@kirjapro/mcp-server-paketti](https://www.npmjs.com/package/@kirjapro/mcp-server) 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](https://kirjapro.fi/openapi.json) koskee vain sivuston discovery-resursseja. Selaimen WebMCP on näistä erillinen mahdollinen ominaisuus, jota tämä paketti ei toteuta. [Agentit ja integraatiot](https://kirjapro.fi/agents/) kokoaa julkiset tietolähteet.

## Mitä tällä voi tehdä?

[Osio nimeltä “Mitä tällä voi tehdä?”](#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ä”](#esimerkkejä)

### Kirjanpito

[Osio nimeltä “Kirjanpito”](#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”](#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”](#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”](#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?”](#mitä-tekoälyavustaja-näkee)

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

Alue Mitä tekoälyavustaja 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 laskuihin Tarjoukset Luoda, lähettää ja muuntaa laskuiksi Tilikaudet Nähdä avoimet ja suljetut kaudet Tarkistukset Y-tunnus, IBAN ja viitenumero

Oletusarvoinen core-pinta sisältää 29 toimintoa ja 11 tietoresurssia. Laaja full-pinta sisältää 55 toimintoa . [Katso ydintoiminnot yksityiskohtaisesti](https://kirjapro.fi/docs/mcp/tyokalut/).

## Käyttöönotto

[Osio nimeltä “Käyttöönotto”](#käyttöönotto)

- 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.

- Lisää yhteys MCP-asiakasohjelmaan [Claude Desktop](#tab-panel-0-0)
- [Claude Code](#tab-panel-0-1)
- [Mistral Vibe](#tab-panel-0-2)
- [ChatGPT](#tab-panel-0-3)
- [Cursor](#tab-panel-0-4)
- [VS Code](#tab-panel-0-5)
- [Windsurf](#tab-panel-0-6)

Avaa Claude Desktop ja siirry asetustiedostoon:

- Klikkaa ☰ (valikko) → Settings → Developer → Edit Config

- 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.

- Tallenna tiedosto ja sulje Claude Desktop kokonaan (pelkkä ikkunan sulkeminen ei riitä, 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ää projektin juureen .mcp.json -tiedosto (tai globaalisti ~/.claude/mcp.json , Windows: %USERPROFILE%\.claude\mcp.json ):

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

Tarkista yhteys komennolla /mcp .

Lisää määritys tiedostoon ~/.vibe/config.toml :

[[mcp_servers]] name = " kirjapro " transport = " stdio " command = " npx " args = [ " -y " , " @kirjapro/mcp-server " ] env = { KIRJAPRO_API_KEY = " kp_sinun_avaimesi " }

Käynnistä Mistral Vibe uudelleen. Voit tarkistaa MCP-yhteydet Viben /mcp -valikosta.

Huomio

Mistral Le Chat hyväksyy custom connectoriksi verkossa saavutettavan MCP-palvelimen URL-osoitteen, ei paikallista stdio -komentoa. Kirjapron nykyinen npm-paketti toimii suoraan Mistral Vibessä. Le Chat -tuki edellyttää erillistä etä-MCP-päätettä.

ChatGPT ei yhdistä paikalliseen stdio -palvelimeen suoraan. Käytä [OpenAI Secure MCP Tunnelia](https://developers.openai.com/api/docs/guides/secure-mcp-tunnels), joka välittää ChatGPT:n pyynnöt paikallisesti käynnistyvälle Kirjapro MCP -palvelimelle.

- Luo tunnelitunniste OpenAI Platformin tunneliasetuksissa.

- Asenna tunnel-client OpenAI 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 "
tunnel-client doctor --profile kirjapro --explain tunnel-client run --profile kirjapro

- Pidä tunnel-client run käynnissä.

- Avaa ChatGPT:n Settings → Plugins , luo developer mode -sovellus ja valitse yhteystyypiksi Tunnel sekä luomasi tunneli.

Varoitus

ChatGPT:n täysi MCP-tuki, mukaan lukien 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ää projektin juureen .cursor/mcp.json :

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

Lisää projektin juureen .vscode/mcp.json :

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

Huom: VS Code käyttää "servers" eikä "mcpServers" .

Lisää projektin juureen .windsurf/mcp.json :

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

Vinkki

Vinkki: Jos käytät Claude Codea, voit pyytää tekoälyavustajaa lisäämään asetuksen puolestasi: “Lisää Kirjapro MCP-palvelin”. Täytä API-avain itse tiedostoon jälkikäteen, älä jaa avainta chatissa.

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 "

- 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”](#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](https://kirjapro.fi/tietosuoja/).

## Tietoturva

[Osio nimeltä “Tietoturva”](#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

Varoitus

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

## Vaatimukset

[Osio nimeltä “Vaatimukset”](#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”](#vianmääritys)

Ongelma Ratkaisu Tekoälyavustaja ei näe Kirjapron toimintoja Käynnistä käyttämäsi MCP-asiakasohjelma kokonaan uudelleen. Claude Desktopissa sulje myös ilmoitusalueen kuvake Could not connect to MCP server Varmista, että Node.js 20+ on asennettu: node --version terminaalissa KIRJAPRO_API_KEY is required Tarkista, että env -lohkossa on oikea API-avain ja avain alkaa kp_ JSON-virhe, kaikki palvelimet katoavat Virheellinen JSON rikkoo kaikki MCP-yhteydet. Tarkista pilkut ja sulkeet. Kokeile JSONLint-työkalua npx: command not found Node.js ei ole järjestelmän PATH:ssa. macOS: asenna [nvm](https://github.com/nvm-sh/nvm), Windows: asenna Node.js ja käynnistä MCP-asiakasohjelma uudelleen

## Seuraavaksi

[Osio nimeltä “Seuraavaksi”](#seuraavaksi)

- [Ydintoiminnot](https://kirjapro.fi/docs/mcp/tyokalut/): oletusarvoisen core-pinnan 29 toimintoa yksityiskohtaisesti

- [Tekoäly-avustaja](https://kirjapro.fi/docs/tekoaly/): Kirjapron sisäänrakennettu tekoälyavustaja

- [Hinnoittelu](https://kirjapro.fi/hinnoittelu/): Vertaa paketteja ja hintoja

Viimeksi päivitetty: 2.10.2026

[Edellinen Automaattinen tiliöinti](https://kirjapro.fi/docs/tekoaly/kategoriointi/)[Seuraava Toiminnot](https://kirjapro.fi/docs/mcp/tyokalut/)