Firemní znalostní báze pro AI: ze šuplíku plného PDF vlastní MCP server pro celou firmu

firemni-znalosti/
├── _vstup/                  ← sem jde všechno surové
│   ├── 01-firma/            o firmě, historie, pobočky, kontakty na oddělení
│   ├── 02-produkty/         katalogy, technické listy, srovnání
│   ├── 03-cenik/            ceníky, slevová pravidla, platební podmínky
│   ├── 04-procesy/          směrnice, postupy, reklamace, servis
│   ├── 05-obchod/           prezentace, vzorové nabídky, námitky zákazníků
│   ├── 06-hr/               onboarding, dovolená, benefity (bez osobních údajů!)
│   ├── 07-brand/            brand manuál, loga, písma, fotky, vzorové texty
│   ├── 08-sablony/          šablony dokumentů, e-mailů, prezentací
│   └── 09-video/            přepisy videí a školení (ne samotná videa)
├── znalosti/                ← sem bude Cowork zapisovat výsledek
└── ke-kontrole/             ← sem Cowork odloží, co si neví rady

Pracuješ na firemní znalostní bázi firmy [název], která [čím se firma
zabývá, 1 věta]. Ze souborů ve složce _vstup tvoříš markdownové soubory
do složky znalosti.

Pravidla:
- Nikdy neměň ani nemaž nic ve složce _vstup.
- Každý výstupní soubor začíná hlavičkou (frontmatter) v tomto tvaru:
  ---
  nazev: krátký výstižný název
  oblast: firma | produkty | cenik | procesy | obchod | hr | brand | sablony
  typ: fakt | postup | pravidlo | sablona | faq
  shrnuti: jedna věta, co dokument obsahuje
  platnost_od: RRRR-MM-DD (pokud ji zdroj uvádí, jinak vynech)
  vlastnik: [doplní člověk — nech prázdné]
  zdroj: cesta k původnímu souboru v _vstup
  ---
- Jeden soubor = jedno téma. Raději víc kratších souborů než jeden obří.
- Píšeš česky, věcně, celými větami. Žádný marketingový vzduch.
- Čísla, ceny, lhůty a názvy přebírej přesně. Nic nezaokrouhluj a nedomýšlej.
- Když si nejsi jistý (nečitelný sken, rozpor mezi zdroji, chybějící
  údaj), nevymýšlej: zapiš problém do ke-kontrole/otazky.md s odkazem
  na zdroj.
- Osobní údaje (jména zákazníků, kontakty na konkrétní lidi mimo firmu,
  rodná čísla) do výstupu nepřenášej — nahraď je [ZÁKAZNÍK] apod.
- Názvy souborů: malá písmena, bez diakritiky, slova oddělená pomlčkou.

Projdi celou složku _vstup a nic zatím nevytvářej. Vrať mi:
1. Tabulku: soubor | oblast | o čem je (1 věta) | odhad počtu
   výstupních témat | problém (nečitelné, duplicitní, zastaralé?)
2. Seznam souborů, které vypadají jako různé verze téhož dokumentu,
   a u každé dvojice, v čem se liší.
3. Soubory, které podle tebe obsahují osobní údaje nebo důvěrné
   informace a do báze pro všechny zaměstnance by nepatřily.
4. Navrženou strukturu složky znalosti (podsložky a názvy souborů).

Zpracuj podsložku _vstup/04-procesy podle instrukcí složky.

U každého postupu (reklamace, servis, objednávka náhradního dílu…)
vytvoř samostatný soubor se strukturou:
## K čemu to je
## Kdo to dělá
## Kroky (číslovaný seznam, každý krok jedna akce)
## Lhůty a čísla
## Časté chyby a výjimky
## Na koho se obrátit (role, ne jméno)

Když se dva zdroje v postupu rozcházejí, nerozhoduj — zapiš rozpor
do ke-kontrole/otazky.md. Na konci mi vypiš seznam vytvořených souborů
a počet otázek ke kontrole.

Zpracuj _vstup/03-cenik. Cílem není přepsat Excel do markdownu,
ale popsat, co platí:
- cenik-sluzby.md: tabulka služba | cena bez DPH | cena s DPH | jednotka
  | poznámka; nad tabulkou datum platnosti
- slevova-pravidla.md: kdy a jakou slevu smí dát obchodník sám,
  kdy schvaluje vedoucí, co se nikdy neslevňuje
- platebni-podminky.md
Každou cenu zkontroluj dvakrát proti zdroji. Do ke-kontrole/otazky.md
zapiš každou buňku se vzorcem, jejíž výsledek se ti nepodařilo ověřit.

