MCP Server Integration
ChatReact implementuje Model Context Protocol (MCP), který vám umožňuje propojit váš účet ChatReact s AI asistenty jako Claude Desktop, Cursor a dalšími nástroji kompatibilními s MCP.
Co je MCP?
Model Context Protocol je otevřený standard, který umožňuje AI asistentům komunikovat s externími službami a zdroji dat. Díky integraci MCP v ChatReact můžete:
- Spravovat chatovací boty — vytvářet, konfigurovat (persona, jazyky, widget, chování, omezení), vložit a mazat chatboty
- Budovat znalostní bázi — přidávat dokumenty, procházet weby, spravovat procházené stránky a hlavní instrukce
- Spravovat FAQ — FAQ, kategorie, návrhy, překlady a FAQ widget
- Kontrolovat konverzace — hodnotit konverzace, přiřazovat kategorie důvěry, spouštět Improvement Agent
- Pracovat s leady a formuláři — leady, kategorie leadů, nastavení zachytávání, kontaktní formuláře a odeslané záznamy
- Jednat jako agent live chatu — nastavit dostupnost, převzít čekající chaty, odpovídat a uzavírat relace
- Spravovat vaši společnost — profil, barvy značky, členy týmu a pozvánky
- Používat Email Assistant — připojení poštovních schránek, kategorie, kontakty a aktivita
- Číst analytiku a notifikace
Vše, co můžete dělat v dashboardu, je dostupné přes MCP (a REST API); pouze akce vázané na prohlížeč, jako platby, mailbox OAuth, passkeys, smazání účtu a správa API klíčů, zůstávají v dashboardu.
Začínáme
1. Vygenerujte API klíč
- Přejděte do vašeho Přehled → Společnost → API záložky
- Klikněte na Vytvořit API klíč
- Dejte klíči popisný název (např. "Claude Desktop") a vyberte alespoň jedno oprávnění
- Zkopírujte vygenerovaný klíč (začíná na
cr_)
API klíče jsou dostupné v placených tarifech — viz naše Pricing page.
Uložte svůj API klíč bezpečně. Po vytvoření ho nelze znovu získat.
2. Nakonfigurujte svého MCP klienta
ChatReact MCP server je hostovaný na https://www.chatreact.ai/api/mcp a komunikuje přes HTTP (JSON-RPC). Autentizujte se pomocí hlavičky Authorization: Bearer — také je akceptována hlavička X-API-Key se stejným klíčem.
Cursor IDE
Cursor přímo podporuje vzdálené MCP servery. Přidejte do nastavení Cursor MCP:
{
"mcpServers": {
"chatreact": {
"url": "https://www.chatreact.ai/api/mcp",
"headers": {
"Authorization": "Bearer cr_your_api_key_here"
}
}
}
}
Claude Desktop
Konfigurační soubor Claude Desktop podporuje servery spouštěné příkazy, proto použijte standardní most mcp-remote pro připojení k hostovanému endpointu:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"chatreact": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://www.chatreact.ai/api/mcp",
"--header",
"X-API-Key:cr_your_api_key_here"
]
}
}
}
Toto nastavení vyžaduje nainstalovaný Node.js. Příklad používá hlavičku X-API-Key, protože některé klienty nespolehlivě zpracovávají mezery v argumentech.
3. Restartujte svého AI asistenta
Po uložení konfigurace restartujte Claude Desktop nebo Cursor, aby se navázalo spojení.
Dostupné nástroje
ChatReact MCP zpřístupňuje níže uvedené nástroje, seskupené podle oblasti. Sloupec Scope ukazuje oprávnění API klíče, které nástroj vyžaduje (any = každý platný klíč). Nástroje běží se stejnými použitelnými oprávněními, limity plánu a vedlejšími efekty jako operace podporované v dashboardu. Operace vázané na prohlížeč týkající se plateb, autorizace mailboxu, passkeys, mazání účtu a správy klíčů zůstávají v dashboardu.
Destruktivní nástroje (smazat, resetovat, uzavřít, sloučit) vyžadují potvrzení při použití přes Dashboard Assistant. Přes API klíč se provedou okamžitě.
Account
| Tool | Description | Scope |
|---|---|---|
account_usage_get | Získat aktuální plán (tier, stav), počítadla využití v běžném fakturačním období (companies, chatbots, team members, chats, tokens) a limity plánu, plus efektivní limity a feature flagy společnosti, ke které je volání vázáno. | any |
user_companies | Vypsat všechny společnosti, ke kterým má aktuální uživatel přístup, s rolí uživatele v každé z nich. | any |
user_notification_mark_read | Označit jednu z notifikací aktuálního uživatele jako přečtenou. | any |
user_notification_preferences_get | Získat preference notifikací aktuálního uživatele: globální email/push přepínače, frekvence/doba/den v týdnu/datum pro digest, tichá hodiny a nastavení kanálů podle typu. | any |
user_notification_preferences_update | Aktualizovat globální preference notifikací aktuálního uživatele (email/push přepínače, rozvrh digestu, tichá hodina). | any |
user_notification_type_setting_update | Povolí nebo zakáže doručování e-mailem / v aplikaci pro jeden typ notifikace aktuálního uživatele (např. | any |
user_notification_types_list | Vypsat všechny typy notifikací seskupené podle kategorií (chatbot, leads, live chat, knowledge, team, billing). | any |
user_notification_unread_count | Získat počet nepřečtených notifikací aktuálního uživatele. | any |
user_notifications | Vypsat notifikace aktuálního uživatele, nejnovější první, s kurzorovou paginací. | any |
user_notifications_delete_old | Údržba: trvale smazat notifikace aktuálního uživatele, které jsou již přečtené a starší než 30 dní. | any |
user_notifications_mark_all_read | Označit všechny notifikace aktuálního uživatele jako přečtené. | any |
user_profile | Získat profil aktuálního uživatele (id, name, email, role, subscription tier). | any |
Company & Team
| Tool | Description | Scope |
|---|---|---|
company_chatbots_list | Vypsat všechny chatboty pro konkrétní společnost s přehledovými statistikami. | chatbots:read |
company_get | Získat podrobné informace o společnosti: profil, owner, nastavení značky (barvy, notifikační email) a počty. | any |
company_invite_cancel | Zrušit (smazat) týmovou pozvánku, aby odkaz přestal fungovat. | company:write |
company_invite_resend | Znovu odeslat čekající týmovou pozvánku: vydá nový token, prodlouží expiraci o 7 dní a znovu odešle pozvánkový e-mail. | company:write |
company_invites_list | Vypsat týmové pozvánky společnosti (výchozí: pending; nastavte includeExpired pro vrácení i expirovaných). | company:read |
company_list | Vypsat všechny společnosti, ke kterým má uživatel přístup (API klíče a Dashboard Assistant vidí pouze svou vlastní společnost). | any |
company_logo_remove | Odebrat logo společnosti (smaže uložený obrázek a vyčistí logo URL). | company:write |
company_member_invite | Pozvat člena týmu e-mailem s rolí (ADMIN, MANAGER, AGENT nebo VIEWER). | company:write |
company_member_remove | Odebrat člena týmu ze společnosti. | company:write |
company_member_update_role | Změnit roli člena týmu (ADMIN, MANAGER, AGENT nebo VIEWER). | company:write |
company_members_list | Vypsat členy společnosti s jejich rolemi (OWNER, ADMIN, MANAGER, AGENT, VIEWER). | any |
company_settings_update | Aktualizovat nastavení značky společnosti: primaryColor / secondaryColor (#RRGGBB) a notificationEmail pro hodnocení konverzací. | company:write |
company_update | Aktualizovat profil společnosti: název (2-100 znaků), popis (max 1000 znaků) nebo web (https:// se přidá automaticky; předat prázdný řetězec pro vymazání webu/popisu). | company:write |
Chatbot Management
| Tool | Description | Scope |
|---|---|---|
chatbot_add_instruction | Přidat novou hlavní instrukci do chatbotu (1-5000 znaků). | chatbots:write |
chatbot_confirm_embed | Označit chatbot jako embedded na webu (skryje připomenutí nastavení v dashboardu). | chatbots:write |
chatbot_create | Vytvořit nového chatbota (stejné jako průvodce v dashboardu). | chatbots:write |
chatbot_delete | Trvale smazat chatbota se všemi jeho FAQ, dokumenty, chaty, leady a formuláři (nevratné). | chatbots:write |
chatbot_delete_instruction | Smazat hlavní instrukci z chatbotu. | chatbots:write |
chatbot_get | Získat podrobné informace o chatbotu: obecná nastavení, osobnost (persona, tonality, languages, restrictions), nastavení widgetu, live chat, learning phase, embed status a počty. | chatbots:read |
chatbot_get_embed_code | Získat HTML snippet pro instalaci chatbota na web (URL skriptu + <script> tag) a informaci, zda bylo potvrzeno vložení. | chatbots:read |
chatbot_get_instructions | Získat všechny hlavní instrukce pro chatbot. | chatbots:read |
chatbot_improve_instructions | Přepsat text hlavní instrukce pomocí platformního AI vylepšovače (stejné jako 'Improve with AI' v dashboardu). | chatbots:write |
chatbot_learning_phase_get | Získat nastavení learning-phase chatbotu: přednastavení chování (CAUTIOUS, BALANCED, CONFIDENT), vlastní prompt a zda je bot stále v learning phase. | chatbots:read |
chatbot_learning_phase_update | Nastavit předvolbu chování learning-phase (CAUTIOUS = při nejistotě odkázat na člověka, BALANCED, CONFIDENT) a/nebo vlastní prompt pro learning-phase. | chatbots:write |
chatbot_list | Vypsat všechny chatboty, ke kterým má uživatel přístup, s přehledovými statistikami. | chatbots:read |
chatbot_reorder_instructions | Nastavit pořadí hlavních instrukcí chatbota. | chatbots:write |
chatbot_templates_list | Vypsat šablony chatbotů (předvolby pro personu, tonality, messages a chování widgetu), které lze předat jako templateId do chatbot_create, a zda je plán společnosti může použít. | chatbots:read |
chatbot_toggle_active | Aktivovat nebo deaktivovat chatbota. | chatbots:write |
chatbot_toggle_learning | Ukončit (false) nebo znovu povolit (true) learning phase chatbota. | chatbots:write |
chatbot_update | Aktualizovat obecná nastavení chatbota: název, popis, isActive, live chat (liveChatEnabled/liveChatMode, funkce plánu), showBranding (white-label plány), e-maily pro recenze chatu, automatické generování FAQ, legacy coreInstructions text, learning phase (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt). | chatbots:write |
chatbot_update_instruction | Aktualizovat existující hlavní instrukci (content, isActive, channel, sortOrder). | chatbots:write |
chatbot_update_personality | Aktualizovat osobnost chatbota: persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), tonality posuvníky 1-5, jazyky (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), messages (welcomeMessage, fallbackMessage, proactive greeting) a omezení (blacklistTopics, complianceRules, maxResponseLength, human handoff). | chatbots:write |
widget_settings_get | Získat aktuální nastavení widgetu pro chatbota (všechny vzhledové, brandovací, behaviorální a předformulářová pole). | chatbots:read |
widget_settings_update | Aktualizovat chat widget chatbota: pozice (vč. | chatbots:write |
widget_translations_get | Získat překlady widgetu pro jednotlivé jazyky chatbota: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }. | chatbots:read |
widget_translations_update | Nastavit překlady widgetu podle jazyků. | chatbots:write |
Knowledge Base
| Tool | Description | Scope |
|---|---|---|
crawler_job_cancel | Zrušit PENDING nebo RUNNING crawl job; zbývající stránky se přeskočí. | knowledge:write |
crawler_job_get | Získat stav crawl jobu, průběh (pagesCrawled/pagesFound, tokensUsed) a stav každé stránky. | knowledge:read |
crawler_jobs_list | Vypsat crawl joby chatbotu (nejnovější první) se stavem a průběhem. | knowledge:read |
crawler_limits | Získat limity crawlování pro plán chatbotu (max stránek na crawl, tokeny na stránku, crawly za měsíc) a zda lze tento měsíc spustit nový crawl. | knowledge:read |
crawler_preview_scan | Naskenovat web a vypsat jeho prohledatelné stránky (url, title, isRecommended) bez importu čehokoli. | knowledge:write |
crawler_start | Spustit crawl job, který importuje vybrané URL do znalostní báze chatbotu (zpracovává se na pozadí; pollujte crawler_job_get). | knowledge:write |
knowledge_document_add_from_url | Stáhnout dokument (PDF, TXT, MD, CSV, JSON, DOCX; max 10 MB) z veřejné http(s) URL a přidat ho do znalostní báze chatbotu. | knowledge:write |
knowledge_document_add_text | Přidat textový nebo markdown dokument do znalostní báze chatbotu z inline obsahu (max 10 MB). | knowledge:write |
knowledge_document_delete | Smazat nahraný dokument ze znalostní báze. | knowledge:write |
knowledge_document_get | Získat podrobnosti nahraného dokumentu včetně stavu zpracování, chybové zprávy a krátkodobého URL ke stažení. | knowledge:read |
knowledge_documents_list | Vypsat nahrané dokumenty (PDF, TXT, MD, CSV, JSON, DOCX) ve znalostní bázi chatbotu se stavem a velikostí. | knowledge:read |
knowledge_page_add | Projít jednu URL a přidat ji do znalostní báze chatbotu (selže s CONFLICT, pokud je URL již indexována, FORBIDDEN při dosažení limitu tokenů). | knowledge:write |
knowledge_page_delete | Smazat procházenou stránku ze znalostní báze (odstraní její soubor vektorového úložiště). | knowledge:write |
knowledge_page_get | Získat procházenou stránku včetně markdown obsahu, který byl indexován pro chatbota (užitečné pro ověření, co bot o stránce ví). | knowledge:read |
knowledge_page_recrawl | Znovu stáhnout procházenou stránku a nahradit její indexovaný obsah (např. | knowledge:write |
knowledge_pages_delete | Smazat více procházených stránek chatbotu najednou. | knowledge:write |
knowledge_pages_list | Vypsat procházené stránky ve znalostní bázi chatbotu, volitelně filtrované podle domény, stavu nebo vyhledávacího výrazu (URL/title). | knowledge:read |
knowledge_stats | Přehled znalostní báze chatbotu: dokumenty (podle stavu, velikosti), procházené stránky a weby (podle stavu), crawl joby, hlavní instrukce rozdělené podle zdroje (ruční vs. improvement agent), FAQ, stav/velikost vektorového úložiště a využití úložiště vs. | knowledge:read |
knowledge_website_delete | Smazat všechny procházené stránky webu (domény) ze znalostní báze chatbotu. | knowledge:write |
knowledge_website_recrawl | Znovu projít každou stránku webu (domény) ve znalostní bázi chatbotu pro obnovení obsahu. | knowledge:write |
knowledge_website_recrawl_cancel | Zrušit probíhající re-crawl webu: frontované (PENDING) stránky domény se vrátí do předchozího indexovaného stavu. | knowledge:write |
knowledge_websites_list | Vypsat weby (domény), jejichž stránky jsou ve znalostní bázi chatbotu, s počty stránek podle stavu a celkovými tokeny. | knowledge:read |
Price Management
Tyto nástroje spravují strukturované návrhy cen a explicitní schválení. Uložení návrhu je oddělené od schválení přesné verze; způsobilost také závisí na stavu a platnosti. Existující API klíče automaticky nezískávají cenová oprávnění. Pouze vlastník společnosti může udělit prices:write nebo prices:approve. Volání přes API klíč se vykonávají přímo, proto před mutací důkladně zkontrolujte vstup. Viz Prices & services pro zákaznický workflow.
| Tool | Description | Scope |
|---|---|---|
price_list | Stránkovat přes price heads a samostatně zjišťovat způsobilost schvářené verze. | prices:read |
price_get | Číst kompletní stav položky a revize. | prices:read |
price_detail | Číst detail položky s stránkovanou historií revizí. | prices:read |
price_suggestions_list | Stránkovat přes návrhy cen. | prices:read |
price_create | Vytvořit návrh s ID položky generovaným serverem. | prices:write |
price_edit | Vytvořit nový návrh z explicitně očekávané verze položky. | prices:write |
price_import_csv | Importovat návrhy s explicitním formatem a stabilním import ID pro bezpečné opakování. | prices:write |
price_suggestion_apply | Aplikovat vybraného kandidáta návrhu jako návrh. | prices:write |
price_approve | Schválit jednu explicitně očekávanou verzi položky. | prices:approve |
price_approve_many | Schválit výběr ID/verze atomicky; jakákoli zastaralá verze odmítne celý výběr. | prices:approve |
price_archive | Archivovat položku v její explicitně očekávané verzi. | prices:approve |
Úpravy návrhů zachovávají předchozí schválenou revizi. Formát CSV a desetinný separátor musí být explicitní; změněný CSV obsah vyžaduje nové import ID. Všechny operace jsou vázány na společnost API klíče a specifikovaného chatbota.
FAQ Management
| Tool | Description | Scope |
|---|---|---|
faq_cache_purge | Vyčistit cache dat FAQ widgetu na všech připojených CMS stránkách (WordPress plugin). | faqs:write |
faq_categories_list | Vypsat kategorie FAQ chatbota s počtem FAQ, slugy, režimem řazení a překlady. | faqs:read |
faq_categories_reorder | Nastavit pořadí kategorií FAQ ve widgetu: pozice v categoryIds se stane sortOrder. | faqs:write |
faq_category_create | Vytvořit kategorii FAQ pro chatbot (slug se generuje z názvu). | faqs:write |
faq_category_delete | Smazat kategorii FAQ. | faqs:write |
faq_category_translations_update | Nahradit překlady kategorie FAQ, např. | faqs:write |
faq_category_update | Přejmenovat kategorii FAQ nebo změnit její popis, ikonu či režim řazení. | faqs:write |
faq_create | Vytvořit FAQ pro chatbot. | faqs:write |
faq_delete | Trvale smazat FAQ (také jej odstraní ze znalostní báze chatbotu a vyprázdní cache widgetu v CMS). | faqs:write |
faq_embed_code_get | Získat embed snippety pro FAQ widget: script tag, WordPress shortcode a Shopify Liquid snippet, plus per-category varianty (použijte categorySlug z faq_categories_list pro vložení pouze jedné kategorie). | chatbots:read |
faq_get | Získat kompletní detaily FAQ: otázka, odpověď, kategorie, stav publikace, pořadí, překlady, SEO pole a statistiky zpětné vazby. | faqs:read |
faq_list | Vypsat FAQ chatbota (použijte chatbot_list pro získání chatbotId). | faqs:read |
faq_reorder | Nastavit pořadí zobrazení FAQ ve widgetu. | faqs:write |
faq_suggestion_approve | Schválit PENDING návrh FAQ: vytvoří publikované FAQ (volitelně s upravenou otázkou/odpovědí/kategorií) a označí návrh jako APPROVED. | faqs:write |
faq_suggestion_get | Získat kompletní detaily návrhu FAQ (úplná odpověď, AI reasoning, navrhovaná kategorie, stav recenze). | faqs:read |
faq_suggestion_reject | Odmítnout PENDING návrh FAQ s nepovinným důvodem. | faqs:write |
faq_suggestions_generate | Nechat AI navrhnout nová FAQ ze znalostní báze chatbotu (crawlované stránky / nahrané dokumenty), volitelně pro jednu kategorii. | faqs:write |
faq_suggestions_list | Vypsat AI-generované návrhy FAQ chatbotu (z chat konverzací nebo faq_suggestions_generate). | faqs:read |
faq_translate | Přeložit otázku a odpověď FAQ pomocí AI do dalších podporovaných jazyků chatbotu (nebo do daných targetLanguages) a uložit výsledek. | faqs:write |
faq_translations_update | Uložit překlady FAQ podle jazyka, např. | faqs:write |
faq_update | Aktualizovat otázku, odpověď, kategorii, stav publikace nebo manuální pořadí FAQ. | faqs:write |
faq_widget_settings_get | Získat nastavení vzhledu a chování vkládacího FAQ widgetu (barvy, border radius, titul, mezery, max width, allowMultipleOpen, autoOpenFirst, režim řazení, překlady názvu). | chatbots:read |
faq_widget_settings_update | Aktualizovat nastavení FAQ widgetu: barvy (hex), borderRadius 0-32, title (max 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0-2000 (0 = plná šířka), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name a překlady titulu podle jazyka. | chatbots:write |
Chat History & Feedback
| Tool | Description | Scope |
|---|---|---|
chat_feedback_dismiss | Označit chat jako zrevidovaný bez jeho ohodnocení (vyčistí ho z fronty pending, nemění confidence skóre). | chats:write |
chat_feedback_get | Získat jednu recenzi chatu (feedback) s AI analýzou, závažností, kategorií důvěry, změnou skóre a připojenou improvement session. | chats:read |
chat_feedback_list | Vypsat recenze chatu (řádky feedbacku) chatbotu s filtrem stavu a počty. | chats:read |
chat_feedback_set_severity | Přepsat klasifikaci závažnosti (MINOR|MODERATE|MAJOR|CRITICAL) u zrevidovaného negativního chatu; závažnost ovlivňuje pokles confidence skóre. | chats:write |
chat_feedback_stats | Počty relací podle review bucketu pro chatbot (total, none, pending, positive, negative, reviewed, improved) — karty statistik na stránce chatů v dashboardu. | chats:read |
chat_feedback_submit | Ohodnotit chat relaci jako Good (isPositive=true) nebo Needs Work (isPositive=false). | chats:write |
chat_session_get | Získat chat relaci s kompletním přepisem (token/model/latence pro každou zprávu/pageUrl), detailami návštěvníka, URL spuštěné stránky, kategorií důvěry, feedbackem (závažnost, AI analýza, připojená improvement session) a tagy. | chats:read |
chat_session_search | Vyhledávat chat relace chatbotu podle obsahu zpráv a/nebo e-mailu návštěvníka. | chats:read |
chat_session_set_category | Přiřadit nebo změnit kategorii důvěry chat relace (opravuje AI kategorizaci; per-category confidence se přepočítá, když byl chat revidován). | chats:write |
chat_sessions_list | Vypsat chat relace chatbotu, nejnovější první, se stejnými filtry fronty recenzí jako stránka chatů v dashboardu. | chats:read |
Improvement Agent
| Tool | Description | Scope |
|---|---|---|
confidence_categories_list | Vypsat confidence kategorie chatbotu s per-category confidence skóre, počtem recenzí a frekvencí e-mailů pro recenze. | chats:read |
confidence_category_create | Vytvořit confidence kategorii pro chatbot. | chatbots:write |
confidence_category_delete | Smazat confidence kategorii. | chatbots:write |
confidence_category_merge | Sloučit jednu confidence kategorii do jiné ve stejném chatbotu: všechny chaty/recenze se přesunou do cíle, zdroj se smaže a skóre se přepočítají. | chatbots:write |
confidence_category_update | Přejmenovat confidence kategorii a/nebo nastavit frekvenci zasílání review e-mailů (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1-24 pouze pro HOURLY). | chatbots:write |
confidence_status_get | Stav důvěry chatbotu: skóre, threshold pro graduaci, flag learning phase, chování learning-phase (CAUTIOUS|BALANCED|CONFIDENT) a vlastní prompt, počty recenzí a per-category confidence skóre. | analytics:read |
improvement_proposal_approve | Schválit PENDING návrh na zlepšení a aplikovat změnu na chatbota (přidání/aktualizace hlavní instrukce, vytvoření/aktualizace FAQ nebo aktualizace persony) — stejná logika a limity plánu jako v dashboardu. | chatbots:write |
improvement_proposal_reject | Odmítnout PENDING návrh zlepšení. | chatbots:write |
improvement_proposal_simulate | Simulovat, jak by chatbot odpověděl na problematickou zprávu s aplikovaným návrhem (originál vs. | chatbots:write |
improvement_proposals_pending | Vypsat návrhy ke zlepšení čekající na revizi (stav PENDING) napříč společností nebo pro jeden chatbot. | chatbots:read |
improvement_session_complete | Označit improvement session jako COMPLETED (chat se pak počítá jako Improved ve frontě recenzí). | chatbots:write |
improvement_session_create | Otevřít Improvement Agent pro chat ohodnocený jako Needs Work. | chatbots:write |
improvement_session_get | Získat improvement session s originálním chatem (zprávy mají 1-based index použitelný jako targetMessageIndex), agentní konverzaci, všechny návrhy (s jejich poslední simulací) a simulace. | chatbots:read |
improvement_session_reset | Restartovat improvement session: smaže všechny agentní zprávy, simulace a PENDING/REJECTED návrhy (aplikované se ponechají) a spustí novou konverzaci. | chatbots:write |
improvement_session_send_message | Poslat zprávu Improvement Agentovi (popište, co bylo špatně s odpovědí bota; volitelně targetMessageIndex = 1-based index botovy zprávy v originalChat.messages). | chatbots:write |
improvement_sessions_list | Vypsat improvement sessions (konverzace Improvement Agentu zahájené z negativních recenzí) pro chatbot nebo celou společnost, nejnovější první, s počty návrhů. | chatbots:read |
improvement_simulation_assess | Ohodnotit výsledek simulace: isApproved=true pokud je simulovaná odpověď dobrá (návrh lze poté aplikovat), false pokud je potřeba další práce (komentář 'almost' = téměř správně). | chatbots:write |
Live Chat
| Tool | Description | Scope |
|---|---|---|
live_chat_agents_available | Získat vlastní dostupnost pro live chat aktuálního uživatele, agenty aktuálně dostupné pro live chat (aktuální heartbeat, stejný signál, který používá widget) a zda plán společnosti zahrnuje live chat. | chats:read |
live_chat_heartbeat | Obnovit heartbeat přítomnosti aktuálního uživatele pro live chat (pouze když je označen jako dostupný přes live_chat_set_availability). | chats:write |
live_chat_message_send | Poslat zprávu návštěvníkovi jako přiřazený agent. | chats:write |
live_chat_queue | Získat frontu live chatu: relace čekající na agenta, nejstarší první (FIFO). | chats:read |
live_chat_session_assign | Vzít WAITING live chat relaci z fronty: přiřadí ji aktuálnímu uživateli (vlastník společnosti pro API klíče) a upozorní návštěvníka, že agent vstoupil. | chats:write |
live_chat_session_close | Ukončit live chat relaci jako agent (jakýkoli člen společnosti kromě VIEWER). | chats:write |
live_chat_session_get | Získat live chat relaci s informacemi o návštěvníkovi, přiřazeném agentovi, všemi zprávami a předchozí bot konverzací (handoff context). | chats:read |
live_chat_sessions_list | Vypsat live chat relace (nejnovější první; WAITING relace nejstarší první) s volitelnými filtry podle chatbotu, stavu a přiřazeného agenta. | chats:read |
live_chat_set_availability | Přepnout přepínač 'Available for Live Chat' současného uživatele pro společnost. | chats:write |
Leads
| Tool | Description | Scope |
|---|---|---|
lead_assign | Přiřadit lead členu společnosti nebo ho od přiřazení odpojit (assignedToId: null). | leads:write |
lead_bulk_update_status | Nastavit stav několika leadů najednou (max 100). | leads:write |
lead_categories_list | Vypsat kategorie leadů chatbotu s počty leadů a členy týmu upozorněnými pro každou kategorii. | leads:read |
lead_category_assign_user | Přidat člena společnosti do notifikačního seznamu kategorie leadů (nebo aktualizovat jeho notifikační flagy). | leads:write |
lead_category_create | Vytvořit kategorii leadů pro chatbot. | leads:write |
lead_category_delete | Smazat kategorii leadů. | leads:write |
lead_category_remove_user | Odebrat člena společnosti ze notifikačního seznamu kategorie leadů. | leads:write |
lead_category_update | Aktualizovat název, popis a/nebo barvu kategorie leadů. | leads:write |
lead_create | Vytvořit lead ručně (např. | leads:write |
lead_delete | Trvale smazat lead. | leads:write |
lead_field_config_get | Získat konfiguraci zachytávání leadů chatbotu: pole (ids mapují na klíče v lead.data), potvrzovací zprávu, překlady polí/UI a nastavení AI rozpoznávání. | leads:read |
lead_field_config_update | Aktualizovat konfiguraci zachytávání leadů chatbotu. | leads:write |
lead_get | Získat úplné detaily leadu včetně přiřazeného, kategorie a zdrojového chat přepisu (stránkováno s messageOffset/messageLimit, výchozích prvních 20 zpráv). | leads:read |
lead_list | Vypsat leady chatbotu (nejnovější první) s volitelnými filtry podle stavu, kategorie, přiřazeného a fulltextového vyhledávání (name/email/company). | leads:read |
lead_stats | Získat statistiky leadů pro chatbot: počty podle stavu, leady za posledních 7 dní a konverzní poměr (v procentech). | leads:read |
lead_update | Aktualizovat status, kategorii, poznámky, zachycená data a/nebo přiřazeného leadu. | leads:write |
Forms
| Tool | Description | Scope |
|---|---|---|
form_create | Vytvořit kontaktní formulář pro chatbot (základ, pole, design a nastavení proti spamu v jednom volání). | forms:write |
form_delete | Trvale smazat kontaktní formulář a VŠECHNY jeho odeslané záznamy (kaskáda). | forms:write |
form_get | Získat kontaktní formulář kompletně: pole, překlady, styling, nastavení proti spamu, stav aktivace, počet odeslání a embed skript (embedCode). | forms:read |
form_list | Vypsat kontaktní formuláře chatbotu s počty polí, počty odeslání a embed kódy. | forms:read |
form_stats | Počty odeslání kontaktního formuláře: total, pending, approved, spam a rejected. | forms:read |
form_submission_delete | Trvale smazat odeslání kontaktního formuláře (např. | forms:write |
form_submission_get | Získat odeslání kontaktního formuláře kompletně: odeslaná data polí, spam skóre a AI analýza spamu, IP/user agent/referrer metadata a informace o revizi. | forms:read |
form_submission_update_status | Provést revizi odeslání kontaktního formuláře: nastavit jeho stav na APPROVED, SPAM nebo REJECTED s nepovinnou poznámkou. | forms:write |
form_submissions_list | Vypsat odeslání kontaktního formuláře, nejnovější první, volitelně filtrované podle stavu (PENDING, APPROVED, SPAM, REJECTED) a data vytvoření. | forms:read |
form_update | Aktualizovat kontaktní formulář: název, popis, aktivní stav (isActive kontroluje, zda se embed vykreslí), pole (úplná náhrada), design (barvy, text tlačítka, zpráva o úspěchu) a nastavení proti spamu (spamThreshold, autoRejectSpam, notificationEmail). | forms:write |
form_update_translations | Nahradit překlady polí a/nebo UI kontaktního formuláře. | forms:write |
Email Assistant
| Tool | Description | Scope |
|---|---|---|
email_activity_list | Vypsat zpracovaný activity log e-mailů připojené poštovní schránky (nejnovější první): odesílatel, předmět, přiřazená kategorie, výsledek (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) a outcomeDetail. | email:read |
email_categories_list | Vypsat e-mailové kategorie připojení poštovní schránky (seřazeno podle sortOrder). | email:read |
email_category_create | Vytvořit e-mailovou kategorii pro připojení poštovní schránky (max 20 na připojení). | email:write |
email_category_delete | Smazat e-mailovou kategorii. | email:write |
email_category_update | Aktualizovat e-mailovou kategorii (částečně: změní se pouze uvedená pole). | email:write |
email_connection_disconnect | Trvale odpojit poštovní schránku. | email:write |
email_connection_get | Získat připojení poštovní schránky včetně | email:read |
email_connection_update | Aktualizovat připojení poštovní schránky: pozastavit/obnovit synchronizaci (paused true/false; pouze přepíná ACTIVE<->DISABLED, nikdy neoverride TOKEN_EXPIRED/ERROR), přepnout vytváření návrhů odpovědí (draftingEnabled) a kategorizaci/organizaci (organizingEnabled), přesměrovat napájejícího chatbota (chatbotId téže společnosti) nebo nastavit HTML podpis odpovědi (signatureHtml, max 20000 znaků; prázdný řetězec vymaže). | email:write |
email_connections_list | Vypsat připojení Email Assistant mailboxů společnosti (adresa, stav ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, poslední sync, poslední chyba, přepínače drafting/organizing, powering chatbot, draftReadyCategoryCount = kategorie, které mohou vytvořit návrhy, baseRuleCount = chatbot-wide 'Chat + Email' pravidla aplikovaná na každý návrh) spolu s limity plánu (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth). | email:read |
email_contact_delete | Smazat naučený e-mailový kontakt (zapomenout profil odesílatele, např. | email:write |
email_contact_get | Získat naučený e-mailový kontakt se všemi naučenými fakty, interními poznámkami, vztahem, nastavením formální/neformální oslovení a statistikami e-mailů. | email:read |
email_contact_update | Aktualizovat naučený e-mailový kontakt. | email:write |
email_contacts_list | Vypsat naučené e-mailové kontakty společnosti (nejnovější e-mail první) s vztahem, formálním/neformálním oslovením (formalAddress: true = formální 'Vy', false = neformální 'ty', null = automaticky), počtem faktů a náhledem poznámek. | email:read |
email_folder_create | Vytvořit složku pošty pod inboxem (vrátí existující, pokud je název obsazen) k použití jako cíl pro přesunutí kategorií. | email:write |
email_folders_list | Vypsat složky, do kterých může e-mailová kategorie přesouvat poštu přímo z mailboxu: podadresáře inboxu, vlastní top-level složky, archiv, nevyžádaná pošta a koš (id 'deleteditems'). | email:read |
email_general_rules_list | Vypsat pravidla platná pro všechny návrhy odpovědí mailboxu: aktivní hlavní instrukce s channel BOTH ("Chat + Email"), plus legacy email-only pravidla, která ještě nebyla migrována do kategorie. | email:read |
Analytics
| Tool | Description | Scope |
|---|---|---|
analytics_chat_volume | Objem chatů (zahájené relace) v čase pro grafy a trendy: period week/month/quarter/year, granularita hour/day/week/month, volitelně pro jednoho chatbota. | analytics:read |
analytics_chatbot_stats | Výkon po jednotlivých chatbotech společnosti v jednom volání (tabulka výkonu chatbotů v dashboardu): id, name, slug, isActive, sessions, messages, FAQs a leads na chatbot, seřazeno podle sessions. | analytics:read |
analytics_forms | Statistiky odeslání kontaktních formulářů pro společnost nebo jednoho chatbota (widget analytiky v dashboardu): odeslání podle stavu (pending/approved/rejected/spam), počet formulářů, celkem, procento spamu a série submissions-per-day za posledních 7 dní. | analytics:read |
analytics_leads | Lead funnel pro společnost nebo jednoho chatbota (widget analytiky v dashboardu): leady podle stavu (new/contacted/qualified/converted/lost), celkem, konverzní poměr v procentech a série leads-per-day za posledních 7 dní. | analytics:read |
analytics_overview | Přehled analytiky pro společnost nebo jednoho chatbota: chaty, zprávy, míra spokojenosti a top otázky za rolovací období (day/week/month/year), plus overview widget dashboardu (celkem chatbotů/publikovaných FAQ/leads, sessions dnes/tento týden/tento měsíc, leads dnes/tento týden, odeslání formulářů celkem/dnes/pending). | analytics:read |
dashboard_activity | Co aktuálně vyžaduje pozornost (domovská stránka dashboardu): podle společnosti, chatboti s novými leady dnes, pending návrhy FAQ, pending odeslání formulářů, čekající/aktivní live chaty nebo probíhající learning phase. | any |
Příkladné workflowy
Přidání hlavní instrukce
Požádejte svého AI asistenta:
"Přidejte hlavní instrukci do mého chatbota 'Support Bot': nabízíme dopravu zdarma na objednávky nad 50 €"
Asistent použije chatbot_add_instruction s příslušnými parametry.
Kontrola návrhů na vylepšení
"Ukaž mi všechny čekající návrhy na vylepšení pro mého chatbota a vysvětli, jaké změny navrhují"
Asistent:
- Použije
improvement_proposals_pendingpro získání návrhů - Analyzuje a shrne každý návrh
- Schválí nebo odmítne je vaším jménem pomocí
improvement_proposal_approveneboimprovement_proposal_reject
Analýza výkonu chatu
"Dejte mi týdenní zprávu o objemu chatů a spokojenosti zákazníků pro mého chatbota"
Asistent použije analytics_overview a analytics_chat_volume ke sestavení komplexní zprávy.
Import webu
"Naskenujte https://example.com, a naimportujte stránky produktů a cen do mého 'Support Bot' a dejte mi vědět, až bude crawl hotový"
Asistent zavolá crawler_preview_scan, vybere relevantní stránky, spustí import pomocí crawler_start a bude pollovat crawler_job_get, dokud job neskončí.
Kontrola leadů a odeslání formulářů
"Ukaž mi nové leady z tohoto týdne, přiřaď kvalifikované Anně a schval pending odeslání kontaktních formulářů"
Asistent zkombinuje lead_list, lead_assign, form_submissions_list a form_submission_update_status.
Převzetí live chatu
"Nastav mě jako dostupného pro live chat a vezmi nejstarší čekající konverzaci"
Asistent použije live_chat_set_availability, live_chat_queue a live_chat_session_assign; odpovědi jdou přes live_chat_message_send.
Zabezpečení
- API klíče jsou vázány na vaši společnost a na oprávnění, která vyberete při jejich vytvoření (viz sloupec Scope výše)
- Klíče se vykonávají s oprávněními vlastníka společnosti; limity plánu a feature gates se uplatňují stejně jako v dashboardu
- Klíče lze kdykoli zrušit v dashboardu
- API přístup je dostupný v placených tarifech — viz naše Pricing page
Řešení problémů
Spojení selhalo
- Ověřte, že je váš API klíč správný
- Zkontrolujte, zda klíč nebyl zrušen
- Ujistěte se, že váš plán zahrnuje API přístup
- Restartujte svého MCP klienta
Nástroj nenalezen
Restartujte svého MCP klienta po změně konfigurace, aby znovu načetl dostupné nástroje. Názvy nástrojů jsou malými písmeny s podtržítky (např. faq_list).
Potřebujete pomoc? Kontaktujte náš support tým →