K čemu to je
Web nabízí rozhraní MCP (Model Context Protocol) na adrese https://váš-web/mcp/. AI agent se k němu připojí a pak stačí napsat třeba:
- „Na stránce Kontakt změň otevírací dobu na 8–16 h.“
- „Přidej na stránku Služby pod úvodní text HTML builder blok se třemi kartami…“
- „Skryj na úvodní stránce blok s akcí.“
Agent si sám najde stránku i správný element a změnu provede. Změna platí na webu hned.
Zapnutí a token
Nastavení → API přístup (vidí jen superadmin)
- Zaškrtněte Povolit API (MCP) a uložte. Dokud API není zapnuté, adresa
/mcp/neexistuje. - V kartě Nový token vyplňte název (např. „Claude Code – Pavel“), vyberte správce, rozsah a platnost.
- Po vytvoření se token zobrazí jen jednou i s hotovým příkazem pro připojení. Zkopírujte si ho.
| Volba | Význam |
|---|---|
| Správce | Agent smí jen to, co tento správce v oblasti Stránky (Přístup, Přidat, Upravit). Odeberete-li správci práva, platí to hned i pro token. |
| Rozsah | jen čtení – agent obsah jen prohlíží; čtení i zápis – může ho i měnit. |
| Platnost | 30, 90, 365 dní nebo bez omezení. Prošlý token přestane fungovat sám. |
| Limit volání | Kolik akcí smí agent s jedním tokenem udělat za hodinu (výchozí 120). |
Připojení v Claude Code
Příkaz z administrace spusťte v terminálu (jednou na počítači):
claude mcp add --transport http muj-web https://váš-web/mcp/ --header "Authorization: Bearer wnx_…"
V nové relaci Claude Code pak stačí psát úkoly běžnou řečí. Kontrola připojení: příkaz /mcp v Claude Code ukáže server jako připojený.
Připojení v Codexu
Blok z administrace vložte do souboru ~/.codex/config.toml (nebo .codex/config.toml v projektu) a Codex restartujte. Nepřipojí-li se, aktualizujte Codex na nejnovější verzi (starší verze uměly vzdálené HTTP servery jen s experimentálním nastavením):
[mcp_servers.muj-web]
url = "https://váš-web/mcp/"
http_headers = { "Authorization" = "Bearer wnx_…" }
Připojení v Google Antigravity
Agent panel → MCP Servers → Manage MCP Servers → View raw config. Je-li soubor prázdný, vložte celý obsah z administrace; jinak přidejte jen vnitřní položku (od názvu serveru) do existujícího mcpServers. Klíč musí být serverUrl (url ani httpUrl Antigravity nezná):
"muj-web": { "serverUrl": "https://váš-web/mcp/", "headers": { "Authorization": "Bearer wnx_…" } }
Token i všechna nastavení zkopírujete tlačítkem s ikonou kopírování vedle pole.
Authorization: Bearer.Co agent smí
| Oblast | Akce |
|---|---|
| Stránky | Číst, založit (vždy jako neaktivní), změnit název, URL, SEO, schema.org, sitemap, layout a typ (stránka / odkaz v menu), zveřejnit či skrýt, změnit pořadí, smazat prázdnou stránku. |
| Elementy | Všechny typy: přidat, upravit obsah i nastavení (galerie, dataset, formulář, články, produkty, box), kopírovat, smazat, skrýt, změnit pořadí, vrátit z historie. |
| Menu | Zařadit stránku nejvyšší úrovně do menu (horní, spodní, mapa webu…), i rovnou při jejím založení, změnit pořadí, odebrat z menu (jde vrátit). Podstránky se v menu zobrazují pod rodičem samy. |
| Společné bloky | Číst, založit, upravit, vypnout. |
| Obrázky | Procházet a nahrávat do /public/files/ (JPG, PNG, WebP, GIF do 5 MB). |
| Sitemap | Vygenerovat sitemap.xml. |
Agent nesmí:
- smazat stránku, která má obsah nebo podstránky,
- smazat, skrýt nebo přesměrovat hlavní stránku webu, odebrat ji z horního menu ani změnit, která stránka je hlavní,
- smazat společný blok (jen vypnout),
- vidět nebo měnit e-mailové adresy ve formulářích,
- spravovat moduly (galerie, články, produkty, formuláře samotné…) a nahrávat jiné soubory než obrázky.
Které akce může dělat, určují práva správce tokenu v oblasti Stránky (Přístup = čtení, Upravit, Přidat, Smazat) a pro menu v oblasti Menu (Přístup, Upravit).
Vrácení změny
Před každou změnou se předchozí obsah uloží do historie elementu. V administraci otevřete element (Stránky → Obsah stránky → element). Pod formulářem jsou zálohy, ty od agenta mají typ Změna přes API. Tlačítkem Obnovit obsah vrátíte předchozí stav. Agenta můžete o vrácení požádat i přímo.
Smazaný element a úprava společného bloku vlastní historii nemají. Jejich předchozí stav se uloží do logu API a agent je umí vrátit (nástroj undo_change). Stačí mu napsat třeba „vrať ten smazaný blok“. Obnovený element dostane nové id a jeho historie úprav se neobnoví.
Přehled všech změn od agentů je na stránce API přístup v tabulce Poslední změny přes API (posledních 180 dní).
Bezpečnost
- Rozhraní funguje jen přes HTTPS a jen s platným tokenem. Token platí jen pro web, kde vznikl.
- V databázi je uložen jen otisk tokenu, ne token samotný.
- Token nezávisí na hesle správce. Změna hesla ho nezruší, zrušte ho proto v tabulce Tokeny, kdykoli už není potřeba.
- Po 20 neúspěšných pokusech z jedné IP se rozhraní pro tuto IP na 15 minut zablokuje.
- Agent vkládá HTML stejně jako správce v administraci. Dávejte mu proto jasné zadání a výsledek zkontrolujte na webu.