DomůDokumentace

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íč

  1. Přejděte do vašeho Přehled → Společnost → API záložky
  2. Klikněte na Vytvořit API klíč
  3. Dejte klíči popisný název (např. "Claude Desktop") a vyberte alespoň jedno oprávnění
  4. 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

ToolDescriptionScope
account_usage_getZí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_companiesVypsat 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_readOznačit jednu z notifikací aktuálního uživatele jako přečtenou.any
user_notification_preferences_getZí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_updateAktualizovat globální preference notifikací aktuálního uživatele (email/push přepínače, rozvrh digestu, tichá hodina).any
user_notification_type_setting_updatePovolí nebo zakáže doručování e-mailem / v aplikaci pro jeden typ notifikace aktuálního uživatele (např.any
user_notification_types_listVypsat všechny typy notifikací seskupené podle kategorií (chatbot, leads, live chat, knowledge, team, billing).any
user_notification_unread_countZískat počet nepřečtených notifikací aktuálního uživatele.any
user_notificationsVypsat 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_readOznačit všechny notifikace aktuálního uživatele jako přečtené.any
user_profileZískat profil aktuálního uživatele (id, name, email, role, subscription tier).any

Company & Team

ToolDescriptionScope
company_chatbots_listVypsat všechny chatboty pro konkrétní společnost s přehledovými statistikami.chatbots:read
company_getZískat podrobné informace o společnosti: profil, owner, nastavení značky (barvy, notifikační email) a počty.any
company_invite_cancelZrušit (smazat) týmovou pozvánku, aby odkaz přestal fungovat.company:write
company_invite_resendZnovu 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_listVypsat týmové pozvánky společnosti (výchozí: pending; nastavte includeExpired pro vrácení i expirovaných).company:read
company_listVypsat 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_removeOdebrat logo společnosti (smaže uložený obrázek a vyčistí logo URL).company:write
company_member_invitePozvat člena týmu e-mailem s rolí (ADMIN, MANAGER, AGENT nebo VIEWER).company:write
company_member_removeOdebrat člena týmu ze společnosti.company:write
company_member_update_roleZměnit roli člena týmu (ADMIN, MANAGER, AGENT nebo VIEWER).company:write
company_members_listVypsat členy společnosti s jejich rolemi (OWNER, ADMIN, MANAGER, AGENT, VIEWER).any
company_settings_updateAktualizovat nastavení značky společnosti: primaryColor / secondaryColor (#RRGGBB) a notificationEmail pro hodnocení konverzací.company:write
company_updateAktualizovat 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

ToolDescriptionScope
chatbot_add_instructionPřidat novou hlavní instrukci do chatbotu (1-5000 znaků).chatbots:write
chatbot_confirm_embedOznačit chatbot jako embedded na webu (skryje připomenutí nastavení v dashboardu).chatbots:write
chatbot_createVytvořit nového chatbota (stejné jako průvodce v dashboardu).chatbots:write
chatbot_deleteTrvale smazat chatbota se všemi jeho FAQ, dokumenty, chaty, leady a formuláři (nevratné).chatbots:write
chatbot_delete_instructionSmazat hlavní instrukci z chatbotu.chatbots:write
chatbot_getZí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_codeZískat HTML snippet pro instalaci chatbota na web (URL skriptu + <script> tag) a informaci, zda bylo potvrzeno vložení.chatbots:read
chatbot_get_instructionsZískat všechny hlavní instrukce pro chatbot.chatbots:read
chatbot_improve_instructionsPřepsat text hlavní instrukce pomocí platformního AI vylepšovače (stejné jako 'Improve with AI' v dashboardu).chatbots:write
chatbot_learning_phase_getZí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_updateNastavit 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_listVypsat všechny chatboty, ke kterým má uživatel přístup, s přehledovými statistikami.chatbots:read
chatbot_reorder_instructionsNastavit pořadí hlavních instrukcí chatbota.chatbots:write
chatbot_templates_listVypsat š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_activeAktivovat nebo deaktivovat chatbota.chatbots:write
chatbot_toggle_learningUkončit (false) nebo znovu povolit (true) learning phase chatbota.chatbots:write
chatbot_updateAktualizovat 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_instructionAktualizovat existující hlavní instrukci (content, isActive, channel, sortOrder).chatbots:write
chatbot_update_personalityAktualizovat 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_getZískat aktuální nastavení widgetu pro chatbota (všechny vzhledové, brandovací, behaviorální a předformulářová pole).chatbots:read
widget_settings_updateAktualizovat chat widget chatbota: pozice (vč.chatbots:write
widget_translations_getZískat překlady widgetu pro jednotlivé jazyky chatbota: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }.chatbots:read
widget_translations_updateNastavit překlady widgetu podle jazyků.chatbots:write

Knowledge Base

ToolDescriptionScope
crawler_job_cancelZrušit PENDING nebo RUNNING crawl job; zbývající stránky se přeskočí.knowledge:write
crawler_job_getZískat stav crawl jobu, průběh (pagesCrawled/pagesFound, tokensUsed) a stav každé stránky.knowledge:read
crawler_jobs_listVypsat crawl joby chatbotu (nejnovější první) se stavem a průběhem.knowledge:read
crawler_limitsZí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_scanNaskenovat web a vypsat jeho prohledatelné stránky (url, title, isRecommended) bez importu čehokoli.knowledge:write
crawler_startSpustit 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_urlStá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_textPřidat textový nebo markdown dokument do znalostní báze chatbotu z inline obsahu (max 10 MB).knowledge:write
knowledge_document_deleteSmazat nahraný dokument ze znalostní báze.knowledge:write
knowledge_document_getZí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_listVypsat nahrané dokumenty (PDF, TXT, MD, CSV, JSON, DOCX) ve znalostní bázi chatbotu se stavem a velikostí.knowledge:read
knowledge_page_addProjí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_deleteSmazat procházenou stránku ze znalostní báze (odstraní její soubor vektorového úložiště).knowledge:write
knowledge_page_getZí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_recrawlZnovu stáhnout procházenou stránku a nahradit její indexovaný obsah (např.knowledge:write
knowledge_pages_deleteSmazat více procházených stránek chatbotu najednou.knowledge:write
knowledge_pages_listVypsat 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_statsPř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_deleteSmazat všechny procházené stránky webu (domény) ze znalostní báze chatbotu.knowledge:write
knowledge_website_recrawlZnovu projít každou stránku webu (domény) ve znalostní bázi chatbotu pro obnovení obsahu.knowledge:write
knowledge_website_recrawl_cancelZruš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_listVypsat 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.

ToolDescriptionScope
price_listStrá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_listStránkovat přes návrhy cen.prices:read
price_createVytvořit návrh s ID položky generovaným serverem.prices:write
price_editVytvořit nový návrh z explicitně očekávané verze položky.prices:write
price_import_csvImportovat návrhy s explicitním formatem a stabilním import ID pro bezpečné opakování.prices:write
price_suggestion_applyAplikovat vybraného kandidáta návrhu jako návrh.prices:write
price_approveSchválit jednu explicitně očekávanou verzi položky.prices:approve
price_approve_manySchválit výběr ID/verze atomicky; jakákoli zastaralá verze odmítne celý výběr.prices:approve
price_archiveArchivovat 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

ToolDescriptionScope
faq_cache_purgeVyčistit cache dat FAQ widgetu na všech připojených CMS stránkách (WordPress plugin).faqs:write
faq_categories_listVypsat kategorie FAQ chatbota s počtem FAQ, slugy, režimem řazení a překlady.faqs:read
faq_categories_reorderNastavit pořadí kategorií FAQ ve widgetu: pozice v categoryIds se stane sortOrder.faqs:write
faq_category_createVytvořit kategorii FAQ pro chatbot (slug se generuje z názvu).faqs:write
faq_category_deleteSmazat kategorii FAQ.faqs:write
faq_category_translations_updateNahradit překlady kategorie FAQ, např.faqs:write
faq_category_updatePřejmenovat kategorii FAQ nebo změnit její popis, ikonu či režim řazení.faqs:write
faq_createVytvořit FAQ pro chatbot.faqs:write
faq_deleteTrvale smazat FAQ (také jej odstraní ze znalostní báze chatbotu a vyprázdní cache widgetu v CMS).faqs:write
faq_embed_code_getZí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_getZískat kompletní detaily FAQ: otázka, odpověď, kategorie, stav publikace, pořadí, překlady, SEO pole a statistiky zpětné vazby.faqs:read
faq_listVypsat FAQ chatbota (použijte chatbot_list pro získání chatbotId).faqs:read
faq_reorderNastavit pořadí zobrazení FAQ ve widgetu.faqs:write
faq_suggestion_approveSchvá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_getZískat kompletní detaily návrhu FAQ (úplná odpověď, AI reasoning, navrhovaná kategorie, stav recenze).faqs:read
faq_suggestion_rejectOdmítnout PENDING návrh FAQ s nepovinným důvodem.faqs:write
faq_suggestions_generateNechat AI navrhnout nová FAQ ze znalostní báze chatbotu (crawlované stránky / nahrané dokumenty), volitelně pro jednu kategorii.faqs:write
faq_suggestions_listVypsat AI-generované návrhy FAQ chatbotu (z chat konverzací nebo faq_suggestions_generate).faqs:read
faq_translatePř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_updateUložit překlady FAQ podle jazyka, např.faqs:write
faq_updateAktualizovat otázku, odpověď, kategorii, stav publikace nebo manuální pořadí FAQ.faqs:write
faq_widget_settings_getZí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_updateAktualizovat 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

ToolDescriptionScope
chat_feedback_dismissOznačit chat jako zrevidovaný bez jeho ohodnocení (vyčistí ho z fronty pending, nemění confidence skóre).chats:write
chat_feedback_getZí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_listVypsat recenze chatu (řádky feedbacku) chatbotu s filtrem stavu a počty.chats:read
chat_feedback_set_severityPř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_statsPoč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_submitOhodnotit chat relaci jako Good (isPositive=true) nebo Needs Work (isPositive=false).chats:write
chat_session_getZí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_searchVyhledávat chat relace chatbotu podle obsahu zpráv a/nebo e-mailu návštěvníka.chats:read
chat_session_set_categoryPř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_listVypsat chat relace chatbotu, nejnovější první, se stejnými filtry fronty recenzí jako stránka chatů v dashboardu.chats:read

Improvement Agent

ToolDescriptionScope
confidence_categories_listVypsat confidence kategorie chatbotu s per-category confidence skóre, počtem recenzí a frekvencí e-mailů pro recenze.chats:read
confidence_category_createVytvořit confidence kategorii pro chatbot.chatbots:write
confidence_category_deleteSmazat confidence kategorii.chatbots:write
confidence_category_mergeSlouč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_updatePř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_getStav 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_approveSchvá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_rejectOdmítnout PENDING návrh zlepšení.chatbots:write
improvement_proposal_simulateSimulovat, jak by chatbot odpověděl na problematickou zprávu s aplikovaným návrhem (originál vs.chatbots:write
improvement_proposals_pendingVypsat návrhy ke zlepšení čekající na revizi (stav PENDING) napříč společností nebo pro jeden chatbot.chatbots:read
improvement_session_completeOznačit improvement session jako COMPLETED (chat se pak počítá jako Improved ve frontě recenzí).chatbots:write
improvement_session_createOtevřít Improvement Agent pro chat ohodnocený jako Needs Work.chatbots:write
improvement_session_getZí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_resetRestartovat 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_messagePoslat 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_listVypsat 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_assessOhodnotit 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

ToolDescriptionScope
live_chat_agents_availableZí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_heartbeatObnovit 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_sendPoslat zprávu návštěvníkovi jako přiřazený agent.chats:write
live_chat_queueZískat frontu live chatu: relace čekající na agenta, nejstarší první (FIFO).chats:read
live_chat_session_assignVzí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_closeUkončit live chat relaci jako agent (jakýkoli člen společnosti kromě VIEWER).chats:write
live_chat_session_getZí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_listVypsat 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_availabilityPřepnout přepínač 'Available for Live Chat' současného uživatele pro společnost.chats:write

Leads

ToolDescriptionScope
lead_assignPřiřadit lead členu společnosti nebo ho od přiřazení odpojit (assignedToId: null).leads:write
lead_bulk_update_statusNastavit stav několika leadů najednou (max 100).leads:write
lead_categories_listVypsat kategorie leadů chatbotu s počty leadů a členy týmu upozorněnými pro každou kategorii.leads:read
lead_category_assign_userPřidat člena společnosti do notifikačního seznamu kategorie leadů (nebo aktualizovat jeho notifikační flagy).leads:write
lead_category_createVytvořit kategorii leadů pro chatbot.leads:write
lead_category_deleteSmazat kategorii leadů.leads:write
lead_category_remove_userOdebrat člena společnosti ze notifikačního seznamu kategorie leadů.leads:write
lead_category_updateAktualizovat název, popis a/nebo barvu kategorie leadů.leads:write
lead_createVytvořit lead ručně (např.leads:write
lead_deleteTrvale smazat lead.leads:write
lead_field_config_getZí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_updateAktualizovat konfiguraci zachytávání leadů chatbotu.leads:write
lead_getZí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_listVypsat 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_statsZískat statistiky leadů pro chatbot: počty podle stavu, leady za posledních 7 dní a konverzní poměr (v procentech).leads:read
lead_updateAktualizovat status, kategorii, poznámky, zachycená data a/nebo přiřazeného leadu.leads:write

Forms

ToolDescriptionScope
form_createVytvořit kontaktní formulář pro chatbot (základ, pole, design a nastavení proti spamu v jednom volání).forms:write
form_deleteTrvale smazat kontaktní formulář a VŠECHNY jeho odeslané záznamy (kaskáda).forms:write
form_getZískat kontaktní formulář kompletně: pole, překlady, styling, nastavení proti spamu, stav aktivace, počet odeslání a embed skript (embedCode).forms:read
form_listVypsat kontaktní formuláře chatbotu s počty polí, počty odeslání a embed kódy.forms:read
form_statsPočty odeslání kontaktního formuláře: total, pending, approved, spam a rejected.forms:read
form_submission_deleteTrvale smazat odeslání kontaktního formuláře (např.forms:write
form_submission_getZí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_statusProvést revizi odeslání kontaktního formuláře: nastavit jeho stav na APPROVED, SPAM nebo REJECTED s nepovinnou poznámkou.forms:write
form_submissions_listVypsat odeslání kontaktního formuláře, nejnovější první, volitelně filtrované podle stavu (PENDING, APPROVED, SPAM, REJECTED) a data vytvoření.forms:read
form_updateAktualizovat 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_translationsNahradit překlady polí a/nebo UI kontaktního formuláře.forms:write

Email Assistant

ToolDescriptionScope
email_activity_listVypsat 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_listVypsat e-mailové kategorie připojení poštovní schránky (seřazeno podle sortOrder).email:read
email_category_createVytvořit e-mailovou kategorii pro připojení poštovní schránky (max 20 na připojení).email:write
email_category_deleteSmazat e-mailovou kategorii.email:write
email_category_updateAktualizovat e-mailovou kategorii (částečně: změní se pouze uvedená pole).email:write
email_connection_disconnectTrvale odpojit poštovní schránku.email:write
email_connection_getZískat připojení poštovní schránky včetněemail:read
email_connection_updateAktualizovat 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_listVypsat 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_deleteSmazat naučený e-mailový kontakt (zapomenout profil odesílatele, např.email:write
email_contact_getZí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_updateAktualizovat naučený e-mailový kontakt.email:write
email_contacts_listVypsat 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_createVytvoř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_listVypsat 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_listVypsat 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

ToolDescriptionScope
analytics_chat_volumeObjem 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_statsVý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_formsStatistiky 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_leadsLead 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_overviewPř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_activityCo 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:

  1. Použije improvement_proposals_pending pro získání návrhů
  2. Analyzuje a shrne každý návrh
  3. Schválí nebo odmítne je vaším jménem pomocí improvement_proposal_approve nebo improvement_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

  1. Ověřte, že je váš API klíč správný
  2. Zkontrolujte, zda klíč nebyl zrušen
  3. Ujistěte se, že váš plán zahrnuje API přístup
  4. 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 →