DomovDokumentácia

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

  1. Prejdite do Vášho Dashboard → Spoločnosť → API záložky
  2. Kliknite na Vytvoriť API kľúč
  3. Dajte kľúču popisný názov (napr. "Claude Desktop") a vyberte aspoň jedno povolenie
  4. 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

ToolDescriptionScope
account_usage_getZí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_companiesZoznam 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_readOznačiť jednu z notifikácií aktuálneho používateľa ako prečítanú.any
user_notification_preferences_getZí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_updateAktualizovať globálne preferencie notifikácií aktuálneho používateľa (prepínače email/push, harmonogram digestu, tiché hodiny).any
user_notification_type_setting_updatePovoliť alebo zakázať doručenie email / in-app pre jeden typ notifikácie aktuálneho používateľa (napr.any
user_notification_types_listZoznam všetkých typov notifikácií zoskupených podľa kategórie (chatbot, leads, live chat, knowledge, team, billing).any
user_notification_unread_countZískať počet neprečítaných notifikácií aktuálneho používateľa.any
user_notificationsZoznam 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_readOznačiť všetky notifikácie aktuálneho používateľa ako prečítané.any
user_profileZískať profil aktuálneho používateľa (id, meno, email, rola, subscription tier).any

Spoločnosť & Tím

ToolDescriptionScope
company_chatbots_listZoznam všetkých chatbotov pre konkrétnu spoločnosť so súhrnnými štatistikami.chatbots:read
company_getZískať podrobné informácie o spoločnosti: profil, vlastník, nastavenia brandu (farby, email pre notifikácie) a počty.any
company_invite_cancelZrušiť (vymazať) pozvánku do tímu, aby odkaz prestal fungovať.company:write
company_invite_resendZnovu 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_listZoznam pozvánok do tímu spoločnosti (predvolene pending; nastavte includeExpired, aby ste vrátili aj expirované).company:read
company_listZoznam 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_removeOdstrániť logo spoločnosti (vymaže uložený obrázok a vyčistí URL loga).company:write
company_member_invitePozvať člena tímu emailom s rolou (ADMIN, MANAGER, AGENT alebo VIEWER).company:write
company_member_removeOdstrániť člena tímu zo spoločnosti.company:write
company_member_update_roleZmeniť rolu člena tímu (ADMIN, MANAGER, AGENT alebo VIEWER).company:write
company_members_listZoznam členov spoločnosti s ich rolami (OWNER, ADMIN, MANAGER, AGENT, VIEWER).any
company_settings_updateAktualizovať nastavenia brandu spoločnosti: primaryColor / secondaryColor (#RRGGBB) a notificationEmail pre recenzie chatov.company:write
company_updateAktualizovať 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

ToolDescriptionScope
chatbot_add_instructionPridať novú core inštrukciu do chatbota (1-5000 znakov).chatbots:write
chatbot_confirm_embedOznačiť chatbota ako embedded na webe (skryje pripomienku nastavenia v dashboarde).chatbots:write
chatbot_createVytvoriť nového chatbota (rovnako ako wizard v dashboarde).chatbots:write
chatbot_deleteTrvalo vymazať chatbota so všetkými jeho FAQ, dokumentmi, chatmi, leadmi a formulármi (nerovná sa spätnému kroku).chatbots:write
chatbot_delete_instructionVymazať core inštrukciu z chatbota.chatbots:write
chatbot_getZí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_codeZí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_instructionsZískať všetky core inštrukcie pre chatbota.chatbots:read
chatbot_improve_instructionsPrepísať text core inštrukcie pomocou AI z platformy (rovnako ako 'Improve with AI' v dashboarde).chatbots:write
chatbot_learning_phase_getZí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_updateNastaviť prednastavenie správania learning-phase (CAUTIOUS = odkázať na človeka pri neistote, BALANCED, CONFIDENT) a/alebo vlastný prompt pre learning-phase.chatbots:write
chatbot_listZoznam všetkých chatbotov, ku ktorým má používateľ prístup, so súhrnnými štatistikami.chatbots:read
chatbot_reorder_instructionsNastaviť poradie core inštrukcií chatbota.chatbots:write
chatbot_templates_listZoznam š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_activeAktivovať alebo deaktivovať chatbota.chatbots:write
chatbot_toggle_learningUkončiť (false) alebo znovu povoliť (true) learning phase chatbota.chatbots:write
chatbot_updateAktualizovať 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_instructionAktualizovať existujúcu core inštrukciu (obsah, isActive, channel, sortOrder).chatbots:write
chatbot_update_personalityAktualizovať 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_getZí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_updateAktualizovať chat widget chatbota: pozícia (vrátanechatbots:write
widget_translations_getZískať preklady widgetu podľa jazykov pre chatbota: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }.chatbots:read
widget_translations_updateNastaviť preklady widgetu podľa jazykov.chatbots:write

Znalostná báza

ToolDescriptionScope
crawler_job_cancelZrušiť PENDING alebo RUNNING crawl job; zostávajúce stránky sa preskočia.knowledge:write
crawler_job_getZískať stav crawl jobu, pokrok (pagesCrawled/pagesFound, tokensUsed) a stav každej stránky.knowledge:read
crawler_jobs_listZoznam crawl jobov chatbota (najnovšie prvé) so stavom a pokrokom.knowledge:read
crawler_limitsZí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_scanNaskenovať web a vypísať jeho crawliteľné stránky (url, title, isRecommended) bez importovania čohokoľvek.knowledge:write
crawler_startSpustiť 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_urlStiahnuť 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_textPridať textový alebo markdown dokument do znalostnej bázy chatbota z inline obsahu (max 10 MB).knowledge:write
knowledge_document_deleteVymazať uploadnutý dokument zo znalostnej bázy.knowledge:write
knowledge_document_getZískať detaily uploadnutého dokumentu vrátane stavu spracovania, chybovej správy a krátkodobej download URL.knowledge:read
knowledge_documents_listZoznam uploadnutých dokumentov (PDF, TXT, MD, CSV, JSON, DOCX) v znalostnej báze chatbota so stavom a veľkosťou.knowledge:read
knowledge_page_addCrawlovať 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_deleteVymazať prehľadanú stránku zo znalostnej bázy (odstráni jej vector-store súbor).knowledge:write
knowledge_page_getZí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_recrawlZnova načítať prehľadanú stránku a nahradiť jej indexovaný obsah (napr.knowledge:write
knowledge_pages_deleteVymazať naraz niekoľko prehľadaných stránok chatbota.knowledge:write
knowledge_pages_listZoznam 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_statsPrehľ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_deleteVymazať všetky prehľadané stránky webu (domény) zo znalostnej bázy chatbota.knowledge:write
knowledge_website_recrawlZnovu prehľadať každú stránku webu (domény) v znalostnej báze chatbota, aby sa obnovil jej obsah.knowledge:write
knowledge_website_recrawl_cancelZruš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_listZoznam 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.

ToolDescriptionScope
price_listPaginovať 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_listPaginovať návrhy cien.prices:read
price_createVytvoriť návrh s ID položky generovaným serverom.prices:write
price_editVytvoriť nový návrh z explicitne očakávanej verzie položky.prices:write
price_import_csvImportovať návrhy s explicitným formátom a stabilným import ID pre bezpečné opakovanie.prices:write
price_suggestion_applyAplikovať vybraného kandidáta návrhu ako návrh.prices:write
price_approveSchváliť jednu explicitne očakávanú verziu položky.prices:approve
price_approve_manySchváliť explicitnú kombináciu ID/verzie atómovo; akákoľvek zastaraná verzia odmietne celú voľbu.prices:approve
price_archiveArchivovať 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

ToolDescriptionScope
faq_cache_purgeVyčistiť cache dát FAQ widgetu na všetkých prepojených CMS stránkach (WordPress plugin).faqs:write
faq_categories_listZoznam kategórií FAQ chatbota s počtom FAQ, slugmi, režimom triedenia a prekladmi.faqs:read
faq_categories_reorderNastaviť poradie kategórií FAQ vo widgete: pozícia v categoryIds sa stane sortOrder.faqs:write
faq_category_createVytvoriť kategóriu FAQ pre chatbota (slug sa vygeneruje z názvu).faqs:write
faq_category_deleteVymazať kategóriu FAQ.faqs:write
faq_category_translations_updateNahradiť preklady kategórie FAQ, napr.faqs:write
faq_category_updatePremenovať kategóriu FAQ alebo zmeniť jej popis, ikonu alebo režim triedenia.faqs:write
faq_createVytvoriť FAQ pre chatbota.faqs:write
faq_deleteTrvalo vymazať FAQ (taktiež ho odstráni zo znalostnej bázy chatbota a vymaže cache widgetu CMS).faqs:write
faq_embed_code_getZí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_getZískať úplné detaily FAQ: otázka, odpoveď, kategória, stav publikovania, poradie, preklady, SEO polia a štatistiky spätnej väzby.faqs:read
faq_listZoznam FAQ chatbota (použite chatbot_list na nájdenie chatbotId).faqs:read
faq_reorderNastaviť poradie zobrazovania FAQ vo widgete.faqs:write
faq_suggestion_approveSchvá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_getZískať úplné detaily návrhu FAQ (úplná odpoveď, AI zdôvodnenie, navrhovaná kategória, stav recenzie).faqs:read
faq_suggestion_rejectOdmietnuť PENDING návrh FAQ s voliteľným dôvodom.faqs:write
faq_suggestions_generateNechať 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_listZoznam AI-generovaných návrhov FAQ chatbota (z chat konverzácií alebo faq_suggestions_generate).faqs:read
faq_translatePrelož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_updateUložiť preklady FAQ podľa jazyka, napr.faqs:write
faq_updateAktualizovať otázku, odpoveď, kategóriu, stav publikovania alebo manuálne poradie FAQ.faqs:write
faq_widget_settings_getZí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_updateAktualizovať 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

ToolDescriptionScope
chat_feedback_dismissOznačiť chat ako revidovaný bez hodnotenia (odstráni ho z čakajúcej fronty, nemení confidence skóre).chats:write
chat_feedback_getZí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_listZoznam recenzií chatov (riadky feedbacku) chatbota s filterom stavu a počtami.chats:read
chat_feedback_set_severityPrepí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_statsPoč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_submitOhodnotiť chatovú reláciu ako Good (isPositive=true) alebo Needs Work (isPositive=false).chats:write
chat_session_getZí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_searchVyhľadávať chatové relácie chatbota podľa obsahu správ a/alebo emailu návštevníka.chats:read
chat_session_set_categoryPriradiť 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_listZoznam 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

ToolDescriptionScope
confidence_categories_listZoznam confidence kategórií chatbota s per-kategóriovým confidence skóre, počtom recenzií a frekvenciou review-emailov.chats:read
confidence_category_createVytvoriť confidence kategóriu pre chatbota.chatbots:write
confidence_category_deleteVymazať confidence kategóriu.chatbots:write
confidence_category_mergeZlúč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_updatePremenovať confidence kategóriu a/alebo nastaviť frekvenciu review-emailov (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1-24 len pre HOURLY).chatbots:write
confidence_status_getStav 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_approveSchvá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_rejectOdmietnuť PENDING improvement návrh.chatbots:write
improvement_proposal_simulateSimulovať, ako by chatbot odpovedal na problematickú správu s aplikovaným návrhom (originál vs.chatbots:write
improvement_proposals_pendingZoznam improvement návrhov čakajúcich na revíziu (stav PENDING) v rámci spoločnosti alebo pre jedného chatbota.chatbots:read
improvement_session_completeOznačiť improvement session ako COMPLETED (chat sa potom počíta ako Improved vo frontove recenzií).chatbots:write
improvement_session_createOtvoriť Improvement Agent pre chat označený Needs Work.chatbots:write
improvement_session_getZí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_resetReš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_messagePoslať 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_listZoznam 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_assessOhodnotiť 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

ToolDescriptionScope
live_chat_agents_availableZí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_heartbeatObnoviť 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_sendPoslať správu návštevníkovi ako priradený agent.chats:write
live_chat_queueZískať frontu live chatu: relácie čakajúce na agenta, najstaršie prvé (FIFO).chats:read
live_chat_session_assignPrevziať 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_closeUkončiť live chat reláciu ako agent (akýkoľvek ne-VIEWER člen spoločnosti).chats:write
live_chat_session_getZí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_listZoznam 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_availabilityPrepínať 'Available for Live Chat' prepínač aktuálneho používateľa pre spoločnosť.chats:write

Leads

ToolDescriptionScope
lead_assignPriradiť lead členovi spoločnosti alebo ho odregistrovať (assignedToId: null).leads:write
lead_bulk_update_statusNastaviť stav viacerých leadov naraz (max 100).leads:write
lead_categories_listZoznam kategórií leadov chatbota s počtom leadov a členmi tímu notifikovanými pre každú kategóriu.leads:read
lead_category_assign_userPridať člena spoločnosti do notifikačného zoznamu kategórie leadov (alebo aktualizovať jeho notifikačné flagy).leads:write
lead_category_createVytvoriť kategóriu leadov pre chatbota.leads:write
lead_category_deleteVymazať kategóriu leadov.leads:write
lead_category_remove_userOdstrániť člena spoločnosti z notifikačného zoznamu kategórie leadov.leads:write
lead_category_updateAktualizovať názov, popis a/alebo farbu kategórie leadov.leads:write
lead_createVytvoriť lead manuálne (napr.leads:write
lead_deleteTrvalo vymazať lead.leads:write
lead_field_config_getZí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_updateAktualizovať konfiguráciu zachytávania leadov chatbota.leads:write
lead_getZí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_listZoznam 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_statsZískať štatistiky leadov pre chatbota: počty podľa stavu, leady za posledných 7 dní a konverzný pomer (percentá).leads:read
lead_updateAktualizovať stav leadu, kategóriu, poznámky, zachytené dáta a/alebo priradenie.leads:write

Formuláre

ToolDescriptionScope
form_createVytvoriť kontaktný formulár pre chatbota (základy, polia, dizajn a spam nastavenia v jednom volaní).forms:write
form_deleteTrvalo vymazať kontaktný formulár a VŠETKY jeho podania (cascade).forms:write
form_getZí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_listZoznam kontaktných formulárov chatbota s počtom polí, počtom podaní a embed kódmi.forms:read
form_statsPočty podaní kontaktného formulára: celkom, pending, approved, spam a rejected.forms:read
form_submission_deleteTrvalo vymazať podanie kontaktného formulára (napr.forms:write
form_submission_getZí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_statusRevidovať podanie kontaktného formulára: nastaviť jeho stav na APPROVED, SPAM alebo REJECTED s voliteľnou poznámkou revízie.forms:write
form_submissions_listZoznam 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_updateAktualizovať 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_translationsNahradiť preklady polí a/alebo UI kontaktného formulára.forms:write

Email Assistant

ToolDescriptionScope
email_activity_listZoznam 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_listZoznam email kategórií pripojenia schránky (zoradené podľa sortOrder).email:read
email_category_createVytvoriť email kategóriu pre pripojenie schránky (max 20 na pripojenie).email:write
email_category_deleteVymazať email kategóriu.email:write
email_category_updateAktualizovať email kategóriu (čiastočne: len zadané polia sa zmenia).email:write
email_connection_disconnectTrvalo odpojiť schránku.email:write
email_connection_getZískať pripojenie schránky vrátaneemail:read
email_connection_updateAktualizovať 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_listZoznam 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_deleteVymazať naučený email kontakt (zabudnúť profil odosielateľa, napr.email:write
email_contact_getZí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_updateAktualizovať naučený email kontakt.email:write
email_contacts_listZoznam 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_createVytvoriť 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_listZoznam 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_listZoznam 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

ToolDescriptionScope
analytics_chat_volumeObjem 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_statsVý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_leadsLead 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_overviewPrehľ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:

  1. Použije improvement_proposals_pending na získanie návrhov
  2. Analyzuje a zhrnie každý návrh
  3. Schváli alebo odmietne ich vo Vašom mene s improvement_proposal_approve alebo improvement_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

  1. Overte, či je Váš API kľúč správny
  2. Skontrolujte, či kľúč nebol zrušený
  3. Uistite sa, že Váš plán obsahuje API prístup
  4. 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 →