Markdown API dokumentace: jak psát dokumentaci čitelnou pro vývojáře i AI nástroje

Co je to sémantické HTML jednoduše vysvětleno

Co je WebMCP jednoduše vysvětleno

Představte si, že do vaší kanceláře přijde nový asistent. První varianta: postaví ho do dveří a necháte ho, aby se rozhlédl, fotil si všechno kolem a snažil se uhodnout, co kde je. Když potřebuje vyplnit dokument, hledá tužku očima, zkouší různé šuplíky. Občas se trefí, občas zničí prezentaci na stole.

Druhá varianta: dáte mu seznam nástrojů, které má k dispozici. „Tady jsou tužky. Tady je tiskárna. Pro odeslání e-mailu zavolej sekretářku.“ Asistent přesně ví, co může udělat a jak. Pracuje rychle, neničí věci, a kdykoliv něco nového přidáte, stačí mu to napsat na seznam.

Přesně to dělá WebMCP pro AI agenty. Standardní AI agent (Claude in Chrome, Comet, ChatGPT Operator) dnes web „vidí“ tak, že si dělá screenshoty a snaží se vizuálně rozpoznat tlačítka. WebMCP tento postup obrací – web přímo řekne AI: „Tady jsou moje funkce, takhle se volají, takhle vrací výsledky.“

Standard byl oficiálně publikován jako W3C Draft Community Group Report 10. února 2026, na společném projektu Google a Microsoft. Najdete ho v Chrome 146 Canary za feature flagem.

Proč vůbec WebMCP vznikl

AI agenti, kteří mají automatizovaně používat web, mají dnes tři zásadní problémy:

• Vysoké náklady na zpracování. Každý screenshot stránky musí AI model přepsat na text a interpretovat. To stojí tokeny, čas a peníze.
• Křehkost. Pokud se design webu změní (jiná barva tlačítka, posun o 5 pixelů), AI agent najednou neví, kam kliknout. Selhání jsou časté.
• Bezpečnostní rizika. Když AI „klikuje“ naslepo, snadno provede něco nezamýšleného – třeba potvrdí objednávku, kterou neměl.

WebMCP řeší všechny tři problémy najednou. Místo screenshotu agent dostane strukturovaný seznam funkcí. Volání je deterministické (vždy stejné), token efficiency podle dat Google a Microsoftu vzrůstá až o 89 % oproti screenshot metodě. A protože každá funkce má jasně definované vstupy a výstupy, riziko nezamýšlené akce se výrazně snižuje.

Jak WebMCP funguje technicky

WebMCP přidává do prohlížeče nové JavaScript API přístupné přes navigator.modelContext. Web pomocí něj zaregistruje své funkce jako „nástroje“, které AI agent může volat.

Jednoduchý příklad pro e-shop, který chce nabídnout AI agentovi funkci „přidat do košíku“:

navigator.modelContext.registerTool({
  name: "add_to_cart",
  description: "Přidá produkt do košíku zákazníka",
  inputSchema: {
    type: "object",
    properties: {
      product_id: {
        type: "string",
        description: "ID produktu (SKU)"
      },
      quantity: {
        type: "number",
        description: "Počet kusů"
      }
    },
    required: ["product_id"]
  },
  execute: async (params) => {
    const result = await pridejDoKosiku(params.product_id, params.quantity);
    return { success: true, cart_count: result.total };
  }
});

Každý nástroj má čtyři klíčové části:

• name – jednoznačný identifikátor, kterým AI nástroj zavolá
• description – přirozený jazyk, který AI pomáhá pochopit, kdy nástroj použít
• inputSchema – JSON Schema definující očekávané vstupy
• execute – funkce, která se spustí při zavolání nástroje agentem

Existuje i deklarativní varianta přes HTML formuláře s atributy toolname a tooldescription, která je vhodná pro jednoduché případy bez JavaScriptu.

WebMCP vs. Anthropic MCP vs. llms.txt: jaký je rozdíl

Tyto tři standardy si lidé často pletou, protože všechny mají v názvu „AI“ nebo „MCP“. Každý ale řeší úplně jiný problém:

• Anthropic MCP – protokol pro backend integrace. Spojuje AI modely (Claude, ChatGPT) se serverovými systémy přes JSON-RPC. Pro vývojáře, kteří staví AI asistenty s přístupem k databázím a API.
• WebMCP – browser API pro klientské funkce. Web v prohlížeči nabídne AI agentovi své interaktivní funkce. Pro weby, které chtějí být použitelné přes AI agenty.
• llms.txt – textový soubor s obsahovým průvodcem. Říká AI nástrojům, které stránky webu jsou důležité a o čem jsou. Pro weby, které chtějí AI usnadnit pochopení obsahu.

