Čo je Model Context Protocol (MCP)?
MCP je otvorený štandard od Anthropic (autor Claude.ai), ktorý umožňuje AI modelom bezpečne pristupovať k externým systémom — databázam, API alebo fakturačnej aplikácii ako MojeFaktury.sk.
Namiesto toho, aby ste museli kopírovať údaje medzi aplikáciou a ChatGPT, MCP necháva AI priamo „vidieť“ do vašej fakturácie — len v tom rozsahu, ktorý povolíte. Token kedykoľvek zrušíte v Nastaveniach.
Postavili sme MCP server podľa najnovšej špecifikácie (2025-11-25), s podporou OAuth 2.1, Dynamic Client Registration a Streamable HTTP transportu. To znamená, že väčšina AI klientov vás pripojí jedným klikom — bez konfigurácie.
Čo všetko vie AI cez MCP?
Cez MCP server získava AI prístup k 67 nástrojom a 5 šablónam workflow-ov. Tu sú konkrétne príklady pre každý typ použitia:
- FakturáciaVystavenie novej faktúry („vystav 500 € faktúru pre Alfa s.r.o. s DPH“), úprava, publikácia konceptu, zrušenie, dobropis, konverzia proformy. AI vám pripraví návrh, vy ho potvrdíte.
- Cenové ponukyVytvorenie ponuky, zaslanie klientovi emailom (PDF v prílohe), zmena statusu, konverzia ponuka → faktúra, sledovanie kto ju otvoril.
- KlientiVyhľadanie klienta podľa mena/IČO, vytvorenie nového klienta z bizdata.sk registra („pridaj klienta s IČO 47079908“), úprava údajov, história fakturácie.
- Výdavky a dokladyZaevidovanie výdavku, prehľad podľa kategórií, štatistiky za obdobie, OCR-ované doklady zo storage. „Koľko som tento mesiac zaplatil za reklamu?“
- Banka a párovanieZoznam transakcií, vyhľadávanie podľa VS, auto-párovanie s faktúrami, potvrdenie/zamietnutie návrhov. „Spáruj mi všetky neuhradené transakcie z minulého týždňa.“
- Reporty a štatistikyMesačný report, DPH súhrn, analýza výnosov, top dlžníci, cashflow forecast, aging faktúr. AI pripraví prehľad s odporúčaniami.
- KomunikáciaOdoslanie faktúry alebo ponuky emailom (PDF v prílohe), pripomienky neuhradených faktúr, sledovanie kto kedy otvoril email.
- AutomatizáciaPravidelné faktúry (mesačné/štvrťročné/ročné), pause/resume, forecast na nadchádzajúce dni, zoznam e-shop objednávok z WooCommerce.
Podporované AI nástroje
Tu je úplný zoznam aktuálne podporovaných MCP klientov (máj 2026). Detailný návod pre každého nájdete na stránke pomoci.
- Claude.ai (web, Desktop, mobile) — OAuth pripojenie jedným klikom
- Claude Code (CLI) —
claude mcp add - ChatGPT (Plus / Pro / Business / Enterprise) — Custom Connectors
- Cursor IDE —
.cursor/mcp.jsonkonfigurácia - VS Code + GitHub Copilot (Agent mode) — natívna MCP podpora
- Windsurf (Codeium) — OAuth alebo token
- Zed editor — cez mcp-remote bridge
- Continue.dev — open-source IDE asistent
- Gemini CLI (Google) — auto-discovery OAuth
- Hermes Agent (NousResearch) — Bearer token
- OpenClaw / NanoClaw — Bearer token
- Goose (Block) — OAuth loopback
- Open WebUI (Ollama UI) — OAuth alebo PAT
- LibreChat (open-source ChatGPT klon) — Bearer alebo OAuth
- mcp-remote bridge — pre stdio-only klientov
Príklady reálnych konverzácií
Pondelkové ráno, kontrola financií:
- „Ako sme zarobili minulý týždeň?“ → AI volá
get_revenue_analysisa vráti súhrn vystavenej fakturácie - „Ktorí klienti mi dlhujú viac ako 30 dní?“ →
get_overdue_invoices+ tabuľka s návrhom akcií - „Pošli pripomienku pre faktúru #2026010“ → AI vás požiada o potvrdenie a pošle (alebo iba pripraví v test mode)
Vystavenie faktúry priamo z Claude.ai
- „Vystav faktúru pre Beta s.r.o., 1000 € + DPH za webdizajn, splatnosť 14 dní“
- AI: vyhľadá klienta, pripraví návrh, ukáže súhrn
- Vy potvrdíte → AI volá
create_invoicea vráti URL na PDF - Voliteľne: „a pošli to klientovi“ →
send_invoice_emails PDF prílohou
Bezpečnosť
Pri vytvorení tokenu máte plnú kontrolu nad jeho rozsahom:
- Granulárne oprávnenia„Len čítanie“ — AI vidí dáta ale nemôže nič meniť. „Čítanie + zápis“ — AI môže vystavovať a meniť. Mutating operácie sa pri read-only tokene skryjú zo zoznamu nástrojov.
- Multi-org izoláciaToken vidí iba organizácie do ktorých máte prístup. Pri viacerých firmách musí AI explicitne povedať s ktorou pracuje.
- Audit logKaždé volanie z AI sa zaznamenáva — kto, kedy, čo, ako dlho trvalo. Súčasť superadmin analytiky.
- PKCE + HTTPS onlyOAuth flow používa PKCE S256, tokeny sa nikdy neprenášajú v URL. Refresh token rotácia pri každom použití.
- Okamžitá revokáciaV Nastaveniach → API kľúče môžete token kedykoľvek deaktivovať. AI klient stratí prístup okamžite.
Ako sa pripojiť
Pre Claude.ai (najjednoduchší spôsob):
- V Claude.ai: Customize → Connectors → + Add custom connector
- Vložte URL:
https://mojefaktury.sk/api/mcp - Kliknite Connect → prihláste sa do MojeFaktury → schválite consent
- Hotovo — môžete sa pýtať „ukáž mi faktúry tento mesiac“
Detailné návody pre každého klienta (s presnými config snippetmi) nájdete v sekcii Pomoc → MCP integrácia.
Často kladené otázky
Musím platiť navyše za MCP?
Nie navyše, ale MCP je dostupné od plánu Profesionálny (rovnako ako REST API). Počas skúšobného obdobia ho máte k dispozícii tiež. Vytvorenie tokenov a počet pripojení je v rámci plánu neobmedzený.
Vidí AI moje dáta aj keď nie som pripojený?
Nie. AI klient (Claude.ai, ChatGPT, …) si dáta vytiahne iba keď ho o niečo požiadate. Server nelogu jeho dotazy do AI poskytovateľa — komunikácia ide priamo medzi vaším AI klientom a našim API.
Posiela MCP server moje dáta Anthropic-u alebo OpenAI?
Nie. MojeFaktury.sk je iba MCP server — pasívne vystavujeme nástroje a dáta na požiadanie. Komunikuje s ním AI klient (Claude.ai, ChatGPT) priamo. Naše servery dáta nikam neposielajú — záleží na tom, ktorého AI klienta používate a aké sú jeho zásady spracovania dát.
Aké AI nástroje sú podporované?
Plne podporujeme 17+ klientov: Claude.ai, ChatGPT, Cursor, VS Code Copilot, Windsurf, Zed, Gemini CLI, Hermes, OpenClaw, Goose, Open WebUI, LibreChat, Continue.dev a mcp-remote bridge. Podporujeme aktuálnu MCP špecifikáciu 2025-11-25 — všetci budúci klienti by mali fungovať out-of-the-box.
Môže AI zmazať moje faktúry?
Pre faktúry áno môže urobiť „soft cancel“ (zmena statusu na zrušené), ale plné zmazanie nie je dostupné cez MCP API. Pre výdavky je dostupné delete_expense ale len s oprávnením read_write. Token „len čítanie“ žiadne mazanie nedovolí.
Čo ak si chcem ponechať plnú kontrolu — môže ma AI o niečo požiadať predtým, než to spraví?
Áno. Všetky moderné AI klienty (Claude.ai, ChatGPT, Cursor) ukazujú návrh akcie pred jej spustením a čakajú na vaše potvrdenie. Naše tooly toto rešpektujú — napr. send_invoice_email sa volá až po vašom OK.
Funguje to aj keď mám viac firiem?
Áno, dokonca priamo z jedného tokenu. Tool list_my_organizations AI ukáže všetky firmy do ktorých máte prístup. Pri každom príkaze môže AI vybrať s ktorou pracuje (predvolene primárna).