MCP-palvelin

Kirjapro on ensimmäinen suomalainen taloushallinto-ohjelmisto, jonka voi yhdistää suoraan Claude-tekoälyyn. 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ä.

Huomio

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

Mitä tällä voi tehdä?

Sen sijaan, että navigoisit valikoissa ja täyttäisit kenttiä, voit sanoa Claudelle:

“Kirjaa toimistotarvikkeiden osto 150 € Gigantista”

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

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

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

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

Esimerkkejä

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

• Luo laskuja: “Luo lasku 3 tunnin konsultoinnista á 120 €”
• 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

• 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

• “Onko Y-tunnus 1234567-8 oikein?”
• “Luo viitenumero laskunumeron perusteella”
• “Onko IBAN FI21 1234 5600 0007 85 oikein?”

Mitä Claude näkee?

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

Alue	Mitä Claude voi tehdä
Tilikartta	Hakea ja suodattaa tilejä
Kirjaukset	Lukea ja luoda kirjauksia
Laskut	Luoda laskuja, kirjata maksuja, 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

Yhteensä 26 toimintoa ja 11 tietoresurssia. Katso kaikki yksityiskohtaisesti.

Käyttöönotto

1. Luo API-avain Kirjaprossa

   Siirry Asetukset → API-avaimet → Luo uusi avain. Kopioi avain talteen, sillä se näytetään vain kerran.

2. Lisää yhteys MCP-asiakasohjelmaan

   Claude Desktop

   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.

   3. Tallenna tiedosto ja sulje Claude Desktop kokonaan (pelkkä ikkunan sulkeminen ei riitä, sulje myös ilmoitusalueen kuvake)
   4. 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
   Claude Code

   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.

   Cursor

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

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

   VS Code

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

   Windsurf

   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ää Claudea lisäämään asetuksen puolestasi: “Lisää Kirjapro MCP-palvelin”. Täytä API-avain itse tiedostoon jälkikäteen, älä jaa avainta chatissa.

3. Kokeile yhteyttä

   Kysy Claudelta esim. “Näytä tilikarttani” tai “Montako avointa laskua minulla on?”. Claude hakee tiedot suoraan Kirjaprosta.

Tietoturva

• Yhteys toimii API-avaimella, joka voidaan poistaa käytöstä milloin tahansa
• Claude 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

Varoitus

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

Vaatimukset

• Tilaus: Yrittäjä- tai Kasvu-paketti
• Node.js: versio 20 tai uudempi
• MCP-asiakasohjelma: Claude Code, Claude Desktop, Cursor, VS Code tai Windsurf

Vianmääritys

Ongelma	Ratkaisu
Claude ei näe Kirjapron toimintoja	Sulje Claude Desktop kokonaan (myös ilmoitusalueelta) ja avaa uudelleen. Pelkkä ikkunan sulkeminen ei riitä
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, Windows: asenna Node.js ja avaa Claude Desktop uudelleen

Seuraavaksi

• Kaikki toiminnot: 26 toimintoa yksityiskohtaisesti
• Tekoäly-avustaja: Kirjapron sisäänrakennettu tekoälyavustaja
• Hinnoittelu: Vertaa paketteja ja hintoja