106. MCP server (napojení AI asistenta)

MCP server propojí AI asistenta jako Claude, ChatGPT, Codex, Gemini nebo Copilot s daty tvé firmy. Po zprovoznění se ptáš běžnou češtinou („kolik zaplatíme na DPH“, „kdo nám dluží“, „jaký byl loni zisk“) a asistent si sám vybere správný nástroj a zavolá ho přes REST API.

Nastavení najdeš v aplikaci: Firma → MCP server. Stránka má dvě záložky: Připojit online pro vzdálený MCP server běžící přímo v této instalaci a Spustit lokálně (.mjs) pro server na tvém počítači. Každá instalace má vlastní adresu; žádný společný server MyÚčta není potřeba.

106.1 Co je MCP

Model Context Protocol je otevřený standard pro připojení nástrojů k AI modelům. Server běží buď přímo v instalaci MyÚčta, nebo jako malý program na tvém počítači. Asistentovi nabízí sadu pojmenovaných nástrojů (list_unpaid_invoices, vat_return_preview, trial_balance, …).

Podstatné vlastnosti:

• MCP server nevytváří vlastní kopii dat. Pracuje přímo s tvojí instancí. Výsledek nástroje ale dostane připojený AI asistent a může jej podle svého provozního modelu odeslat poskytovateli AI. Citlivost dotazu proto posuzuj stejně jako při ručním vložení údajů do daného asistenta.
• Asistent má jen schválený přístup. U online připojení ho omezuje souhlas uživatele, aktuálně dostupné firmy, rozsah a role. U lokálního připojení platí rozsah, vazba na firmu, omezení podle IP a oprávnění role vydaného API tokenu.
• Všechno je vidět v logu. Každé volání se zapíše včetně názvu nástroje.

106.2 Rozsah — co asistent umí

V režimu jen pro čtení (MYUCTO_READ_ONLY=1, § 106.4) server nezveřejňuje nástroje, které mění data. Každé použití nástroje dále omezují aktuální práva uživatele. Přesný počet vypíše server při startu do stderr (§ 106.3, krok 4).

Dotazy podle dimenzí

Asistent nejprve načte dostupné typy a hodnoty nástrojem list_dimensions. Pak se ho můžeš zeptat například:

• „Jaký je zisk střediska Servis za rok 2026? Ukaž i náklady a výnosy po účtech.“
• „Porovnej měsíční vývoj projektů v roce 2026 s minulým rokem.“
• „Ukaž rozvahu a výsledovku k 30. červnu pro projekt Stavba A.“
• „Jaké je cash flow tohoto projektu za první pololetí?“
• „Sečti zisk této globální dimenze přes všechny firmy skupiny, ke kterým mám přístup.“

Filtr dimension_value_id používá ID hodnoty z přehledu dimenzí. Standardně zahrnuje i podřízené hodnoty; dimension_descendants=false vybere pouze přesnou hodnotu. Filtr podporují rozvaha, obě výsledovky, výkazy po účtech, obratovka, hlavní kniha, účetní deník a dimenzní cash flow.

dimension_profit a dimension_analytics s scope=group sčítají globální typ dimenze přes dostupné firmy jeho skupiny. U dimension_cash_flow je pro souhrn skupiny potřeba vybrat hodnotu globální dimenze. Přístup vázaný na jedinou firmu tento rozsah nerozšíří. Rozvaha a výsledovka se sestavují pro jednu firmu a její vlastní účetní období.

Cash flow podle dimenze je manažerská sestava nepřímou metodou, která vychází ze zisku a změn rozvahových účtů. Ukazuje také skutečný pohyb peněz, nepřiřazený rozdíl a kontrolu shody. Úhrada bez dimenze proto není vydávána za peněžní pohyb konkrétního projektu.

106.3 Zprovoznění

Pro online připojení použij § 106.3.5. Následující čtyři kroky popisují lokální soubor .mjs.

106.3.1 Krok 1 — API token

V Firma → API tokeny vytvoř nový token. Zobrazí se jen jednou, hned si ho zkopíruj.

• Pro zkoušení volič rozsah čtení. Rozsah čtení a zápis dávej až tehdy, když má asistent opravdu vystavovat doklady nebo měnit ceny.
• Token rovnou omez na svou IP adresu (sloupec *IP omezení* u tokenu).

106.3.2 Krok 2 — příprava serveru

Server vyžaduje Node 20 nebo novější. Ve vydané distribuci je už připravený hotový build; nic nemusíš sestavovat ani instalovat. Máš dvě možnosti.

Pokud Node nemáš: Windows — winget install --id OpenJS.NodeJS.LTS --exact; macOS — brew install node.

A) Hotový build z distribuce (doporučeno). Použij přiložený soubor:

MCP/dist/myucto-mcp.mjs

Jde o jediný soubor bez externích balíčků. Můžeš ho nechat v instalaci nebo zkopírovat kamkoliv, třeba na jiný počítač. V konfiguraci asistenta pak jen nastavíš jeho úplnou cestu. V artefaktech vydání je navíc ke stažení také jako samostatný soubor MCP serveru.

Server při startu na pozadí ověří poslední stabilní vydání na GitHubu a případnou novější verzi oznámí v diagnostickém výstupu asistenta. Kontrolu lze vyvolat také nástrojem check_update, například dotazem „Je dostupná aktualizace MCP serveru?“. Výsledek obsahuje běžící a nejnovější verzi, odkaz na poznámky k vydání a přímo na soubor myucto-mcp-<verze>.mjs. Staženým souborem nahraď původní MCP server při zachování cesty v konfiguraci a restartuj asistenta. Aktualizace se neinstaluje sama. Pokud je GitHub nedostupný, server dál normálně funguje.

B) Vývoj ze zdrojáků. Hodí se, když si chceš nástroje upravovat:

cd MCP
npm install

Server pak běží z MCP/src/index.mjs a potřebuje vedle sebe node_modules.

106.3.3 Krok 3 — registrace u asistenta

Na stránce Firma → MCP server vyber v kroku 3 svého asistenta; zobrazí se hotová konfigurace i s adresou tvojí instance, kterou stačí zkopírovat.

Například pro Claude Code:

claude mcp add myucto \
  --env MYUCTO_API_URL=https://tvoje-instance.cz/api/v1 \
  --env MYUCTO_API_TOKEN=mi_pat_tvuj_token \
  -- node /cesta/k/myucto.cz/MCP/dist/myucto-mcp.mjs

Na stránce v aplikaci se dá přepnout, jestli má konfigurace ukazovat na hotový MCP/dist/myucto-mcp.mjs, nebo na vývojový MCP/src/index.mjs — cesta se změní ve všech ukázkách naráz.