Jednoduchá analogie: Anthropic MCP je telefonická linka mezi AI a vaším systémem. WebMCP je dálkové ovládání, které dáte AI do ruky, když přijde do vašeho obchodu. A llms.txt je leták s nejdůležitějšími informacemi o vaší firmě, který si AI může přečíst.

Tyto tři standardy si nekonkurují – řeší různé scénáře. WebMCP a llms.txt mohou klidně koexistovat na jednom webu.

Funguje WebMCP vůbec? Upřímný pohled

WebMCP je oficiální W3C standard s podporou dvou největších technologických firem. Ale realita produkčního nasazení v dubnu 2026 je výrazně skromnější.

Co říká stav podpory

• Chrome – early preview v Chrome 146 Canary za feature flagem (od února 2026). Není zapnuté výchozí, uživatel musí flag aktivovat ručně.
• Edge – Microsoft je spoluautor standardu, podpora je očekávaná, ale formálně neoznámená.
• Firefox – Mozilla zatím nezveřejnila žádné plány.
• Safari – Apple zatím mlčí. Vzhledem k jeho historii se standardy WebKit nelze čekat rychlou implementaci.

Co říkají data

V dubnu 2026 počet webů s implementovaným WebMCP řádově nepřesahuje stovky. Většinou jsou to demo aplikace od Google a Microsoftu, několik experimentálních e-shopů a prototypy SaaS nástrojů. Žádný velký český web standard zatím veřejně nenasadil.

Token efficiency 89 % vychází z testů Google a Microsoftu na vlastních benchmarcích, takže je třeba ji brát s rezervou. V reálném provozu se čísla mohou lišit.

Kde WebMCP přesto dává smysl

Přestože je standard v rané fázi, ve specifických případech má smysl ho sledovat nebo experimentovat:

• Pro SaaS aplikace s častými opakovanými úkony. Pokud uživatelé denně dělají stejné věci (filtrace, vytváření záznamů, exporty), WebMCP může z těchto úkonů udělat jednovětý příkaz pro AI.
• Pro e-shopy s vyhledáváním produktů. AI agent může za uživatele najít konkrétní produkt podle popisu, porovnat ceny, přidat do košíku.
• Pro accessibility. WebMCP může výrazně zlepšit přístupnost webu pro uživatele s postižením, kteří používají AI asistenty.
• Jako experimentální výhoda. Pokud teď přijdete s funkčním WebMCP řešením v ČR, máte minimálně 12 měsíců náskok před konkurencí.

Realistické očekávání: WebMCP v dubnu 2026 nemá žádný okamžitý SEO ani business dopad. Ale pokud se podpora rozšíří do dalších prohlížečů (Edge, Firefox), může být do roku 2027 standardem podobně jako schema.org. Sledování vývoje se vyplatí.

Jak vyzkoušet WebMCP už dnes

1. Aktivace v Chrome Canary

Pro testování WebMCP potřebujete Chrome 146 Canary nebo novější. Postup:

1. Stáhněte si Chrome Canary (běhá vedle vaší standardní verze)
2. Otevřete chrome://flags
3. Vyhledejte „WebMCP“ nebo „Model Context Protocol“
4. Aktivujte flag a restartujte prohlížeč
5. Volitelně si nainstalujte rozšíření „Model Context Tool Inspector“ pro debugging

2. Implementace na vlastním webu

Pro WordPress zatím neexistují produkční pluginy. Pokud chcete experimentovat, máte dvě cesty:

• Vlastní JavaScript v šabloně. Přidejte volání navigator.modelContext.registerTool() do functions.php přes wp_enqueue_script() nebo přímo do šablony.
• Custom blok v Gutenbergu. Vytvořte vlastní blok, který nabídne konkrétní funkci jako WebMCP nástroj (například „rezervovat termín“).

Vždy nejdřív otestujte v Chrome Canary s aktivovaným flagem. V ostatních prohlížečích se kód buď ignoruje (pokud není API přítomné), nebo způsobí chybu (vždy ošetřete podmínkou if ('modelContext' in navigator)).

3. Sledování vývoje

