EasyFaktury Nejrychlejší vystavování faktur
MCP Server URL

Klikněte do pole nebo na tlačítko a vložte tuto URL do ChatGPT, Claude nebo jiného MCP klienta.

EasyFaktury MCP

Připojte EasyFaktury do svého AI klienta.

Přidejte URL serveru do ChatGPT, Claude.ai nebo jiného MCP klienta. Přihlašujete se přes prohlížeč stejně jako do jakékoliv webové appky. Pak můžete vystavovat faktury, hledat klienty nebo generovat PDF rovnou z AI hosta.

Rychlý start Průvodce pro Claude OAuth 2.0 Streamable HTTP 21 nástrojů 1 profil = 1 připojení

Zvolte vašeho AI poskytovatele

ChatGPT a Claude.ai mají na této stránce zkrácený quickstart. Codex a další MCP klienti používají stejný endpoint a stejné OAuth přihlášení, jen trochu jiné prostředí.

Rychlý start podle klienta

Nejkratší cesta pro ChatGPT a Claude.ai. Oba klienti používají stejný endpoint https://easyfaktury.cz/mcp a stejné přihlášení přes prohlížeč.

Ukázka v praxi

ChatGPT setup a první faktura

Ve videu uvidíte první nastavení na chatgpt.com, přidání EasyFaktury jako nové app a práci s fakturami přímo v chatu.

  1. otevření ChatGPT na webu
  2. přidání EasyFaktury jako nové app
  3. dokončení propojení
  4. první faktura a PDF
Ukázka v praxi

Claude setup a první faktura

Ve videu uvidíte přidání EasyFaktury do Claude, dokončení OAuth přihlášení a první práci s fakturami přímo v aplikaci Claude.

  1. otevření Integrations v Claude
  2. vložení EasyFaktury MCP URL
  3. dokončení OAuth přihlášení
  4. první faktura a PDF přímo v Claude
ChatGPT

Přidat EasyFaktury do ChatGPT

První setup se dělá na webu chatgpt.com. Po propojení pak můžete s EasyFaktury pokračovat i v aplikacích pod stejným OpenAI účtem.

  1. 1
    Otevřete ChatGPT na webu

    V profilu přejděte do Settings, sekce Apps, a pokud je potřeba, zapněte Developer mode.

  2. 2
    Vytvořte novou appku

    Do nové appky vložte název, MCP URL a krátký popis z bloku níže. ChatGPT si endpoint zapamatuje jako novou integraci.

  3. 3
    Dokončete přihlášení v prohlížeči

    ChatGPT otevře EasyFaktury stránku, kde zadáte email, OTP kód a zvolíte profil firmy.

  4. 4
    Vraťte se do chatu

    Po návratu můžete rovnou hledat klienty, vystavovat faktury, upravovat je nebo vracet PDF.

Claude.ai / aplikace Claude

Přidat EasyFaktury do Claude.ai

Claude používá stejné OAuth flow, ale samotné přidání děláte v sekci Integrations přímo v aplikaci Claude.

  1. 1
    Otevřete Integrations

    V aplikaci Claude nebo v Claude.ai přejděte do Integrations a zvolte Add Integration.

  2. 2
    Vložte MCP Server URL

    Použijte stejnou URL https://easyfaktury.cz/mcp. Ruční JSON konfigurace je níže pro klienty, kteří ji vyžadují.

  3. 3
    Claude otevře prohlížeč

    Dokončíte email, OTP kód a vyberete profil firmy, ke kterému má mít Claude přístup.

  4. 4
    Pokračujete rovnou v Claude

    Po návratu už máte k dispozici všechny EasyFaktury nástroje, včetně práce s klienty, fakturami a PDF.

Hodnoty pro novou appku v ChatGPT
Název: EasyFaktury MCP
MCP Server URL: https://easyfaktury.cz/mcp
Popis: Vystavování faktur, správa klientů, ARES lookup, další číslo faktury, email a generování PDF v EasyFaktury.

Do ChatGPT obvykle stačí právě tyto tři hodnoty. Detailní screenshoty najdete na samostatné ChatGPT stránce.

Společná MCP Server URL
https://easyfaktury.cz/mcp

Stejnou URL používá ChatGPT, Claude.ai, Codex i další klienti, kteří umí remote HTTP MCP.

Ruční HTTP MCP konfigurace
{
  "mcpServers": {
    "easyfaktury": {
      "type": "http",
      "url": "https://easyfaktury.cz/mcp"
    }
  }
}

Název souboru může být pořád claude_desktop_config.json, i když stejné připojení používáte napříč Claude.ai, aplikací Claude i dalšími klienty.

Jak přihlášení funguje

Krok 1

Klient zjistí, že je potřeba OAuth

Při první akci nad EasyFaktury klient otevře přihlašovací stránku ve vašem prohlížeči. Nepotřebujete API klíče ani ručně generované tokeny.

Krok 2

