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

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

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 €”
• 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

• 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ä 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ää 27 toimintoa ja 11 tietoresurssia. Laaja full-pinta sisältää 52 toimintoa. Katso ydintoiminnot 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.

   Mistral Vibe

   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

   ChatGPT ei yhdistä paikalliseen stdio-palvelimeen suoraan. Käytä OpenAI Secure MCP Tunnelia, joka välittää ChatGPT:n pyynnöt paikallisesti käynnistyvälle Kirjapro MCP -palvelimelle.

   1. Luo tunnelitunniste OpenAI Platformin tunneliasetuksissa.
   2. Asenna tunnel-client OpenAI Platformin tarjoamasta latauslinkistä.
   3. Suorita macOS- tai Linux-terminaalissa:

   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

   4. Pidä tunnel-client run käynnissä.
   5. 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.

   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ää 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ää 27 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ää 52 toimintoa. Core on suositeltu oletus, koska rajatumpi työkalujoukko helpottaa tekoälyä valitsemaan oikean toiminnon.

3. Kokeile yhteyttä

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

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

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, Mistral Vibe, ChatGPT Secure MCP Tunnelin kautta, Cursor, VS Code tai Windsurf

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, Windows: asenna Node.js ja käynnistä MCP-asiakasohjelma uudelleen

Seuraavaksi

• Ydintoiminnot: oletusarvoisen core-pinnan 27 toimintoa yksityiskohtaisesti
• Tekoäly-avustaja: Kirjapron sisäänrakennettu tekoälyavustaja
• Hinnoittelu: Vertaa paketteja ja hintoja