MCP Server Integration
ChatReact implementează Model Context Protocol (MCP), permițându-vă să vă 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 și surse de date externe. Cu integrarea MCP a ChatReact, puteți:
- Gestiona chatboți direct din asistentul dumneavoastră AI
- Crea și actualiza FAQ-uri folosind limbaj natural
- Vizualiza analitice și istoricul chat-urilor
- Controla Improvement Agent pentru optimizarea chatbot-ului
- Gestiona sesiuni de chat live fără a părăsi instrumentul dumneavoastră AI
Începerea utilizării
1. Generați o cheie API
- Navigați la Dashboard → Settings → API Keys
- Faceți clic pe Create API Key
- Atribuiți cheii un nume descriptiv (de ex., "Claude Desktop")
- Copiați cheia generată (începe cu
cr_)
Păstrați cheia API în siguranță. Nu poate fi recuperată după creare.
2. Configurați clientul MCP
Claude Desktop
Adăugați următoarele în fișierul de configurare al 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
Adăugați în setările Cursor MCP ale dumneavoastră:
{
"mcpServers": {
"chatreact": {
"url": "https://www.chatreact.ai/api/mcp",
"headers": {
"Authorization": "Bearer cr_your_api_key_here"
}
}
}
}
Dezvoltare locală (stdio)
Pentru dezvoltare locală, puteți folosi pachetul nostru npm:
npm install -g @chatreact/mcp
Configurați în clientul dvs. MCP:
{
"mcpServers": {
"chatreact": {
"command": "chatreact-mcp",
"args": ["--api-key", "cr_your_api_key_here"]
}
}
}
3. Repornirea asistentului AI
După salvarea configurației, reporniți Claude Desktop sau Cursor pentru a stabili conexiunea.
Unelte disponibile
ChatReact MCP oferă peste 30 de unelte organizate pe categorii:
Company & Team Management
| Instrument | Descriere |
|---|---|
company_list | Listează toate companiile la care aveți acces |
company_get | Obține detalii despre o companie specifică |
company_team_list | Listează membrii echipei unei companii |
Chatbot Management
| Instrument | Descriere |
|---|---|
chatbot_list | Listează toate chatboții dintr-o companie |
chatbot_get | Obține detalii și configurația unui chatbot |
chatbot_create | Creează un chatbot nou |
chatbot_update | Actualizează setările chatbot-ului |
chatbot_get_instructions | Obține instrucțiunile de bază pentru un chatbot |
chatbot_add_instruction | Adaugă o instrucțiune de bază nouă |
FAQ Management
| Instrument | Descriere |
|---|---|
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 |
faq_suggest | Generează FAQ-uri sugerate de AI |
Knowledge Base
| Instrument | Descriere |
|---|---|
knowledge_list_documents | Listează documentele încărcate |
knowledge_list_websites | Listează site-urile crawl-uite |
knowledge_crawl_website | Pornește crawling-ul unui site |
knowledge_get_crawl_status | Verifică progresul crawling-ului |
Analytics
| Instrument | Descriere |
|---|---|
analytics_overview | Obține metrici generale de performanță |
analytics_chat_volume | Obține volumul de chat în timp |
analytics_feedback | Obține feedback și evaluări |
analytics_chat_history | Răsfoiește sesiunile de chat |
analytics_get_session | Obține date detaliate despre o sesiune |
Improvement Agent
| Instrument | Descriere |
|---|---|
improvement_list_sessions | Listează sesiunile de îmbunătățire |
improvement_start_session | Pornește o sesiune de analiză nouă |
improvement_list_proposals | Listează propunerile de îmbunătățire |
improvement_get_proposal | Obține detalii despre o propunere |
improvement_create_proposal | Creează o propunere personalizată |
improvement_simulate_proposal | Previzualizează efectele unei propuneri |
improvement_apply_proposal | Aplică o propunere |
improvement_reject_proposal | Respinge o propunere |
Live Chat
| Instrument | Descriere |
|---|---|
livechat_get_queue | Obține sesiunile de chat în așteptare |
livechat_get_active_sessions | Listează sesiunile active cu agenți umani |
livechat_get_session | Obține detalii despre o sesiune |
livechat_assign_session | Vă atribuiți unei sesiuni |
livechat_send_message | Trimite un mesaj ca agent |
livechat_close_session | Închide o sesiune de chat |
livechat_check_availability | Verifică disponibilitatea agenților |
Fluxuri de lucru exemplu
Crearea unui chatbot nou
Întrebați asistentul dumneavoastră AI:
"Creează un chatbot nou numit 'Support Bot' pentru compania mea 'acme-corp' cu un ton prietenos, profesional"
Asistentul va folosi chatbot_create cu parametrii corespunzători.
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_list_proposalspentru a prelua propunerile - Analiza și rezuma fiecare sugestie
- Vă ajuta să decideți pe care să le aplicați
Analiza performanței chat-urilor
"Dă-mi un raport săptămânal privind volumul de chat și satisfacția clienților pentru chatbot-ul meu"
Asistentul va folosi analytics_overview și analytics_feedback pentru a compila un raport cuprinzător.
Securitate
- Cheile API sunt limitate la contul dumneavoastră de utilizator și la accesul companiei
- Toate cererile sunt înregistrate în audit trail
- Cheile pot fi revocate în orice moment din dashboard
- Se aplică limite de rate: 60 cereri/minut
Depanare
Conexiune eșuată
- Verificați dacă cheia API este corectă
- Verificați că cheia nu a fost revocată
- Asigurați-vă că aveți o conexiune activă la internet
- Repornți clientul MCP
Unealta nu a fost găsită
Unele unelte necesită permisiuni specifice. Asigurați-vă că aveți rolul corespunzător în companie (Owner, Admin, sau Manager).
Limită de rată
Dacă vedeți erori de tip rate limit, așteptați un minut înainte de a reîncerca. Luați în considerare gruparea operațiunilor când este posibil.
Aveți nevoie de ajutor? Contactați echipa noastră de suport →