106.3.4 Krok 4 — ověření

Napiš asistentovi „ověř připojení k MyÚčtu“. Zavolá nástroj whoami a vrátí uživatele, roli a firmu. Volání se hned objeví v logu na stránce MCP serveru.

106.3.5 Vzdálené připojení bez stahování

V záložce Připojit online zkopíruj adresu MCP serveru své instalace, například https://ucto.tvoje-firma.cz/mcp. Do asistenta zadávej adresu své instalace, ne dev.myucto.cz ani adresu jiné firmy. Doména musí mít veřejný DNS záznam, být dostupná z internetu a mít HTTPS certifikát od veřejně důvěryhodné autority. Lokální vývojová adresa nebo certifikát vlastní CA nestačí. ChatGPT a Claude se připojují ze svých serverů, nikoli přímo z počítače nebo telefonu, na kterém používáš jejich aplikaci.

Vzdálený server je po instalaci vypnutý. V záložce se ukazuje jeho stav a superadmin ho zapne tlačítkem Zapnout server. Před zapnutím musí být v prostředí, které spouští MCP, dostupný Node.js; když chybí, stránka ukáže upozornění a zapnutí nedovolí. Nainstaluj Node.js do tohoto prostředí, ověř jeho dostupnost pro aplikaci a stránku znovu načti. Na počítači ani telefonu uživatele Node.js potřeba není. Stejným přepínačem může superadmin server později vypnout. V cfg.php se server nezapíná. V Dockeru a na IIS lze stav řídit proměnnou MYINVOICE_MCP_ENABLED=1 nebo 0; při jejím nastavení je přepínač ve webu jen informativní. Bez této proměnné platí nastavení uložené v aplikaci. Dockerový obraz už Node.js obsahuje. Ve spravované SaaS instalaci (app.managed = true) záleží na provozovateli. Dokud most s Node.js nepřipraví, je serverový MCP vypnutý bez ohledu na proměnnou prostředí i uložený přepínač, záložka Připojit online se nezobrazuje a dostupný zůstává lokální postup se souborem .mjs. Jakmile ho připraví, záložka se objeví a superadmin server zapíná stejným přepínačem jako jinde. Pokud Claude při přidávání konektoru hlásí, že na adrese žádný server neodpověděl, zkontroluj nejdřív tento přepínač. Vypnutý /mcp vrací chybu 404 mcp_disabled a klient proto nemůže zjistit přihlašovací údaje OAuth. MCP obsluhuje REST API přes samostatný PHP CLI proces na stejném serveru. Nevyžaduje další síťový port ani dostupnost vlastní veřejné domény z Docker kontejneru. Na IIS a Apache musí mít PHP povolenou funkci proc_open a účet webového serveru musí umět spustit Node.js. Pokud Node není v jeho PATH, nastav MYINVOICE_MCP_NODE_BINARY na úplnou cestu k node.exe nebo binárnímu souboru Node na daném serveru. Na IIS s PHP přes FastCGI tuto proměnnou přidej v Správce IIS → server → Nastavení FastCGI → php-cgi.exe → Proměnné prostředí. Vyber položku php-cgi.exe, kterou používá mapování handleru daného webu, změnu ulož a recykluj jeho aplikační pool. Sdílí-li stejnou položku FastCGI více webů, proměnnou dostanou všechny jejich PHP procesy. Server potřebuje také PHP CLI; není-li ve standardním adresáři PHP, nastav MYINVOICE_MCP_PHP_BINARY na úplnou cestu k php.exe. Na počítači uživatele Node pro online připojení není třeba.

Na IIS nastav u webu Authentication → Anonymous Authentication → Edit → Application pool identity. Výchozí účet IUSR může při spuštění Node z PHP FastCGI způsobit Access is denied u potomkových procesů a pád Node s hláškou ncrypto::CSPRNG(nullptr, 0). Pro instalaci použij vlastní aplikační pool, aby nastavení identity nezasáhlo jiné weby. Na poolu ponech ApplicationPoolIdentity a zapni Load User Profile. Práva k adresáři aplikace a node.exe musí této identitě umožnit čtení a spuštění.

1. Přidej adresu jako vlastní vzdálený MCP konektor v asistentovi.
2. Při připojení se v prohlížeči přihlas do MyÚčta. Připojení platí pro všechny firmy, ke kterým máš aktuálně práva, včetně firem přidělených později. Když asistent požaduje čtení a zápis, můžeš v poli Udělit přístup zvolit Pouze čtení (výchozí volba) nebo Čtení a zápis. Pokud asistent požaduje jen čtení, širší přístup mu udělit nelze. I při povolení zápisu platí oprávnění tvého účtu. Rozsah již uděleného připojení změníš jeho odvoláním a novým připojením. Pokud máš zapnuté MFA, ověř se passkey nebo novým kódem ověřovací aplikace. Bez MFA stačí přístup potvrdit. Kód použitý při přihlášení nelze znovu použít. Pro běžné dotazy stačí čtení; čtení a zápis schvaluj jen tehdy, když má asistent opravdu měnit data. Po schválení se prohlížeč vrátí do asistenta. Když se nepřesměruje automaticky, zvol Pokračovat do asistenta.
3. Konektor zapni v konverzaci a napiš „Ověř připojení k MyÚčtu a vypiš dostupné firmy“. Nástroje whoami a list_suppliers vrátí účet a firmy, ke kterým máš přístup. V dalších dotazech asistent předává supplier_id vybrané firmy. Pokud jsi připojení schválil dříve jen pro jednu firmu, odvolej ho a připoj asistenta znovu.

Server odešle celý katalog dostupný pro schválený rozsah přístupu v jedné odpovědi. Asistent může v konkrétní konverzaci nabídnout jen nástroje relevantní pro aktuální úkol. Katalog se zatím nefiltruje podle jednotlivých práv role. Nástroj mimo její oprávnění se může zobrazit, ale API jeho volání odmítne.

Pro online připojení nevytváříš ani nekopíruješ API token a na svém zařízení neinstaluješ Node ani soubor .mjs. Každé volání ověřuje aktuální členství ve zvolené firmě, rozsah a oprávnění účtu. Odebrání firmy nebo práv se projeví při dalším volání. Aktivní povolení se zobrazují ve stejné záložce pod stavem serveru. Tlačítko Odvolat přístup okamžitě zneplatní přístupový token i možnost jeho obnovy. Konektor můžeš navíc odebrat v nastavení asistenta. Uživatel s rolí pouze pro čtení může připojení povolit jen pro čtení. Pro sdílení samotných statistik mu nastav roli s přístupem pouze k příslušným přehledům a právem číst správu vlastních API tokenů. Správce může tlačítkem Otestovat nástroje ověřit, že serverový Node most skutečně nabízí nástroje. Pokud asistent hlásí nedostupný konektor nebo nula nástrojů, spusť tento test a zkontroluj uvedenou chybu.

