KezdőlapDokumentáció

MCP Server Integráció

A ChatReact megvalósítja a Model Context Protocol (MCP) protokollt, amely lehetővé teszi, hogy összekapcsolja ChatReact fiókját olyan AI asszisztensekkel, mint a Claude Desktop, Cursor és egyéb MCP-kompatibilis eszközök.

Mi az MCP?

A Model Context Protocol egy nyílt szabvány, amely lehetővé teszi az AI asszisztensek számára, hogy külső szolgáltatásokkal és adatforrásokkal kommunikáljanak. A ChatReact MCP integrációjával Ön:

  • Kezelheti a chatbotokat — frissítheti az utasításokat, személyiséget és widget beállításokat
  • Létrehozhat és frissíthet GYIK-eket természetes nyelven
  • Megtekintheti az elemzéseket, csevegési előzményeket és leadeket
  • Áttekintheti az Improvement Agent javaslatait és jóváhagyhatja vagy elutasíthatja azokat
  • Figyelheti az élő csevegési munkameneteket és a várakozási sort

Első lépések

1. API kulcs létrehozása

  1. Lépjen a DashboardCompanyAPI fülre
  2. Kattintson a Create API Key gombra
  3. Adjon a kulcsnak egy leíró nevet (pl. "Claude Desktop") és válasszon legalább egy jogosultságot
  4. Másolja ki a generált kulcsot (cr_ előtaggal kezdődik)

Az API kulcsok fizetős csomagokban érhetők el — lásd a Pricing page.

Tárolja az API kulcsot biztonságosan. Létrehozás után nem kérhető le újra.

2. MCP kliens konfigurálása

A ChatReact MCP szerver a https://www.chatreact.ai/api/mcp címen érhető el és HTTP (JSON-RPC) protokollon kommunikál. Hitelesítés az Authorization: Bearer fejléccel történik — elfogadott az ugyanazzal a kulccsal történő X-API-Key fejléc is.

Cursor IDE

A Cursor közvetlenül támogatja a távoli MCP szervereket. Adja hozzá a következőt a Cursor MCP beállításaihoz:

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

Claude Desktop

A Claude Desktop konfigurációs fájlja támogat parancs alapú szervereket, ezért használja a szabványos mcp-remote bridge-et a hosztolt végponthoz való kapcsolódáshoz:

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"
      ]
    }
  }
}

Ehhez a beállításhoz telepített Node.js szükséges. A példa az X-API-Key fejlécet használja, mert néhány kliens nem kezeli megbízhatóan a szóközöket az argumentumokban.

3. Indítsa újra az AI asszisztenst

A konfiguráció mentése után indítsa újra a Claude Desktopot vagy a Cursor-t a kapcsolat létrehozásához.

Elérhető eszközök

A ChatReact MCP átfogó eszközkészletet biztosít, kategóriákba rendezve:

Fiókja

ToolDescription
user_profileLekéri a profilinformációkat
user_companiesFelsorolja azt a vállalatot, amelyhez az API kulcs van kötve
user_notificationsLekéri a legutóbbi értesítéseket

Vállalat- és csapatkezelés

ToolDescription
company_listFelsorolja azt a vállalatot, amelyhez az API kulcs van kötve
company_getLekéri egy adott vállalat részleteit
company_members_listFelsorolja a vállalat tagjait és szerepeiket
company_chatbots_listFelsorolja a vállalat összes chatbotját
company_updateFrissíti a vállalat nevét, leírását vagy beállításait

Chatbot kezelése

ToolDescription
chatbot_listFelsorolja az összes chatbotot összegző statisztikákkal
chatbot_getLekéri a chatbot részleteit és konfigurációját
chatbot_get_instructionsLekéri a chatbot alapvető utasításait
chatbot_add_instructionÚj alapvető utasítás hozzáadása
chatbot_update_instructionMeglévő alapvető utasítás frissítése
chatbot_delete_instructionAlapvető utasítás törlése
chatbot_update_personalityA hangnem, nyelv és üzenetek frissítése
chatbot_toggle_activeChatbot aktiválása vagy deaktiválása
chatbot_toggle_learningTanulási fázis engedélyezése vagy letiltása
widget_settings_getLekéri a jelenlegi widget beállításokat
widget_settings_updateFrissíti a widget megjelenését (színek, méret, pozíció)

GYIK kezelése

ToolDescription
faq_listFelsorolja az összes GYIK-et egy chatbothoz
faq_getLekéri a GYIK részleteit
faq_createÚj GYIK létrehozása
faq_updateMeglévő GYIK frissítése
faq_deleteGYIK törlése
faq_categories_listGYIK kategóriák listázása
faq_suggestions_listFelsorolja a csevegésekből generált függőben lévő GYIK javaslatokat

