AI asistent (Claude, ChatGPT)

MujVykaz umí mluvit s AI asistentem přímo — přes takzvaný MCP server. Asistent pak vidí vaše data a umí s nimi pracovat: zapsat výkaz, ukázat čerpání paušálu, spočítat ziskovost, zkontrolovat doklady k nákladům, sestavit report klientovi.

Asistent nikdy neuvidí ani neudělá víc, než smíte vy sami. Dědí vaši roli i organizaci: člen zapisuje jen své výkazy, manažer schvaluje jen svůj tým, náklady vidí jen ten, kdo na ně má právo i v aplikaci.

Adresa serveru: https://app.mujvykaz.cz/api/mcp

Najdete ji i v aplikaci: Nastavení → Kalendář a AI asistenti, karta Připojení AI asistenta, s tlačítkem Kopírovat.

Jaký tarif

Připojení asistenta je součástí tarifu Starter a vyšších (zkušební doba má funkce tarifu Business). U tarifu Free se povolovací stránka zastaví s vysvětlením. Už připojený asistent po přechodu organizace na Free přestane fungovat a dostane chybu 403 — po přechodu na vyšší tarif funguje zase, nic se nemaže.

Claude

V Claude (aplikace i claude.ai) se přihlásíte tlačítkem. Klíč nikam nekopírujete — Claude si ho vytvoří sám.

Nastavení → Konektory → Přidat vlastní konektor.
Jako adresu vložte https://app.mujvykaz.cz/api/mcp.
Klikněte Připojit a přihlaste se svým běžným účtem.
Na stránce Povolit přístup zkontrolujte řádek Přístup dostane — u Claude tam musí stát claude.ai (nebo claude.com).
Vyberte organizaci a úroveň přístupu. Předvybrané je Jen číst; chcete-li, aby asistent i zapisoval, zvolte Číst i zapisovat. Klikněte Povolit.

Připojení pak najdete v aplikaci v Nastavení → Kalendář a AI asistenti → Připojené aplikace, včetně řádku „Přístup se vrací na: …“ a tlačítka Odpojit. Změna úrovně přístupu = odpojit a připojit znovu.

Jiná adresa než claude.ai? Klikněte Zamítnout

Jméno aplikace si aplikace při připojení volí sama, proto stránka ukazuje hlavně adresu, kam se přístup vrátí. Když vám odkaz na povolovací stránku někdo poslal, u Přístup dostane stojí cizí adresa, nebo svítí varování Tuto adresu neznáme či Pozor, může jít o podvod, klikněte Zamítnout. Claude Code a mcp-remote běží u vás na počítači, u nich stránka píše Aplikace na tomto počítači.

Číst i zapisovat, nebo jen číst?

Doporučujeme Číst i zapisovat. Jinak asistent umí jen přehledy a při každém pokusu zapsat výkaz skončí hláškou o plném přístupu.

ChatGPT

ChatGPT se k vlastnímu MCP nepřihlašuje tlačítkem — jeho formulář přihlášení vůbec nenabízí. Místo něj se vkládá osobní API klíč do hlavičky.

Jen ve Work

Vlastní MCP servery jsou dostupné pouze v pracovním prostředí ChatGPT. V běžném chatu je nenajdete.

