Ako prepojiť Billiwo s vlastnou AI

Mnohí z vás už používajú AI na písanie e-mailov či prípravu podkladov. Billiwo sa teraz dá pripojiť k AI, ktorú si sami vyberiete. Opýtate sa jej na svoje faktúry, klientov alebo výdavky a môže vám pripraviť koncept faktúry. V tomto návode ukážeme, ako ju pripojiť, čo zvládne a kde končí.

Čo je MCP

MCP (Model Context Protocol) je spoločný spôsob, ako sa AI aplikácia pripojí k inej službe, v našom prípade k Billiwu. Predstavte si ho ako zástrčku, ktorá sa hodí do viacerých zariadení. AI cez ňu dostane povolenie robiť s vašimi údajmi len to, čo jej kľúčom dovolíte. Nemusíte nič programovať, stačí vložiť adresu servera a kľúč do nastavenia aplikácie.

Pripojenie je dostupné v plánoch Business a Enterprise a Billiwo za AI nič nepripočítava.

Čo AI s Billiwom dnes zvládne

AI môže čítať:

• faktúry, dobropisy, cenové ponuky a zálohové faktúry,
• klientov a platby,
• výdavky a číselné rady,
• orientačný prehľad DPH.

S kľúčom „Čítanie a koncepty“ môže navyše pridať alebo upraviť klienta a pripraviť koncept faktúry alebo cenovej ponuky, aj so zľavami na položkách.

Čo AI nezvládne

AI nevystaví ani neočísluje doklad, neodošle e-mail ani eFaktúru, nezaznamená platbu a nič nevymaže. To vždy urobíte vy v Billiwe. AI pripraví, vy rozhodnete. Koncept, ktorý AI pripraví, nájdete v zozname faktúr alebo ponúk so stavom „Návrh“. Skontrolujete ho, upravíte a vystavíte sami.

Krok 1: vytvorte kľúč

1. V Billiwe otvorte Nastavenia → Integrácie → Pripojiť vlastnú AI (MCP).
2. Kliknite na Vytvoriť kľúč a pomenujte ho podľa aplikácie, napríklad „Claude na notebooku“.
3. Vyberte, čo smie AI robiť: len čítať, alebo čítať a pripravovať koncepty.
4. Nastavte platnosť kľúča.
5. Skopírujte kľúč. Ukážeme vám ho len raz.

Kľúč je ako heslo k vašim údajom. Neposielajte ho e-mailom a nevkladajte ho do četu s AI. Patrí len do nastavenia aplikácie. Pre každú AI vytvorte samostatný kľúč, aby ste mohli každej zvlášť zrušiť prístup.

Adresa servera MCP je https://billiwo.com/api/mcp. Zobrazí sa vám aj v nastaveniach.

Krok 2: pripojte aplikáciu

Vo všetkých príkladoch nahraďte <kľúč> svojím kľúčom. Billiwo vám hotové nastavenie ukáže aj priamo po vytvorení kľúča, s vyplneným kľúčom.

Claude Desktop

V Claude Desktop otvorte Settings → Developer → Edit Config. Otvorí sa súbor claude_desktop_config.json. Pridajte do neho server billiwo. Potrebujete nainštalovaný Node.js, pretože Claude Desktop sa pripája cez malý prekladač mcp-remote.

{
  "mcpServers": {
    "billiwo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@0.15.1",
        "https://billiwo.com/api/mcp",
        "--header",
        "Authorization:${BILLIWO_AUTH}"
      ],
      "env": { "BILLIWO_AUTH": "Bearer <kľúč>" }
    }
  }
}

Potom Claude Desktop reštartujte.

Claude Code

V termináli spustite jediný príkaz:

claude mcp add --transport http billiwo https://billiwo.com/api/mcp --header "Authorization: Bearer <kľúč>"

Cursor

V Cursore pridajte server v nastaveniach MCP (Add new MCP server) alebo do súboru .cursor/mcp.json vo vašom projekte:

{
  "mcpServers": {
    "billiwo": {
      "url": "https://billiwo.com/api/mcp",
      "headers": { "Authorization": "Bearer <kľúč>" }
    }
  }
}

Iné aplikácie

Funguje aj s ďalšími aplikáciami s podporou MCP, ktoré vedia poslať kľúč v hlavičke Authorization. Aplikácie, ktoré sa pripájajú len prihlásením cez účet, nie sú podporované.

Krok 3: opýtajte sa

Pár nápadov na začiatok:

• Ktoré faktúry sú po splatnosti?
• Priprav faktúru pre … za 10 hodín po 45 €.
• Koľko som zarobil v septembri podľa klientov?
• Aké výdavky mám za október?

Ak AI pripraví koncept faktúry, otvorte ho v Billiwe, skontrolujte sumy, klienta a splatnosť a až potom ho vystavte. AI sa môže pomýliť, preto za konečný doklad vždy zodpovedáte vy.

Bezpečnosť

• Samostatný kľúč pre každú AI. Ak jednu prestanete používať, zrušíte len jej kľúč.
• Dve úrovne oprávnenia. Kľúč „Len čítanie“ nič nezmení. Kľúč „Čítanie a koncepty“ smie pripravovať koncepty, nič viac.
• Platnosť kľúča. Pri vytvorení nastavíte, dokedy kľúč platí.
• Zrušenie kedykoľvek. Zrušený kľúč prestane fungovať okamžite a nedá sa obnoviť.
• Záznam volaní. Každé volanie AI cez kľúč nájdete v záznamoch volaní API v nastaveniach.

Zodpovednosť za údaje

Údaje, ktoré si vaša AI vyžiada (napríklad faktúry, kontakty klientov alebo výdavky), Billiwo pošle poskytovateľovi AI, ktorého ste si vybrali. Billiwo s ním nemá zmluvu. Za spracúvanie u neho zodpovedáte vy podľa svojej zmluvy s ním, preto si pozrite jeho podmienky a zásady ochrany osobných údajov. Údaje, ktoré poskytovateľ už dostal, Billiwo vymazať nevie. Požiadajte o to jeho. Prístup ukončíte zrušením kľúča. Podrobnosti nájdete v zásadách ochrany osobných údajov a v podmienkach používania.

Viac o pripojení vlastnej AI nájdete na stránke funkcie. Ak Billiwo ešte nepoužívate, môžete ho vyskúšať zadarmo a bez platobnej karty.