nksweb-mcp

Kdo spravuje obsah na několika webech, dělá v administraci pořád dokola tytéž kroky: najít stránku, upravit blok textu, založit článek, přidat přesměrování po změně adresy, podívat se na návštěvnost. nksweb-mcp tyto úkony zpřístupní AI asistentovi. Je to MCP server pro redakční systém NKS-Web, přes který Claude Code nebo jiný klient protokolu MCP čte a mění stránky, články, kategorie, novinky, soubory, uživatele, zprávy z kontaktního formuláře, přesměrování, nastavení a analytiku, a to na všech webech, ke kterým má klíč přístup.

Z věty rovnou do administrace

Redaktor nemusí vědět, kde v administraci co je. Řekne „přidej přesměrování ze staré adresy ceníku na novou“ nebo „které stránky byly tento měsíc nejnavštěvovanější“, a model zavolá příslušný nástroj se správnými parametry. Oproti psaní skriptů nad REST API odpadá studium dokumentace a ošetření chyb; oproti ručnímu klikání odpadá přepínání mezi obrazovkami a mezi weby.

Co server umí a k čemu to je

Obsah celého webu v 49 nástrojích

Stránky, články, kategorie, novinky, přesměrování a uživatelé mají úplnou sadu pro výpis, detail, založení, úpravu a smazání. U souborů, zpráv a nastavení jsou nástroje podle toho, co dává smysl: soubor jde vypsat, zobrazit a smazat, zprávu označit jako přečtenou. Stránky se dají filtrovat podle typu, stavu a jazyka a prohledávat podle názvu, adresy i obsahu HTML. Stránka se maže měkce, záznam v databázi tedy zůstane.

Úprava jednoho bloku místo celé stránky

Stránky se v administraci skládají z pojmenovaných bloků HTML, které se upravují v editoru Quill. Server s nimi umí pracovat jednotlivě: změnit nadpis v úvodu stránky znamená poslat jeden blok, ne přepsat celý obsah a riskovat, že se zbytek poškodí.

Víc webů jedním klíčem, ale nikdy omylem

Systém je multitenantní a jeden API klíč může mít přístup k několika webům. Nástroj nksweb_set_tenant přepne kontext a všechny další požadavky jdou na zvolený web přes hlavičku X-Tenant. Když klíč vidí víc webů, server nic neudělá, dokud model web výslovně nevybere. Úprava tak nedopadne na jiný web, než jaký uživatel myslel.

Oprávnění podle rozsahu klíče

Každý nástroj potřebuje odpovídající rozsah API klíče, například pages:read, articles:write nebo analytics:read. Klíč pro asistenta, který má jen odpovídat na dotazy o návštěvnosti, tedy nemůže nic smazat. Nástroje navíc nesou příznaky MCP readOnlyHint, destructiveHint a idempotentHint, podle kterých klient pozná, co jen čte a co mění, a u mazání se může zeptat.

Návštěvnost bez dalšího nástroje

Čtyři analytické nástroje vrátí přehled relací, zobrazení, uživatelů a míry okamžitého odchodu, nejnavštěvovanější stránky, zdroje návštěv a rozpad podle 14 dimenzí, mezi nimi země, prohlížeč, zařízení a parametry UTM. Bez zadaného období berou posledních 30 dní.

Chyby, kterým model rozumí

Kódy 400, 401, 403, 404, 409, 429, 502 a 503 mají vlastní zprávu, která pojmenuje příčinu, třeba chybějící rozsah klíče. Seznam delší než 25 000 znaků se zkrátí na polovinu položek s poznámkou, ať model stránkuje, ostatní odpovědi se zkrátí na 25 000 znaků. Požadavek bez odpovědi do 30 sekund skončí chybou.

Jak se zapojí

{
  "mcpServers": {
    "nksweb": {
      "command": "npx",
      "args": ["-y", "@nks-hub/nksweb-mcp"],
      "env": {
        "NKSWEB_URL": "https://your-site.com",
        "NKSWEB_API_KEY": "nks_your_api_key"
      }
    }
  }
}

Stačí adresa webu a API klíč s předponou nks_ a rozsahy pro nástroje, které má asistent používat. Asistent pak pracuje třeba takhle:

User: "Update the hero heading on homepage"
→ nksweb_upsert_content_block { pageId: 14, key: "hero_heading",
    content: "Digital Solutions That Work", label: "Hero Heading" }

User: "Add a redirect from /old-page to /new-page"
→ nksweb_create_redirect { source: "/old-page", target: "/new-page",
    statusCode: 301, isActive: true }

Kde se hodí

• Redakce: koncept článku s kategoriemi a údaji pro vyhledávače založí asistent podle zadání a redaktor ho jen zkontroluje a zveřejní.
• Úprava po změně struktury webu: hromada přesměrování 301 najednou, bez vyplňování formuláře pro každé z nich.
• Měsíční přehled: návštěvnost, nejčtenější stránky a zdroje návštěv za všechny weby, ke kterým má klíč přístup, v jedné odpovědi.
• Správa kontaktního formuláře: výpis nepřečtených zpráv a jejich označení jako vyřízených.

Stav projektu

Server vznikl v březnu 2026. Na npm je verze 0.2.3 z 22. března 2026, která přinesla stránkování seznamů. Repozitář je dál: v květnu přibyl režim HTTP, ve kterém server běží jako samostatná služba, a strukturované výstupy se schématem u všech nástrojů. Ty zatím na npm nevyšly, kdo je chce, sestaví server ze zdrojů. V repozitáři je integrační test, který se pouští ručně proti běžící instanci systému s vlastním API klíčem.

Jak začít

npx -y @nks-hub/nksweb-mcp
# nebo v Claude Code
claude mcp add nksweb -e NKSWEB_URL=https://your-site.com -e NKSWEB_API_KEY=nks_key -- npx -y @nks-hub/nksweb-mcp

Potřeba je Node.js 18 nebo novější a web na NKS-Web se zapnutým API. Ze zdrojů se server sestaví příkazy npm install a npm run build a v konfiguraci se pak místo npx spouští node build/index.js.

Zdrojový kód

Kód je na GitHubu v repozitáři nks-hub/nksweb-mcp pod licencí MIT, napsaný v TypeScriptu nad oficiálním MCP SDK. Balíček je na npm jako @nks-hub/nksweb-mcp, poslední verze 0.2.3.