Online MCP se aktualizuje spolu s MyÚčtem na této instalaci. Adresa /mcp i schválené připojení zůstávají stejné; na zařízení se nic nestahuje. Server při připojení hlásí verzi instalace. Po přidání nebo změně nástrojů obnov jejich seznam v asistentovi a začni nový chat. V ChatGPT připojeném ve vývojářském režimu použij u serveru akci Refresh.

ChatGPT: V Nastavení → Integrace → Pluginy zvol Přidat → Přidat server MCP a typ Streamovatelné HTTP. Zadej název a adresu své instalace končící /mcp. Pole Proměnná prostředí tokenu nositele a záhlaví nech prázdné. OAuth se v tomto formuláři nevybírá. Server ulož; v desktopové aplikaci ji případně restartuj. Pokud se v seznamu serverů zobrazí Authenticate (Ověřit), zvol tuto akci a dokonči souhlas v MyÚčtu. Pak server zapni v konverzaci. Pokud ověření chybí, zkontroluj, že je vzdálený MCP server v MyÚčtu zapnutý. Při vypnutém serveru vrací /mcp odpověď 404 a klient OAuth nezahájí.

Claude: Na webu nebo v desktopové aplikaci otevři Customize → Connectors. U osobního účtu zvol + → Add custom connector, vlož adresu /mcp, přidej konektor a tlačítkem Connect dokonči přihlášení. V organizaci musí vlastní konektor nejprve přidat vlastník v nastavení organizace. V konverzaci jej zapni přes + → Connectors. Anthropic potvrzuje, že jednou přidaný vzdálený konektor funguje také v mobilní aplikaci Claude.

106.4 Nastavení

Lokální server .mjs se konfiguruje proměnnými prostředí:

MYUCTO_READ_ONLY=1 je užitečná pojistka i u tokenu, který právo zápisu má — zápisové nástroje se v takovém režimu asistentovi ani nezobrazí, takže si nenaplánuje postup, který by stejně nedokončil.

Stropy MAX_RPS a MAX_CONCURRENT nejsou kosmetika: API sdílí PHP procesy s běžícím webem, takže asistent bez omezení zpomalí i běžné uživatele. Přebytečná volání čekají ve frontě. Nezávisle na nich platí serverový rate limit tokenu.

106.5 Příklady dotazů

Fakturace a pohledávky

• „Které faktury jsou po splatnosti a kdo nám dluží nejvíc?“
• „Najdi fakturu pro ACME z června a ukaž, jestli je zaplacená.“
• „Vystav fakturu firmě ACME na 10 hodin konzultací po 1 500 Kč.“ *(token čtení a zápis)*

Úprava konceptu faktury *(token čtení a zápis)*

• „Na konceptu pro ACME změň cenu druhé položky na 1 800 Kč.“
• „Přidej na koncept položku Doprava, 1 ks, 350 Kč.“
• „Odeber poslední položku, je tam omylem.“
• „Posuň splatnost konceptu o 14 dní a doplň poznámku.“

Podrobnosti v § 106.7.4.

Další práce s vydanými fakturami *(token čtení a zápis)*

• „Fakturu 2026042 jsme vystavili omylem, stornuj ji.“
• „K faktuře 2026042 připrav dobropis, zákazník vrátil zboží.“
• „Udělej kopii zářijové faktury pro ACME s datem 1. října.“
• „Záloha pro ACME je zaplacená, připrav finální fakturu.“
• „Kolik by byl úrok z prodlení u faktury 2026031? Pokud víc než 100 Kč, připrav penalizační fakturu.“
• „Zaeviduj k faktuře 2026042 hotovostní platbu 5 000 Kč z dnešního dne.“
• „Z přiložené smlouvy udělej splátkový kalendář na nájem a nastav rozpis plateb.“
• „Pošli upomínky ke všem fakturám, které jsou víc než 30 dní po splatnosti.“

Podrobnosti v § 106.7.5.

Pravidelná fakturace *(token čtení a zápis)*

• „Založ pro ACME měsíční paušál 5 000 Kč za správu serveru, vždy k 1. dni v měsíci.“
• „Zvyš paušál pro ACME od příští faktury na 5 500 Kč.“
• „Pozastav pravidelnou fakturaci pro ACME, dokud se nedohodneme.“
• „Vygeneruj fakturu z paušálu pro ACME hned, jen jako koncept.“

Podrobnosti v § 106.7.6.

Přijaté faktury *(token čtení a zápis)*

• „Zapiš fakturu od Dodavatel s.r.o. číslo FA-118 na 2 000 Kč bez DPH, sazba 21 %, DUZP 9. září, splatnost 24. září.“
• „U té faktury oprav číslo dokladu na FA-2026-118 a přidej položku Doprava 350 Kč.“
• „Přijmi ji.“ *(asistent nejdřív ukáže, co přijetí udělá, a čeká na potvrzení)*
• „Spáruj fakturu od Dodavatele se zálohou, kterou jsme platili v srpnu.“
• „Připrav příkaz k úhradě na všechny faktury splatné tento týden.“

Podrobnosti v § 106.8.4.

Odběratelé

• „Založ klienta podle IČO 45274649.“
• „Najdi v ARES firmu s IČO 12345678 a ukaž mi její adresu.“
• „Uprav Prazdroji telefon na +420 123 456 789.“
• „Přenačti údaje ACME z ARES, přestěhovali se.“

Výkazy práce a materiálu

• „Přidej mi do výkazu práce pro AVYX 3 hodiny práce na MCP serveru.“
• „Kolik hodin je zatím ve výkazu na téhle faktuře?“
• „Přidej do výkazu 5 metrů kabeláže po 120 Kč.“
• „Smaž poslední řádek z výkazu, zadal jsem ho omylem.“

Podrobnosti v § 106.7.

Zakázky, dokumenty a kniha jízd

• „Založ zakázku pro ACME s rozpočtem 200 000 Kč a splatností 14 dní.“ *(token čtení a zápis)*
• „Jaká je ziskovost zakázek od začátku roku a které mají nezaúčtované doklady?“
• „Najdi ve smlouvách zmínku o výpovědní lhůtě a ukaž text dokumentu.“
• „Připoj tu smlouvu k zakázce Web 2026.“ *(token čtení a zápis)*
• „Přidej dnešní služební jízdu Praha–Kolín, 120 km.“ *(asistent si nechá vybrat kategorii; token čtení a zápis)*
• „Zapiš tankování 40 litrů za 1 520 Kč.“ *(token čtení a zápis)*

