Paġna ewlenijaDokumentazzjoni

MCP Server Integration

ChatReact timplimenta l-Model Context Protocol (MCP), li jippermettilek tikkonnetti l-kont ChatReact tiegħek maʼ assistenti AI bħal Claude Desktop, Cursor, u għodod oħra kompatibbli maʼ MCP.

X'inhu MCP?

Model Context Protocol huwa standard miftuħ li jippermetti lill-assistenti AI jinteraġixxu maʼ servizzi esterni u sorsi taʼ data. Bl-integrazzjoni MCP taʼ ChatReact, inti tistaʼ:

  • Timmaniġġja chatbots — aġġorna istruzzjonijiet, personalità, u settings tal-widget
  • Oħloq u aġġorna FAQs bl-użu tal-lingwa naturali
  • Uri analytics, storja tal-chat, u leads
  • Iċċekkja proposti tal-Improvement Agent u aċċetta jew tirrifjutahom
  • Monitora sessjonijiet taʼ live chat u l-katina taʼ stennija

Biex Tibda

1. Ġenera API Key

  1. Mur fil-DashboardCompany → tab API
  2. Ikklikkja Create API Key
  3. Agħti lit-tecla isem deskriptiv (pereżempju, "Claude Desktop") u għażel mill-inqas permess wieħed
  4. Kopja l-key ġenerata (tibda bi cr_)

API keys huma disponibbli fuq il-pjatti mħallsa — ara l-Pricing page.

Ħlief il-API key tiegħek b'mod sigur. Mhux possibbli tiksebha lura wara l-ħolqien.

2. Ikkonfigura l-MCP Client Tiegħek

Is-server MCP taʼ ChatReact huwa ospitat fuq https://www.chatreact.ai/api/mcp u jikkomunika fuq HTTP (JSON-RPC). Authentikazzjoni bl-intestazzjoni Authorization: Bearer — wkoll aċċettata intestazzjoni X-API-Key bl-istess key.

Cursor IDE

Cursor jappoġġja servers MCP remoti direttament. Żid fis-settings MCP taʼ Cursor tiegħek:

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

Claude Desktop

Il-fajl taʼ konfigurazzjoni taʼ Claude Desktop jappoġġja servers bbażati fuq commands, għalhekk uża l-bridge standard mcp-remote biex tikkonnetti mal-endpoint ospitat:

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

Din il-konfigurazzjoni teħtieġ li Node.js ikun installat. L-eżempju juża l-intestazzjoni X-API-Key għaliex xi klijenti ma jimmaniġġjawx spazji fl-arguments b'mod affidabbli.

3. Reboot l-AI Assistant Tiegħek

Wara li tissejvjja l-konfigurazzjoni, rebbuta Claude Desktop jew Cursor biex tistabbilixxi l-konnessjoni.

Għodod Disponibbli

ChatReact MCP jipprovdi sett kompletu taʼ għodod organizzati f'kategoriji:

Kont Tiegħek

ToolDeskrizzjoni
user_profileIġib l-informazzjoni tal-profil tiegħek
user_companiesIddeskrivi lill-kumpanija li l-API key tiegħek huwa scope għalih
user_notificationsIġib in-notifikazzjonijiet riċenti tiegħek

Immaniġġjar tal-Kumpanija u tat-Tim

ToolDeskrizzjoni
company_listLista tal-kumpaniji li l-API key tiegħek huwa scope għalih
company_getIġib dettalji taʼ kumpanija partikolari
company_members_listLista tal-membri tal-kumpanija b'rwoli tagħhom
company_chatbots_listLista taʼ l-ogħla chatbots għal kumpanija
company_updateAġġorna l-isem tal-kumpanija, deskrizzjoni, jew settings

Immaniġġjar tal-Chatbot

ToolDeskrizzjoni
chatbot_listLista taʼ l-chatbots kollha b'statistika sommarja
chatbot_getIġib dettalji u konfigurazzjoni taʼ chatbot
chatbot_get_instructionsIġib l-istruzzjonijiet ewlenin għal chatbot
chatbot_add_instructionŻid istruzzjoni ewlenija ġdida
chatbot_update_instructionAġġorna istruzzjoni ewlenija eżistenti
chatbot_delete_instructionĦassar istruzzjoni ewlenija
chatbot_update_personalityAġġorna tonality, lingwa, u messaġġi
chatbot_toggle_activeAttiva jew deattiva chatbot
chatbot_toggle_learningIffranka jew itfi l-fażi tat-tagħlim
widget_settings_getIġib is-settings kurrenti tal-widget
widget_settings_updateAġġorna l-apparenza tal-widget (kuluri, daqs, pożizzjoni)

Immaniġġjar FAQ

