Připojíte se za minutu, bez klíče a bez instalace. Claude pak vidí přesně to, co vy v aplikaci — stejná role, stejná organizace.
Můj Výkaz a Remote MCP server URL: https://app.mujvykaz.cz/api/mcp.ChatGPT se k vlastnímu MCP nepřihlašuje tlačítkem jako Claude — jeho formulář přihlášení vůbec nenabízí. Místo něj se vkládá osobní API klíč do hlavičky. Ověřeno naostro 14. 9. 2026.
MujVykaz. S diakritikou ho ChatGPT zkomolí („MůjVýkaz" se uloží jako m-jv-kaz).https://app.mujvykaz.cz/api/mcpAuthorization, Hodnota = Bearer VÁŠ_KLÍČ. Slovo Bearer, mezera a klíč patří dohromady do jedné hodnoty.V nové konverzaci s Claude nebo ChatGPT zkuste tyto dotazy:
Nástroje, které neumí přihlášení tlačítkem, se připojují osobním API klíčem. Klíč vytvoříte v
Můj profil → Integrace → Osobní API klíče: zadáte název, zvolíte Pouze čtení nebo Plný přístup
a klíč cl_… si hned zkopírujete — uvidíte ho jen jednou.
HTTP Claude Code umí vzdálený server s klíčem v hlavičce — jeden příkaz v terminálu:
claude mcp add --transport http mujvykaz https://app.mujvykaz.cz/api/mcp --header "Authorization: Bearer cl_váš_klíč_zde"
claude a nástroje jsou k dispozici.HTTP Do ~/.claude/mcp.json (globálně) nebo .claude/mcp.json v projektu:
{
"mcpServers": {
"mujvykaz": {
"type": "http",
"url": "https://app.mujvykaz.cz/api/mcp",
"headers": { "Authorization": "Bearer cl_váš_klíč_zde" }
}
}
}
Cmd+Shift+P → Developer: Reload Window).stdio Balíček mujvykaz-mcp běží u vás a hodí se jen pro klienty, kteří vzdálené MCP servery neumí. Nedoporučujeme ho jako první volbu: vyžaduje Node.js, kopírování klíče a verzi, kterou jste si stáhli — vzdálené připojení je vždy aktuální.
{
"mcpServers": {
"mujvykaz": {
"command": "npx",
"args": ["-y", "mujvykaz-mcp"],
"env": { "MUJVYKAZ_API_KEY": "cl_váš_klíč_zde" }
}
}
}
To je správně — přihlaste se svým účtem, pak se ukáže stránka „Povolit přístup".
Ochrana Claude proti podvrženým odkazům. Pokud jste připojování spustili sami, klikněte „Continue connecting".
Připojení bylo povoleno jen ke čtení. V Můj profil → Integrace → Připojené aplikace ho odpojte a v Claude znovu klikněte Connect, tentokrát zvolte „Číst i zapisovat".
Připojení Claude je od tarifu Starter. Vlastník organizace ho změní v Nastavení → Předplatné.
API klíč není nastavený v konfiguraci. Zkontrolujte, že env.MUJVYKAZ_API_KEY obsahuje váš klíč (cl_...).
Ujistěte se, že máte nainstalovaný Node.js 18+ a npm. Zkuste v terminálu:
MUJVYKAZ_API_KEY=cl_váš_klíč npx -y mujvykaz-mcp
Mělo by vypsat „running on stdio". Bez klíče se server záměrně nespustí a vypíše MUJVYKAZ_API_KEY environment variable is required — to není chyba, jen chybějící klíč.
Klíč je neplatný nebo byl odvolán. Vygenerujte nový v Můj profil → Integrace → Osobní API klíče; u konektoru stačí Odpojit a znovu Připojit.
Klíč je platný, ale na tuhle akci nemá právo. Buď ji vaše role nemá (viz přehled nástrojů níže), nebo je klíč „Pouze čtení" a akce zapisuje. U modulů Paušály a Plánování kapacit ověřte, že máte plán Business.
Konfigurace s npx -y stahuje vždy aktuální verzi — stačí restartovat klienta. Pokud máte balíček nainstalovaný napevno, aktualizujte ho: npm i -g mujvykaz-mcp@latest. Nejjistější je připojení přes Connectors (HTTP) — to je vždy aktuální bez instalace.
Překročen rate limit (60 požadavků/min). Počkejte minutu a zkuste znovu.
Claude uvidí přesně to, co vy v aplikaci — připojení i klíč nesou vaši roli i rozsah. Pracovník tedy vidí svoje výkazy, manažer svůj tým. Nástroje označené ᴹ vyžadují roli manažer a výš.
list_time_entries · create_time_entry · update_time_entry · delete_time_entry · submit_time_entries · approve_time_entries ᴹ · reject_time_entries ᴹ
list_projects · create_project ᴹ · update_project ᴹ · list_clients · create_client ᴹ · update_client ᴹ
list_tasks · create_task · update_task · add_task_comment
list_client_contacts · list_client_activities · add_client_activity
Pro vlastníka, admina, manažera a účetní.
list_retainers · retainer_status
Pro vlastníka, admina, manažera a účetní. Ceny vidí jen finanční role.
capacity_overview · my_plan · plan_work ᴹ · update_planned_work ᴹ · delete_planned_work ᴹ
Kolize naplánované práce s absencí zápis neblokuje — vrátí se jako varování.
controlling_overview
Závazky klientů za měsíc — paušály, zakázky za pevnou cenu, hodinové stropy. Pro vlastníka, admina, manažera a účetní; náklady a marži vidí jen finanční role.
list_catalog_items · propose_catalog_item
Typy práce a kategorie nákladů. Manažer položku navrhne, schvaluje ji vlastník nebo admin v aplikaci.
list_absence_types · request_absence · list_absences · decide_absence · vacation_balance · list_vacation_entitlements · set_vacation_entitlement
Žádost podáváte vždy za sebe. Schvalovat a zamítat smí vlastník, admin a HR — manažer ne. Typ nepřítomnosti se nižším rolím maskuje. Nároky na dovolenou spravuje HR; vlastní nárok si nenastaví nikdo.
list_expenses · create_expense · update_expense · delete_expense · approve_expenses ᴹ
Bez zadané přeúčtované částky ji appka dopočítá z marže nastavené na středisku nebo u klienta.
list_bonuses · create_bonus · update_bonus · delete_bonus
Pro vlastníka, admina, HR a účetní. Manažer ne — jsou to mzdové údaje kolegů. Odměna je nákladem měsíce výplaty.
list_client_reports · get_client_report · create_client_report · send_client_report
Soupis odvedené práce za období. send_client_report skutečně odešle e-mail klientovi a report se tím stává podkladem faktury — na pouhé zobrazení slouží get_client_report.
create_invoice_from_report · update_invoice_status · cancel_invoice · preview_retainer_close · close_retainer_period
Faktura se vystavuje z odsouhlaseného reportu, ne skládáním řádků v chatu. Nemaze se, ale stornuje s důvodem. Uzavření období paušálu má vlastní náhled — zmrazuje ceny i dohodu o přesahu.
profitability_summary · finance_check · open_closures
Souhrn Ziskovosti ve dvou perspektivách (dle výkazů a dle reality), kontrola nastavení peněz a přehled toho, co ještě nedošlo k faktuře. Pro účetní a výš; manažerovi se nákladová strana nevrací.
my_profile · my_stats · list_users · team_stats ᴹ · query_reports · create_user · update_user · list_birthdays · import_birthdays
query_reports (dotaz přirozeným jazykem) je pro vlastníka, admina, manažera a účetní — a potřebuje klíč s plným přístupem.
update_user (datum nástupu, konec spolupráce, typ vztahu, sazba, náklad) je pro vlastníka, admina a HR — vlastní datum nástupu a konec spolupráce si nezmění nikdo, ani vlastník. create_user smí i manažer, ale jen s rolí člen; roli administrátor přidělí jedině vlastník.
list_invoices