Pokud nechcete experimentovat, ale chcete být připravení, sledujte:

• Oficiální W3C specifikaci – aktuální verze standardu
• GitHub repozitář – diskuze, issues, examples
• Chrome Status pro WebMCP – kdy se dostane do stable verze
• WordPress.org pluginy – sledujte hesla „WebMCP“ a „Model Context“

Best practices pro WebMCP nástroje

• Pište jasné popisy. AI agent rozhoduje o použití nástroje podle description. „Vyhledá lety podle parametrů“ je lepší než „Search function“.
• Definujte striktní JSON schémata. Čím přesnější vstupy, tím méně chyb. Používejte required, enum a popisy u každého property.
• Vracejte strukturované výsledky. Místo „OK“ vraťte { success: true, order_id: "12345" }. AI agent může výsledek dál použít.
• Dejte agentovi jen to, co dává smysl. Neregistrujte všechno – vyberte 5-15 klíčových funkcí, které tvoří hlavní user journey.
• Implementujte autorizaci. Pro citlivé operace (platba, mazání) vyžadujte potvrzení uživatele, ne jen volání agentem.
• Lokalizujte popisy. Pokud cílíte na český trh, popisujte nástroje česky. AI agenti pracují vícejazyčně.

Časté chyby a omezení

• Spoléhání na produkční podporu. WebMCP je v dubnu 2026 jen v Chrome Canary za flagem. Žádný uživatel ho nemá zapnutý standardně.
• Záměna s Anthropic MCP. Jiný protokol, jiné použití. WebMCP je pro browser, Anthropic MCP pro backend služby.
• Tools jen v jednom tabu. WebMCP nástroje žijí jen v aktuálním tabu. Po navigaci se mažou. Není to perzistentní registrace.
• Bezpečnostní díry. Pokud zaregistrujete nástroj „smazat účet“ bez potvrzení, AI agent ho může omylem zavolat. Vždy chraňte destruktivní operace.
• Žádný discovery mechanismus. AI agent zatím nemá způsob, jak zjistit, které weby WebMCP podporují, dokud na ně nepřijde. Plánuje se .well-known/webmcp, ale není.
• Frontend-only omezení. WebMCP funguje jen v JavaScript v prohlížeči. Pro backend funkce (přístup k databázi, server-side logika) je potřeba kombinovat s Anthropic MCP.

Kdo dnes WebMCP podporuje

Adopce je v dubnu 2026 v plenkách, ale významní hráči už standard aktivně tlačí:

• Google – spoluautor specifikace, první implementace v Chrome 146 Canary, demo aplikace pro vyhledávání letů
• Microsoft – druhý spoluautor, podpora v Edge očekávaná, integrace s Copilot Studio
• Amazon (přes Alex Nahas) – původní MCP-B projekt, který se stal základem WebMCP
• W3C Web Machine Learning Community Group – oficiální správce standardu

Z českých firem zatím žádné veřejné nasazení. Mezinárodně se experimentuje hlavně v travel tech, e-commerce a SaaS nástrojích.

Závěr: máte WebMCP řešit?

Krátká odpověď: sledovat ano, nasazovat zatím ne.

WebMCP je v dubnu 2026 nejdůležitější nový standard pro AI agenty na webu. Má za sebou dvě největší technologické firmy (Google a Microsoft), oficiální W3C statut a jasné technické výhody (89 % úspora tokenů). Zároveň je v early preview, podporuje ho jediný prohlížeč ve verzi pro vývojáře a chybí produkční nástroje pro WordPress.

Komu se vyplatí WebMCP řešit prioritně:

• SaaS aplikacím a webovým nástrojům s opakovanými úkony
• E-shopům, které chtějí být použitelné přes AI agenty
• Agenturám a vývojářům, kteří chtějí získat náskok v expertize
• Webům cílícím na accessibility a alternativní přístupy

Komu je WebMCP zatím irelevantní:

• Statickým firemním webům bez interaktivních funkcí
• Blogům a obsahovým webům (pro ně je relevantnější llms.txt)
• Webům, kde neexistuje business case pro AI agenta

Hlavní pravidlo zní: WebMCP je investice do budoucnosti, ne do současnosti. V dubnu 2026 vám standard nepřinese žádné měřitelné výsledky, ale jeho znalost a experimentování může být v roce 2027 vaše konkurenční výhoda. Sledujte vývoj, testujte v Canary, ale s produkčním nasazením počkejte na širší podporu prohlížečů.