Email, OTP a výběr profilu

Zadáte email, 6místný ověřovací kód a potvrdíte, ke kterému profilu firmy má mít dané MCP připojení přístup.

Krok 3

Klient dostane token a pracujete dál

Po návratu do AI klienta už můžete číst klienty, vytvářet a upravovat faktury, posílat je emailem, vracet PDF i generovat DPH XML exporty.

Aktuálně 25 nástrojů

Live server teď nabízí 25 nástrojů rozdělených mezi profily, nastavení, klienty, faktury, stav faktur, email, PDF a nově i DPH exporty. Každé připojení je stále svázané s jedním profilem firmy.

Profily a nastavení

Přehled profilu a změny nastavení

  • list_profiles – dostupné firemní profily
  • get_profile_settings – aktuální nastavení profilu
  • preview_profile_settings_update – náhled změny před uložením
  • apply_profile_settings_update – potvrzení změny nastavení
Klienti a lookup

Vyhledávání a zakládání odběratelů

  • list_clients – seznam klientů
  • find_client_by_name – hledání klienta podle názvu
  • create_client – vytvoření nového klienta
  • lookup_company – ARES lookup podle IČO
Faktury a stav

Celý cyklus od draftu po zaplacení

  • list_invoices – přehled faktur s filtry
  • get_next_invoice_number – další číslo faktury
  • create_invoice – vytvoření faktury
  • get_invoice – detail faktury
  • update_invoice – úprava faktury
  • delete_invoice – soft delete
  • restore_invoice – obnova smazané faktury
  • mark_invoice_paid – označení jako zaplacené
  • mark_invoice_unpaid – vrácení na nezaplacené
Email a výstupy

Odkazy, email a PDF

  • send_invoice_email – odeslání faktury emailem
  • get_invoice_email_status – stav odeslání emailu
  • generate_invoice_link – veřejný odkaz na fakturu
  • generate_invoice_pdf – PDF faktury
DPH a daňové exporty

Přehled připravenosti a XML pro podání

  • get_vat_export_overview – kontrola připravenosti a souhrn DPH
  • generate_vat_return_xml – Přiznání k DPH v XML
  • generate_vat_control_statement_xml – Kontrolní hlášení v XML
  • generate_vat_eu_sales_list_xml – Souhrnné hlášení v XML

Další klienti a prostředí

ChatGPT a Claude.ai mají nahoře rychlý start, ale stejný endpoint funguje i v dalších nástrojích, pokud umí remote HTTP MCP.

OpenAI

ChatGPT a Codex

  • stejná MCP URL a stejné OAuth přihlášení
  • ChatGPT je nejpřímější cesta pro běžné použití
  • Codex dává smysl pro práci nad workspace a soubory
Anthropic

Claude.ai, aplikace Claude a Claude Code

  • Claude.ai i aplikace Claude umí stejné OAuth flow
  • Claude Code se hodí tam, kde chcete víc práce v projektu
  • ruční JSON konfigurace je výš pro klienty, kteří ji vyžadují
IDE

Cursor, Zed a další editorové klienty

  • pokud editor umí remote HTTP MCP, stačí stejný endpoint
  • přihlášení i profilové omezení zůstává stejné
  • hodí se pro workflow, kde AI řeší faktury vedle práce v kódu
Vlastní klienti

Když si píšete vlastní integraci

  • transport je Streamable HTTP
  • autorizace běží přes OAuth 2.0 Authorization Code + PKCE
  • technické parametry a endpoint najdete níže

Technické detaily a další odkazy

Parametry serveru
Endpoint:   https://easyfaktury.cz/mcp
Transport:  Streamable HTTP
Auth:       OAuth 2.0 (Authorization Code + PKCE)
Metadata:   /.well-known/oauth-authorization-server
Authorize:  /oauth/authorize
Token:      /oauth/token
Revoke:     /oauth/revoke
Scope:      invoices
Client ID:  easyfaktury-mcp

Časté dotazy

  • Musím si vytvořit API klíče? Ne. Přihlášení běží přes prohlížeč a OAuth 2.0. MCP klient si tokeny vyřeší sám.
  • Je nástrojů opravdu 25? Ano. Aktuální live MCP server dnes nabízí 25 nástrojů včetně práce s nastavením profilu, stavy faktur, emailem, PDF i DPH XML exporty.
  • Jaký je rozdíl mezi ChatGPT a Claude.ai quickstartem? Endpoint i přihlášení jsou stejné. Liší se jen místo, kde integraci přidáváte: v ChatGPT na webu, v Claude v sekci Integrations.
  • Může jedno připojení vidět více firem? Ne. Každé připojení je svázané s jedním profilem firmy. Pokud chcete pracovat s jinou firmou, vytvoříte druhé připojení.
  • Kdy je lepší CLI než MCP? Když chcete plně lokální nebo serverový workflow bez chatu, například pro cron, CI, lokální PDF nebo deterministické skripty.