Funkce · · 7 min čtení

MCP integrace: Jak ovládat Taxorio přes Claude nebo jiného AI asistenta

Propoj Taxorio s Claude, Cline nebo Zed přes MCP server. 17 nástrojů pro správu faktur, klientů a exportů přímo z AI asistenta. Návod krok za krokem.

Pokud patříš k vývojářům nebo power userům, kteří pracují s AI asistenty jako Claude, Cline nebo Zed, máš možnost propojit je přímo s Taxoriem. Díky MCP (Model Context Protocol) serveru může tvůj oblíbený AI asistent přistupovat k tvým fakturám, klientům a datům -- a na tvůj pokyn vystavovat faktury, vyhledávat klienty nebo exportovat přehledy, aniž bys otevřel prohlížeč.

Co je MCP a proč na tom záleží

MCP (Model Context Protocol) je otevřený standard vyvinutý firmou Anthropic, který umožňuje AI asistentům bezpečně přistupovat k externím nástrojům a datovým zdrojům. Místo toho, aby AI jen "věděl věci" ze svého tréninkového datasetu, dostane přes MCP přístup k živým nástrojům -- API, databázím, soborům nebo aplikacím jako Taxorio.

Prakticky to znamená: v Claude Desktopu nebo Cline napíšeš "vytvořit fakturu pro firmu Novák s.r.o. za konzultace na 40 000 Kč" a AI to skutečně udělá -- zavolá Taxorio API, vytvoří fakturu a potvrdí ti výsledek. Není to simulace, je to reálná akce v tvém účtu.

17 dostupných nástrojů

Taxorio MCP server nabízí tyto nástroje rozdělené do logických skupin:

Správa faktur

  • taxorio_list_invoices -- výpis faktur s filtry (datum, stav, klient)
  • taxorio_get_invoice -- detail konkrétní faktury dle čísla nebo ID
  • taxorio_create_invoice -- vytvoření nové faktury (klient, položky, DPH, splatnost)
  • taxorio_update_invoice -- úprava existující faktury (přidání položky, změna splatnosti)
  • taxorio_delete_invoice -- smazání faktury (s potvrzením)

Správa klientů

  • taxorio_list_clients -- výpis všech klientů
  • taxorio_get_client -- detail klienta včetně historie faktur
  • taxorio_create_client -- přidání nového klienta
  • taxorio_ares_lookup -- vyhledání firmy v ARES dle IČO a automatické předvyplnění

Evidence výdajů

  • taxorio_list_expenses -- přehled výdajů s filtry
  • taxorio_create_expense -- přidání nového výdaje do evidence

Přehledy a exporty

  • taxorio_get_dashboard_stats -- souhrnné statistiky (příjmy, výdaje, DPH)
  • taxorio_generate_vat_export -- vygenerování exportu pro přiznání k DPH

Uživatelský účet

  • taxorio_get_user_info -- informace o přihlášeném uživateli a nastavení
  • authenticate_taxorio -- spuštění autentizačního flow

Příklady konverzací s Claude přes MCP

Níže jsou reálné příklady toho, co můžeš Claude říct a co se stane:

Vytvoření faktury

Ty: Vytvoř fakturu pro Petr Svoboda s.r.o. (IČO 12345678) za vývoj webové aplikace v březnu 2026, celkem 85 000 Kč bez DPH, splatnost 14 dní.
Claude: Hledám klienta Petr Svoboda s.r.o. v Taxoriu... Klient nalezen. Vytvářím fakturu č. 2026-047: Petr Svoboda s.r.o., položka "Vývoj webové aplikace 03/2026", 85 000 Kč + DPH 21 % = 102 850 Kč, splatnost 16. dubna 2026. Faktura byla úspěšně vytvořena a je k dispozici ke stažení v PDF.

Vyhledání klienta přes ARES

Ty: Přidej nového klienta -- IČO 45274649.
Claude: Vyhledávám v ARES... Nalezeno: ČEZ, a.s., Duhová 2/1444, Praha 4, DIČ CZ45274649. Přidávám jako nového klienta do Taxoria. Hotovo -- klient byl vytvořen.

Přehled po splatnosti

Ty: Které faktury jsou více než 30 dní po splatnosti?
Claude: Načítám faktury z Taxoria... Faktury po splatnosti více než 30 dní: (1) faktura č. 2026-019 -- Jan Kovář, 8 700 Kč, po splatnosti 34 dní; (2) faktura č. 2026-008 -- ABC Trade s.r.o., 52 000 Kč, po splatnosti 51 dní. Celkem 60 700 Kč. Chceš připravit upomínkové e-maily?

Autentizace: OAuth Device Flow

Bezpečnost přístupu k tvým datům řeší Taxorio přes OAuth 2.0 Device Flow -- autentizační mechanismus navržený pro prostředí, kde není dostupný plnohodnotný prohlížeč (jako CLI nebo IDE pluginy).

Postup je jednoduchý:

  1. V AI asistentovi (Claude Desktop, Cline, Zed) spustíš autentizaci přes nástroj authenticate_taxorio
  2. AI ti zobrazí krátký kód a URL adresu (taxorio.app/connect)
  3. Na telefonu nebo v prohlížeči otevřeš URL, přihlásíš se do Taxoria a zadáš kód
  4. AI asistent dostane token a od té chvíle má přístup k tvým datům

Token je uložen lokálně a přístup můžeš kdykoliv odvolat v nastavení Taxoria. Žádné heslo se nesdílí s AI asistentemi ani s jejich providery.

Jak propojit Taxorio s Claude Desktopem

Pro Claude Desktop přidáš Taxorio MCP server do konfiguračního souboru claude_desktop_config.json:

Přesný postup včetně aktuálního konfiguračního snippetu najdeš v dokumentaci Taxoria v sekci Nastavení → MCP integrace. Konfigurace se liší podle verze Claude Desktopu, proto doporučujeme řídit se aktuálními instrukcemi přímo v aplikaci.

Pro Cline (VS Code plugin) a Zed editor je postup obdobný -- Taxorio MCP server přidáš do nastavení MCP serverů v daném nástroji.

Praktické use cases

MCP integrace se nejvíce hodí pro:

  • Vývojáře, kteří pracují celý den v IDE a nechtějí přepínat do prohlížeče kvůli faktuře
  • Power usery s Claude Desktopem, kteří chtějí mít správu faktur jako součást svého AI workflow
  • Automatizace -- například generování měsíčních souhrnných faktur pro pravidelné klienty
  • Rychlé vyhledávání -- "kolik mi zaplatil klient X v posledním čtvrtletí" bez otevírání aplikace

MCP server Taxoria je open source -- zdrojový kód je dostupný na GitHubu a komunita může přispívat novými nástroji nebo integrací s dalšími AI platformami.