Jak přes MCP uzavřít smyčku zpětné vazby k dokumentaci

Váš chatbot už dnes ukazuje, s čím si neví rady: odpovědi s palcem dolů, odpovědi typu „nevím“, slabé vyhledávání, nezodpovězené dotazy a stránky, které uživatelé a jejich AI agenti nahlásili jako chybné nebo zastaralé. Insights MCP server předává tato data AI asistentovi, se kterým píšete dokumentaci. Celou cestu od nespokojeného uživatele k opravené a znovu zaindexované stránce tak zvládnete na jednom místě.

Jde o jiný server než ten z návodu Propojení přes MCP. Ten zpřístupňuje znalostní bázi bota koncovým uživatelům. Tento zpřístupňuje členům workspace zpětnou vazbu a konverzace.

Co získáte

Po připojení může váš asistent:

• vypsat problémové konverzace za poslední týden, měsíc, kvartál, rok nebo vlastní období až 400 dní a přečíst si celé přepisy
• zjistit, které stránky dokumentace uživatelé a jejich AI agenti hlásí nejčastěji, a přečíst si každé hlášení i s pasáží, kterou cituje
• projít znalostní mezery za delší období a nejčastější dotazy za posledních 90 dní
• na otázku „kde to opravit?“ vrátit diagnózu příčiny, cílovou stránku, nadpis sekce k úpravě a návrh změny
• před návrhem úpravy si přečíst aktuální text stránky a prohledat dokumentaci stejně, jako to dělá bot
• po zveřejnění opravy označit položku jako vyřešenou, uzavřít hlášení od uživatelů, spustit novou synchronizaci zdroje a ověřit, že bot nový text najde

Server do vaší dokumentace nikdy nezasahuje. Píšete ve svém vlastním nástroji (Confluence, Notion, Git, CMS), obvykle přes konektor tohoto nástroje ve stejném chatu.

Předpoklady

• Workspace ChatbotIQ na tarifu s přístupem k API (Personal, Standard nebo Business).
• Členství v tomto workspace. Číst mohou všechny role; oprávnění k zápisu (označení jako vyřešené, uzavření hlášení, synchronizace) mohou udělit jen vlastníci a administrátoři.
• MCP klient: Claude.ai nebo Claude Desktop, ChatGPT, Claude Code, Cursor nebo jakýkoli jiný klient, který umí MCP přes HTTP.

Krok 1: Najděte adresu serveru

1. Otevřete Analytika > Zpětná vazba k dokumentaci.
2. V části Připojte svého AI asistenta vyberte záložku svého klienta a zkopírujte adresu serveru. Má tvar https://app.chatbotiq.eu/v1/mcp/workspaces/<id-workspace>/mcp.

Každý workspace má vlastní adresu. Token vydaný pro jeden workspace v jiném workspace nefunguje.

Krok 2: Připojte klienta

Když klienta připojujete přes OAuth, otevře se souhlasová stránka ChatbotIQ. Pokud v tom prohlížeči do ChatbotIQ přihlášeni nejste, nejdřív se přihlásíte a pak se na souhlasovou stránku vrátíte. Vidíte na ní, kterým účtem jste přihlášeni a kam se prohlížeč po schválení vrátí (například na claude.ai nebo chatgpt.com, u Claude Code na místní adresu na vašem počítači). Pokud přihlášený účet není členem workspace z adresy serveru, klikněte na Použít jiný účet a přihlaste se tím správným.

Desktopoví klienti jako Claude Code a Cursor otevírají výchozí prohlížeč. Pokud jste do ChatbotIQ přihlášeni v jiném prohlížeči, klikněte na přihlašovací nebo souhlasové stránce na Zkopírovat odkaz a do 10 minut odkaz otevřete v tom prohlížeči.

Claude.ai a Claude Desktop

1. Otevřete Customize > Connectors, klikněte na + a poté na Add custom connector.
2. Vložte adresu serveru, klikněte na Add a poté na Connect.
3. Otevře se přihlašovací stránka ChatbotIQ. Přihlaste se, zkontrolujte workspace a oprávnění a klikněte na Povolit přístup.
4. V chatu klikněte na +, zvolte Connectors a konektor zapněte. Prompty serveru, například Get started a Weekly documentation review, najdete ve stejné nabídce u konektoru.

Na tarifech Team a Enterprise přidá konektor jednou vlastník v Organization settings > Connectors (Add, poté Custom > Web). Každý člen pak u něj v Customize > Connectors klikne na Connect a přihlásí se vlastním účtem ChatbotIQ.

ChatGPT

