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ľúč
- Prejdite do svojho Dashboard → Company → záložka API
- Kliknite na Create API Key
- Pomenujte svoj kľúč opisným názvom (napr. "Claude Desktop") a vyberte aspoň jedno oprávnenie
- 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
| Tool | Description |
|---|---|
user_profile | Získať informácie o vašom profile |
user_companies | Zoznam spoločnosti, ku ktorej je váš API kľúč viazaný |
user_notifications | Získať vaše posledné notifikácie |
Správa spoločnosti a tímu
| Tool | Description |
|---|---|
company_list | Zoznam spoločnosti, ku ktorej je váš API kľúč viazaný |
company_get | Získať detaily konkrétnej spoločnosti |
company_members_list | Zoznam členov spoločnosti s ich rolami |
company_chatbots_list | Zoznam všetkých chatbotov pre spoločnosť |
company_update | Aktualizovať názov spoločnosti, popis alebo nastavenia |
Správa chatbotov
| Tool | Description |
|---|---|
chatbot_list | Zoznam všetkých chatbotov so súhrnnými štatistikami |
chatbot_get | Získať detaily a konfiguráciu chatbota |
chatbot_get_instructions | Získať základné inštrukcie pre chatbota |
chatbot_add_instruction | Pridať novú základnú inštrukciu |
chatbot_update_instruction | Aktualizovať existujúcu základnú inštrukciu |
chatbot_delete_instruction | Odstrániť základnú inštrukciu |
chatbot_update_personality | Aktualizovať tón, jazyk a správy |
chatbot_toggle_active | Aktivovať alebo deaktivovať chatbota |
chatbot_toggle_learning | Povoliť alebo zakázať fázu učenia |
widget_settings_get | Získať aktuálne nastavenia widgetu |
widget_settings_update | Aktualizovať vzhľad widgetu (farby, veľkosť, pozíciu) |
Správa FAQ
| Tool | Description |
|---|---|
faq_list | Zoznam všetkých FAQ pre chatbota |
faq_get | Získať detaily FAQ |
faq_create | Vytvoriť nové FAQ |
faq_update | Aktualizovať existujúce FAQ |
faq_delete | Odstrániť FAQ |
faq_categories_list | Zoznam kategórií FAQ |
faq_suggestions_list | Zoznam čakajúcich návrhov FAQ generovaných z rozhovorov |
Knowledge Base
| Tool | Description |
|---|---|
knowledge_documents_list | Zoznam dokumentov v znalostnej databáze chatbota |
knowledge_document_get | Získať detaily konkrétneho dokumentu |
knowledge_document_delete | Odstrániť dokument zo znalostnej databázy |
knowledge_stats | Získať štatistiky znalostnej databázy |
Prehliadanie webu (website crawling) sa spravuje z dashboardu — pozrite si Knowledge Base.
Správa leadov
| Tool | Description |
|---|---|
lead_list | Zoznam leadov s voliteľným filtrovaním podľa statusu alebo kategórie |
lead_get | Získať kompletné detaily leadu vrátane zdrojovej chat session |
lead_update | Aktualizovať status leadu, kategóriu alebo poznámky |
lead_delete | Trvalo odstrániť lead |
lead_categories_list | Zoznam kategórií leadov |
lead_stats | Získať štatistiky leadov vrátane počtov podľa statusu |
lead_field_config_get | Získať konfiguráciu polí zberu leadov |
História rozhovorov
| Tool | Description |
|---|---|
chat_sessions_list | Zoznam chat session s voliteľnými filtrami |
chat_session_get | Získať chat session so všetkými správami |
chat_session_search | Vyhľadávať chat session podľa obsahu správ alebo údajov návštevníka |
Analytika
| Tool | Description |
|---|---|
analytics_overview | Získať počty chatov, počty správ a mieru spokojnosti |
analytics_chat_volume | Získať objem chatov v čase pre grafy a trendy |
Improvement Agent
| Tool | Description |
|---|---|
improvement_sessions_list | Zoznam improvement session |
improvement_session_get | Získať detaily session vrátane návrhov |
improvement_proposals_pending | Zoznam čakajúcich návrhov na preskúmanie |
improvement_proposal_approve | Schváliť návrh a aplikovať zmenu |
improvement_proposal_reject | Odmietnuť návrh |
Live Chat
| Tool | Description |
|---|---|
live_chat_sessions_list | Zoznam live chat session |
live_chat_session_get | Získať live chat session so všetkými správami |
live_chat_queue | Zí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:
- Použije
improvement_proposals_pendingna načítanie návrhov - Analyzuje a zhrnie každý návrh
- Za vás ich schváli alebo odmietne pomocou
improvement_proposal_approvealeboimprovement_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ť
- Overte, či je váš API kľúč správny
- Skontrolujte, či kľúč nebol zrušený
- Uistite sa, že váš plán obsahuje prístup k API
- 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 →