Podrobnosti v § 106.8.

Soubory a přílohy

• „Stáhni PDF faktury 2026015 a shrň mi, co na ní je.“
• „Pošli mi ISDOC k faktuře pro ACME.“
• „Přilož tuhle objednávku v PDF k faktuře 2026015.“ *(token čtení a zápis)*
• „Tady je ISDOC od dodavatele, založ z něj přijatou fakturu.“ *(token čtení a zápis)*
• „Nahraj tuhle smlouvu do Dokumentů, označ ji tagem smlouvy a připoj ji k ACME.“ *(token čtení a zápis)*

Podrobnosti v § 106.8.6.

Daně

• „Kolik letos v červenci zaplatíme na DPH?“
• „Jak vychází DPH za tenhle kvartál a co se ještě změní z konceptů?“
• „Z jakých dokladů se skládá DPH za červen?“
• „Kolik letos odvedeme na dani z příjmů a jak jsme na tom se zálohami?“

Účetnictví

• „Ukaž obratovou předvahu za letošní období.“
• „Jak se zaúčtovala faktura číslo 2026001?“
• „Co visí v saldu — komu jsme nespárovali platby?“

Ostatní pohledávky a závazky *(zápis jen s tokenem čtení a zápis)*

• „Jaké máme otevřené závazky z úvěrů a nájmů a kdy jsou splatné?“
• „Založ koncept závazku: nájem kanceláře na říjen, 15 000 Kč, splatnost 15. 10., protiúčet 518.“
• „Z přiložené úvěrové smlouvy založ koncept závazku na jistinu a nastav splátkový kalendář.“
• „Opakuj ten nájem každý měsíc do konce roku.“
• „Pozastav opakování pojistného.“

Podrobnosti v § 106.8.5.

Statistika

• „Ukaž trend obratu a zisku po měsících za poslední rok.“
• „Kde nám utíkají peníze — rozpad nákladů podle kategorií.“
• „Jak moc jsme závislí na největších zákaznících?“
• „Co bych měl dneska řešit?“

E-shop a sklad

• „Které zboží je pod minimální zásobou a mělo by se doobjednat?“
• „Kolik máme uloženo ve skladu k dnešnímu dni?“
• „Založ zboží Kabel HDMI 2 m, sazba 21 %, minimální zásoba 10.“ *(token čtení a zápis)*
• „Zdraž všechno zboží značky Acme o pět procent.“ *(token čtení a zápis)*
• „Nasklaď 20 kusů kabelu na hlavní sklad za 89 Kč a příjemku zaúčtuj.“ *(token čtení a zápis)*

Celá kapitola: § 106.9.

Mzdy a zaměstnanci

• „Jakou má Jana Nováková sjednanou hrubou mzdu?“
• „Kolik vyšla Janě Novákové čistá mzda za srpen?“
• „Zvyš Janě mzdu od září na 55 000 Kč.“ *(token čtení a zápis)*
• „Zadej Janě neschopenku od 3. do 12. září.“ *(token čtení a zápis)*
• „Zapiš Janě dvě hodiny přesčasu dnes od 17 do 19 hodin.“ *(token čtení a zápis)*
• „Přidej Janě mimořádnou odměnu 5 000 Kč za září.“ *(token čtení a zápis)*

Mzdový běh tím nevznikne ani se neposune do dalšího stavu. Výpočet, kontrola, schválení, zaúčtování, platby, uzavření a odeslání zůstávají na člověku v aplikaci.

106.6 Odběratelé a ARES

Nového odběratele stačí zadat IČEM:

„Založ klienta podle IČO 45274649.“

Asistent si vytáhne z ARES název, adresu, DIČ i registraci k DPH a kartu založí. Cokoli řekneš navíc („…a e-mail fakturace@firma.cz“) má přednost před tím, co vrátí rejstřík — může jít o změnu, která se do ARES ještě nepropsala.

Bez IČO je potřeba název, ulice, město a PSČ; asistent si o ně řekne.

106.6.1 Ochrana proti duplicitám

Před založením se kontroluje, jestli odběratel se stejným IČO nebo DIČ už neexistuje. Pokud ano, nic se nezaloží a asistent ukáže stávající kartu. Druhou kartu téže firmy lze vytvořit jen vědomě, na výslovné potvrzení.

106.6.2 Úprava

Stačí říct, co se má změnit — zbytek karty zůstane. Asistent si ji načte, změnu do ní vloží a uloží celou zpět, takže se nic nevynuluje.

Když se firma přestěhuje nebo přejmenuje, jde údaje přenačíst z rejstříku:

„Přenačti údaje ACME z ARES.“

Když je ARES nedostupný, u úpravy se nic nemění (raději nic než půlka starých a půlka nových údajů). U zakládání se použijí údaje ze zadání, pokud stačí — asistent do odpovědi napíše, odkud data vzal.

106.7 Koncept faktury, výkazy práce a materiálu

Výkaz je navázaný na koncept faktury — přesně jako v aplikaci. Stačí tedy říct:

„Přidej mi do výkazu práce pro AVYX 3 hodiny práce na MCP serveru.“

Asistent zakázku dohledá, najde její koncept faktury a řádek přidá. Existující řádky zůstanou beze změny.

106.7.1 Jak se určí hodinová sazba

Sazbu zadávat nemusíš. Doplní se v tomhle pořadí a první nenulová vyhraje:

1. poslední řádek výkazu — když už se výkaz jednou vyplnil, nová hodina má sedět s ním, ne s ceníkem;
2. hodinová sazba zakázky;
3. hodinová sazba odběratele;
4. výchozí hodinová sazba firmy (Nastavení firmy).

Když sazbu nemá nikdo, asistent to řekne a požádá o ni — netipuje. Vlastní sazbu lze samozřejmě určit („…3 hodiny po 1 800 Kč“).

106.7.2 Který doklad se použije

• Pokud řekneš číslo faktury, použije se ta.
• Pokud jmenuješ jen zakázku nebo odběratele, hledá se jeho koncept faktury.
• Je-li konceptů víc, asistent nehádá — vypíše je a nechá tě vybrat. Zapsat hodiny na cizí doklad by bylo horší než se doptat.
• Vystavená faktura je uzamčená; do jejího výkazu se zapsat nedá.

106.7.3 Materiál

Řádky materiálu fungují stejně (množství, jednotka, cena za jednotku). Jediný rozdíl: sazbu DPH materiálu si asistent nevymýšlí. Převezme ji z už existujícího výkazu, jinak si o ni řekne — špatná sazba by se propsala do přiznání k DPH.