Na základě všech souborů ve složce znalosti a anonymizovaných dotazů
zákazníků v _vstup/05-obchod/dotazy vytvoř soubor znalosti/faq/
[oblast]-faq.md pro každou oblast.

Každá položka:
### Otázka formulovaná tak, jak by se zeptal zákazník nebo kolega
Odpověď ve 2–5 větách.
Zdroj: odkaz na soubor ve znalosti, ze kterého odpověď vychází.

Zahrň i otázky, na které odpověď zní „to neděláme“ nebo „to záleží
na…“ — ty jsou pro bázi stejně důležité. Nevytvářej odpovědi, které
nemají oporu v žádném souboru; takové otázky dej do ke-kontrole.

Vytvoř znalosti/firma/kdo-co-vi.md: tabulka oblast | typické otázky
| role | interní kontakt (oddělení, sdílená schránka) | zastupuje.
Vycházej z organizační struktury v _vstup/01-firma. Jména osob uveď
jen tam, kde jsou ve zdroji výslovně jako kontaktní osoba pro danou
oblast, a označ je k ověření.

Přečti celou složku znalosti a najdi:
1. Rozpory: kde dva soubory tvrdí o téže věci něco jiného (cena,
   lhůta, postup, název). U každého: oba soubory, obě tvrzení.
2. Osiřelé odkazy: zmínky o dokumentu, procesu nebo produktu,
   který v bázi nemá vlastní soubor.
3. Soubory bez data platnosti, které obsahují ceny nebo lhůty.
4. Pět otázek, které by podle tebe zaměstnanci kladli nejčastěji
   a na které báze zatím neodpoví.
Výsledek zapiš do ke-kontrole/audit.md. Nic neopravuj.

znalosti/
├── README.md              co to je, kdo to vlastní, jak navrhnout změnu
├── znalosti/
│   ├── firma/             o-firme.md, pobocky.md, kdo-co-vi.md
│   ├── produkty/
│   ├── cenik/
│   ├── procesy/
│   ├── obchod/
│   ├── hr/
│   ├── brand/             viz fáze 8
│   ├── sablony/
│   └── faq/
└── assets/
    └── brand/             loga (SVG, PNG), barevné palety, ikonky

Jsi napojený na znalostní bázi firmy [název]. Pravidla:
1. Na otázky o firmě, jejích produktech, cenách, postupech a značce
   odpovídej z báze (nástroj hledej), ne z obecných znalostí.
2. U každého faktu uveď zdroj (cestu k souboru).
3. Když báze odpověď nemá, řekni to výslovně, zavolej nahlas_mezeru
   a pomocí kdo_to_vi doporuč, na koho se obrátit. Nikdy nedomýšlej
   ceny, lhůty ani podmínky.
4. Když si dva dokumenty odporují, uveď oba a dej přednost tomu
   s novějším datem platnosti.
5. Před tvorbou jakéhokoli textu nebo materiálu ven zavolej brand.
6. Do nástrojů posílej jen věcný dotaz (např. "lhůta reklamace"),
   nikdy jména, kontakty ani celé zprávy zákazníků.

V tomto repozitáři je ve složce znalosti/ firemní znalostní báze
v markdownu. Každý soubor má frontmatter s poli nazev, oblast, typ,
shrnuti, platnost_od, vlastnik, zdroj.

Postav nad ní vzdálený MCP server, který poběží na Vercelu:
- Next.js (App Router) s balíčkem mcp-handler, endpoint /api/mcp,
  transport Streamable HTTP. Drž se aktuální dokumentace Vercelu
  "Deploy MCP servers to Vercel" a verze balíčku, kterou uvádí.
- Při startu načti všechny soubory ze znalosti/ do paměti.
- Nástroje:
  1. hledej(dotaz, oblast?) — fulltext s normalizací diakritiky
     a jednoduchým zohledněním českých koncovek; vrať max. 8 výsledků:
     nazev, shrnuti, cesta, relevantní úryvek (max. 800 znaků),
     platnost_od. Novější platnost má při shodě přednost.
  2. dokument(cesta) — celý soubor; jen soubory uvnitř znalosti/,
     ošetři pokusy o cestu ven ze složky.
  3. prehled() — oblasti a soubory s shrnutím.
  4. brand(tema?) — obsah složky znalosti/brand a veřejné URL
     souborů v assets/brand.
  5. sablona(nazev?) — bez parametru seznam šablon, s parametrem obsah.
  6. kdo_to_vi(oblast) — z znalosti/firma/kdo-co-vi.md.
  7. nahlas_mezeru(otazka, kontext?) — zápis do databáze (viz níže).