Vytvořte si klíč v aplikaci: Nastavení → Kalendář a AI asistenti → Osobní API klíče (viz Autentizace). Pro první zkoušku stačí rozsah Pouze čtení.
V ChatGPT otevřete Připojení k vlastnímu MCP.
Název napište bez diakritiky, například MujVykaz. S diakritikou ho ChatGPT zkomolí („MůjVýkaz" se uloží jako m-jv-kaz).
Typ přepněte na Streamovatelné HTTP.
URL: https://app.mujvykaz.cz/api/mcp
Pole Proměnná prostředí tokenu nositele nechte prázdné — chce název systémové proměnné, ne samotný klíč.
V sekci Záhlaví vyplňte jeden řádek:

Klíč Hodnota
Authorization Bearer VÁŠ_KLÍČ

Slovo Bearer, mezera a klíč patří dohromady do jedné hodnoty.
Sekci Záhlaví z proměnných prostředí nechte prázdnou a uložte.

Klíč	Hodnota
`Authorization`	`Bearer VÁŠ_KLÍČ`

Proč ChatGPT není v „Připojených aplikacích"

Ta sekce ukazuje jen připojení přihlášená tlačítkem. ChatGPT se hlásí klíčem, takže se v ní neobjeví — zrušíte ho smazáním příslušného API klíče.

Ostatní klienti

Claude Code, Cursor, VS Code a další se hlásí osobním API klíčem v hlavičce.

Claude Code — jeden příkaz v terminálu:

claude mcp add --transport http mujvykaz https://app.mujvykaz.cz/api/mcp --header "Authorization: Bearer vas_api_klic"

Cursor, VS Code a další — do konfigurace MCP serverů:

{
  "mcpServers": {
    "mujvykaz": {
      "type": "http",
      "url": "https://app.mujvykaz.cz/api/mcp",
      "headers": {
        "Authorization": "Bearer vas_api_klic"
      }
    }
  }
}

Název klíče (mcpServers / servers) a umístění souboru se liší podle klienta; řiďte se jeho návodem na „remote" nebo „HTTP" MCP server.

Klient bez podpory vzdálených serverů (umí spustit jen lokální příkaz) použije obecnou proxy mcp-remote:

{
  "mcpServers": {
    "mujvykaz": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.mujvykaz.cz/api/mcp"]
    }
  }
}

Proxy vás při prvním spuštění přihlásí stejně jako Claude a nabízí vždy aktuální sadu nástrojů.

Balíček mujvykaz-mcp na npm se dál nevyvíjí

Dřív šlo server spustit i lokálně přes npx. Tuhle cestu už nedoporučujeme a nové funkce do ní nepřibývají — vzdálené připojení se aktualizuje samo s aplikací a nic se u vás neinstaluje. Používáte-li balíček, přejděte na adresu výš; funguje s týmž API klíčem.

Co asistent umí

Server nabízí 103 nástrojů. Asistent si je vybírá sám podle toho, na co se ptáte — nemusíte je znát. Přehled podle oblastí:

