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
- Mur fil-Dashboard → Company → tab API
- Ikklikkja Create API Key
- Agħti lit-tecla isem deskriptiv (pereżempju, "Claude Desktop") u għażel mill-inqas permess wieħed
- 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
| Tool | Deskrizzjoni |
|---|---|
user_profile | Iġib l-informazzjoni tal-profil tiegħek |
user_companies | Iddeskrivi lill-kumpanija li l-API key tiegħek huwa scope għalih |
user_notifications | Iġib in-notifikazzjonijiet riċenti tiegħek |
Immaniġġjar tal-Kumpanija u tat-Tim
| Tool | Deskrizzjoni |
|---|---|
company_list | Lista tal-kumpaniji li l-API key tiegħek huwa scope għalih |
company_get | Iġib dettalji taʼ kumpanija partikolari |
company_members_list | Lista tal-membri tal-kumpanija b'rwoli tagħhom |
company_chatbots_list | Lista taʼ l-ogħla chatbots għal kumpanija |
company_update | Aġġorna l-isem tal-kumpanija, deskrizzjoni, jew settings |
Immaniġġjar tal-Chatbot
| Tool | Deskrizzjoni |
|---|---|
chatbot_list | Lista taʼ l-chatbots kollha b'statistika sommarja |
chatbot_get | Iġib dettalji u konfigurazzjoni taʼ chatbot |
chatbot_get_instructions | Iġib l-istruzzjonijiet ewlenin għal chatbot |
chatbot_add_instruction | Żid istruzzjoni ewlenija ġdida |
chatbot_update_instruction | Aġġorna istruzzjoni ewlenija eżistenti |
chatbot_delete_instruction | Ħassar istruzzjoni ewlenija |
chatbot_update_personality | Aġġorna tonality, lingwa, u messaġġi |
chatbot_toggle_active | Attiva jew deattiva chatbot |
chatbot_toggle_learning | Iffranka jew itfi l-fażi tat-tagħlim |
widget_settings_get | Iġib is-settings kurrenti tal-widget |
widget_settings_update | Aġġorna l-apparenza tal-widget (kuluri, daqs, pożizzjoni) |
Immaniġġjar FAQ
| Tool | Deskrizzjoni |
|---|---|
faq_list | Lista taʼ l-FAQs kollha għal chatbot |
faq_get | Iġib dettalji taʼ FAQ |
faq_create | Oħloq FAQ ġdida |
faq_update | Aġġorna FAQ eżistenti |
faq_delete | Ħassar FAQ |
faq_categories_list | Lista taʼ kategoriji tal-FAQ |
faq_suggestions_list | Lista taʼ suġġerimenti tal-FAQ pendenti ġenerati minn konversazzjonijiet tal-chat |
Knowledge Base
| Tool | Deskrizzjoni |
|---|---|
knowledge_documents_list | Lista d-dokumenti fil-knowledge base taʼ chatbot |
knowledge_document_get | Iġib dettalji taʼ dokument partikolari |
knowledge_document_delete | Ħassar dokument mil-knowledge base |
knowledge_stats | Iġib statistika tal-knowledge base |
Crawling tal-website huwa mmaniġġjat mid-dashboard — ara Knowledge Base.
Immaniġġjar tal-Lead
| Tool | Deskrizzjoni |
|---|---|
lead_list | Lista taʼ leads b'filtrazzjoni fakultattiva billi status jew kategorija |
lead_get | Iġib dettalji sħaħ tal-lead inkluża s-sessjoni tal-chat sors |
lead_update | Aġġorna l-status, kategorija, jew noti tal-lead |
lead_delete | Ħassar lead b'mod permanenti |
lead_categories_list | Lista taʼ kategoriji tal-lead |
lead_stats | Iġib statistika tal-leads inklużi counts skont status |
lead_field_config_get | Iġib il-konfigurazzjoni tal-kamp tal-capture tal-lead |
Storja tal-Chat
| Tool | Deskrizzjoni |
|---|---|
chat_sessions_list | Lista taʼ sessjonijiet tal-chat b'filtri fakultattivi |
chat_session_get | Iġib sessjoni tal-chat b'kollox messaġġi tagħha |
chat_session_search | Fittex sessjonijiet tal-chat skond kontenut tal-messaġġ jew informazzjoni tal-viżitatur |
Analytics
| Tool | Deskrizzjoni |
|---|---|
analytics_overview | Iġib counts tal-chat, counts tal-messaġġi, u rates taʼ sodisfazzjon |
analytics_chat_volume | Iġib volum taʼ chat maż-żmien għal charts u trends |
Improvement Agent
| Tool | Deskrizzjoni |
|---|---|
improvement_sessions_list | Lista taʼ sessjonijiet taʼ improvement |
improvement_session_get | Iġib dettalji tas-sessjoni inklużi proposti |
improvement_proposals_pending | Lista taʼ proposti pendenti li qed jistennew reviżjoni |
improvement_proposal_approve | Aċċetta proposta u applika l-bidla |
improvement_proposal_reject | Irrifjuta proposta |
Live Chat
| Tool | Deskrizzjoni |
|---|---|
live_chat_sessions_list | Lista taʼ sessjonijiet taʼ live chat |
live_chat_session_get | Iġib sessjoni taʼ live chat b'kollox messaġġi |
live_chat_queue | Iġ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:
- Juża
improvement_proposals_pendingbiex jġib il-proposti - Janalizza u jissemma kull suġġeriment
- Aċċetta jew jirrifjutahom f'isem tiegħek bl-użu taʼ
improvement_proposal_approvejewimprovement_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
- Ivverifika li l-API key tiegħek hu korrett
- Iċċekkja li l-key ma ġietx revokata
- Kun żgur li l-pjan tiegħek jinkludi aċċess għall-API
- 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 →