1. V nastavení ChatGPT zapněte režim pro vývojáře (developer mode). Na tarifech Business a Enterprise ho možná musí nejdřív povolit správce.
2. Otevřete chatgpt.com/plugins a zvolte Přidat > Nový plugin.
3. Zadejte název, v části Připojení vložte adresu serveru do pole Adresa URL serveru a jako Ověřování zvolte OAuth.
4. V upozornění na rizika klikněte na Rozumím a chci pokračovat a poté na Vytvořit.
5. Přihlaste se do ChatbotIQ a klikněte na Povolit přístup.

Claude Code

claude mcp add --transport http chatbotiq-insights https://app.chatbotiq.eu/v1/mcp/workspaces/<id-workspace>/mcp

Poté v Claude Code spusťte /mcp, vyberte chatbotiq-insights a přihlaste se v prohlížeči, který se otevře. Prompty serveru se stanou příkazy: najdete je po napsání /, nebo rovnou spusťte /mcp__chatbotiq-insights__weekly_docs_review.

Cursor a další klienti bez OAuth

1. V Analytika > Zpětná vazba k dokumentaci vytvořte osobní přístupový token. Zadejte název a dobu platnosti (30, 90 nebo 365 dní). Token se zobrazí jen jednou.
2. Přidejte server do MCP konfigurace klienta a token vložte do hlavičky Authorization:

{
  "mcpServers": {
    "chatbotiq-insights": {
      "url": "https://app.chatbotiq.eu/v1/mcp/workspaces/<id-workspace>/mcp",
      "headers": { "Authorization": "Bearer mcpu_..." }
    }
  }
}

Konfigurační soubor nikomu nesdílejte. Token můžete kdykoli zneplatnit v Analytika > Zpětná vazba k dokumentaci.

Krok 3: Spusťte revizi

Pokud se serverem začínáte, spusťte prompt Get started, nebo se prostě zeptejte „co to umí?“. Asistent zjistí, co na vás čeká (problémové dotazy za posledních 7 dní, nová hlášení od uživatelů, nejčastěji hlášené stránky, aktivní znalostní mezery), a navrhne další krok.

Celou smyčku projdete s promptem Weekly documentation review: v Claude.ai ho vyberte u konektoru v nabídce +, v Claude Code spusťte /mcp__chatbotiq-insights__weekly_docs_review, případně s obdobím, například last_30d. V jakémkoli klientovi se také můžete prostě zeptat:

Na co si uživatelé dokumentačního bota minulý týden stěžovali a kde to mám opravit?

Asistent:

1. zavolá list_problem_conversations za dané období a get_content_hotspots pro stránky, které uživatelé hlásí nejčastěji,
2. seskupí položky podle tématu,
3. pro hlavní témata zavolá get_doc_recommendation,
4. ukáže vám tabulku: téma, počet dotazů, hlášení od uživatelů ke stejné stránce (a kolik z nich agent podal na žádost člověka), příčina, stránka a sekce, návrh změny, odkaz na konverzaci,
5. zastaví se a zeptá se, kterým položkám se chcete věnovat.

Hlášení od uživatelů

Když MCP server bota používá API klíč, dostanou k němu připojení AI agenti nástroj submit_feedback. Uživatelé a jejich agenti jím hlásí stránku nebo pasáž, která je chybná, zastaralá, matoucí nebo neúplná, obvykle i s přesnou citací. Stejná hlášení během 24 hodin se sloučí a times_reported ukazuje, kolikrát přišla. U každého hlášení je vidět, jestli ho agent podal na žádost člověka (human), nebo z vlastního úsudku (agent); tento údaj nastavuje klient, který hlášení podal, a ChatbotIQ ho nemůže ověřit.

get_content_hotspots řadí stránky podle počtu hlášení, list_user_feedback vrací samotná hlášení. Stejná hlášení najdete u bota na záložce Nasazení v dlaždici AI asistenti a vlastníkům a administrátorům chodí denní e-mail, když přibudou nová (Účet > Oznámení, Souhrn zpětné vazby od uživatelů).

Delší období

Odmítnuté dotazy, dotazy s nízkou jistotou a nejčastější dotazy pocházejí z analytiky dotazů, která se uchovává 90 dní. Dotazy s palcem dolů, nezodpovězené dotazy a celé konverzace sahají dál do minulosti. Pro kvartál nebo rok si místo jednotlivých konverzací vyžádejte znalostní mezery: teprve ty udělají delší období přehledným.

Krok 4: Jak číst doporučení

Každé doporučení začíná příčinou. Jen jedna z nich znamená, že je potřeba změnit dokumentaci:

