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íč
- Přejděte do Dashboard → Company → záložka API
- Klikněte na Create API Key
- Dejte klíči popisný název (např. "Claude Desktop") a vyberte alespoň jedno oprávnění
- 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
| Tool | Description |
|---|---|
user_profile | Získat informace o vašem profilu |
user_companies | Vypsat společnost, na kterou je váš API klíč vázán |
user_notifications | Získat vaše nedávné notifikace |
Správa společnosti a týmu
| Tool | Description |
|---|---|
company_list | Vypsat společnost, na kterou je váš API klíč vázán |
company_get | Získat podrobnosti o konkrétní společnosti |
company_members_list | Vypsat členy společnosti s jejich rolemi |
company_chatbots_list | Vypsat všechny chatboty pro společnost |
company_update | Aktualizovat název společnosti, popis nebo nastavení |
Správa chatbotů
| Tool | Description |
|---|---|
chatbot_list | Vypsat všechny chatboty se souhrnnými statistikami |
chatbot_get | Získat podrobnosti a konfiguraci chatbotu |
chatbot_get_instructions | Získat základní instrukce pro chatbot |
chatbot_add_instruction | Přidat novou základní instrukci |
chatbot_update_instruction | Aktualizovat existující základní instrukci |
chatbot_delete_instruction | Smazat základní instrukci |
chatbot_update_personality | Aktualizovat tón, jazyk a zprávy |
chatbot_toggle_active | Aktivovat nebo deaktivovat chatbot |
chatbot_toggle_learning | Zapnout nebo vypnout fázi učení |
widget_settings_get | Získat aktuální nastavení widgetu |
widget_settings_update | Aktualizovat vzhled widgetu (barvy, velikost, pozice) |
Správa FAQ
| Tool | Description |
|---|---|
faq_list | Vypsat všechny FAQ pro chatbot |
faq_get | Získat podrobnosti FAQ |
faq_create | Vytvořit nové FAQ |
faq_update | Aktualizovat existující FAQ |
faq_delete | Odstranit FAQ |
faq_categories_list | Vypsat kategorie FAQ |
faq_suggestions_list | Vypsat čekající návrhy FAQ vygenerované z konverzací |
Knowledge Base
| Tool | Description |
|---|---|
knowledge_documents_list | Vypsat dokumenty v znalostní bázi chatbotu |
knowledge_document_get | Získat podrobnosti o konkrétním dokumentu |
knowledge_document_delete | Smazat dokument ze znalostní báze |
knowledge_stats | Získat statistiky znalostní báze |
Procházení webu se řídí z dashboardu — viz Knowledge Base.
Správa leadů
| Tool | Description |
|---|---|
lead_list | Vypsat leady s volitelným filtrováním podle stavu nebo kategorie |
lead_get | Získat úplné podrobnosti leadu včetně zdrojové chatovací relace |
lead_update | Aktualizovat stav leadu, kategorii nebo poznámky |
lead_delete | Trvale smazat lead |
lead_categories_list | Vypsat kategorie leadů |
lead_stats | Získat statistiky leadů včetně počtů podle stavu |
lead_field_config_get | Získat konfiguraci polí pro zachytávání leadů |
Historie chatů
| Tool | Description |
|---|---|
chat_sessions_list | Vypsat chatovací relace s volitelnými filtry |
chat_session_get | Získat chatovací relaci se všemi zprávami |
chat_session_search | Hledat chatovací relace podle obsahu zpráv nebo informací o návštěvníkovi |
Analytika
| Tool | Description |
|---|---|
analytics_overview | Získat počty chatů, počty zpráv a míry spokojenosti |
analytics_chat_volume | Získat objem chatů v čase pro grafy a trendy |
Improvement Agent
| Tool | Description |
|---|---|
improvement_sessions_list | Vypsat sessions Improvement Agentu |
improvement_session_get | Získat podrobnosti session včetně návrhů |
improvement_proposals_pending | Vypsat čekající návrhy vyžadující přezkum |
improvement_proposal_approve | Schválit návrh a aplikovat změnu |
improvement_proposal_reject | Odmítnout návrh |
Live Chat
| Tool | Description |
|---|---|
live_chat_sessions_list | Vypsat živé chatovací relace |
live_chat_session_get | Získat živou chatovací relaci se všemi zprávami |
live_chat_queue | Zí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:
- Použije
improvement_proposals_pendingk načtení návrhů - Analyzuje a shrne každý návrh
- Schválí nebo odmítne návrhy vaším jménem pomocí
improvement_proposal_approveneboimprovement_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
- Ověřte, že je váš API klíč správný
- Zkontrolujte, že klíč nebyl zrušen
- Ujistěte se, že váš plán zahrnuje přístup k API
- 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 →