- Instrukce serveru (server instructions) vlož z [vložit text
  instrukcí výše].
- Popisy nástrojů piš česky a tak, aby z nich model poznal, kdy který
  použít.
- Server musí být zamčený od prvního nasazení: obal ho přes
  withMcpAuth s required: true, takže dokud přihlášení není nastavené,
  odmítne každý požadavek (401). Přihlášení doplníme v dalším kroku.
  Pro lokální testování přijmi navíc testovací token z proměnné
  MCP_TEST_TOKEN v .env.local, ale jen při běhu na mém počítači
  (mimo Vercel); na Vercelu ho server nesmí přijmout nikdy.
- Každé volání nástroje zaloguj do Postgres databáze z proměnné
  DATABASE_URL (Neon, driver @neondatabase/serverless): čas, nástroj,
  počet výsledků, cesty vrácených dokumentů, doba zpracování v ms,
  hash identifikátoru uživatele, pokud je k dispozici. Text dotazu
  (u hledej a nahlas_mezeru) před uložením minimalizuj: odstraň
  e-maily, telefonní čísla, rodná čísla a další dlouhé číselné řetězce
  a zkrať ho na 200 znaků. Ostatní parametry neukládej, jen cestu
  u nástroje dokument. Přidej naplánovanou úlohu (Vercel Cron), která
  jednou denně smaže záznamy starší než 180 dní.
  Logování nesmí nikdy shodit odpověď nástroje —
  když databáze není dostupná, nástroj odpoví a chybu jen vypíše.
  Databázové připojení inicializuj až při prvním použití, ne při
  buildu.
- Přidej migraci SQL pro tabulky a soubor docs/statistiky.sql
  s dotazy z tohoto zadání [viz fáze 7].
- Přidej testy: pro hledání sadu 20 otázek ze souboru
  tests/otazky.md, u každé očekávaný soubor ve výsledcích.
- Žádné tajné údaje v kódu ani v repozitáři; vše přes proměnné
  prostředí. Do README napiš, které proměnné server potřebuje.

Nejdřív mi napiš plán a seznam souborů, které vytvoříš. Kód piš
až po mém potvrzení.

Přidej k MCP serveru povinné OAuth přihlášení podle sekce "Enabling
authorization" v dokumentaci Vercelu k MCP serverům. Poskytovatel
identity: [Microsoft Entra ID / Google Workspace / jiný]. Povol jen
účty z domény [firma.cz]. Z ověřeného tokenu ulož do logu jen hash
identifikátoru uživatele, nikdy e-mail ani jméno. Napiš mi krok
za krokem, co musím nastavit u poskytovatele identity a jaké proměnné
prostředí doplnit na Vercelu. Klíče a tajné hodnoty do repozitáře
nedávej.

Tady je export dotazů bez výsledku za poslední měsíc [vložit tabulku].
1. Seskup je podle tématu a odhadni, kolik různých potřeb za nimi stojí.
2. U každé skupiny navrhni, jestli jde o: chybějící dokument,
   chybějící synonymum (informace v bázi je, ale jinými slovy),
   nebo otázku, která do báze nepatří.
3. Seřaď podle počtu dotazů a navrhni vlastníka oblasti.
Výstup jako tabulka pro poradu.

Podle firemní znalostní báze: [otázka]. Uveď zdroj u každého faktu.
Když v bázi odpověď není, řekni to a doporuč, na koho se obrátit.

Co všechno o [téma] je ve firemní bázi? Udělej přehled dokumentů
s jednovětým shrnutím a upozorni, kde si dokumenty odporují nebo
kde chybí datum platnosti.

Připrav nabídku pro [typ zákazníka, velikost objektu, požadavek].
Ceny, slevová pravidla a platební podmínky ber výhradně z báze
a u každé ceny uveď zdroj. Použij šablonu nabídky z báze a tón
značky (nástroj brand). Když požadavek vyžaduje slevu nad rámec
pravidel, nepočítej ji — napiš, kdo ji musí schválit.

Zákazník namítá: "[námitka]". Najdi v bázi, jak na tuto námitku
odpovídáme, a navrhni dvě verze odpovědi: krátkou do telefonu
a e-mailovou. Nic neslibuj, co v bázi není.

Zákazník píše: "[text zprávy]". Podle postupů v bázi:
1. o jaký typ požadavku jde a jaká je lhůta,
2. co od zákazníka ještě potřebujeme,
3. návrh odpovědi v tónu značky.
Když postup v bázi není, nepiš odpověď a řekni, komu to předat.