Oblast	Co asistent zvládne
Profil a přehledy	Můj profil, moje hodiny a částky za týden a měsíc, seznam členů týmu, statistiky týmu (manažer a výš) a dotaz na data běžnou řečí (vlastník, administrátor, manažer, účetní) — stejný jako v AI Reportech
Výkazy práce	Zobrazit, zapsat (i s typem práce a úkolem), upravit, smazat, odeslat ke schválení; schválit a vrátit k přepracování (vlastník, administrátor, manažer)
Projekty a klienti	Seznam, založení a úprava (vlastník, administrátor a manažer u svých klientů; platí limit tarifu)
Karta klienta	Kontakty, historie klienta a přidání záznamu (Starter a výš)
Úkoly	Seznam, založení, úprava, komentář (Starter a výš)
Číselníky	Typy práce a kategorie nákladů. Vlastník a administrátor položku založí rovnou, manažer podá návrh ke schválení
Plánování kapacit	Kdo má volno, můj plán, naplánování, úprava a smazání naplánované práce, i opakující se (Business a výš). Sobě plánuje každý, ostatním manažer a výš nebo Plánovač kapacit
Nepřítomnost	Typy, žádost o volno, schválení a zamítnutí (vlastník, administrátor, HR), zůstatek dovolené a roční nároky (HR); Business a výš
Členové týmu a narozeniny	Založit člena (pozvánka odejde e-mailem; smí i manažer, ale jen člena), upravit datum nástupu a ukončení, typ vztahu, roli, úvazek, sazbu a náklad (cizí profil vlastník, administrátor a HR). Hromadně nahrát narozeniny z tabulky smí vlastník, administrátor a HR
Náklady	Seznam, zápis (i s dodavatelem a DPH), úprava, smazání, schválení (kdo náklady schvaluje — vlastník, administrátor, účetní, manažer u svých klientů, ručně určený schvalovatel). Nastavení schvalování a volby Kdo zapisuje náklady přečte každý, změní vlastník a administrátor
Doklady k nákladům	Doklady ke kontrole, přečtené údaje a upozornění, potvrzení dokladu jako nákladu (i rozložení do měsíců nebo rozdělení na střediska) a zahození
Pravidelné položky	Nájem, leasing, předplatné: seznam, založení, nová částka od měsíce, ukončení, měsíc bez nákladu (vlastník, administrátor, účetní)
Balíček pro účetní	Co balíček za měsíc obsahuje a co v něm chybí, nastavení kódů středisek pro účetnictví (vlastník, administrátor, účetní)
Import nákladů z účetnictví	Z tabulky nebo knihy přijatých faktur nejdřív ukáže náhled, potom náklady zapíše; poslední importy a vrácení importu (vlastník, administrátor, účetní)
Odměny a náklady lidí	Odměny nad rámec mzdy, historie odměny člena, přepočet nákladovky výkazů a pravidla Kam patří náklady (vlastník, administrátor, HR, účetní; pravidla smí měnit jen vlastník a administrátor)
Finance	Ziskovost ve dvou pohledech (i s plnými náklady včetně režie), Kontrola financí, závazky klientů (Controlling, Business a výš) a otevřená období k fakturaci
Klientské reporty a faktury	Sestavení a odeslání reportu, faktura z reportu, změna stavu, storno
Paušály	Čerpání, přebytek, otevřená období, náhled a uzavření období, doplnění do uzávěrky (Business a výš)
Uzávěrky	Externí faktura se skutečnou částkou, její úprava, storno a historie, připsání paušálu k dokladu
Zámek měsíce	Stav zámku, zamknout měsíc, dočasně odemknout (vlastník, administrátor, účetní). Odemčení jen pro sebe: požádat o něj (člen, manažer, HR), vypsat žádosti a „kdo zapisuje po termínu“, žádost schválit nebo zamítnout (vlastník, administrátor, účetní)

Zápis potřebuje připojení Číst i zapisovat (u klíče plný přístup). Role a tarif asistent posuzuje stejně jako aplikace: co byste v aplikaci nesměli, odmítne i asistent.

Úplný a vždy aktuální seznam včetně toho, co který nástroj vyžaduje za roli a tarif, je na stránce s návodem přímo v aplikaci.

Co přes asistenta nejde

Některé věci zůstávají záměrně jen v aplikaci:

Nahrát soubor dokladu. Asistent doklady ke kontrole vypíše a potvrdí, ale soubor nahrajete v aplikaci (nebo přes REST API).
Stáhnout ZIP Balíčku pro účetní. Asistent řekne, co balíček obsahuje; ZIP stáhnete v aplikaci, nebo přes REST API.
Natrvalo odemknout měsíc. Asistent ho může odemknout jen dočasně, po platnosti se zamkne zpět. Do zamčeného měsíce se přes asistenta nezapisuje, dokud ho dočasně neodemknete nebo dokud vám někdo neschválí odemčení jen pro vás. Žádost stáhnout a odemčení ukončit dřív jde v aplikaci nebo přes REST API.
Schválit návrh položky číselníku. Návrhy manažera schvaluje administrátor v aplikaci.
Uzavřít období paušálu s placenými vícepracemi. O faktuře za ně rozhoduje člověk v průvodci na kartě klienta.

Zkuste třeba:

Kolik hodin jsem odpracoval tento týden?
Zapiš 3 hodiny na projekt API integrace za dnešek.
Kolik hodin zbývá z paušálu klienta Firma s.r.o.?
Kdo má příští týden volnou kapacitu?
Jaký máme zisk za minulý měsíc?
Vytvoř úkol „Připravit podklady“ na projektu Redesign a přiřaď ho Janě.
Co chybí v Balíčku pro účetní za září?
Naimportuj náklady z této tabulky a nejdřív mi ukaž náhled.

Nové nástroje se objeví po restartu

Běžící asistent si seznam nástrojů drží po celou dobu běhu. Když přibudou nové, restartujte ho — odpojovat a připojovat konektor není potřeba.