Příčina	Význam	Co dělat
content_gap	V dokumentaci chybí, co uživatel potřeboval, nebo je tam chybně či zastarale.	Upravte cílovou stránku a sekci, nebo vytvořte novou stránku tam, kde ji doporučení navrhuje.
retrieval_failure	Odpověď v dokumentaci je, ale bot ji nenašel.	V dokumentaci nic neměňte. Dejte vědět správci workspace; jde o problém bota nebo indexace.
answer_quality	Bot měl správné podklady, a přesto odpověděl špatně.	Obvykle nic. Pokud je sekce opravdu matoucí, zpřehledněte ji.
out_of_scope	Dotaz se netýká tohoto produktu.	Ignorujte; pokud se dotaz opakuje, přidejte ho do FAQ.

Cílová stránka se vždy vybírá z reálně zaindexovaných stránek a nadpis sekce se přebírá z její osnovy. Pole signals vysvětluje, proč byla stránka vybrána: bot ji citoval, vrátilo ji vyhledávání, její nadpis odpovídá dotazu a podobně. Pokud model navrhne nadpis, který na stránce není, doporučení ho vynechá; nikdy si ho nevymyslí.

U odpovědí s palcem dolů se doporučení vytvoří automaticky krátce po hodnocení. U ostatních dotazů ho asistent vytvoří na vyžádání, nejvýše 30 za hodinu na workspace.

Hlášení od uživatelů vlastní doporučení nemají. U nich si asistent přečte hlášení přes list_user_feedback: citovaná pasáž mu řekne nejen, kterou stránku opravit, ale i který odstavec.

Krok 5: Opravte a uzavřete smyčku

1. Požádejte asistenta, aby si přes get_page přečetl cílovou stránku a navrhl změnu. Když nějaký údaj nezná, řekne vám, že ho musí dodat odborník, místo aby si ho vymyslel.
2. Změnu proveďte ve svém nástroji pro dokumentaci.
3. Požádejte asistenta, aby položku označil jako vyřešenou (mark_feedback_addressed, výsledek docs_updated), uzavřel související hlášení od uživatelů (update_user_feedback, stav resolved) a spustil novou synchronizaci zdroje (trigger_source_resync). Všechny tři kroky vyžadují oprávnění k zápisu.
4. Až synchronizace doběhne, požádejte ho o ověření pomocí search_docs s původním dotazem uživatele.

Novou synchronizaci lze spustit u zdrojů typu web, Confluence a Notion. U nahraných zdrojů (PDF, soubory, tabulky, otázky a odpovědi, OpenAPI) nahrajte upravený soubor v aplikaci.

Vyřešené odpovědi s palcem dolů mají v kartě Negativní zpětná vazba na stránce Analytika > Přehled štítek Dokumentace upravena (případně Není problém dokumentace nebo Nebude opraveno) spolu s doporučenou opravou a jménem toho, kdo položku vyřešil. Vyřešená hlášení od uživatelů zmizí ze seznamu nových hlášení u bota v Nasazení > AI asistenti. Zbytek týmu tak vidí stav, aniž by musel otevírat chat.

Přehled nástrojů

Nástroj	Účel	Oprávnění
list_problem_conversations	Dotazy s palcem dolů, odmítnuté, s nízkou jistotou a nezodpovězené za zvolené období, po stránkách; každý dotaz jen jednou, vložený kód se nepočítá jako nízká jistota	čtení
get_conversation	Celý anonymizovaný přepis s citacemi, zpětnou vazbou a stavem řešení	čtení
search_conversations	Konverzace podle úryvku textu nebo filtru zpětné vazby	čtení
get_content_hotspots	Stránky seřazené podle počtu hlášení od uživatelů, s rozpadem podle typu problému, toho, kdo hlásil, a stavu řešení	čtení
list_user_feedback	Hlášení od uživatelů s citovanou pasáží, informací, kdo hlásil a kolikrát; filtr podle stránky, stavu, typu hlásícího nebo klienta	čtení
list_knowledge_gaps	Znalostní mezery (seskupené dotazy) se zjištěním, doporučením, jistotou a mírou odmítnutí, po stránkách (výchozí 20, u každé až 8 ukázkových dotazů)	čtení
get_top_queries	Nejčastější dotazy se skóre vyhledávání a mírou odmítnutí (posledních 90 dní; bez krátkých odpovědí a vloženého materiálu)	čtení
get_doc_recommendation	Příčina, doporučená akce, cílová stránka a sekce, návrh změny	čtení
search_docs	Prohledání zaindexované dokumentace stejným vyhledáváním, jaké používá bot	čtení
get_page	Celý markdown stránky včetně osnovy nadpisů	čtení
list_bots, list_sources	Seznam botů a zdrojů ve workspace	čtení
mark_feedback_addressed	Zapsat, jak byl problémový dotaz vyřešen	zápis
update_user_feedback	Nastavit hlášení stav nové, zkontrolované, vyřešené nebo zamítnuté (new, reviewed, resolved, dismissed)	zápis
resolve_knowledge_gap	Uzavřít znalostní mezeru	zápis
trigger_source_resync	Naplánovat nové procházení webu nebo synchronizaci přes API	zápis