ToolDeskrizzjoni
faq_listLista taʼ l-FAQs kollha għal chatbot
faq_getIġib dettalji taʼ FAQ
faq_createOħloq FAQ ġdida
faq_updateAġġorna FAQ eżistenti
faq_deleteĦassar FAQ
faq_categories_listLista taʼ kategoriji tal-FAQ
faq_suggestions_listLista taʼ suġġerimenti tal-FAQ pendenti ġenerati minn konversazzjonijiet tal-chat

Knowledge Base

ToolDeskrizzjoni
knowledge_documents_listLista d-dokumenti fil-knowledge base taʼ chatbot
knowledge_document_getIġib dettalji taʼ dokument partikolari
knowledge_document_deleteĦassar dokument mil-knowledge base
knowledge_statsIġib statistika tal-knowledge base

Crawling tal-website huwa mmaniġġjat mid-dashboard — ara Knowledge Base.

Immaniġġjar tal-Lead

ToolDeskrizzjoni
lead_listLista taʼ leads b'filtrazzjoni fakultattiva billi status jew kategorija
lead_getIġib dettalji sħaħ tal-lead inkluża s-sessjoni tal-chat sors
lead_updateAġġorna l-status, kategorija, jew noti tal-lead
lead_deleteĦassar lead b'mod permanenti
lead_categories_listLista taʼ kategoriji tal-lead
lead_statsIġib statistika tal-leads inklużi counts skont status
lead_field_config_getIġib il-konfigurazzjoni tal-kamp tal-capture tal-lead

Storja tal-Chat

ToolDeskrizzjoni
chat_sessions_listLista taʼ sessjonijiet tal-chat b'filtri fakultattivi
chat_session_getIġib sessjoni tal-chat b'kollox messaġġi tagħha
chat_session_searchFittex sessjonijiet tal-chat skond kontenut tal-messaġġ jew informazzjoni tal-viżitatur

Analytics

ToolDeskrizzjoni
analytics_overviewIġib counts tal-chat, counts tal-messaġġi, u rates taʼ sodisfazzjon
analytics_chat_volumeIġib volum taʼ chat maż-żmien għal charts u trends

Improvement Agent

ToolDeskrizzjoni
improvement_sessions_listLista taʼ sessjonijiet taʼ improvement
improvement_session_getIġib dettalji tas-sessjoni inklużi proposti
improvement_proposals_pendingLista taʼ proposti pendenti li qed jistennew reviżjoni
improvement_proposal_approveAċċetta proposta u applika l-bidla
improvement_proposal_rejectIrrifjuta proposta

Live Chat

ToolDeskrizzjoni
live_chat_sessions_listLista taʼ sessjonijiet taʼ live chat
live_chat_session_getIġib sessjoni taʼ live chat b'kollox messaġġi
live_chat_queueIġib sessjonijiet li qed jistennew għal agent

L-għodod taʼ live chat huma read-only. Biex tikkummunika direttament mal-viżitaturi, uża d-dashboard Live Chat.

Eżempji taʼ Workflows

Żieda taʼ Istruzzjoni Ewlenija

Staqsi lill-assistent AI tiegħek:

"Żid istruzzjoni ewlenija lill-chatbot 'Support Bot' tiegħi: noffru shipping b'xejn fuq ordnijiet fuq €50"

L-assistent se juża chatbot_add_instruction bil-parametri xierqa.

Reviżjoni taʼ Suġġerimenti taʼ Improvement

"Uri lili l-proposti kollha pendenti taʼ improvement għall-chatbot tiegħi u spjega xʼbidliet jissuġġerixxu"

L-assistent se:

  1. Juża improvement_proposals_pending biex jġib il-proposti
  2. Janalizza u jissemma kull suġġeriment
  3. Aċċetta jew jirrifjutahom f'isem tiegħek bl-użu taʼ improvement_proposal_approve jew improvement_proposal_reject

Analiżi tal-Performance tal-Chat

"Agħtini rapport fil-:ġimgħa tal-volum tal-chat u s-sodisfazzjon tal-klijent għall-chatbot tiegħi"

L-assistent se juża analytics_overview u analytics_chat_volume biex jikkumpila rapport komprensiv.

Sigurta'

  • API keys huma scope għall-kumpanija tiegħek
  • Il-keys jistgħu jiġu revokati fi kwalunkwe ħin mid-dashboard
  • Aċċess għall-API huwa disponibbli fuq il-pjatti mħallsa — ara l-Pricing page

Troubleshooting

Konnessjoni Falliet

  1. Ivverifika li l-API key tiegħek hu korrett
  2. Iċċekkja li l-key ma ġietx revokata
  3. Kun żgur li l-pjan tiegħek jinkludi aċċess għall-API
  4. Rebbuta l-MCP client tiegħek

Għodda Mhijiex Misjuba

Rebbuta l-MCP client tiegħek wara li tbiddel il-konfigurazzjoni sabiex jerġgħu jħaddmu l-għodod disponibbli. L-ismijiet tal-għodod huma kollha bil-ittri żgħar u underscores (pereżempju, faq_list).


Għandek bżonn għajnuna? Contact our support team →