Tudásbázis

ToolDescription
knowledge_documents_listFelsorolja a chatbot tudásbázisában lévő dokumentumokat
knowledge_document_getLekéri egy adott dokumentum részleteit
knowledge_document_deleteTörli a dokumentumot a tudásbázisból
knowledge_statsLekéri a tudásbázis statisztikáit

A weboldal feltérképezését a dashboardról lehet kezelni — lásd a Knowledge Base.

Lead kezelés

ToolDescription
lead_listLeadek listázása opcionális szűréssel státusz vagy kategória szerint
lead_getLekéri a lead teljes részleteit, beleértve a forrás csevegési munkamenetet
lead_updateFrissíti a lead státuszát, kategóriáját vagy megjegyzéseit
lead_deleteVéglegesen törli a leadet
lead_categories_listLead kategóriák listázása
lead_statsLekéri a lead statisztikákat, beleértve a státuszok szerinti bontást
lead_field_config_getLekéri a lead rögzítési mezők konfigurációját

Csevegési előzmények

ToolDescription
chat_sessions_listFelsorolja a csevegési munkameneteket opcionális szűrőkkel
chat_session_getLekéri egy csevegési munkamenet összes üzenetét
chat_session_searchKeresés csevegési munkamenetekben üzenettartalom vagy látogató adatai alapján

Elemzések

ToolDescription
analytics_overviewLekéri a chat számokat, üzenetszámokat és elégedettségi arányokat
analytics_chat_volumeLekéri a chat volumenét időben a grafikonokhoz és trendekhez

Improvement Agent

ToolDescription
improvement_sessions_listFelsorolja a javítási munkameneteket
improvement_session_getLekéri a munkamenet részleteit, beleértve a javaslatokat
improvement_proposals_pendingFelsorolja a jóváhagyásra váró javaslatokat
improvement_proposal_approveJóváhagy egy javaslatot és alkalmazza a változtatást
improvement_proposal_rejectElutasít egy javaslatot

Élő chat

ToolDescription
live_chat_sessions_listFelsorolja az élő csevegési munkameneteket
live_chat_session_getLekéri egy élő csevegési munkamenet összes üzenetét
live_chat_queueLekéri az ügynökre váró munkameneteket

Az élő chat eszközök csak olvashatók. Ha közvetlenül szeretne csevegni a látogatókkal, használja a Live Chat dashboardot.

Példafolyamatok

Alapvető utasítás hozzáadása

Kérje meg az AI asszisztensét:

"Adjon hozzá egy alapvető utasítást a 'Support Bot' chatbotomhoz: ingyenes szállítást kínálunk 50€ feletti rendelésekre"

Az asszisztens a chatbot_add_instruction eszközt fogja használni a megfelelő paraméterekkel.

Javítási javaslatok áttekintése

"Mutassa meg az összes függőben lévő javítási javaslatot a chatbotomhoz és magyarázza el, milyen változtatásokat javasolnak"

Az asszisztens a következőket teszi:

  1. A improvement_proposals_pending használatával lekéri a javaslatokat
  2. Elemezi és összefoglalja az egyes javaslatokat
  3. Ön helyett jóváhagyja vagy elutasítja azokat a improvement_proposal_approve vagy improvement_proposal_reject hívással

Csevegési teljesítmény elemzése

"Adjon nekem heti jelentést a chatvolumenről és az ügyfél-elégedettségről a chatbotom számára"

Az asszisztens az analytics_overview és analytics_chat_volume eszközöket használja egy átfogó jelentés összeállításához.

Biztonság

  • Az API kulcsok a vállalatához vannak kötve
  • A kulcsokat bármikor visszavonhatja a dashboardról
  • Az API hozzáférés fizetős csomagokban érhető el — lásd a Pricing page

Hibakeresés

Kapcsolódás sikertelen

  1. Ellenőrizze, hogy az API kulcs helyes-e
  2. Ellenőrizze, hogy a kulcsot nem vonták-e vissza
  3. Győződjön meg róla, hogy a csomagja tartalmaz API hozzáférést
  4. Indítsa újra az MCP kliensét

Eszköz nem található

Indítsa újra az MCP kliensét a konfiguráció megváltoztatása után, hogy újratöltse az elérhető eszközöket. Az eszköznevek kisbetűsek és alulvonással elválasztottak (pl. faq_list).


Szüksége van segítségre? Lépjen kapcsolatba az ügyfélszolgálatunkkal →