API a MCP

API a webhooky jsou součástí programu Vystav. Nastavíte je v Nastavení › , API a webhooky; klíče a webhooky spravuje vlastník nebo administrátor.

API klíč

1. V části API klíče zadejte Označení klíče, například název aplikace, která jej bude používat.
2. Zaškrtněte pouze oprávnění, která aplikace skutečně potřebuje.
3. Klikněte na Vytvořit klíč a klíč si ihned zkopírujte. Zobrazí se pouze jednou, Vystav ukládá jen jeho otisk.

Klíč, který již nepotřebujete nebo mohl uniknout, zrušte tlačítkem Zrušit. Aplikace, které jej používají, přestanou fungovat.

invoices:read

Čtení faktur.

invoices:write

Koncepty faktur, jejich vystavení a úhrady.

contacts:read

Čtení kontaktů.

contacts:write

Zakládání kontaktů.

products:read

Čtení ceníku.

expenses:read

Čtení přijatých dokladů a nákladů.

reports:read

Přehledy a souhrny.

Rozhraní

API je REST s formátem JSON na adrese /api/v1. Klíč posíláte v hlavičce Authorization: Bearer nota_…. Popis všech volání ve formátu OpenAPI je na /api/v1/openapi.json.

Webhooky

Webhook pošle na zadanou adresu zprávu pokaždé, když ve Vystavu nastane vybraná událost: faktura se vytvoří, vystaví, odešle e-mailem, uhradí nebo se dostane po splatnost, zaeviduje se náklad nebo zákazník přijme cenovou nabídku.

Každou zprávu podepisujeme hlavičkou vystav-signature (HMAC-SHA256) podpisovým klíčem, který uvidíte jednou, při vytvoření webhooku. Pokud vaše adresa zprávu nepřijme, doručení opakujeme s narůstajícím odstupem.

Claude přes MCP

Claude a další aplikace s podporou MCP (Model Context Protocol) pracují s vašimi fakturami, kontakty a přehledy prostřednictvím API klíče a smějí pouze to, co klíči povolíte.

1. Vytvořte API klíč. Pro dotazy stačí oprávnění invoices:read, contacts:read a reports:read. Pokud má Claude připravovat faktury a zapisovat úhrady, přidejte invoices:write, pro zakládání kontaktů contacts:write.
2. V části Claude (MCP) zkopírujte adresu serveru. Aplikaci, která u vlastního konektoru umožňuje zadat hlavičku, stačí tato adresa a hlavička s vaším klíčem.
3. Pro Claude Desktop zkopírujte připravené nastavení tlačítkem Kopírovat nastavení. V Claude otevřete Settings › , Developer › , Edit Config a nastavení vložte do souboru claude_desktop_config.json. Místo nota_… doplňte svůj klíč a Claude restartujte. Potřebujete nainstalovaný Node.js.

Přes MCP umí Claude vyhledat faktury a kontakty, připravit koncept faktury a vystavit jej, zaevidovat úhradu, založit kontakt, najít firmu v registru a zobrazit přehled a souhrn DPH. Koncept faktury se sám nevystaví, vystavení je samostatný krok.