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.claude.ai (nebo claude.com). Vyberte organizaci (pokud jste ve víc) a co smí Claude dělat: předvybrané je Jen číst, chcete-li, aby Claude i zapisoval, zvolte Číst i zapisovat. Klikněte „Povolit".mcp-remote běží u vás, u nich stránka píše „Aplikace na tomto počítači".
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.
Muj Vykaz. S diakritikou ho ChatGPT zkomolí (písmena s háčkem a čárkou z něj vypadnou — „MůjVýkaz“ se uložil 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
Nastavení → Kalendář a AI asistenti → 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 souboru .vscode/mcp.json v projektu (VS Code v něm čte klíč servers):
{
"servers": {
"mujvykaz": {
"type": "http",
"url": "https://app.mujvykaz.cz/api/mcp",
"headers": { "Authorization": "Bearer cl_váš_klíč_zde" }
}
}
}
Cmd+Shift+P → Developer: Reload Window).mujvykaz-mcp se dál nevyvíjí. Nové nástroje do něj nepřibývají a nedoporučujeme ho zakládat. Vzdálené připojení umí všechno, co uměl, aktualizuje se samo s aplikací a nic se u vás neinstaluje.
Používáte ho? Přechod je jedna změna v konfiguraci a funguje s týmž API klíčem — původní záznam nahraďte tímto:
{
"mcpServers": {
"mujvykaz": {
"type": "http",
"url": "https://app.mujvykaz.cz/api/mcp",
"headers": { "Authorization": "Bearer cl_váš_klíč_zde" }
}
}
}
V Claude Desktop a na claude.ai je ještě pohodlnější cesta bez klíče — konektor s přihlášením tlačítkem, viz krok 1 nahoře.
A co klient, který vzdálený server vůbec neumí?
Na to je obecná proxy mcp-remote — přeloží vzdálené připojení na místní,
takže ji zvládne jakýkoli klient s Node.js. Je to lepší volba než bývalý balíček:
vidí vždy aktuální sadu nástrojů a umí i přihlášení bez klíče.
{
"mcpServers": {
"mujvykaz": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://app.mujvykaz.cz/api/mcp"]
}
}
}
Při prvním spuštění se otevře přihlášení do Můj Výkaz v prohlížeči
— žádný klíč v konfiguraci. Kdo klíč použít chce, přidá
"--header", "Authorization: Bearer cl_váš_klíč".
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 Nastavení → Kalendář a AI asistenti → 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í → Tarif a platby.
API klíč není nastavený v konfiguraci. Zkontrolujte, že env.MUJVYKAZ_API_KEY obsahuje váš klíč (cl_...).
Týká se jen ukončené cesty přes balíček. Ujistěte se, že máte Node.js 18+, a 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 Nastavení → Kalendář a AI asistenti → 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.
Přes balíček npm novější nástroje nedostanete. Balíček skončil na verzi 1.5.0 (37 nástrojů) a další verze už nevyjdou — restart ani @latest s tím nic neudělá. Aktuální sadu (dnes 103 nástrojů) má jen vzdálené připojení přes Connectors (HTTP), které jede s každým nasazením a nic se u vás neinstaluje.
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
get_expense_approval · set_expense_approval · get_expense_writers · set_expense_writers
list_expense_documents · get_expense_document · confirm_expense_document · discard_expense_document
list_recurring_expenses · create_recurring_expense · update_recurring_expense
accounting_package_summary · set_accounting_codes
import_expenses · list_expense_imports · undo_expense_import
Bez zadané přeúčtované částky ji appka dopočítá z marže nastavené na středisku nebo u klienta. Nahraný doklad (faktura, účtenka) appka přečte; náklad z něj vznikne až potvrzením, roční platbu jde rozložit do měsíců. Pravidelné položky provozu (nájem, leasing, mobily) zakládá a mění vlastník, admin a účetní — appka za ně každý měsíc založí náklad a doklad pak odhad nahradí. Balíček pro účetní (doklady měsíce, přehled a soubor pro Money S3) shrne asistent i s tím, co v něm chybí; samotný ZIP se stahuje v aplikaci. Náklady z účetnictví (kniha přijatých faktur) asistent naimportuje — nejdřív ukáže náhled s duplicitami a neznámými středisky, import jde do 30 dní vrátit. Firma může zápis nákladů nechat jen vedení a účetním (případně i manažerům) — ostatní pak dostanou hlášku, komu náklad poslat.
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_cost_history · recalculate_entry_costs
Od kterého měsíce platila jaká mzda, paušál nebo hodinová nákladovka. Změna se zapisuje přes update_user s polem costValidFrom (od měsíce, nebo „start“ = oprava od začátku). Přepočet výkazů podle historie smí vlastník, admin a HR.
get_cost_rules · set_cost_rules
Pravidla, do kterých středisek jdou nevykázané hodiny, svátky, volno, odměny nad rámec a náklady bez střediska — rozpustit do práce člověka, nebo poslat třeba do Interní – režie. Platí od zvoleného měsíce. Přesčas a nevykázané hodiny jednoho člověka se nastavují přes update_user. Měnit smí vlastník a admin.
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 · list_open_retainer_periods · preview_retainer_close · close_retainer_period · refill_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. Seznam otevřených období řekne i to, která mají vícepráce k fakturaci — ta se uzávěrkou hromadně nezavírají.
preview_external_closure · close_period_externally · list_external_invoices · update_external_invoice · attach_retainer_to_external_invoice · external_invoice_history · cancel_external_invoice
Pro firmy, které fakturují jinde: za klienta a měsíc zapíšete skutečně vyfakturovanou částku a číslo faktury, výkazy se uzavřou a jejich sazby ani hodiny se nemění. Ziskovost pak srovnává Vyfakturováno vs Odpracováno. Typicky: nahrajete tabulku z fakturace, model ji spáruje s klienty a uzavře měsíc po řádcích. Číslo faktury je nepovinné. Paušál klienta jde uzavřít týmž dokladem s vlastní částkou (appka navrhne cenu balíčku + placené vícepráce), starší doklad jde o paušál doplnit.
month_lock_status · lock_month · unlock_month · request_month_unlock · list_month_unlock_requests · decide_month_unlock_request
Zamčený měsíc nepřijme nový výkaz ani náklad a schválená práce se v něm nemění — čísla pro fakturaci a uzávěrku zůstanou stejná. Přes konektor se do zamčeného měsíce nezapisuje; oprava jde přes dočasné odemčení, které se po platnosti samo zamkne zpět. Kdo potřebuje dopsat jen své výkazy, požádá o odemčení pro sebe (i na víc měsíců najednou, odpověď jmenuje schvalovatele); schválení platí do konce dne a jen pro jeho výkazy. Přehled „kdo zapisuje po termínu“ vrátí list_month_unlock_requests.
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