106.7.4 Úprava konceptu faktury

Koncept, který asistent připravil, nemusíš opravovat ručně v editoru. Stačí mu říct, co změnit, a koncept upraví:

Platí přitom:

• Mění se jen to, co řekneš. Ostatní pole hlavičky i ostatní položky zůstanou, včetně údajů, které v rozhovoru nevidíš: časové rozlišení, vazba na sklad a majetek, nastavení OSS a pořadí položek.
• Položku určíš pořadím, jak ji vidíš na dokladu („druhá položka“), nebo jejím ID. Řádek se slevou z celé faktury se nepočítá, ten dopočítává aplikace sama.
• Sazbu DPH si asistent nevymýšlí. U nové položky se na ni zeptá, u upravované ji nechá, dokud ji výslovně nezměníš. Po změně sazby, data zdanitelného plnění nebo přenesené daňové povinnosti si aplikace zařazení položek pro přiznání k DPH a OSS odvodí znovu.
• Doklad se dohledá stejně jako u výkazu práce (§ 106.7.2): má-li odběratel víc konceptů, asistent je vypíše a nechá tě vybrat.
• Součty a DPH spočítá aplikace; asistent vrátí upravený doklad.
• Upravit jde jen koncept. Vystavenou fakturu asistent odmítne změnit, ta se opravuje dobropisem nebo stornem v aplikaci.
• Jedinou položku dokladu odebrat nejde, doklad musí nějakou mít.

V režimu jen pro čtení se tyto nástroje nenabízejí; vyžadují token s oprávněním čtení a zápis.

106.7.5 Další práce s vydanými fakturami

Kromě konceptu umí asistent s vydanými doklady totéž, co detail faktury v aplikaci:

Platí přitom:

• Storno a dobropis jsou daňové kroky. Asistent je udělá jen na tvůj výslovný pokyn a vždy až po potvrzení (§ 106.9.4). Interní storno je pro doklad, který odběratel nepřevzal: faktura dostane stav stornovaná a vypadne z evidence DPH. Pokud doklad odběratel už má, patří k němu dobropis. Ten vznikne jako koncept, zkontroluješ ho a vystavíš stejně jako fakturu.
• Storno, zrušení storna ani nové doklady s datem v uzavřeném nebo uzamčeném období (po podání přiznání k DPH) aplikace nepovolí.
• Finální faktura ze zálohy, dobropis, kopie, penalizační faktura i daňový doklad k platbě vznikají jako koncepty. Daňový dopad mají až po vystavení.
• Platební kalendář je jeden daňový doklad s rozpisem plateb (§ 31 a § 31a ZDPH). Rozpis může asistent sestavit z podkladu, který mu dáš (smlouva, tabulka splátek), a před uložením ti ho ukáže. Součet splátek musí přesně sedět na celkovou částku dokladu; když nesedí, asistent nic neuloží a řekne rozdíl.
• Platby z bankovního výpisu se párují v bance. Ručně se evidují hotovost, zápočet nebo platba, kterou banka nespárovala.
• Upomínka i poděkování za platbu jsou e-maily odběrateli, posílají se jen na tvůj pokyn.
• Zaúčtování dokladu asistent neumí, to zůstává v aplikaci.

106.7.6 Pravidelná fakturace

Šablony pravidelné fakturace asistent čte (list_recurring_invoices, get_recurring_invoice, recurring_invoice_history) a umí je i spravovat:

Platí přitom:

• Bez automatického vystavení vznikají z šablony koncepty ke kontrole. Automatické vystavení a odeslání e-mailem asistent zapne jen na výslovný pokyn.
• Ruční vygenerování faktury vyžaduje potvrzení. U šablony s automatickým vystavením se faktura rovnou vystaví (a případně odešle), proto asistent předem řekne, co se stane. Na požádání vytvoří jen koncept.
• Úprava šablony se týká až faktur, které z ní teprve vzniknou.

106.8 Zakázky, dokumenty a kniha jízd

106.8.1 Zakázky

Asistent umí zakázku založit, upravit, archivovat i bezpečně smazat, pokud ještě nemá doklady. Při úpravě nejdřív načte současný stav a zachová všechna nezadaná pole. Změna výchozí kategorie tržby může doplnit tuto kategorii i do dosavadních faktur zakázky; proto ji zadávej výslovně.

Přehled ziskovosti je jen ke čtení. V podvojném účetnictví vychází z deníku, v daňové evidenci z dokladů, a upozorní i na nezaúčtované doklady. Asistent přes něj nic nezaúčtuje ani neopraví.

106.8.2 Dokumenty

MCP umí dokumenty vypsat, hledat v názvu, popisu i vytěženém textu, přečíst omezený úsek textu, upravit název, popis a tagy a připojit dokument k odběrateli, dokladu nebo zakázce. Dlouhý text se vrací po částech nejvýše 50 000 znaků. Platí stejná firemní a osobní oprávnění jako v aplikaci.

Soubor umí asistent do Dokumentů i nahrát a originál stáhnout, postup a limity popisuje § 106.8.6. Pro práci s obsahem dokumentu je ale levnější vytěžený text než celý soubor. Odpojení vazby vyžaduje potvrzení, dokument samotný ale nemaže.

106.8.3 Kniha jízd

Asistent umí spravovat vozidla, přidávat a upravovat jízdy a tankování a číst roční souhrn kilometrů a spotřeby. U nové jízdy vyžaduje vozidlo, datum, vzdálenost nebo oba stavy tachometru a hlavně výslovně vybranou kategorii. Soukromou či služební povahu cesty nikdy neodhaduje — pokud kategorii neřekneš, nejdřív nabídne číselník a doptá se.

Smazání vozidla, jízdy nebo tankování vyžaduje potvrzení. Používané vozidlo nelze smazat; lze ho pouze archivovat. Roční daňový souhrn je dostupný jen ke čtení a žádný účetní zápis z MCP nevytváří.

106.8.4 Přijaté faktury

Došlý doklad od dodavatele asistent zapíše jako koncept. Do evidence DPH, závazků a účetnictví vstoupí až přijetím, do té doby jde koncept opravit nebo smazat.

Platí přitom:

