Integrarea Serverului MCP
ChatReact implementează Model Context Protocol (MCP), permițându-vă să conectați contul ChatReact la asistenți AI precum Claude Desktop, Cursor și alte instrumente compatibile MCP.
Ce este MCP?
Model Context Protocol este un standard deschis care permite asistenților AI să interacționeze cu servicii externe și surse de date. Cu integrarea MCP a ChatReact puteți:
- Gestiona chatboți — actualiza instrucțiunile, personalitatea și setările widgetului
- Crea și actualiza FAQ-uri folosind limbaj natural
- Vizualiza analize, istoricul chat-urilor și lead-urile
- Revizui propunerile Improvement Agent și să le aprobați sau respingeți
- Monitoriza sesiuni de chat live și coada de așteptare
Început
1. Generați o cheie API
- Navigați la Dashboard → Company → fila API
- Faceți clic pe Create API Key
- Dați cheii un nume descriptiv (de ex., "Claude Desktop") și selectați cel puțin o permisiune
- Copiați cheia generată (începe cu
cr_)
Cheile API sunt disponibile pe planuri plătite — vedeți Pricing page.
Păstrați cheia API în siguranță. Nu poate fi recuperată după creare.
2. Configurați clientul MCP
Serverul MCP ChatReact este găzduit la https://www.chatreact.ai/api/mcp și comunică prin HTTP (JSON-RPC). Autentificați-vă cu antetul Authorization: Bearer — este acceptat și un antet X-API-Key cu aceeași cheie.
Cursor IDE
Cursor acceptă servere MCP remote direct. Adăugați la setările MCP din Cursor:
{
"mcpServers": {
"chatreact": {
"url": "https://www.chatreact.ai/api/mcp",
"headers": {
"Authorization": "Bearer cr_your_api_key_here"
}
}
}
}
Claude Desktop
Fișierul de configurare Claude Desktop acceptă servere bazate pe comenzi, așa că folosiți bridge-ul standard mcp-remote pentru a vă conecta la endpoint-ul găzduit:
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"
]
}
}
}
Această configurație necesită instalarea Node.js. Exemplul folosește antetul X-API-Key deoarece unii clienți nu gestionează spațiile din argumente în mod fiabil.
3. Reporniți asistentul AI
După salvarea configurației, reporniți Claude Desktop sau Cursor pentru a stabili conexiunea.
Instrumente disponibile
ChatReact MCP oferă un set cuprinzător de instrumente organizate pe categorii:
Contul dumneavoastră
| Tool | Description |
|---|---|
user_profile | Obține informațiile profilului dumneavoastră |
user_companies | Listează compania la care este asociată cheia API |
user_notifications | Obține notificările recente |
Managementul companiei & echipei
| Tool | Description |
|---|---|
company_list | Listează compania la care este asociată cheia API |
company_get | Obține detalii despre o companie specifică |
company_members_list | Listează membrii companiei cu rolurile lor |
company_chatbots_list | Listează toți chatboții unei companii |
company_update | Actualizează numele companiei, descrierea sau setările |
Managementul chatboților
| Tool | Description |
|---|---|
chatbot_list | Listează toți chatboții cu statistici sumare |
chatbot_get | Obține detalii și configurația unui chatbot |
chatbot_get_instructions | Obține instrucțiunile de bază pentru un chatbot |
chatbot_add_instruction | Adaugă o instrucțiune de bază nouă |
chatbot_update_instruction | Actualizează o instrucțiune de bază existentă |
chatbot_delete_instruction | Șterge o instrucțiune de bază |
chatbot_update_personality | Actualizează tonalitatea, limba și mesajele |
chatbot_toggle_active | Activează sau dezactivează un chatbot |
chatbot_toggle_learning | Activează sau dezactivează faza de învățare |
widget_settings_get | Obține setările curente ale widgetului |
widget_settings_update | Actualizează aspectul widgetului (culori, dimensiune, poziție) |
Managementul FAQ-urilor
| Tool | Description |
|---|---|
faq_list | Listează toate FAQ-urile pentru un chatbot |
faq_get | Obține detalii despre un FAQ |
faq_create | Creează un FAQ nou |
faq_update | Actualizează un FAQ existent |
faq_delete | Șterge un FAQ |
faq_categories_list | Listează categoriile FAQ-urilor |
faq_suggestions_list | Listează sugestiile de FAQ în așteptare generate din conversații |
Bază de cunoștințe
| Tool | Description |
|---|---|
knowledge_documents_list | Listează documentele din baza de cunoștințe a unui chatbot |
knowledge_document_get | Obține detalii despre un document specific |
knowledge_document_delete | Șterge un document din baza de cunoștințe |
knowledge_stats | Obține statistici ale bazei de cunoștințe |
Crawlarea site-ului este gestionată din dashboard — vedeți Knowledge Base.
Managementul lead-urilor
| Tool | Description |
|---|---|
lead_list | Listează lead-urile cu filtrare opțională după status sau categorie |
lead_get | Obține detaliile complete ale unui lead inclusiv sesiunea de chat sursă |
lead_update | Actualizează statusul, categoria sau notițele unui lead |
lead_delete | Șterge un lead permanent |
lead_categories_list | Listează categoriile de lead-uri |
lead_stats | Obține statistici ale lead-urilor incluzând numere pe status |
lead_field_config_get | Obține configurația câmpurilor pentru capturarea lead-urilor |
Istoricul chat-urilor
| Tool | Description |
|---|---|
chat_sessions_list | Listează sesiuni de chat cu filtre opționale |
chat_session_get | Obține o sesiune de chat cu toate mesajele sale |
chat_session_search | Caută sesiuni de chat după conținutul mesajelor sau informații despre vizitator |
Analize
| Tool | Description |
|---|---|
analytics_overview | Obține numărul de chat-uri, numărul de mesaje și ratele de satisfacție |
analytics_chat_volume | Obține volumul de chat în timp pentru grafice și tendințe |
Improvement Agent
| Tool | Description |
|---|---|
improvement_sessions_list | Listează sesiunile de îmbunătățire |
improvement_session_get | Obține detaliile unei sesiuni incluzând propunerile |
improvement_proposals_pending | Listează propunerile în așteptare pentru revizuire |
improvement_proposal_approve | Aprobă o propunere și aplică modificarea |
improvement_proposal_reject | Respinge o propunere |
Chat live
| Tool | Description |
|---|---|
live_chat_sessions_list | Listează sesiuni de chat live |
live_chat_session_get | Obține o sesiune de chat live cu toate mesajele |
live_chat_queue | Obține sesiunile care așteaptă un agent |
Instrumentele pentru chat live sunt doar în modul de citire. Pentru a discuta direct cu vizitatorii, folosiți dashboard-ul Live Chat.
Fluxuri de lucru exemplu
Adăugarea unei instrucțiuni de bază
Cereți asistentului AI:
"Adăugați o instrucțiune de bază pentru chatbot-ul meu 'Support Bot': oferim livrare gratuită pentru comenzile peste €50"
Asistentul va folosi chatbot_add_instruction cu parametrii adecvați.
Revizuirea sugestiilor de îmbunătățire
"Arată-mi toate propunerile de îmbunătățire în așteptare pentru chatbot-ul meu și explică ce modificări propun"
Asistentul va:
- Folosi
improvement_proposals_pendingpentru a prelua propunerile - Analiza și sumariza fiecare sugestie
- Să le aprobe sau respingă în numele dumneavoastră cu
improvement_proposal_approvesauimprovement_proposal_reject
Analiza performanței chat-urilor
"Dă-mi un raport săptămânal al volumului de chat și al satisfacției clienților pentru chatbot-ul meu"
Asistentul va folosi analytics_overview și analytics_chat_volume pentru a compila un raport cuprinzător.
Securitate
- Cheile API sunt restricționate la compania dumneavoastră
- Cheile pot fi revocate în orice moment din dashboard
- Accesul API este disponibil pe planuri plătite — vedeți Pricing page
Depanare
Conexiune eșuată
- Verificați că cheia API este corectă
- Verificați că cheia nu a fost revocată
- Asigurați-vă că planul dumneavoastră include acces API
- Reporniți clientul MCP
Instrumentul nu a fost găsit
Reporniți clientul MCP după schimbarea configurației pentru a reîncărca instrumentele disponibile. Numele instrumentelor sunt cu litere mici și underscore-uri (de ex., faq_list).
Aveți nevoie de ajutor? Contactați echipa noastră de suport →