Dokumentace
Vše, co potřebujete k nastavení a používání Odpovia.
Správa znalostí přes MCP (Cursor, Claude Code)
Od plánu Plus můžete spravovat podklady a nastavení pokynem v Cursoru nebo Claude Code. Návod pro správce a vývojáře vysvětluje připojení přes MCP i kontrolu provedených změn.
Co je MCP a k čemu je to dobré
MCP (Model Context Protocol) je standard, kterým AI nástroje jako Cursor nebo Claude Code komunikují s externími službami. Po připojení můžete v editoru napsat „přidej do znalostí Odpovia tento text o dopravě“ nebo „ukaž mi konverzace s negativním hodnocením“ a nástroj to udělá za vás.
MCP server Odpovia umí: vypsat, přidat (text nebo adresu webu) a smazat zdroje znalostí; vypsat, přečíst a fulltextově prohledat konverzace; přečíst a upravit osobnost bota (roli, tón, délku odpovědí, uvítání, jméno); zobrazit využití plánu a seznam poptávek. Neumí upravovat existující zdroje, nahrávat soubory ani Q&A a neměnit vzhled widgetu – to zůstává v aplikaci. Dostupné od plánu Plus.
Vytvořte API klíč
Otevřít MCP server v aplikaci- V aplikaci otevřete Nastavení → MCP server.
- V kartě API klíče klikněte na Vytvořit klíč, pojmenujte ho podle toho, kde ho použijete (např. „Claude Code – notebook“), a potvrďte.
- Zobrazený klíč začínající
odp_si hned zkopírujte – po zavření okna ho aplikace už nezobrazí, ukládá jen jeho otisk.
Klíč má plný přístup k vašemu účtu, zacházejte s ním jako s heslem. Můžete mít nejvýše 10 aktivních klíčů; nepotřebný zrušíte ikonou koše a připojený nástroj okamžitě ztratí přístup.
Připojte Cursor nebo jiný nástroj s JSON konfigurací
V kartě Nastavení v AI nástroji je připravená konfigurace, kterou zkopírujete tlačítkem Kopírovat. Vložte ji do nastavení MCP serverů vašeho nástroje (v Cursoru soubor
.cursor/mcp.jsonv projektu nebo~/.cursor/mcp.json) a místoVÁŠ_KLÍČdoplňte klíč z předchozího kroku. Server komunikuje přes HTTP, není potřeba nic instalovat.{ "mcpServers": { "odpovio": { "type": "http", "url": "https://api.odpovio.cz/mcp", "headers": { "Authorization": "Bearer VÁŠ_KLÍČ" } } } }Připojte Claude Code
V terminálu spusťte příkaz z aplikace (je zobrazený pod JSON konfigurací) s doplněným klíčem. Připojení ověříte příkazem
claude mcp list.claude mcp add --transport http odpovio https://api.odpovio.cz/mcp --header "Authorization: Bearer VÁŠ_KLÍČ"Spravujte znalosti pokynem v editoru
Nástroj má po připojení k dispozici tyto akce:
list_knowledge_sources,add_knowledge_text,add_knowledge_url(jedna stránka, nebo režim procházení celého webu / sitemapy na povolené doméně),delete_knowledge_source,list_conversations,get_conversation,search_conversations,get_bot_persona,update_bot_persona,get_usage_statsalist_leads.Příklady pokynů: „Přidej do znalostí Odpovia text ‚Doprava a platba‘ s tímto obsahem…“, „Vypiš zdroje znalostí a smaž ten s názvem Ceník 2025“, „Najdi konverzace, kde se ptali na reklamaci“. Nový text je pro bota dostupný zhruba do minuty. Limit je 120 požadavků za minutu na klíč.
Kontrolujte, co editor změnil
Každá změna přes MCP se projeví v aplikaci stejně, jako byste ji udělali ručně: nové zdroje uvidíte v Trénink → Znalosti, změněnou osobnost v Chatbot → Osobnost. Mazání zdroje je nevratné i přes MCP – nechte si nástrojem změny nejdřív vypsat a potvrďte je. V kartě API klíče vidíte u každého klíče, kdy byl naposledy použit.
Hotovo!
Znalosti a osobnost bota spravujete přímo z editoru. Hodí se hlavně agenturám a vývojářům, kteří web i bota upravují v jednom prostředí.
Přejít do aplikace
