MCP Server Integration
ChatReact implementuje Model Context Protocol (MCP), ktorý Vám umožňuje prepojiť Váš účet ChatReact s AI asistentmi ako Claude Desktop, Cursor a ďalšími nástrojmi kompatibilnými s MCP.
Čo je MCP?
Model Context Protocol je otvorený štandard, ktorý umožňuje AI asistentom komunikovať s externými službami a zdrojmi dát. Vďaka integrácii MCP v ChatReact môžete:
- Spravovať chatboty — vytvárať, konfigurovať (persona, jazyky, widget, správanie, obmedzenia), vkladať a mazať chatboty
- Budovať znalostnú bázu — pridávať dokumenty, prehľadávať weby, spravovať prehľadané stránky a hlavné inštrukcie
- Spravovať FAQ — FAQ, kategórie, návrhy, preklady a FAQ widget
- Revidovať rozhovory — hodnotiť konverzácie, priraďovať kategórie dôvery, spúšťať Improvement Agent
- Pracovať s leadmi a formulármi — leady, kategórie leadov, nastavenia capture, kontaktné formuláre a podania
- Pôsobiť ako live chat agent — nastaviť dostupnosť, prevziať čakajúce rozhovory, odpovedať a ukončiť relácie
- Administrovať Vašu spoločnosť — profil, brand farby, členov tímu a pozvánky
- Používať Email Assistant — pripojenia schránok, kategórie, kontakty a aktivita
- Čítať analytiku a notifikácie
Všetko, čo môžete robiť v dashboarde, je dostupné cez MCP (a REST API); len akcie viazané na prehliadač, ako platby, mailbox OAuth, passkeys, vymazanie účtu a správa API kľúčov zostávajú v dashboarde.
Začíname
1. Generovanie API kľúča
- Prejdite do Vášho Dashboard → Spoločnosť → API záložky
- Kliknite na Vytvoriť API kľúč
- Dajte kľúču popisný názov (napr. "Claude Desktop") a vyberte aspoň jedno povolenie
- Skopírujte vygenerovaný kľúč (začína sa na
cr_)
API kľúče sú dostupné v platených plánoch — pozrite si našu Cenovú stránku.
Ukladáte svoj API kľúč bezpečne. Po vytvorení ho nie je možné získať späť.
2. Konfigurácia Vášho MCP klienta
ChatReact MCP server je hosťovaný na https://www.chatreact.ai/api/mcp a komunikuje cez HTTP (JSON-RPC). Autentifikujte sa hlavičkou Authorization: Bearer — akceptovaná je aj hlavička X-API-Key s rovnakým kľúčom.
Cursor IDE
Cursor priamo podporuje vzdialené MCP servery. Pridajte do Vašich Cursor MCP nastavení:
{
"mcpServers": {
"chatreact": {
"url": "https://www.chatreact.ai/api/mcp",
"headers": {
"Authorization": "Bearer cr_your_api_key_here"
}
}
}
}
Claude Desktop
Konfiguračný súbor Claude Desktop podporuje servery založené na príkaze, preto použite štandardný bridge mcp-remote na prepojenie s hosťovaným endpointom:
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 nastavenie vyžaduje nainštalovaný Node.js. Príklad používa hlavičku X-API-Key, pretože niektorí klienti nespracovávajú medzery v argumentoch spoľahlivo.
3. Reštartujte Vášho AI asistenta
Po uložení konfigurácie reštartujte Claude Desktop alebo Cursor, aby sa nadviazalo pripojenie.
Dostupné nástroje
ChatReact MCP vystavuje nižšie uvedené nástroje, zoskupené podľa oblasti. Stĺpec Scope ukazuje povolenie API kľúča, ktoré nástroj vyžaduje (any = každý platný kľúč). Nástroje bežia s tými istými platnými povoleniami, limitmi plánu a vedľajšími účinkami ako operácie podporované v dashboarde. Akcie viazané na prehliadač pre platby, autorizáciu mailboxu, passkey, vymazanie účtu a správu kľúčov zostávajú v dashboarde.
Deštruktívne nástroje (vymazať, resetovať, zavrieť, zlúčiť) pri použití cez Dashboard Assistant žiadajú potvrdenie. Pri volaní cez API kľúč sa vykonajú okamžite.
Účet
| Tool | Description | Scope |
|---|---|---|
account_usage_get | Získať aktuálny plán (tier, status), počítadlá použitia v aktuálnom fakturačnom období (spoločnosti, chatboty, členovia tímu, rozhovory, tokeny) a limity plánu, plus efektívne limity a feature flagy spoločnosti, na ktorú je volanie zamerané. | any |
user_companies | Zoznam všetkých spoločností, ku ktorým má aktuálny používateľ prístup, s používateľovou rolou v každej z nich. | any |
user_notification_mark_read | Označiť jednu z notifikácií aktuálneho používateľa ako prečítanú. | any |
user_notification_preferences_get | Získať preferencie notifikácií aktuálneho používateľa: globálne prepínače email/push, frekvencia/doba/dni digestu, tiché hodiny a nastavenia kanálov podľa typu. | any |
user_notification_preferences_update | Aktualizovať globálne preferencie notifikácií aktuálneho používateľa (prepínače email/push, harmonogram digestu, tiché hodiny). | any |
user_notification_type_setting_update | Povoliť alebo zakázať doručenie email / in-app pre jeden typ notifikácie aktuálneho používateľa (napr. | any |
user_notification_types_list | Zoznam všetkých typov notifikácií zoskupených podľa kategórie (chatbot, leads, live chat, knowledge, team, billing). | any |
user_notification_unread_count | Získať počet neprečítaných notifikácií aktuálneho používateľa. | any |
user_notifications | Zoznam notifikácií aktuálneho používateľa, najnovšie prvé, s kurzorovou pagináciou. | any |
user_notifications_delete_old | Údržba: navždy vymazať notifikácie aktuálneho používateľa, ktoré sú už prečítané a staršie ako 30 dní. | any |
user_notifications_mark_all_read | Označiť všetky notifikácie aktuálneho používateľa ako prečítané. | any |
user_profile | Získať profil aktuálneho používateľa (id, meno, email, rola, subscription tier). | any |
Spoločnosť & Tím
| Tool | Description | Scope |
|---|---|---|
company_chatbots_list | Zoznam všetkých chatbotov pre konkrétnu spoločnosť so súhrnnými štatistikami. | chatbots:read |
company_get | Získať podrobné informácie o spoločnosti: profil, vlastník, nastavenia brandu (farby, email pre notifikácie) a počty. | any |
company_invite_cancel | Zrušiť (vymazať) pozvánku do tímu, aby odkaz prestal fungovať. | company:write |
company_invite_resend | Znovu odoslať čakajúcu pozvánku do tímu: vydá nový token, predĺži expiráciu o 7 dní a znovu odošle pozývací email. | company:write |
company_invites_list | Zoznam pozvánok do tímu spoločnosti (predvolene pending; nastavte includeExpired, aby ste vrátili aj expirované). | company:read |
company_list | Zoznam všetkých spoločností, ku ktorým má používateľ prístup (API kľúče a Dashboard Assistant vidia len svoju vlastnú spoločnosť). | any |
company_logo_remove | Odstrániť logo spoločnosti (vymaže uložený obrázok a vyčistí URL loga). | company:write |
company_member_invite | Pozvať člena tímu emailom s rolou (ADMIN, MANAGER, AGENT alebo VIEWER). | company:write |
company_member_remove | Odstrániť člena tímu zo spoločnosti. | company:write |
company_member_update_role | Zmeniť rolu člena tímu (ADMIN, MANAGER, AGENT alebo VIEWER). | company:write |
company_members_list | Zoznam členov spoločnosti s ich rolami (OWNER, ADMIN, MANAGER, AGENT, VIEWER). | any |
company_settings_update | Aktualizovať nastavenia brandu spoločnosti: primaryColor / secondaryColor (#RRGGBB) a notificationEmail pre recenzie chatov. | company:write |
company_update | Aktualizovať profil spoločnosti: názov (2-100 znakov), popis (max 1000 znakov) alebo web (https:// sa pridá automaticky; pošlite prázdny reťazec pre vymazanie webu/popisu). | company:write |
Správa chatbotov
| Tool | Description | Scope |
|---|---|---|
chatbot_add_instruction | Pridať novú core inštrukciu do chatbota (1-5000 znakov). | chatbots:write |
chatbot_confirm_embed | Označiť chatbota ako embedded na webe (skryje pripomienku nastavenia v dashboarde). | chatbots:write |
chatbot_create | Vytvoriť nového chatbota (rovnako ako wizard v dashboarde). | chatbots:write |
chatbot_delete | Trvalo vymazať chatbota so všetkými jeho FAQ, dokumentmi, chatmi, leadmi a formulármi (nerovná sa spätnému kroku). | chatbots:write |
chatbot_delete_instruction | Vymazať core inštrukciu z chatbota. | chatbots:write |
chatbot_get | Získať podrobné informácie o chatbotovi: všeobecné nastavenia, osobnosť (persona, tonality, jazyky, obmedzenia), nastavenia widgetu, live chat, learning phase, stav embedovania a počty. | chatbots:read |
chatbot_get_embed_code | Získať HTML snippet na inštaláciu chatbota na web (URL skriptu + <script> tag) a informáciu, či bolo embedovanie potvrdené. | chatbots:read |
chatbot_get_instructions | Získať všetky core inštrukcie pre chatbota. | chatbots:read |
chatbot_improve_instructions | Prepísať text core inštrukcie pomocou AI z platformy (rovnako ako 'Improve with AI' v dashboarde). | chatbots:write |
chatbot_learning_phase_get | Získať nastavenia learning-phase chatbota: prednastavené správanie (CAUTIOUS, BALANCED, CONFIDENT), vlastný prompt a či je bot stále v learning phase. | chatbots:read |
chatbot_learning_phase_update | Nastaviť prednastavenie správania learning-phase (CAUTIOUS = odkázať na človeka pri neistote, BALANCED, CONFIDENT) a/alebo vlastný prompt pre learning-phase. | chatbots:write |
chatbot_list | Zoznam všetkých chatbotov, ku ktorým má používateľ prístup, so súhrnnými štatistikami. | chatbots:read |
chatbot_reorder_instructions | Nastaviť poradie core inštrukcií chatbota. | chatbots:write |
chatbot_templates_list | Zoznam šablón chatbota (prednastavenia pre personu, tonality, správy a správanie widgetu), ktoré môžu byť odovzdané ako templateId do chatbot_create, a či ich plán spoločnosti môže používať. | chatbots:read |
chatbot_toggle_active | Aktivovať alebo deaktivovať chatbota. | chatbots:write |
chatbot_toggle_learning | Ukončiť (false) alebo znovu povoliť (true) learning phase chatbota. | chatbots:write |
chatbot_update | Aktualizovať všeobecné nastavenia chatbota: názov, popis, isActive, live chat (liveChatEnabled/liveChatMode, funkcia plánu), showBranding (white-label plány), emaily pre recenzie chatov, auto-generovanie FAQ, legacy coreInstructions text, learning phase (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt). | chatbots:write |
chatbot_update_instruction | Aktualizovať existujúcu core inštrukciu (obsah, isActive, channel, sortOrder). | chatbots:write |
chatbot_update_personality | Aktualizovať osobnosť chatbota: persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), posúvače tonality 1-5, jazyky (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), správy (welcomeMessage, fallbackMessage, proactive greeting) a obmedzenia (blacklistTopics, complianceRules, maxResponseLength, human handoff). | chatbots:write |
widget_settings_get | Získať aktuálne nastavenia widgetu pre chatbota (všetko vzhľadom, branding, správanie a polia pre pre-chat formulár). | chatbots:read |
widget_settings_update | Aktualizovať chat widget chatbota: pozícia (vrátane | chatbots:write |
widget_translations_get | Získať preklady widgetu podľa jazykov pre chatbota: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }. | chatbots:read |
widget_translations_update | Nastaviť preklady widgetu podľa jazykov. | chatbots:write |
Znalostná báza
| Tool | Description | Scope |
|---|---|---|
crawler_job_cancel | Zrušiť PENDING alebo RUNNING crawl job; zostávajúce stránky sa preskočia. | knowledge:write |
crawler_job_get | Získať stav crawl jobu, pokrok (pagesCrawled/pagesFound, tokensUsed) a stav každej stránky. | knowledge:read |
crawler_jobs_list | Zoznam crawl jobov chatbota (najnovšie prvé) so stavom a pokrokom. | knowledge:read |
crawler_limits | Získať limity crawlovania pre plán chatbota (max stránok na crawl, tokeny na stránku, crawly za mesiac) a či možno tento mesiac spustiť nový crawl. | knowledge:read |
crawler_preview_scan | Naskenovať web a vypísať jeho crawliteľné stránky (url, title, isRecommended) bez importovania čohokoľvek. | knowledge:write |
crawler_start | Spustiť crawl job, ktorý importuje vybrané URL do znalostnej bázy chatbota (spracováva sa na pozadí; poll crawler_job_get). | knowledge:write |
knowledge_document_add_from_url | Stiahnuť dokument (PDF, TXT, MD, CSV, JSON, DOCX; max 10 MB) z verejného http(s) URL a pridať ho do znalostnej bázy chatbota. | knowledge:write |
knowledge_document_add_text | Pridať textový alebo markdown dokument do znalostnej bázy chatbota z inline obsahu (max 10 MB). | knowledge:write |
knowledge_document_delete | Vymazať uploadnutý dokument zo znalostnej bázy. | knowledge:write |
knowledge_document_get | Získať detaily uploadnutého dokumentu vrátane stavu spracovania, chybovej správy a krátkodobej download URL. | knowledge:read |
knowledge_documents_list | Zoznam uploadnutých dokumentov (PDF, TXT, MD, CSV, JSON, DOCX) v znalostnej báze chatbota so stavom a veľkosťou. | knowledge:read |
knowledge_page_add | Crawlovať jednu URL a pridať ju do znalostnej bázy chatbota (zlyhá s CONFLICT, keď je URL už indexovaná, FORBIDDEN pri dosiahnutí limitu tokenov). | knowledge:write |
knowledge_page_delete | Vymazať prehľadanú stránku zo znalostnej bázy (odstráni jej vector-store súbor). | knowledge:write |
knowledge_page_get | Získať prehľadanú stránku vrátane markdown obsahu, ktorý bol indexovaný pre chatbota (užitočné na overenie, čo bot vie o stránke). | knowledge:read |
knowledge_page_recrawl | Znova načítať prehľadanú stránku a nahradiť jej indexovaný obsah (napr. | knowledge:write |
knowledge_pages_delete | Vymazať naraz niekoľko prehľadaných stránok chatbota. | knowledge:write |
knowledge_pages_list | Zoznam prehľadaných stránok v znalostnej báze chatbota, voliteľne filtrované podľa domény, stavu alebo vyhľadávacieho termínu (URL/title). | knowledge:read |
knowledge_stats | Prehľad znalostnej bázy chatbota: dokumenty (podľa stavu, veľkosti), prehľadané stránky a weby (podľa stavu), crawl joby, core inštrukcie rozdelené podľa zdroja (manuálne vs improvement agent), FAQ, stav/veľkosť vector store a využitie úložiska vs. | knowledge:read |
knowledge_website_delete | Vymazať všetky prehľadané stránky webu (domény) zo znalostnej bázy chatbota. | knowledge:write |
knowledge_website_recrawl | Znovu prehľadať každú stránku webu (domény) v znalostnej báze chatbota, aby sa obnovil jej obsah. | knowledge:write |
knowledge_website_recrawl_cancel | Zrušiť prebiehajúce znovuprehľadávanie webu: čakajúce (PENDING) stránky domény sa vrátia do predchádzajúceho indexovaného stavu. | knowledge:write |
knowledge_websites_list | Zoznam webov (domén), ktorých stránky sú v znalostnej báze chatbota, s počtami strán podľa stavu a súčtami tokenov. | knowledge:read |
Správa cien
Tieto nástroje spravujú štruktúrované návrhy cien a explicitné schválenia. Uloženie návrhu je oddelené od schválenia presnej verzie; oprávnenosť závisí aj od stavu a platnosti. Existujúce API kľúče automaticky nezískavajú oprávnenia pre ceny. Len vlastník spoločnosti môže udeliť prices:write alebo prices:approve. Volania cez API kľúč sa vykonávajú priamo, preto pred volaním mutácie skontrolujte presný vstup. Pozrite si Prices & services pre zákaznícky workflow.
| Tool | Description | Scope |
|---|---|---|
price_list | Paginovať cez price heads a samostatnú oprávnenosť schválenej verzie. | prices:read |
price_get | Čítať úplný stav položky a revízie. | prices:read |
price_detail | Čítať detail položky s paginovanou históriou revízií. | prices:read |
price_suggestions_list | Paginovať návrhy cien. | prices:read |
price_create | Vytvoriť návrh s ID položky generovaným serverom. | prices:write |
price_edit | Vytvoriť nový návrh z explicitne očakávanej verzie položky. | prices:write |
price_import_csv | Importovať návrhy s explicitným formátom a stabilným import ID pre bezpečné opakovanie. | prices:write |
price_suggestion_apply | Aplikovať vybraného kandidáta návrhu ako návrh. | prices:write |
price_approve | Schváliť jednu explicitne očakávanú verziu položky. | prices:approve |
price_approve_many | Schváliť explicitnú kombináciu ID/verzie atómovo; akákoľvek zastaraná verzia odmietne celú voľbu. | prices:approve |
price_archive | Archivovať položku pri jej explicitne očakávanej verzii. | prices:approve |
Úpravy návrhu zachovávajú predchádzajúcu schválenú revíziu. Formát CSV a desatinný oddeľovač musia byť explicitné; zmenený CSV obsah vyžaduje nové import ID. Všetky operácie sú viazané na spoločnosť API kľúča a špecifikovaného chatbota.
Správa FAQ
| Tool | Description | Scope |
|---|---|---|
faq_cache_purge | Vyčistiť cache dát FAQ widgetu na všetkých prepojených CMS stránkach (WordPress plugin). | faqs:write |
faq_categories_list | Zoznam kategórií FAQ chatbota s počtom FAQ, slugmi, režimom triedenia a prekladmi. | faqs:read |
faq_categories_reorder | Nastaviť poradie kategórií FAQ vo widgete: pozícia v categoryIds sa stane sortOrder. | faqs:write |
faq_category_create | Vytvoriť kategóriu FAQ pre chatbota (slug sa vygeneruje z názvu). | faqs:write |
faq_category_delete | Vymazať kategóriu FAQ. | faqs:write |
faq_category_translations_update | Nahradiť preklady kategórie FAQ, napr. | faqs:write |
faq_category_update | Premenovať kategóriu FAQ alebo zmeniť jej popis, ikonu alebo režim triedenia. | faqs:write |
faq_create | Vytvoriť FAQ pre chatbota. | faqs:write |
faq_delete | Trvalo vymazať FAQ (taktiež ho odstráni zo znalostnej bázy chatbota a vymaže cache widgetu CMS). | faqs:write |
faq_embed_code_get | Získať embed snippet pre FAQ widget: script tag, WordPress shortcode a Shopify Liquid snippet, plus varianty podľa kategórie (použite categorySlug z faq_categories_list na embedovanie len jednej kategórie). | chatbots:read |
faq_get | Získať úplné detaily FAQ: otázka, odpoveď, kategória, stav publikovania, poradie, preklady, SEO polia a štatistiky spätnej väzby. | faqs:read |
faq_list | Zoznam FAQ chatbota (použite chatbot_list na nájdenie chatbotId). | faqs:read |
faq_reorder | Nastaviť poradie zobrazovania FAQ vo widgete. | faqs:write |
faq_suggestion_approve | Schváliť PENDING návrh FAQ: vytvorí publikované FAQ (voliteľne s upravenou otázkou/odpoveďou/kategóriou) a označí návrh ako APPROVED. | faqs:write |
faq_suggestion_get | Získať úplné detaily návrhu FAQ (úplná odpoveď, AI zdôvodnenie, navrhovaná kategória, stav recenzie). | faqs:read |
faq_suggestion_reject | Odmietnuť PENDING návrh FAQ s voliteľným dôvodom. | faqs:write |
faq_suggestions_generate | Nechať AI navrhnúť nové FAQ zo znalostnej bázy chatbota (prehľadané stránky / uploadnuté dokumenty), voliteľne pre jednu kategóriu. | faqs:write |
faq_suggestions_list | Zoznam AI-generovaných návrhov FAQ chatbota (z chat konverzácií alebo faq_suggestions_generate). | faqs:read |
faq_translate | Preložiť otázku a odpoveď FAQ pomocou AI do ostatných podporovaných jazykov chatbota (alebo zadaných targetLanguages) a uložiť výsledok. | faqs:write |
faq_translations_update | Uložiť preklady FAQ podľa jazyka, napr. | faqs:write |
faq_update | Aktualizovať otázku, odpoveď, kategóriu, stav publikovania alebo manuálne poradie FAQ. | faqs:write |
faq_widget_settings_get | Získať nastavenia vzhľadu a správania embedovateľného FAQ widgetu (farby, border radius, titulok, odsadenie, max šírka, allowMultipleOpen, autoOpenFirst, sort mode, preklady titulov). | chatbots:read |
faq_widget_settings_update | Aktualizovať nastavenia FAQ widgetu: farby (hex), borderRadius 0-32, titulok (max 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0-2000 (0 = plná šírka), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name a preklady titulov podľa jazyka. | chatbots:write |
História chatov & spätná väzba
| Tool | Description | Scope |
|---|---|---|
chat_feedback_dismiss | Označiť chat ako revidovaný bez hodnotenia (odstráni ho z čakajúcej fronty, nemení confidence skóre). | chats:write |
chat_feedback_get | Získať jednu recenziu chatu (feedback) s AI analýzou, závažnosťou, kategóriou dôvery, zmenou skóre a prepojenou improvement session. | chats:read |
chat_feedback_list | Zoznam recenzií chatov (riadky feedbacku) chatbota s filterom stavu a počtami. | chats:read |
chat_feedback_set_severity | Prepísať klasifikáciu závažnosti (MINOR|MODERATE|MAJOR|CRITICAL) recenzovaného negatívneho chatu; závažnosť ovplyvňuje pokles confidence skóre. | chats:write |
chat_feedback_stats | Počty relácií podľa review bucketu pre chatbota (celkom, none, pending, positive, negative, reviewed, improved) — štatistické karty na stránke chats v dashboarde. | chats:read |
chat_feedback_submit | Ohodnotiť chatovú reláciu ako Good (isPositive=true) alebo Needs Work (isPositive=false). | chats:write |
chat_session_get | Získať chatovú reláciu s úplným transcriptom (token/model/latencia pre správu/pageUrl návštevníka), detaily návštevníka, URL stránky, kde sa začalo, kategória dôvery, feedback (závažnosť, AI analýza, prepojená improvement session) a tagy. | chats:read |
chat_session_search | Vyhľadávať chatové relácie chatbota podľa obsahu správ a/alebo emailu návštevníka. | chats:read |
chat_session_set_category | Priradiť alebo zmeniť kategóriu dôvery chatovej relácie (opraví AI kategorizáciu; per-category confidence sa prepočíta, keď bol chat revidovaný). | chats:write |
chat_sessions_list | Zoznam chatových relácií chatbota, najnovšie prvé, s rovnakými filtračnými možnosťami fronty recenzií ako stránka chats v dashboarde. | chats:read |
Improvement Agent
| Tool | Description | Scope |
|---|---|---|
confidence_categories_list | Zoznam confidence kategórií chatbota s per-kategóriovým confidence skóre, počtom recenzií a frekvenciou review-emailov. | chats:read |
confidence_category_create | Vytvoriť confidence kategóriu pre chatbota. | chatbots:write |
confidence_category_delete | Vymazať confidence kategóriu. | chatbots:write |
confidence_category_merge | Zlúčiť jednu confidence kategóriu do inej tej istej chatbota: všetky chaty/reviewy sa presunú do cieľa, zdroj sa vymaže a skóre sa prepočítajú. | chatbots:write |
confidence_category_update | Premenovať confidence kategóriu a/alebo nastaviť frekvenciu review-emailov (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1-24 len pre HOURLY). | chatbots:write |
confidence_status_get | Stav dôvery chatbota: skóre, threshold pre graduáciu, flag learning phase, learning-phase správanie (CAUTIOUS|BALANCED|CONFIDENT) a vlastný prompt, počty recenzií a per-kategóriové confidence skóre. | analytics:read |
improvement_proposal_approve | Schváliť PENDING improvement návrh a aplikovať zmenu na chatbota (pridať/aktualizovať core inštrukciu, vytvoriť/aktualizovať FAQ alebo aktualizovať personu) — rovnaká logika a limity plánu ako v dashboarde. | chatbots:write |
improvement_proposal_reject | Odmietnuť PENDING improvement návrh. | chatbots:write |
improvement_proposal_simulate | Simulovať, ako by chatbot odpovedal na problematickú správu s aplikovaným návrhom (originál vs. | chatbots:write |
improvement_proposals_pending | Zoznam improvement návrhov čakajúcich na revíziu (stav PENDING) v rámci spoločnosti alebo pre jedného chatbota. | chatbots:read |
improvement_session_complete | Označiť improvement session ako COMPLETED (chat sa potom počíta ako Improved vo frontove recenzií). | chatbots:write |
improvement_session_create | Otvoriť Improvement Agent pre chat označený Needs Work. | chatbots:write |
improvement_session_get | Získať improvement session s originálnym chatom (správy majú 1-bázový index použiteľný ako targetMessageIndex), konverzáciu agenta, všetky návrhy (s ich najnovšou simuláciou) a simulácie. | chatbots:read |
improvement_session_reset | Reštartovať improvement session: vymaže všetky správy agenta, simulácie a PENDING/REJECTED návrhy (aplikované zostanú) a spustí novú konverzáciu. | chatbots:write |
improvement_session_send_message | Poslať správu Improvement Agentovi (popísať, čo bolo zlé na odpovedi bota; voliteľne targetMessageIndex = 1-bázový index botovej správy v originalChat.messages). | chatbots:write |
improvement_sessions_list | Zoznam improvement session (konverzácie Improvement Agenta spustené z negatívnych recenzií chatov) pre chatbota alebo celú spoločnosť, najnovšie prvé, s počtom návrhov. | chatbots:read |
improvement_simulation_assess | Ohodnotiť výsledok simulácie: isApproved=true keď je simulovaná odpoveď dobrá (návrh potom možno aplikovať), false keď potrebuje ďalšiu prácu (komentár 'almost' = takmer správne). | chatbots:write |
Live Chat
| Tool | Description | Scope |
|---|---|---|
live_chat_agents_available | Získať vlastnú dostupnosť pre live chat aktuálneho používateľa, agentov momentálne dostupných pre live chat (čerstvý heartbeat, ten istý signál, ktorý používa widget) a či plán spoločnosti obsahuje live chat. | chats:read |
live_chat_heartbeat | Obnoviť heartbeat prítomnosti live chatu aktuálneho používateľa (len keď je označený ako dostupný cez live_chat_set_availability). | chats:write |
live_chat_message_send | Poslať správu návštevníkovi ako priradený agent. | chats:write |
live_chat_queue | Získať frontu live chatu: relácie čakajúce na agenta, najstaršie prvé (FIFO). | chats:read |
live_chat_session_assign | Prevziať WAITING live chat reláciu z fronty: priradí ju aktuálnemu používateľovi (vlastník spoločnosti pre API kľúče) a notifikovať návštevníka, že agent sa pripojil. | chats:write |
live_chat_session_close | Ukončiť live chat reláciu ako agent (akýkoľvek ne-VIEWER člen spoločnosti). | chats:write |
live_chat_session_get | Získať live chat reláciu s informáciami o návštevníkovi, priradenom agentovi, všetkými správami a predchádzajúcou bot konverzáciou (handoff context). | chats:read |
live_chat_sessions_list | Zoznam live chat relácií (najnovšie prvé; WAITING relácie najstaršie prvé) s voliteľnými filtrami podľa chatbota, stavu a priradeného agenta. | chats:read |
live_chat_set_availability | Prepínať 'Available for Live Chat' prepínač aktuálneho používateľa pre spoločnosť. | chats:write |
Leads
| Tool | Description | Scope |
|---|---|---|
lead_assign | Priradiť lead členovi spoločnosti alebo ho odregistrovať (assignedToId: null). | leads:write |
lead_bulk_update_status | Nastaviť stav viacerých leadov naraz (max 100). | leads:write |
lead_categories_list | Zoznam kategórií leadov chatbota s počtom leadov a členmi tímu notifikovanými pre každú kategóriu. | leads:read |
lead_category_assign_user | Pridať člena spoločnosti do notifikačného zoznamu kategórie leadov (alebo aktualizovať jeho notifikačné flagy). | leads:write |
lead_category_create | Vytvoriť kategóriu leadov pre chatbota. | leads:write |
lead_category_delete | Vymazať kategóriu leadov. | leads:write |
lead_category_remove_user | Odstrániť člena spoločnosti z notifikačného zoznamu kategórie leadov. | leads:write |
lead_category_update | Aktualizovať názov, popis a/alebo farbu kategórie leadov. | leads:write |
lead_create | Vytvoriť lead manuálne (napr. | leads:write |
lead_delete | Trvalo vymazať lead. | leads:write |
lead_field_config_get | Získať konfiguráciu zachytávania leadov chatbota: polia (id mapujú na kľúče v lead.data), potvrdzujúca správa, preklady polí/UI a nastavenia AI rozpoznávania. | leads:read |
lead_field_config_update | Aktualizovať konfiguráciu zachytávania leadov chatbota. | leads:write |
lead_get | Získať úplné detaily leadu vrátane priradenia, kategórie a zdrojového chat transcriptu (paginované s messageOffset/messageLimit, predvolene prvých 20 správ). | leads:read |
lead_list | Zoznam leadov chatbota (najnovšie prvé) s voliteľnými filtrami podľa stavu, kategórie, priradenia a full-textového vyhľadávania (meno/email/spoločnosť). | leads:read |
lead_stats | Získať štatistiky leadov pre chatbota: počty podľa stavu, leady za posledných 7 dní a konverzný pomer (percentá). | leads:read |
lead_update | Aktualizovať stav leadu, kategóriu, poznámky, zachytené dáta a/alebo priradenie. | leads:write |
Formuláre
| Tool | Description | Scope |
|---|---|---|
form_create | Vytvoriť kontaktný formulár pre chatbota (základy, polia, dizajn a spam nastavenia v jednom volaní). | forms:write |
form_delete | Trvalo vymazať kontaktný formulár a VŠETKY jeho podania (cascade). | forms:write |
form_get | Získať kontaktný formulár v plnom rozsahu: polia, preklady, štýling, spam nastavenia, aktívny stav, počet podaní a embed script tag (embedCode). | forms:read |
form_list | Zoznam kontaktných formulárov chatbota s počtom polí, počtom podaní a embed kódmi. | forms:read |
form_stats | Počty podaní kontaktného formulára: celkom, pending, approved, spam a rejected. | forms:read |
form_submission_delete | Trvalo vymazať podanie kontaktného formulára (napr. | forms:write |
form_submission_get | Získať podanie kontaktného formulára v plnom rozsahu: odoslané dáta polí, spam skóre a AI spam analýza, IP/user agent/referrer metadata a informácie o revízii. | forms:read |
form_submission_update_status | Revidovať podanie kontaktného formulára: nastaviť jeho stav na APPROVED, SPAM alebo REJECTED s voliteľnou poznámkou revízie. | forms:write |
form_submissions_list | Zoznam podaní kontaktného formulára, najnovšie prvé, voliteľne filtrované podľa stavu (PENDING, APPROVED, SPAM, REJECTED) a dátumu vytvorenia. | forms:read |
form_update | Aktualizovať kontaktný formulár: názov, popis, aktívny stav (isActive kontroluje, či sa embed renderuje), polia (úplná náhrada), dizajn (farby, text tlačidla, úspešná správa) a spam nastavenia (spamThreshold, autoRejectSpam, notificationEmail). | forms:write |
form_update_translations | Nahradiť preklady polí a/alebo UI kontaktného formulára. | forms:write |
Email Assistant
| Tool | Description | Scope |
|---|---|---|
email_activity_list | Zoznam logu spracovaných email aktivít pripojenia schránky (najnovšie prvé): odosielateľ, predmet, priradená kategória, výsledok (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) a outcomeDetail. | email:read |
email_categories_list | Zoznam email kategórií pripojenia schránky (zoradené podľa sortOrder). | email:read |
email_category_create | Vytvoriť email kategóriu pre pripojenie schránky (max 20 na pripojenie). | email:write |
email_category_delete | Vymazať email kategóriu. | email:write |
email_category_update | Aktualizovať email kategóriu (čiastočne: len zadané polia sa zmenia). | email:write |
email_connection_disconnect | Trvalo odpojiť schránku. | email:write |
email_connection_get | Získať pripojenie schránky vrátane | email:read |
email_connection_update | Aktualizovať pripojenie schránky: pozastaviť/obnoviť sync (paused true/false; len prepína ACTIVE<->DISABLED, nikdy neprepisuje TOKEN_EXPIRED/ERROR), prepínať tvorbu odpovedí (draftingEnabled) a kategorizovanie/organizovanie (organizingEnabled), preraziť napájací chatbot (chatbotId tej istej spoločnosti) alebo nastaviť HTML podpis odpovede (signatureHtml, max 20000 znakov; prázdny reťazec vymaže podpis). | email:write |
email_connections_list | Zoznam pripojení Email Assistant schránok spoločnosti (adresa, status ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, posledná synchronizácia, posledná chyba, prepínače drafting/organizing, powering chatbot, draftReadyCategoryCount = kategórie, ktoré môžu vytvoriť drafty, baseRuleCount = chatbot-ové 'Chat + Email' pravidlá aplikované na každý draft) spolu s limitmi plánu (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth). | email:read |
email_contact_delete | Vymazať naučený email kontakt (zabudnúť profil odosielateľa, napr. | email:write |
email_contact_get | Získať naučený email kontakt so všetkými naučenými faktami, internými poznámkami, vzťahom, nastavením formálnej/neformálnej adresy a email štatistikami. | email:read |
email_contact_update | Aktualizovať naučený email kontakt. | email:write |
email_contacts_list | Zoznam naučených email kontaktov spoločnosti (najnovší email prvý) s vzťahom, formálna/neformálna adresa (formalAddress: true = formálne 'Vy', false = neformálne 'ty', null = automaticky), počtom faktov a náhľadom poznámok. | email:read |
email_folder_create | Vytvoriť mail priečinok pod inboxom (vráti existujúci, ak je názov obsadený) na použitie ako cieľ presunu kategórie. | email:write |
email_folders_list | Zoznam priečinkov, do ktorých môže email kategória presúvať poštu, naživo zo schránky: inbox subfolders, custom top-level folders, archive, junk a trash (id 'deleteditems'). | email:read |
email_general_rules_list | Zoznam pravidiel platných pre každý reply draft schránky: aktívne core inštrukcie s channel BOTH ("Chat + Email"), plus legacy email-only pravidlá, ktoré ešte neboli migrované do kategórie. | email:read |
Analytika
| Tool | Description | Scope |
|---|---|---|
analytics_chat_volume | Objem chatov (spustené relácie) v čase pre grafy a trendy: obdobie week/month/quarter/year, granularita hour/day/week/month, voliteľne pre jeden chatbot. | analytics:read |
analytics_chatbot_stats | Výkon na chatbota pre spoločnosť v jednom volaní (tabuľka výkonu chatbotov v dashboarde): id, názov, slug, isActive, sessions, messages, FAQs a leads na chatbota, zoradené podľa sessions. | analytics:read |
analytics_forms | Štatistiky podaní kontaktných formulárov pre spoločnosť alebo jeden chatbot (widget analytiky v dashboarde): podania podľa stavu (pending/approved/rejected/spam), počet formulárov, celkom, spam rate v percentách a séria submissions-per-day za posledných 7 dní. | analytics:read |
analytics_leads | Lead funnel pre spoločnosť alebo jeden chatbot (widget analytiky v dashboarde): leady podľa stavu (new/contacted/qualified/converted/lost), celkom, konverzný pomer v percentách a séria leads-per-day za posledných 7 dní. | analytics:read |
analytics_overview | Prehľad analytiky pre spoločnosť alebo jeden chatbot: charty, správy, miera spokojnosti a top otázky za pohyblivé obdobie (day/week/month/year), plus overview widget dashboardu (celkové chatboty/publikované FAQ/leady, sessions dnes/tento týždeň/tento mesiac, leads dnes/tento týždeň, podania formulárov celkom/dnes/pending). | analytics:read |
dashboard_activity | Čo momentálne potrebuje pozornosť (domovská obrazovka dashboardu): podľa spoločnosti, chatboty s novými leadmi dnes, pending FAQ návrhy, pending podania formulárov, čakajúce/aktívne live chaty alebo prebiehajúca learning phase. | any |
Príkladové workflowy
Pridanie core inštrukcie
Požiadajte svojho AI asistenta:
"Pridaj core inštrukciu do môjho chatbota 'Support Bot': ponúkame dopravu zadarmo pri objednávkach nad €50"
Asistent použije chatbot_add_instruction s vhodnými parametrami.
Revízia návrhov na zlepšenie
"Ukáž mi všetky pending improvement návrhy pre môjho chatbota a vysvetli, aké zmeny navrhujú"
Asistent:
- Použije
improvement_proposals_pendingna získanie návrhov - Analyzuje a zhrnie každý návrh
- Schváli alebo odmietne ich vo Vašom mene s
improvement_proposal_approvealeboimprovement_proposal_reject
Analýza výkonu chatov
"Daj mi týždennú správu o objeme chatov a spokojnosti zákazníkov pre môjho chatbota"
Asistent použije analytics_overview a analytics_chat_volume na zostavenie komplexnej správy.
Import webu
"Naskenuj https://example.com,, importuj produktové a cenové stránky do môjho 'Support Bot' a povedz mi, keď crawl skončí"
Asistent zavolá crawler_preview_scan, vyberie relevantné stránky, spustí import s crawler_start a bude pollovať crawler_job_get, kým úloha neskončí.
Revízia leadov a podaní formulárov
"Ukáž mi nové leady z tohto týždňa, priraď kvalifikované Anni a schváľ pending podania kontaktného formulára"
Asistent skombinuje lead_list, lead_assign, form_submissions_list a form_submission_update_status.
Prevzatie live chatu
"Nastav ma ako dostupného pre live chat a prevezmi najstaršiu čakajúcu konverzáciu"
Asistent použije live_chat_set_availability, live_chat_queue a live_chat_session_assign; odpovede prechádzajú cez live_chat_message_send.
Bezpečnosť
- API kľúče sú viazané na Vašu spoločnosť a na povolenia, ktoré vyberiete pri ich vytváraní (pozrite stĺpec Scope vyššie)
- Kľúče vykonávajú operácie s oprávneniami vlastníka spoločnosti; limity plánu a feature gated sa uplatňujú presne ako v dashboarde
- Kľúče je možné kedykoľvek zrušiť z dashboardu
- API prístup je dostupný v platených plánoch — pozrite si našu Cenovú stránku
Riešenie problémov
Pripojenie zlyhalo
- Overte, či je Váš API kľúč správny
- Skontrolujte, či kľúč nebol zrušený
- Uistite sa, že Váš plán obsahuje API prístup
- Reštartujte Váš MCP klient
Nástroj nenájdený
Po zmene konfigurácie reštartujte Váš MCP klient, aby znovu načítal dostupné nástroje. Názvy nástrojov sú v malých písmenách s podčiarkovníkmi (napr. faq_list).
Potrebujete pomoc? Kontaktujte náš tím podpory →