HomeDocumentation

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 MCP integraci v ChatReact můžete:

  • Spravovat chatboty přímo z vašeho AI asistenta
  • Vytvářet a aktualizovat FAQ pomocí přirozeného jazyka
  • Prohlížet analytiku a historii chatů
  • Řídit Improvement Agent pro optimalizaci chatbotů
  • Zpracovávat live chat sezení, aniž byste museli opouštět svůj AI nástroj

Začínáme

1. Vygenerujte API Key

  1. Přejděte do DashboardSettingsAPI Keys
  2. Klikněte na Create API Key
  3. Dejte svému klíči popisný název (např. "Claude Desktop")
  4. Zkopírujte vygenerovaný klíč (začíná na cr_)

Uložte svůj API klíč bezpečně. Nelze ho znovu získat po vytvoření.

2. Nakonfigurujte svého MCP klienta

Claude Desktop

Přidejte následující do konfiguračního souboru Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\\Claude\\claude_desktop_config.json

{
  "mcpServers": {
    "chatreact": {
      "url": "https://www.chatreact.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer cr_your_api_key_here"
      }
    }
  }
}

Cursor IDE

Přidejte do nastavení Cursor MCP:

{
  "mcpServers": {
    "chatreact": {
      "url": "https://www.chatreact.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer cr_your_api_key_here"
      }
    }
  }
}

Lokální vývoj (stdio)

Pro lokální vývoj můžete použít náš balíček npm:

npm install -g @chatreact/mcp

Konfigurujte ve svém MCP klientovi:

{
  "mcpServers": {
    "chatreact": {
      "command": "chatreact-mcp",
      "args": ["--api-key", "cr_your_api_key_here"]
    }
  }
}

3. Restart Your AI Assistant

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

Available Tools

ChatReact MCP poskytuje přes 30 nástrojů uspořádaných do kategorií:

Company & Team Management

ToolDescription
company_listVyjmenuje všechny společnosti, ke kterým máte přístup
company_getZíská podrobnosti o konkrétní společnosti
company_team_listVyjmenuje členy týmu společnosti

Chatbot Management

ToolDescription
chatbot_listVyjmenuje všechny chatboty ve společnosti
chatbot_getZíská informace a konfiguraci chatbota
chatbot_createVytvoří nového chatbota
chatbot_updateAktualizuje nastavení chatbota
chatbot_get_instructionsZíská hlavní instrukce pro chatbota
chatbot_add_instructionPřidá novou hlavní instrukci

FAQ Management

ToolDescription
faq_listVyjmenuje všechny FAQ pro chatbota
faq_getZíská podrobnosti o FAQ
faq_createVytvoří nové FAQ
faq_updateAktualizuje existující FAQ
faq_deleteOdstraní FAQ
faq_categories_listVyjmenuje kategorie FAQ
faq_suggestVygeneruje AI-navrhované FAQ

Knowledge Base

ToolDescription
knowledge_list_documentsVyjmenuje nahrané dokumenty
knowledge_list_websitesVyjmenuje prohledané weby
knowledge_crawl_websiteSpustí crawl webu
knowledge_get_crawl_statusZkontroluje průběh crawlování

Analytics

ToolDescription
analytics_overviewZíská obecné metriky výkonu
analytics_chat_volumeZíská objem chatů v čase
analytics_feedbackZíská zpětnou vazbu a hodnocení
analytics_chat_historyProhlíží chatové relace
analytics_get_sessionZíská podrobné údaje o relaci

Improvement Agent

ToolDescription
improvement_list_sessionsVyjmenuje relace zlepšení
improvement_start_sessionSpustí novou analyzační relaci
improvement_list_proposalsVyjmenuje návrhy na zlepšení
improvement_get_proposalZíská podrobnosti návrhu
improvement_create_proposalVytvoří vlastní návrh
improvement_simulate_proposalNáhled efektů návrhu
improvement_apply_proposalAplikuje návrh
improvement_reject_proposalOdmítne návrh

Live Chat

ToolDescription
livechat_get_queueZíská čekající chatové relace
livechat_get_active_sessionsVyjmenuje aktivní relace lidských agentů
livechat_get_sessionZíská podrobnosti relace
livechat_assign_sessionPřidělí si relaci
livechat_send_messageOdešle zprávu jako agent
livechat_close_sessionUzavře chatovou relaci
livechat_check_availabilityZkontroluje dostupnost agentů

Example Workflows

Creating a New Chatbot

Požádejte svého AI asistenta:

"Create a new chatbot called 'Support Bot' for my company 'acme-corp' with a friendly, professional tone"

Asistent použije chatbot_create s příslušnými parametry.

Reviewing Improvement Suggestions

"Show me all pending improvement proposals for my chatbot and explain what changes they suggest"

Asistent bude postupovat takto:

  1. Použije improvement_list_proposals k získání návrhů
  2. Analyzuje a shrne každý návrh
  3. Pomůže vám rozhodnout, které aplikovat

Analyzing Chat Performance

"Give me a weekly report of chat volume and customer satisfaction for my chatbot"

Asistent použije analytics_overview a analytics_feedback k sestavení souhrnné zprávy.

Security

  • API keys jsou vázány na váš uživatelský účet a přístup ke společnosti
  • Všechny požadavky jsou zaznamenány v audit trail
  • Klíče lze kdykoli zneplatnit z dashboardu
  • Rate limits platí: 60 requests/minute

Troubleshooting

Connection Failed

  1. Ověřte, že je váš API key správný
  2. Zkontrolujte, že klíč nebyl zneplatněn
  3. Ujistěte se, že máte aktivní připojení k internetu
  4. Restartujte svého MCP klienta

Tool Not Found

Některé nástroje vyžadují specifická oprávnění. Ujistěte se, že máte odpovídající roli ve společnosti (Owner, Admin nebo Manager).

Rate Limited

Pokud se zobrazí chyby o překročení limitu, počkejte minutu před dalším pokusem. Zvažte dávkování operací, pokud je to možné.


Potřebujete pomoc? Contact our support team →