API a MCP

API a webhooky sú súčasťou programu Vystav. Nastavíte ich v Nastavenia › , API a webhooky; kľúče a webhooky spravuje vlastník alebo administrátor.

API kľúč

1. V časti API kľúče zadajte Označenie kľúča, napríklad názov aplikácie, ktorá ho bude používať.
2. Zaškrtnite len oprávnenia, ktoré aplikácia naozaj potrebuje.
3. Kliknite na Vytvoriť kľúč a kľúč si hneď skopírujte. Zobrazí sa iba raz, Vystav si ukladá len jeho odtlačok.

Kľúč, ktorý už nepotrebujete alebo mohol uniknúť, zrušte tlačidlom Zrušiť. Aplikácie, ktoré ho používajú, prestanú fungovať.

invoices:read

Čítanie faktúr.

invoices:write

Koncepty faktúr, ich vystavenie a úhrady.

contacts:read

Čítanie kontaktov.

contacts:write

Zakladanie kontaktov.

products:read

Čítanie cenníka.

expenses:read

Čítanie prijatých dokladov a nákladov.

reports:read

Prehľady a súhrny.

Rozhranie

API je REST s formátom JSON na adrese /api/v1. Kľúč posielate v hlavičke Authorization: Bearer nota_…. Popis všetkých volaní vo formáte OpenAPI je na /api/v1/openapi.json.

Webhooky

Webhook pošle na adresu, ktorú zadáte, správu vždy, keď sa vo Vystave stane udalosť, ktorú si vyberiete: faktúra sa vytvorí, vystaví, odošle e-mailom, uhradí alebo sa dostane po splatnosť, zaeviduje sa náklad alebo zákazník prijme cenovú ponuku.

Každú správu podpisujeme hlavičkou vystav-signature (HMAC-SHA256) podpisovým kľúčom, ktorý uvidíte raz, pri vytvorení webhooku. Keď vaša adresa správu neprijme, doručenie opakujeme s narastajúcim odstupom.

Claude cez MCP

Claude a ďalšie aplikácie s podporou MCP (Model Context Protocol) pracujú s vašimi faktúrami, kontaktmi a prehľadmi cez API kľúč a smú len to, čo kľúču povolíte.

1. Vytvorte API kľúč. Na otázky stačia oprávnenia invoices:read, contacts:read a reports:read. Ak má Claude pripravovať faktúry a zapisovať úhrady, pridajte invoices:write, na zakladanie kontaktov contacts:write.
2. V časti Claude (MCP) skopírujte adresu servera. Aplikácii, ktorá pri vlastnom konektore dovolí zadať hlavičku, stačí táto adresa a hlavička s vaším kľúčom.
3. Pre Claude Desktop skopírujte pripravené nastavenie tlačidlom Kopírovať nastavenie. V Claude otvorte Settings › , Developer › , Edit Config a nastavenie vložte do súboru claude_desktop_config.json. Namiesto nota_… doplňte svoj kľúč a Claude reštartujte. Potrebujete nainštalovaný Node.js.

Cez MCP Claude vie vyhľadať faktúry a kontakty, pripraviť koncept faktúry a vystaviť ho, zaevidovať úhradu, založiť kontakt, nájsť firmu v registri a ukázať prehľad a súhrn DPH. Koncept faktúry sa sám nevystaví, vystavenie je samostatný krok.