• Sazbu DPH a DUZP si asistent nevymýšlí. Bere je z dokladu, a když na dokladu nejsou, zeptá se nebo je vynechá. DUZP a datum přijetí dokladu rozhodují o období, ve kterém se uplatní odpočet DPH; bez data přijetí se použije datum vystavení.
• U cizí měny se kurz načte z ČNB k DUZP, a když DUZP chybí, k datu vystavení. Ruční kurz zadává asistent jen na výslovný pokyn.
• Mění se jen to, co řekneš. Při úpravě hlavičky i položek zůstanou ostatní údaje beze změny, včetně těch, které v rozhovoru nevidíš: druh nákladu, nákladový účet, časové rozlišení, vazba na sklad a pořadí položek.
• Po změně dodavatele nebo přenesené daňové povinnosti si aplikace zařazení položek pro přiznání k DPH odvodí znovu. Změna data zařazení nemění.
• Doklad s ruční rekapitulací DPH podle dokladu upravuj v aplikaci; asistent jeho položky nemění, protože by rekapitulace přestala sedět.
• Upravit jde jen koncept. Přijatý doklad opravuje účetní v aplikaci.
• Přijetí může doklad rovnou zaúčtovat. Má-li firma zapnuté automatické účtování přijatých faktur, aplikace doklad při přijetí zaúčtuje; u úhrady hotově z pokladny založí výdajový pokladní doklad. Asistent to před přijetím řekne a čeká na potvrzení.
• Zaúčtovat doklad asistent neumí. Ruční zaúčtování je účetní úkon a přes token nejde. U zaúčtovaného dokladu proto odmítne i změnu druhu dokladu, druhu nákladu, kurzu a spárování se zálohou, protože by se doklad rozešel s deníkem. Zakázku přiřadit jde, je to jen analytický údaj.
• Zálohová faktura se zakládá jako druh „záloha“, daňový doklad k zaplacené záloze jako „daňový doklad k záloze“. Konečnou fakturu se zálohou spáruje link_purchase_advance; náklad se pak nepočítá dvakrát.
• Příkaz k úhradě asistent jen připraví. Do banky nic neodesílá a faktury neoznačí jako uhrazené. Soubor pro banku stáhneš a odešleš v aplikaci.
• PDF dokladu nahraješ, stáhneš nebo z ISDOC založíš doklad nástroji ze § 106.8.6.

V režimu jen pro čtení se zápisové nástroje nenabízejí; vyžadují token s oprávněním čtení a zápis.

106.8.5 Ostatní pohledávky a závazky

Nájem, půjčka nebo úvěr, leasing, kauce, pojistné a poplatky se evidují jako ostatní pohledávky a závazky (viz kapitola 52). Asistent je umí číst i připravit, ale jen jako koncept. Koncept nemá zápis v deníku; potvrdí a zaúčtuje ho účetní v aplikaci, kde vidí kontext a krok potvrzuje.

Koncept. Kontaci zadáš buď jedním protiúčtem, nebo několika protiřádky, jejichž součet musí přesně odpovídat částce dokladu. Agenda je jen v Kč. Při úpravě asistent načte současný stav a pošle celý doklad, takže nezadaná pole se nezmění. Jediný protiřádek se při změně částky přepočte, u více protiřádků se asistent zeptá na nové rozdělení. Upravit a smazat lze jen koncept.

Splátkový kalendář může asistent vyčíst z dokumentu, třeba z úvěrové nebo leasingové smlouvy či splátkového kalendáře banky, a poslat ho jako data. Před zápisem zkontroluje, že:

• splátek je 2 až 120 a termíny jdou vzestupně, nejdříve od data vzniku dokladu,
• částky jsou kladné a na haléře,
• součet splátek přesně odpovídá částce dokladu,
• doklad zatím nemá spárovanou úhradu.

U úvěru a leasingu patří do kalendáře jen jistina; úroky a poplatky nejsou součástí částky dokladu. Uložení nahradí celý dosavadní kalendář, proto asistent posílá vždy všechny splátky. Zrušení celého kalendáře vyžaduje potvrzení. Splátky slouží k plánu cashflow a do deníku nic nezapisují.

Opakování vytvoří z dokladu pravidelnou řadu (měsíčně, čtvrtletně, ročně). Aplikace další doklady zakládá dopředu jako koncepty. Automatické účtování přes asistenta zapnout nejde: opakování vzniká vždy bez něj a asistent smí opakování pozastavit nebo obnovit jen tehdy, když automatiku nemá. Koncept z automaticky účtovaného opakování asistent neupraví ani nesmaže: úpravu by aplikace zaúčtovala bez další kontroly a smazáním by zaúčtování tiše zmizelo. Vypnout automatiku asistent smí, účtování tím jen zastaví.

Přes asistenta nejde: potvrdit nebo zaúčtovat doklad, stornovat ho, přeúčtovat, spárovat nebo odpojit úhradu ani ručně vygenerovat doklady z opakování. Tyto kroky dělá účetní v aplikaci.

106.8.6 Soubory a přílohy

Asistent umí soubory stahovat i nahrávat. Soubor přitom jde celý přes asistenta: obsah se přenáší v konverzaci a model s ním pracuje stejně jako se souborem, který mu přiložíš sám. Proto si o soubor řekni jen tehdy, když ho opravdu potřebuješ. Na otázku, co je v dokumentu napsané, stačí vytěžený text (get_document), který je mnohem menší.

Velikost. Lokální server přenese soubor do 10 MB (mění se proměnnou MYUCTO_MAX_FILE_MB, § 106.4), serverový MCP do 5 MB, protože tam soubor putuje několika procesy aplikace. Větší soubor nástroj odmítne se zprávou file_too_large; stáhni nebo nahraj ho přímo v aplikaci. Platí i limity samotné agendy, například u přílohy faktury nejvýš 10 MB na soubor a 20 MB na všechny přílohy jedné faktury.

Podporované typy při nahrání.

Přípona souboru musí odpovídat jeho typu a aplikace typ znovu ověří z obsahu. HTML, SVG, skripty a spustitelné soubory přes MCP nahrát nejde. Z názvu souboru se odstraní cesta i znaky, které do názvu nepatří.

Založení přijaté faktury ze souboru je deterministický import strukturovaných dat, nepoužívá AI vytěžení. Když PDF vložený ISDOC nemá, asistent dostane chybu no_embedded_isdoc; doklad pak založí ručně a PDF k němu nahraje jako originál. Stejný doklad, který už v evidenci je, se podruhé nezaloží.

Výsledek stažení. Obrázek se vrátí jako obrázek, PDF jako vložený soubor a ISDOC jako text. Na požádání vrátí asistent obsah i jako base64, třeba když ho chce předat dalšímu nástroji.

Pro nahrání musí mít token oprávnění čtení a zápis a v režimu jen pro čtení se nahrávací nástroje nenabízejí. Doklad v uzavřeném období aplikace změnit nedovolí stejně jako v aplikaci. Smazání přílohy nebo PDF a náhrada už archivovaného PDF vyžadují potvrzení (§ 106.9.4).