Přístupová práva

Asistent respektuje roli, tarif organizace i rozsah přístupu. Člen spravuje jen svá data, manažer vidí své klienty a práci svých lidí (částky jen u svých klientů), HR spravuje tým, nepřítomnosti a nároky na dovolenou, účetní vidí finance celé firmy, vlastník a administrátor vše. Faktury a paušály člen ani HR nedostanou, manažer je vidí jen u svých klientů — stejně jako v aplikaci. Přístup Jen číst zápisové nástroje odmítne.

Některé oblasti závisí i na tarifu: úkoly a karta klienta jsou od tarifu Starter, paušály, plánování kapacit, nepřítomnosti a controlling od tarifu Business.

Dotaz na data běžnou řečí navíc čerpá limit AI dotazů organizace jako v aplikaci. Když má organizace v Nastavení → AI funkce AI vypnuté, dotaz na data asistent odmítne.

Server přijme nejvýš 60 požadavků za minutu na jedno připojení nebo klíč. Při překročení počkejte minutu a zkuste to znovu.

Osobní API klíče

Klíč potřebují jen nástroje, které se neumí přihlásit tlačítkem: ChatGPT, Claude Code, Zapier, Make, vlastní skripty.

Klíč se kopíruje ručně, zacházejte s ním jako s heslem — nese vaši roli i organizaci, takže kdo ho má, jedná za vás. Zobrazí se pouze jednou po vytvoření.

Najdete je v Nastavení → Kalendář a AI asistenti. Každý člověk může mít nejvýš 5 klíčů. Podrobně o klíčích píše stránka Autentizace.

Rozsah

Rozsah	Co dovolí
Pouze čtení	Reporty a přehledy, včetně dotazu na data běžnou řečí (ten data jen čte). Každý zápis server odmítne
Plný přístup	Vytvářet, upravovat a mazat záznamy

Platnost

Při vytváření zvolíte, jak dlouho má klíč platit: bez omezení (výchozí), nebo 30, 90 či 365 dní.

Bez omezení je správná volba pro scénáře v Zapieru nebo Make, které mají běžet dál — vypršení by je shodilo bez varování. Omezenou platnost dávejte klíči na jedno použití.

Vypršelý klíč server odmítne a v přehledu má odznak Vypršel. Obnovit ho nejde, vytvoříte nový. Klíče vytvořené dříve platnost omezenou nemají a fungují dál.

Odznak „Nepoužívaný"

Klíč, kterým se nikdo nepřihlásil přes 90 dní, označíme v přehledu jako nepoužívaný. Klíč funguje dál — je to jen doporučení, že ho nejspíš můžete zrušit.

Klíč člena, který byl v organizaci deaktivován, přestane fungovat okamžitě, bez ohledu na platnost.

Když se to nepovede

Co vidíte	Co s tím
„API error 401"	Klíč je neplatný, odvolaný, nebo mu vypršela platnost. Vytvořte nový.
„API error 403"	Klíč má rozsah Pouze čtení a asistent chtěl zapisovat, nebo na tu akci nemáte právo ani v aplikaci (role nebo tarif).
„API a MCP jsou od tarifu Starter…"	Organizace je na tarifu Free, takže klíč ani připojení nefungují. Po přechodu na vyšší tarif (vlastník nebo administrátor v Nastavení → Tarif a platby) začnou fungovat znovu.
„Tarif organizace nezahrnuje API a MCP" na stránce Povolit přístup	Připojení vyžaduje tarif Starter nebo vyšší.
„API error 429"	Překročený limit 60 požadavků za minutu. Počkejte minutu.
Asistent nevidí novější nástroje	Restartujte ho.
Claude po kliknutí na Připojit ukáže přihlášení	Správně — přihlaste se běžným účtem, pak vyberte organizaci a úroveň přístupu.

Claude​

ChatGPT​

Ostatní klienti​

Co asistent umí​

Co přes asistenta nejde​

Přístupová práva​

Osobní API klíče​

Rozsah​

Platnost​

Když se to nepovede​