DomůDokumentace

Integrace MCP serveru

ChatReact implementuje Model Context Protocol (MCP), který vám umožňuje připojit váš účet ChatReact k AI asistentům jako Claude Desktop, Cursor a dalším nástrojům kompatibilním 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 ChatReactu můžete:

  • Spravovat chatboty — aktualizovat instrukce, osobnost a nastavení widgetu
  • Vytvářet a aktualizovat FAQ pomocí přirozeného jazyka
  • Prohlížet analytiku, historii chatů a leady
  • Přezkoumávat návrhy Improvement Agenta a schvalovat či odmítat je
  • Sledovat živé chaty a frontu čekajících

Začínáme

1. Vygenerujte API klíč

  1. Přejděte do DashboardCompany → záložka API
  2. Klikněte na Create API Key
  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 plánech — podívejte se na naši Pricing page.

Uložte svůj API klíč bezpečně. Po vytvoření jej nelze znovu získat.

2. Nakonfigurujte svého MCP klienta

MCP server ChatReact je hostován 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 podporuje vzdálené MCP servery přímo. 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 založené na příkazech, 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ěkteří klienti nezpracovávají mezery v argumentech spolehlivě.

3. Restartujte svého AI asistenta

Po uložení konfigurace restartujte Claude Desktop nebo Cursor, aby se navázalo připojení.

Dostupné nástroje

ChatReact MCP poskytuje komplexní sadu nástrojů uspořádaných do kategorií:

Váš účet

ToolDescription
user_profileZískat informace o vašem profilu
user_companiesVypsat společnost, na kterou je váš API klíč vázán
user_notificationsZískat vaše nedávné notifikace

Správa společnosti a týmu

ToolDescription
company_listVypsat společnost, na kterou je váš API klíč vázán
company_getZískat podrobnosti o konkrétní společnosti
company_members_listVypsat členy společnosti s jejich rolemi
company_chatbots_listVypsat všechny chatboty pro společnost
company_updateAktualizovat název společnosti, popis nebo nastavení

Správa chatbotů

ToolDescription
chatbot_listVypsat všechny chatboty se souhrnnými statistikami
chatbot_getZískat podrobnosti a konfiguraci chatbotu
chatbot_get_instructionsZískat základní instrukce pro chatbot
chatbot_add_instructionPřidat novou základní instrukci
chatbot_update_instructionAktualizovat existující základní instrukci
chatbot_delete_instructionSmazat základní instrukci
chatbot_update_personalityAktualizovat tón, jazyk a zprávy
chatbot_toggle_activeAktivovat nebo deaktivovat chatbot
chatbot_toggle_learningZapnout nebo vypnout fázi učení
widget_settings_getZískat aktuální nastavení widgetu
widget_settings_updateAktualizovat vzhled widgetu (barvy, velikost, pozice)

Správa FAQ

ToolDescription
faq_listVypsat všechny FAQ pro chatbot
faq_getZískat podrobnosti FAQ
faq_createVytvořit nové FAQ
faq_updateAktualizovat existující FAQ
faq_deleteOdstranit FAQ
faq_categories_listVypsat kategorie FAQ
faq_suggestions_listVypsat čekající návrhy FAQ vygenerované z konverzací

Knowledge Base

ToolDescription
knowledge_documents_listVypsat dokumenty v znalostní bázi chatbotu
knowledge_document_getZískat podrobnosti o konkrétním dokumentu
knowledge_document_deleteSmazat dokument ze znalostní báze
knowledge_statsZískat statistiky znalostní báze

Procházení webu se řídí z dashboardu — viz Knowledge Base.

Správa leadů

ToolDescription
lead_listVypsat leady s volitelným filtrováním podle stavu nebo kategorie
lead_getZískat úplné podrobnosti leadu včetně zdrojové chatovací relace
lead_updateAktualizovat stav leadu, kategorii nebo poznámky
lead_deleteTrvale smazat lead
lead_categories_listVypsat kategorie leadů
lead_statsZískat statistiky leadů včetně počtů podle stavu
lead_field_config_getZískat konfiguraci polí pro zachytávání leadů

Historie chatů

ToolDescription
chat_sessions_listVypsat chatovací relace s volitelnými filtry
chat_session_getZískat chatovací relaci se všemi zprávami
chat_session_searchHledat chatovací relace podle obsahu zpráv nebo informací o návštěvníkovi

Analytika

ToolDescription
analytics_overviewZískat počty chatů, počty zpráv a míry spokojenosti
analytics_chat_volumeZískat objem chatů v čase pro grafy a trendy

Improvement Agent

ToolDescription
improvement_sessions_listVypsat sessions Improvement Agentu
improvement_session_getZískat podrobnosti session včetně návrhů
improvement_proposals_pendingVypsat čekající návrhy vyžadující přezkum
improvement_proposal_approveSchválit návrh a aplikovat změnu
improvement_proposal_rejectOdmítnout návrh

Live Chat

ToolDescription
live_chat_sessions_listVypsat živé chatovací relace
live_chat_session_getZískat živou chatovací relaci se všemi zprávami
live_chat_queueZískat relace čekající na agenta

Nástroje pro živý chat jsou pouze pro čtení. Pro přímé chatování s návštěvníky použijte dashboard Live Chat.

Ukázkové workflowy

Přidání základní instrukce

Požádejte svého AI asistenta:

"Přidejte základní instrukci do mého chatbota 'Support Bot': nabízíme dopravu zdarma u objednávek nad €50"

Asistent použije chatbot_add_instruction s odpovídajícími parametry.

Přezkoumání návrhů Improvement Agenta

"Ukaž mi všechny čekající návrhy zlepšení pro mého chatbota a vysvětli, jaké změny navrhují"

Asistent:

  1. Použije improvement_proposals_pending k načtení návrhů
  2. Analyzuje a shrne každý návrh
  3. Schválí nebo odmítne návrhy 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 k sestavení komplexní zprávy.

Bezpečnost

  • API klíče jsou vázány na vaši společnost
  • Klíče lze kdykoli zrušit z dashboardu
  • API přístup je dostupný v placených plánech — viz naše Pricing page

Řešení problémů

Připojení selhalo

  1. Ověřte, že je váš API klíč správný
  2. Zkontrolujte, že klíč nebyl zrušen
  3. Ujistěte se, že váš plán zahrnuje přístup k API
  4. Restartujte svého MCP klienta

Nástroj nebyl nalezen

Po změně konfigurace restartujte svého MCP klienta, aby znovu načetl dostupné nástroje. Názvy nástrojů jsou v malých písmenech s podtržítky (např. faq_list).


Potřebujete pomoc? Kontaktujte náš support tým →