106.9 E-shop a sklad

Na rozdíl od účetnictví je e-shopová a skladová agenda obousměrná — asistent umí katalog nejen číst, ale i zakládat, upravovat a mazat. Důvod je prostý: skladový pohyb je dohledatelný ve skladové knize a zaúčtovaný doklad jde stornovat protidokladem, takže se chyba dá v aplikaci napravit. Účetní dopad vzniká až v účetní vrstvě, která zůstává jen ke čtení.

106.9.1 Co asistent umí

106.9.2 Dávkové čtení katalogu

Když asistent potřebuje více karet najednou, použije get_products_batch nebo get_product_prices_batch místo stovek jednotlivých dotazů. Oba nástroje jsou čtecí a fungují s tokenem v režimu read i při MYUCTO_READ_ONLY=1.

get_products_batch přijme až 500 unikátních ID. Odpověď zachová jejich pořadí; cizí nebo chybějící karta je vždy unavailable s data: null, takže asistent nerozliší chybějící kartu od karty jiné firmy. Bez výběru polí dostane SKU, název, EAN a aktivitu. Může si vyžádat jen potřebné části, například překlady, ceny nebo dostupnost, a omezit je na konkrétní jazyky, měny a sklady. Nákladové ocenění (costs) není dostupné tokenu jen pro čtení: vyžaduje oprávnění stock.items.write.

get_product_prices_batch vrací platnou cenu pro každou kombinaci karty a množství. Množství MCP vyžaduje jako kladný desetinný řetězec, aby se nezaokrouhlilo při předání; API sice při přímém volání dovoluje jeho vynechání a použije "1", MCP ho vyžaduje záměrně. Měna je výchozí CZK a cena, která pro kartu a měnu neexistuje, je null, ne nula.

list_products umožňuje výběr podle výrobce, dodavatele, kategorie, štítků, dostupnosti a chybějících údajů. get_catalog_facets vrací počty hodnot filtrů nad celou odpovídající množinou. get_catalog_job ukáže průběh a souhrnný výsledek úlohy, ke které má uživatel oprávnění.

106.9.3 Ceny pro konkrétního odběratele

Na otázku „za kolik to prodáme firmě ACME“ asistent odpoví nástrojem quote_product_prices. Ten spočítá cenu stejně jako faktura: nejdřív individuální cena zákazníka, pak cenová hladina odběratele, jinak standardní cena; akční cena vyhraje, jen když je levnější. Počítá se v zadané měně a k datu a řádek může být i v balení, třeba „10 kartonů“. Nic se neukládá, stačí token jen pro čtení.

„Kolik zaplatí ACME za 10 kartonů kabelu k 1. říjnu?“ „Které cenové hladiny máme a jakou slevu dává Gold?“ „Má tahle karta nějaké smluvní ceny zákazníků?“

Individuální ceny zákazníků, cenové hladiny, balení a číselník balení asistent jen čte. Nastavují se v aplikaci na kartě zboží a v číselnících e-shopu.

Firmy bez skladového modulu mají místo cen na kartách ceník služeb. Asistent z něj umí vypsat položky, jejich ceny po měnách, individuální ceny zákazníků i výslednou cenu pro konkrétního odběratele a měnu dokladu. Ceník také jen čte.

106.9.4 Potvrzování nevratných kroků

Mazání, storno dokladu, uzavření inventury, odebrání položky z konceptu faktury, smazání konceptu ostatní pohledávky nebo závazku, zrušení celého splátkového kalendáře, smazání přílohy faktury nebo PDF přijaté faktury a náhrada už archivovaného PDF vyžadují výslovné potvrzení. U vydaných faktur a pravidelné fakturace jde o smazání konceptu, storno a dobropis, zrušení storna, smazání úhrady, vrácení stavu zaplaceno, hromadné upomínky, smazání šablony pravidelné fakturace a ruční vygenerování faktury ze šablony. U přijatých faktur navíc přijetí dokladu (může ho rovnou zaúčtovat), storno, smazání konceptu, odebrání položky, zrušení vazby na zálohu, změna účtu dodavatele a smazání příkazu k úhradě. Potvrzovací výpis u přijaté faktury vždy uvádí dodavatele, číslo dokladu dodavatele a částku. První volání takového nástroje záměrně nic neprovede — jen vrátí, čeho by se změna týkala:

NEPROVEDENO — chybí potvrzení. Smazat se má výrobce: ACME — Acme s.r.o. Operace je nevratná. Ukaž to uživateli a teprve po jeho souhlasu zavolej nástroj znovu s confirm: true.

Funguje to tedy jako suchý běh: uvidíš konkrétní záznam včetně kódu a názvu, ne jen to, co si asistent myslí, že maže. Teprve druhé volání s potvrzením operaci provede. U médií a hodnot parametrů se navíc kontroluje, že záznam opravdu patří ke zboží (resp. parametru), které jsi uvedl — překlep v čísle tak nesmaže fotku cizímu zboží.

Praktický dopad: asistent se tě před smazáním vždycky zeptá. Řetězec „ukliď nepoužívané štítky“ neproběhne jedním vrzem, ale jako výpis a dotaz.

106.9.5 Kolekce se nahrazují celé

Ceny, dodavatelé, jazykové verze, kategorie, štítky, parametry a řádky skladového dokladu se ukládají jako celek — co v uloženém seznamu není, to se smaže. Není to nedostatek nástroje, ale způsob, jakým to ukládá i aplikace.

Nástroje na to asistenta upozorňují a jeho správný postup je: nejdřív si stav načíst, do něj vložit změnu a poslat zpátky kompletní seznam. Když si nejsi jistý, řekni si o vypsání současného stavu předem:

„Ukaž ceny toho zboží, pak k nim přidej eurovou cenu s marží 25 %.“

106.9.6 Skladové doklady mají dvě fáze

Příjemka, výdejka i převodka vznikají jako koncept, který se stavem skladu nedělá nic — teprve zaúčtování pohyb provede, přidělí dokladu číslo a doklad uzamkne. Nástroje ty dvě fáze schválně nespojují: asistent má doklad připravit a nechat si ho zkontrolovat, než se zásoby pohnou.

„Nasklaď 20 kusů kabelu na hlavní sklad za 89 Kč za kus.“ → asistent založí koncept příjemky a ukáže ti ho. „Souhlasím, zaúčtuj.“ → teprve teď se zásoba zvýší.

Zaúčtovaný doklad už upravit ani smazat nejde, jen stornovat — vznikne k němu opačný protidoklad v původních cenách a oba zůstanou ve skladové knize.