Technik hlásí: [popis závady / chybový kód]. Najdi v bázi postup
a vypiš ho jako číslovaný seznam kroků do terénu. Upozorni na
bezpečnostní pokyny a na kroky, které smí dělat jen certifikovaný
technik.

Napiš [3 příspěvky na LinkedIn / newsletter / text na web] o [téma].
Fakta o produktech ber jen z báze, tón a zakázané fráze z nástroje
brand. Ke každému textu přidej seznam tvrzení, která je potřeba
před zveřejněním ověřit.

Zkontroluj tento text proti pravidlům značky v bázi: [text].
Vypiš odchylky (tón, zakázané fráze, nesprávné názvy produktů,
čísla, která nesedí s bází) a navrhni opravenou verzi.

Jsem nový zaměstnanec na pozici [pozice]. Podle báze mi sestav
plán prvního týdne: co si musím zařídit, koho kontaktovat (role)
a které dokumenty si přečíst. U každého bodu odkaz na zdroj.

Kolega se ptá: "[otázka na dovolenou, benefity, home office…]".
Odpověz podle interních pravidel v bázi, ne podle obecného
zákoníku práce. Když pravidlo v bázi chybí, řekni to.

Projdi bázi a připrav souhrn: které oblasti jsou popsané dobře,
které slabě (málo dokumentů, staré platnosti, chybí vlastník)
a co bys doplnil jako první. Výstup jako tabulka.

Připravuji [změnu ceníku / nový proces]. Najdi v bázi všechny
dokumenty, kterých se změna dotkne, a navrhni, co v nich upravit.
Nic neměň, jen seznam.

V _vstup/07-brand je náš brand manuál (PDF), loga a vzorové texty
z webu a sociálních sítí. Vytvoř soubory do znalosti/brand podle
tohoto seznamu: ton-hlasu.md, slovnik.md, barvy.md, pisma.md,
logo.md, fotografie.md, formaty.md.

U vizuálních pravidel přebírej přesně kódy barev a názvy písem
z manuálu. Tón hlasu odvoď ze skutečných textů, ne z obecných
frází v manuálu — a ke každé vlastnosti tónu dej ukázkovou větu
z našich textů. Kde manuál a skutečné texty nesouhlasí (manuál
říká vykání, web tyká), zapiš to do ke-kontrole/otazky.md.
Soubory loga zkopíruj do assets/brand s popisnými názvy
(logo-barevne.svg, logo-bile.png…) a v logo.md uveď, kdy kterou
variantu použít.

Vytvoř ve složce vystupy dokument [produktový list / interní směrnici
/ nabídku] o [téma] jako .docx a .pdf. Obsah ber z firemní báze,
vizuál podle nástroje brand: barvy, písma (když firemní písmo není
nainstalované, použij náhradní z pisma.md), logo z assets/brand
v záhlaví. Na konec přidej seznam zdrojů z báze. Než soubor vytvoříš,
ukaž mi osnovu.

Připrav prezentaci (.pptx, 10–12 snímků) pro [publikum] na téma
[téma]. Fakta z báze, každé číslo s poznámkou o zdroji v poznámkách
řečníka. Barvy, písma a logo podle brandu; jedna hlavní myšlenka
na snímek, žádné odstavce textu. Na poslední snímek kontakt podle
kdo_to_vi.

Připrav sérii 5 příspěvků na [Instagram / LinkedIn] k [akce, produkt].
Ke každému: text příspěvku v tónu značky, krátký text do grafiky
(max. 8 slov), návrh vizuálu (co na obrázku, barvy z brand/barvy.md
v HEX, umístění loga podle logo.md) a rozměr podle formaty.md.
Fakta o produktu jen z báze.

Připrav podklady pro [30vteřinové video na Instagram / 2minutové
video na web] o [téma]. Z báze ber fakta o produktu, z brandu tón,
barvy, písma a pravidla pro video z formaty.md (úvod, závěr, logo).
Výstup:
1. scénář (co se říká),
2. scénosled jako tabulka: čas | záběr | text v obraze | zvuk,
3. titulky ve formátu .srt,
4. seznam záběrů k natočení nebo vygenerování.
Ulož do vystupy/video-[téma]/.

Tady je přepis hotového videa [vložit] a seznam textů v obraze
[vložit]. Zkontroluj je proti firemní bázi a brandu: nesprávná
čísla, staré názvy produktů, zakázané fráze, tón. Vypiš jen
nálezy s časem ve videu.