AcasăDocumentație

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

  1. Navigați la DashboardCompany → fila API
  2. Faceți clic pe Create API Key
  3. Dați cheii un nume descriptiv (de ex., "Claude Desktop") și selectați cel puțin o permisiune
  4. 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ă

ToolDescription
user_profileObține informațiile profilului dumneavoastră
user_companiesListează compania la care este asociată cheia API
user_notificationsObține notificările recente

Managementul companiei & echipei

ToolDescription
company_listListează compania la care este asociată cheia API
company_getObține detalii despre o companie specifică
company_members_listListează membrii companiei cu rolurile lor
company_chatbots_listListează toți chatboții unei companii
company_updateActualizează numele companiei, descrierea sau setările

Managementul chatboților

ToolDescription
chatbot_listListează toți chatboții cu statistici sumare
chatbot_getObține detalii și configurația unui chatbot
chatbot_get_instructionsObține instrucțiunile de bază pentru un chatbot
chatbot_add_instructionAdaugă o instrucțiune de bază nouă
chatbot_update_instructionActualizează o instrucțiune de bază existentă
chatbot_delete_instructionȘterge o instrucțiune de bază
chatbot_update_personalityActualizează tonalitatea, limba și mesajele
chatbot_toggle_activeActivează sau dezactivează un chatbot
chatbot_toggle_learningActivează sau dezactivează faza de învățare
widget_settings_getObține setările curente ale widgetului
widget_settings_updateActualizează aspectul widgetului (culori, dimensiune, poziție)

Managementul FAQ-urilor

ToolDescription
faq_listListează toate FAQ-urile pentru un chatbot
faq_getObține detalii despre un FAQ
faq_createCreează un FAQ nou
faq_updateActualizează un FAQ existent
faq_deleteȘterge un FAQ
faq_categories_listListează categoriile FAQ-urilor
faq_suggestions_listListează sugestiile de FAQ în așteptare generate din conversații

Bază de cunoștințe

ToolDescription
knowledge_documents_listListează documentele din baza de cunoștințe a unui chatbot
knowledge_document_getObține detalii despre un document specific
knowledge_document_deleteȘterge un document din baza de cunoștințe
knowledge_statsObține statistici ale bazei de cunoștințe

Crawlarea site-ului este gestionată din dashboard — vedeți Knowledge Base.

Managementul lead-urilor

ToolDescription
lead_listListează lead-urile cu filtrare opțională după status sau categorie
lead_getObține detaliile complete ale unui lead inclusiv sesiunea de chat sursă
lead_updateActualizează statusul, categoria sau notițele unui lead
lead_deleteȘterge un lead permanent
lead_categories_listListează categoriile de lead-uri
lead_statsObține statistici ale lead-urilor incluzând numere pe status
lead_field_config_getObține configurația câmpurilor pentru capturarea lead-urilor

Istoricul chat-urilor

ToolDescription
chat_sessions_listListează sesiuni de chat cu filtre opționale
chat_session_getObține o sesiune de chat cu toate mesajele sale
chat_session_searchCaută sesiuni de chat după conținutul mesajelor sau informații despre vizitator

Analize

ToolDescription
analytics_overviewObține numărul de chat-uri, numărul de mesaje și ratele de satisfacție
analytics_chat_volumeObține volumul de chat în timp pentru grafice și tendințe

Improvement Agent

ToolDescription
improvement_sessions_listListează sesiunile de îmbunătățire
improvement_session_getObține detaliile unei sesiuni incluzând propunerile
improvement_proposals_pendingListează propunerile în așteptare pentru revizuire
improvement_proposal_approveAprobă o propunere și aplică modificarea
improvement_proposal_rejectRespinge o propunere

Chat live

ToolDescription
live_chat_sessions_listListează sesiuni de chat live
live_chat_session_getObține o sesiune de chat live cu toate mesajele
live_chat_queueObț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:

  1. Folosi improvement_proposals_pending pentru a prelua propunerile
  2. Analiza și sumariza fiecare sugestie
  3. Să le aprobe sau respingă în numele dumneavoastră cu improvement_proposal_approve sau improvement_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ă

  1. Verificați că cheia API este corectă
  2. Verificați că cheia nu a fost revocată
  3. Asigurați-vă că planul dumneavoastră include acces API
  4. 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 →