Server sám odmítne (409) výdej do minusu, jakýkoli pohyb na skladu s rozběhnutou inventurou a doklad do uzavřeného účetního období.

106.9.7 Objednávky u dodavatele

Asistent umí celý životní cyklus objednávky (§ 35.11) — a drží se v něm stejných pravidel jako aplikace:

• Nová objednávka vzniká jako koncept. Nedostane číslo a do „na cestě" se nezapočítá. Teprve *odeslat* jí přidělí číslo řady OBJ a zboží se začne počítat jako objednané.
• Úprava objednávky nahrazuje i řádky celé — platí tu totéž pravidlo jako u ostatních kolekcí (viz výše). Upravovat jde jen koncept.
• Zavřít zbytek, stornovat a smazat vyžadují potvrzení (jsou nevratné). Storno projde jen do doby, než se z objednávky cokoli přijme; potom server odmítne s doporučením použít *zavřít zbytek*.
• Příjem z objednávky založí příjemku jako koncept — skladem pohne teprve její zaúčtování, stejně jako u ručně pořízeného dokladu.
• Doplnění zásob umí objednat hromadně: z plochého seznamu zboží a množství vznikne jedna objednávka na dodavatele, vždy jako koncept. Položky, které nešly zařadit (chybí dodavatel, neplatné množství, neznámé zboží), asistent dostane zpátky vypsané i s důvodem — nikdy se nezahodí tiše.

Množstevní pohledy jsou jen ke čtení a odpovídají § 33.9: stock_quantities vrací u každé karty skladem, rezervováno, prodejné a na cestě, stock_in_transit rozpad na konkrétní objednávky a stock_reservations rozpad na konkrétní faktury.

„Kolik máme kabelů volných k prodeji a co z toho je jen rezervované?" „Co je potřeba doobjednat a od koho?" → asistent přečte množstevní pohledy a návrh doplnění, objednávky ale založí jako koncepty, které si odsouhlasíš.

106.9.8 Inventura

Postup kopíruje aplikaci: založit → spustit (udělá se snímek očekávaných stavů a sklad se zablokuje pro zaúčtování dokladů) → zapsat napočítané množství → uzavřít. Uzavření vygeneruje rozdílovou příjemku na přebytky a výdejku na manka, rovnou zaúčtované — proto vyžaduje potvrzení a proto asistent před ním hlásí, kolik řádků zůstalo nespočítaných (ty se přeskočí).

106.9.9 Co přes MCP nejde

• Hromadný import zboží z XLSX/CSV ani import ceníku dodavatele. Oba importy mají v aplikaci vlastní průvodce s náhledem. Jednotlivé nabídky dodavatelů ale asistent zakládat i upravovat umí.
• Stáhnout PDF nebo XLSX skladového dokladu, inventurního soupisu či sestavy. Data sestav asistent přečte, hotový soubor si stáhneš v aplikaci.

106.10 Log volání

Stránka Firma → MCP server má dole Log volání — každé volání tvých API tokenů včetně zamítnutých. U volání z MCP serveru je vidět i název nástroje, takže poznáš, co asistent dělal, ne jen jaké URL zavolal.

Filtruje se podle tokenu, metody, cesty, zdroje a na samotné chyby. Podrobnosti jsou v § 104.8.

106.11 Bezpečnost

Následující pravidla pro API tokeny se týkají lokálního souboru .mjs. Online připojení používá přihlášení a souhlas popsané v § 106.3.5.

• Token se ukládá jen jako SHA-256 hash; plaintext se zobrazí jednou.
• Omez token na IP — uniklý token je pak mimo tvou síť k ničemu.
• Rozsah čtení stačí na drtivou většinu dotazů; zápis dávej vědomě.
• Bearer token má přístup jen k veřejnému API. Správa uživatelů, rolí, citlivá nastavení a podpisové profily jsou pro něj nedostupné bez ohledu na roli uživatele, který token vydal.
• Token nedávej do souborů, které commituješ do gitu (týká se hlavně .vscode/mcp.json a .cursor/mcp.json v projektu).
• Nepoužívaný token zruš. Historie volání v logu zůstane.
• Mazání a storna se neprovedou napoprvé. Nástroje, které nejdou vzít zpět, vyžadují potvrzení a při prvním zavolání jen vypíšou, čeho by se změna týkala (viz § 106.9). Je to pojistka proti tomu, aby asistent smazal něco, co si domyslel — ne náhrada za MYUCTO_READ_ONLY=1, který je u nedozorovaného provozu pořád ta správná volba.
• Argumenty se ověřují proti schématu nástroje. Lokální i serverový MCP odmítne volání s neznámým parametrem, špatným typem nebo hodnotou mimo povolený rozsah dřív, než cokoli odejde do aplikace. ID záznamu musí být celé číslo, takže podvržená hodnota typu ../../invoices/123 nesměruje nástroj na jiný záznam. Chyba uvede název parametru a asistent volání opraví.

106.12 Řešení problémů

106.13 Vlastní HTTPS certifikát

Instance s certifikátem od firemní nebo vlastní autority (typicky testovací prostředí) je zvláštní případ: Node má vlastní seznam kořenových autorit a úložiště operačního systému ve výchozím stavu nečte. Adresa, která v prohlížeči funguje bez varování, tedy asistentovi spadne — a protože fetch takovou chybu hlásí jako obyčejné selhání spojení, vypadá to, jako by server neběžel. Přesně tohle je za hláškou *„server momentálně neodpovídá“*.

Server proto při startu autority ze systému načte sám. Nainstalovaný root certifikát tak stačí a nic dalšího nastavovat nemusíš. Co načetl, vypíše na svůj chybový výstup:

MyÚčto MCP připojen — nástroje načteny, API https://…/api/v1; TLS: systémové certifikáty načteny

Když spojení i tak selže na certifikát, dostaneš konkrétní hlášku s postupem. Nejčastější zbylé příčiny:

• Neúplný řetěz certifikátů. Server neposílá mezilehlý certifikát — projeví se jako unable to verify the first certificate. Náprava je na straně webserveru, ne klienta.
• Node starší než 22.15, který runtime načtení autorit neumí. Přidej do konfigurace asistenta NODE_OPTIONS=--use-system-ca, případně NODE_EXTRA_CA_CERTS=/cesta/k/ca.pem.
• Certifikát není vydaný nainstalovanou autoritou (jiný self-signed).

Jako poslední možnost — a výhradně proti vývojové instanci — jde ověřování vypnout přes MYUCTO_INSECURE_TLS=1. Server na to při startu hlasitě upozorní. Na produkci to nepoužívej: bez ověření certifikátu jde spojení odposlechnout i podvrhnout, a token v hlavičce je to první, co útočník získá.