DomovDokumentácia

Integrácia MCP servera

ChatReact implementuje Model Context Protocol (MCP), čo 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 interagovať s externými službami a zdrojmi údajov. S MCP integráciou v ChatReact môžete:

  • Spravovať chatboty — aktualizovať inštrukcie, osobnosť a nastavenia widgetu
  • Vytvárať a aktualizovať FAQ pomocou prirodzeného jazyka
  • Zobraziť analytiku, históriu rozhovorov a leady
  • Preskúmať návrhy Improvement Agenta a schváliť alebo odmietnuť ich
  • Monitorovať živé chaty a čakaciu frontu

Začíname

1. Vygenerujte API kľúč

  1. Prejdite do svojho DashboardCompany → záložka API
  2. Kliknite na Create API Key
  3. Pomenujte svoj kľúč opisným názvom (napr. "Claude Desktop") a vyberte aspoň jedno oprávnenie
  4. Skopírujte vygenerovaný kľúč (začína na cr_)

API kľúče sú dostupné v platených plánoch — pozrite si našu Pricing page.

Uložte svoj API kľúč bezpečne. Po vytvorení ho nie je možné znovu získať.

2. Nakonfigurujte svoj MCP klient

ChatReact MCP server je hosťovaný na https://www.chatreact.ai/api/mcp a komunikuje cez HTTP (JSON-RPC). Autentifikujte sa pomocou hlavičky 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 svojich 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íkazoch, takže použite štandardný most mcp-remote na prepojenie s hosťovaným koncovým bodom:

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 spoľahlivo nezvládajú medzery v argumentoch.

3. Reštartujte svojho AI asistenta

Po uložení konfigurácie reštartujte Claude Desktop alebo Cursor, aby sa nadviazalo pripojenie.

Dostupné nástroje

ChatReact MCP poskytuje rozsiahlu sadu nástrojov usporiadaných do kategórií:

Váš účet

ToolDescription
user_profileZískať informácie o vašom profile
user_companiesZoznam spoločnosti, ku ktorej je váš API kľúč viazaný
user_notificationsZískať vaše posledné notifikácie

Správa spoločnosti a tímu

ToolDescription
company_listZoznam spoločnosti, ku ktorej je váš API kľúč viazaný
company_getZískať detaily konkrétnej spoločnosti
company_members_listZoznam členov spoločnosti s ich rolami
company_chatbots_listZoznam všetkých chatbotov pre spoločnosť
company_updateAktualizovať názov spoločnosti, popis alebo nastavenia

Správa chatbotov

ToolDescription
chatbot_listZoznam všetkých chatbotov so súhrnnými štatistikami
chatbot_getZískať detaily a konfiguráciu chatbota
chatbot_get_instructionsZískať základné inštrukcie pre chatbota
chatbot_add_instructionPridať novú základnú inštrukciu
chatbot_update_instructionAktualizovať existujúcu základnú inštrukciu
chatbot_delete_instructionOdstrániť základnú inštrukciu
chatbot_update_personalityAktualizovať tón, jazyk a správy
chatbot_toggle_activeAktivovať alebo deaktivovať chatbota
chatbot_toggle_learningPovoliť alebo zakázať fázu učenia
widget_settings_getZískať aktuálne nastavenia widgetu
widget_settings_updateAktualizovať vzhľad widgetu (farby, veľkosť, pozíciu)

Správa FAQ

ToolDescription
faq_listZoznam všetkých FAQ pre chatbota
faq_getZískať detaily FAQ
faq_createVytvoriť nové FAQ
faq_updateAktualizovať existujúce FAQ
faq_deleteOdstrániť FAQ
faq_categories_listZoznam kategórií FAQ
faq_suggestions_listZoznam čakajúcich návrhov FAQ generovaných z rozhovorov

Knowledge Base

ToolDescription
knowledge_documents_listZoznam dokumentov v znalostnej databáze chatbota
knowledge_document_getZískať detaily konkrétneho dokumentu
knowledge_document_deleteOdstrániť dokument zo znalostnej databázy
knowledge_statsZískať štatistiky znalostnej databázy

Prehliadanie webu (website crawling) sa spravuje z dashboardu — pozrite si Knowledge Base.

Správa leadov

ToolDescription
lead_listZoznam leadov s voliteľným filtrovaním podľa statusu alebo kategórie
lead_getZískať kompletné detaily leadu vrátane zdrojovej chat session
lead_updateAktualizovať status leadu, kategóriu alebo poznámky
lead_deleteTrvalo odstrániť lead
lead_categories_listZoznam kategórií leadov
lead_statsZískať štatistiky leadov vrátane počtov podľa statusu
lead_field_config_getZískať konfiguráciu polí zberu leadov

História rozhovorov

ToolDescription
chat_sessions_listZoznam chat session s voliteľnými filtrami
chat_session_getZískať chat session so všetkými správami
chat_session_searchVyhľadávať chat session podľa obsahu správ alebo údajov návštevníka

Analytika

ToolDescription
analytics_overviewZískať počty chatov, počty správ a mieru spokojnosti
analytics_chat_volumeZískať objem chatov v čase pre grafy a trendy

Improvement Agent

ToolDescription
improvement_sessions_listZoznam improvement session
improvement_session_getZískať detaily session vrátane návrhov
improvement_proposals_pendingZoznam čakajúcich návrhov na preskúmanie
improvement_proposal_approveSchváliť návrh a aplikovať zmenu
improvement_proposal_rejectOdmietnuť návrh

Live Chat

ToolDescription
live_chat_sessions_listZoznam live chat session
live_chat_session_getZískať live chat session so všetkými správami
live_chat_queueZískať session čakajúce na agenta

Nástroje pre živý chat sú read-only. Ak chcete priamo komunikovať s návštevníkmi, použite dashboard Live Chat.

Príkladné pracovné postupy

Pridanie základnej inštrukcie

Požiadajte svojho AI asistenta:

"Pridaj základnú inštrukciu do môjho chatbota 'Support Bot': ponúkame dopravu zadarmo pri objednávkach nad €50"

Asistent použije chatbot_add_instruction s príslušnými parametrami.

Preskúmanie návrhov Improvement Agenta

"Ukáž mi všetky čakajúce návrhy zlepšení pre môjho chatbota a vysvetli, aké zmeny navrhujú"

Asistent:

  1. Použije improvement_proposals_pending na načítanie návrhov
  2. Analyzuje a zhrnie každý návrh
  3. Za vás ich schváli alebo odmietne pomocou improvement_proposal_approve alebo improvement_proposal_reject

Analýza výkonu chatu

"Daj mi týždennú správu o objeme chatov a spokojnosti zákazníkov pre môj chatbot"

Asistent použije analytics_overview a analytics_chat_volume na zostavenie komplexnej správy.

Bezpečnosť

  • API kľúče sú viazané na vašu spoločnosť
  • Kľúče možno kedykoľvek zrušiť z dashboardu
  • Prístup k API je dostupný v platených plánoch — pozrite si našu Pricing page

Riešenie problémov

Nepodarilo sa pripojiť

  1. Overte, či je váš API kľúč správny
  2. Skontrolujte, či kľúč nebol zrušený
  3. Uistite sa, že váš plán obsahuje prístup k API
  4. Reštartujte svoj MCP klient

Nástroj nenájdený

Po zmene konfigurácie reštartujte svoj MCP klient, aby znovu načítal dostupné nástroje. Názvy nástrojov sú v malých písmenách s podtržníkmi (napr. faq_list).


Potrebujete pomoc? Kontaktujte náš tím podpory →