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, 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 v aplikaci.

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

Najdete ji i v aplikaci v Můj profil → Integrace, s tlačítkem Kopírovat.

Jaký tarif

Připojení asistenta je součástí tarifu Starter a vyšších. U tarifu Free se povolovací stránka zastaví s vysvětlením.

Claude

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

1. Nastavení → Konektory → Přidat vlastní konektor.
2. Jako adresu vložte https://app.mujvykaz.cz/api/mcp.
3. Klikněte Připojit a přihlaste se svým běžným účtem.
4. Na stránce Povolit přístup vyberte organizaci a úroveň přístupu — Číst i zapisovat, nebo Jen číst.

Připojení pak najdete v aplikaci v Můj profil → Integrace → Připojené aplikace, včetně tlačítka Odpojit. Změna úrovně přístupu = odpojit a připojit znovu.

Čí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.

1. Vytvořte si klíč v aplikaci: Můj profil → Integrace → Osobní API klíče. Pro první zkoušku stačí rozsah Pouze čtení.

2. V ChatGPT otevřete Připojení k vlastnímu MCP.

3. Název napište bez diakritiky, například MujVykaz. S diakritikou ho ChatGPT zkomolí („MůjVýkaz" se uloží jako m-jv-kaz).

4. Typ přepněte na Streamovatelné HTTP.

5. URL: https://app.mujvykaz.cz/api/mcp

6. Pole Proměnná prostředí tokenu nositele nechte prázdné — chce název systémové proměnné, ne samotný klíč.

7. V sekci Záhlaví vyplňte jeden řádek:

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

   Slovo Bearer, mezera a klíč patří dohromady do jedné hodnoty.

8. Sekci Záhlaví z proměnných prostředí nechte prázdnou a uložte.

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.

Co asistent umí

Přes 60 nástrojů napříč aplikací — výkazy, projekty, klienti, úkoly, paušály, nepřítomnost, náklady, odměny, ziskovost, reporty klientům i fakturace.

Zkuste třeba:

• Ukaž mi moje výkazy za tento týden
• Kolik hodin zbývá klientovi z paušálu?
• Jaký máme zisk za minulý měsíc?
• Zapiš 2 hodiny na projektu Redesign webu, dnes, popis „code review"

Úplný seznam nástrojů je na stránce s návodem.

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.

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 Můj profil → Integrace. Každý člověk může mít nejvýš 5 klíčů.

Rozsah

Rozsah	Co dovolí
Pouze čtení	Reporty a přehledy
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.
„Tarif organizace nezahrnuje API a MCP"	Připojení vyžaduje tarif Starter nebo vyšší.
Asistent nevidí novější nástroje	Restartujte ho.