list_problem_conversations a search_conversations mají volitelný parametr origin (widget, dashboard, api nebo slack), kterým oddělíte koncové uživatele od playgroundu a integrací.

Prompty: get_started (bez parametrů), weekly_docs_review (období, volitelně bot) a triage_one (jedno id zprávy).

Zabezpečení a soukromí

• Přihlášení, ne sdílené klíče. Claude a ChatGPT se připojují přes OAuth s PKCE a přihlašujete se přímo do ChatbotIQ. Osobní přístupové tokeny jsou jen pro klienty bez podpory OAuth, mají omezenou platnost a zobrazí se jen jednou.
• Vázané na člena. Každý token patří konkrétnímu uživateli a workspace. Členství a role se ověřují při každém volání, takže odebrání člena okamžitě ukončí jeho přístup a snížení role odebere oprávnění k zápisu.
• Minimální oprávnění. Výchozí je jen čtení. Oprávnění k zápisu dostanou pouze vlastníci a administrátoři, a to jen tehdy, když o něj klient požádá; na souhlasové stránce ho mohou odškrtnout a připojit se jen pro čtení.
• Maskování osobních údajů. E-maily, telefonní čísla, čísla karet a podobné osobní údaje se v každém textovém poli maskují dřív, než opustí ChatbotIQ. Kontaktní e-maily, adresy stránek, id relací a IP adresy se nepředávají vůbec.
• Nedůvěryhodný obsah. Dotazy, komentáře a hlášení uživatelů jsou data, ne instrukce. To platí i pro citovanou pasáž v hlášení: napsal ji klient, který hlášení podal, i když vypadá jako text vaší dokumentace. Server to asistentovi připomíná při každém volání a označuje položky, které vypadají jako pokus o prompt injection. K označeným položkám přistupujte opatrně.
• Auditní záznam. U každého volání nástroje se ukládá, kdo ho provedl, jakým tokenem, který nástroj a která konverzace. Vlastníci a administrátoři vidí na stránce Zpětná vazba k dokumentaci všechna aktivní připojení a mohou kterékoli z nich zrušit.
• Limity počtu volání. Platí pro token i pro workspace; výpočty doporučení na vyžádání mají ještě vlastní limit.

Řešení problémů

Souhlasová stránka hlásí „This account can’t approve the connection“. Do ChatbotIQ jste přihlášeni jiným účtem, než který je členem workspace, například pracovním místo osobního. Na souhlasové stránce klikněte na Použít jiný účet a přihlaste se účtem, který členem je, nebo požádejte vlastníka workspace, aby váš účet pozval. Tlačítko Zrušit připojování ukončí a můžete začít znovu ze svého MCP klienta.

Souhlasová stránka hlásí „This authorization request has expired“. Odkaz na souhlasovou stránku platí 10 minut. Spusťte připojení znovu ze svého MCP klienta.

Konektor vyžaduje přihlášení stále dokola. Přístupové tokeny platí hodinu a obnovují se automaticky na pozadí. Konektor, který 30 dní nikdo nepoužil, se musí přihlásit znovu. Pokud obnovení selže dřív, někdo mohl připojení na stránce Zpětná vazba k dokumentaci zrušit nebo se změnilo vaše členství. Připojte konektor znovu.

Souhlasová stránka hlásí „Přístup k MCP vyžaduje placený plán pro tento workspace“. Workspace je na tarifu Free, takže tlačítko Povolit přístup zůstane neaktivní. Přejděte na vyšší tarif, nebo o to požádejte vlastníka. Pokud workspace přejde na tarif Free až po připojení, volání nástrojů selžou s hláškou „MCP access is not included in the free plan“.

Nástroj odpoví insufficient_scope. Váš token nebo připojení má jen oprávnění ke čtení. Vlastníci a administrátoři se mohou připojit znovu a oprávnění k zápisu si udělit; běžní členové ne.

trigger_source_resync odpoví resync_unsupported. Zdroj je nahraný soubor, ne web, Confluence ani Notion. Nahrajte upravený soubor v aplikaci a pak výsledek ověřte přes search_docs.

Doporučení říká retrieval_failure, ale já vím, že stránka je chybná. Bot našel stránku, která téma zdánlivě pokrývá. Otevřete ji přes get_page a přečtěte si odpovídající sekci. Pokud je text opravdu chybný, opravte ho a položku označte jako docs_updated. Pokud je stránka v pořádku, nahlaste problém s vyhledáváním správci workspace.

Claude.ai se k serveru nepřipojí. Adresa musí být dostupná z veřejného internetu. Na instalace schované za přístupovou proxy (staging, chráněná vlastní doména) se servery Anthropic ani OpenAI nedostanou.