Ενσωμάτωση MCP Server
Το ChatReact υλοποιεί το Model Context Protocol (MCP), επιτρέποντάς σας να συνδέσετε τον λογαριασμό ChatReact με βοηθούς AI όπως Claude Desktop, Cursor και άλλα εργαλεία συμβατά με MCP.
Τι είναι το MCP;
Το Model Context Protocol είναι ένα ανοιχτό πρότυπο που επιτρέπει στους βοηθούς AI να αλληλεπιδρούν με εξωτερικές υπηρεσίες και πηγές δεδομένων. Με την ενσωμάτωση MCP του ChatReact, μπορείτε να:
- Διαχειρίζεστε chatbots — ενημέρωση οδηγιών, προσωπικότητας και ρυθμίσεων widget
- Δημιουργείτε και ενημερώνετε Συχνές Ερωτήσεις (FAQs) χρησιμοποιώντας φυσική γλώσσα
- Προβάλετε αναλυτικά στοιχεία, ιστορικό συνομιλιών και leads
- Εξετάζετε προτάσεις του Improvement Agent και να τις εγκρίνετε ή να τις απορρίπτετε
- Παρακολουθείτε ζωντανές συνομιλίες και την ουρά αναμονής
Ξεκινώντας
1. Δημιουργία API Key
- Πλοηγηθείτε στο Dashboard → Company → καρτέλα API
- Κάντε κλικ στο Create API Key
- Δώστε στο κλειδί σας ένα περιγραφικό όνομα (π.χ. "Claude Desktop") και επιλέξτε τουλάχιστον μία άδεια
- Αντιγράψτε το δημιουργημένο κλειδί (ξεκινά με
cr_)
Τα API keys είναι διαθέσιμα σε πληρωμένα πακέτα — δείτε τη Pricing page.
Αποθηκεύστε το API key με ασφάλεια. Δεν μπορεί να ανακτηθεί μετά τη δημιουργία.
2. Διαμόρφωση του MCP Client σας
Ο MCP server του ChatReact φιλοξενείται στο https://www.chatreact.ai/api/mcp και επικοινωνεί μέσω HTTP (JSON-RPC). Πιστοποιηθείτε με ένα header Authorization: Bearer — γίνεται επίσης αποδεκτό ένα header X-API-Key με το ίδιο κλειδί.
Cursor IDE
Το Cursor υποστηρίζει απομακρυσμένους MCP servers απευθείας. Προσθέστε στις ρυθμίσεις MCP του Cursor:
{
"mcpServers": {
"chatreact": {
"url": "https://www.chatreact.ai/api/mcp",
"headers": {
"Authorization": "Bearer cr_your_api_key_here"
}
}
}
}
Claude Desktop
Το αρχείο διαμόρφωσης του Claude Desktop υποστηρίζει servers βάσει εντολών, οπότε χρησιμοποιήστε τη στάνταρ γέφυρα mcp-remote για να συνδεθείτε με το φιλοξενούμενο endpoint:
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"
]
}
}
}
Αυτή η ρύθμιση απαιτεί εγκατεστημένο Node.js. Το παράδειγμα χρησιμοποιεί το header X-API-Key επειδή κάποιοι clients δεν χειρίζονται αξιόπιστα τα κενά σε ορίσματα.
3. Επανεκκινήστε τον βοηθό AI σας
Μετά την αποθήκευση της διαμόρφωσης, επανεκκινήστε το Claude Desktop ή το Cursor για να εγκαθιδρύσετε τη σύνδεση.
Διαθέσιμα Εργαλεία
Το ChatReact MCP παρέχει ένα πλήρες σύνολο εργαλείων οργανωμένων σε κατηγορίες:
Ο Λογαριασμός σας
| Tool | Description |
|---|---|
user_profile | Λάβετε πληροφορίες του προφίλ σας |
user_companies | Λίστα της εταιρείας στην οποία περιορίζεται το API key σας |
user_notifications | Λάβετε τις πρόσφατες ειδοποιήσεις σας |
Διαχείριση Εταιρείας & Ομάδας
| Tool | Description |
|---|---|
company_list | Λίστα της εταιρείας στην οποία περιορίζεται το API key σας |
company_get | Λάβετε λεπτομέρειες μιας συγκεκριμένης εταιρείας |
company_members_list | Λίστα μελών εταιρείας με τους ρόλους τους |
company_chatbots_list | Λίστα όλων των chatbots μιας εταιρείας |
company_update | Ενημέρωση ονόματος εταιρείας, περιγραφής ή ρυθμίσεων |
Διαχείριση Chatbot
| Tool | Description |
|---|---|
chatbot_list | Λίστα όλων των chatbots με συνοπτικά στατιστικά |
chatbot_get | Λάβετε λεπτομέρειες και διαμόρφωση chatbot |
chatbot_get_instructions | Λάβετε τις βασικές οδηγίες για ένα chatbot |
chatbot_add_instruction | Προσθέστε μια νέα βασική οδηγία |
chatbot_update_instruction | Ενημερώστε μια υπάρχουσα βασική οδηγία |
chatbot_delete_instruction | Διαγράψτε μια βασική οδηγία |
chatbot_update_personality | Ενημέρωση τόνου, γλώσσας και μηνυμάτων |
chatbot_toggle_active | Ενεργοποιήστε ή απενεργοποιήστε ένα chatbot |
chatbot_toggle_learning | Ενεργοποίηση ή απενεργοποίηση της φάσης μάθησης |
widget_settings_get | Λάβετε τις τρέχουσες ρυθμίσεις widget |
widget_settings_update | Ενημέρωση εμφάνισης widget (χρώματα, μέγεθος, θέση) |
Διαχείριση FAQ
| Tool | Description |
|---|---|
faq_list | Λίστα όλων των FAQs για ένα chatbot |
faq_get | Λάβετε λεπτομέρειες FAQ |
faq_create | Δημιουργία νέου FAQ |
faq_update | Ενημέρωση υπάρχοντος FAQ |
faq_delete | Διαγραφή FAQ |
faq_categories_list | Λίστα κατηγοριών FAQ |
faq_suggestions_list | Λίστα εκκρεμών προτάσεων FAQ που δημιουργήθηκαν από συνομιλίες |
Βάση Γνώσης
| Tool | Description |
|---|---|
knowledge_documents_list | Λίστα εγγράφων στη βάση γνώσης ενός chatbot |
knowledge_document_get | Λάβετε λεπτομέρειες συγκεκριμένου εγγράφου |
knowledge_document_delete | Διαγραφή εγγράφου από τη βάση γνώσης |
knowledge_stats | Λάβετε στατιστικά της βάσης γνώσης |
Η ανίχνευση ιστοσελίδας (website crawling) διαχειρίζεται από το dashboard — δείτε το Knowledge Base.
Διαχείριση Leads
| Tool | Description |
|---|---|
lead_list | Λίστα leads με προαιρετική φιλτράρισμα κατά κατάσταση ή κατηγορία |
lead_get | Λάβετε πλήρεις λεπτομέρειες lead συμπεριλαμβανομένης της συνομιλίας πηγής |
lead_update | Ενημέρωση κατάστασης, κατηγορίας ή σημειώσεων ενός lead |
lead_delete | Μόνιμη διαγραφή lead |
lead_categories_list | Λίστα κατηγοριών lead |
lead_stats | Λάβετε στατιστικά leads συμπεριλαμβανομένων μετρήσεων κατά κατάσταση |
lead_field_config_get | Λάβετε τη διαμόρφωση πεδίων σύλληψης lead |
Ιστορικό Συνομιλιών
| Tool | Description |
|---|---|
chat_sessions_list | Λίστα συνεδριών συνομιλιών με προαιρετικά φίλτρα |
chat_session_get | Λάβετε μια συνομιλία με όλα τα μηνύματά της |
chat_session_search | Αναζήτηση συνομιλιών με βάση το περιεχόμενο μηνυμάτων ή πληροφορίες επισκέπτη |
Analytics
| Tool | Description |
|---|---|
analytics_overview | Λάβετε αριθμούς συνομιλιών, πλήθος μηνυμάτων και ποσοστά ικανοποίησης |
analytics_chat_volume | Λάβετε τον όγκο συνομιλιών με την πάροδο του χρόνου για διαγράμματα και τάσεις |
Improvement Agent
| Tool | Description |
|---|---|
improvement_sessions_list | Λίστα συνεδριών βελτίωσης |
improvement_session_get | Λάβετε λεπτομέρειες συνεδρίας συμπεριλαμβανομένων προτάσεων |
improvement_proposals_pending | Λίστα εκκρεμών προτάσεων που περιμένουν έλεγχο |
improvement_proposal_approve | Εγκρίνετε μια πρόταση και εφαρμόστε την αλλαγή |
improvement_proposal_reject | Απορρίψτε μια πρόταση |
Ζωντανή Συνομιλία (Live Chat)
| Tool | Description |
|---|---|
live_chat_sessions_list | Λίστα ζωντανών συνομιλιών |
live_chat_session_get | Λάβετε μια ζωντανή συνομιλία με όλα τα μηνύματα |
live_chat_queue | Λάβετε τις συνεδρίες που περιμένουν για έναν πράκτορα |
Τα εργαλεία ζωντανής συνομιλίας είναι μόνο για ανάγνωση. Για να συνομιλήσετε άμεσα με επισκέπτες, χρησιμοποιήστε το dashboard Live Chat.
Παραδείγματα Ροών Εργασίας
Προσθήκη Βασικής Οδηγίας
Ζητήστε από τον βοηθό AI σας:
"Προσθέστε μια βασική οδηγία στο chatbot 'Support Bot' μου: προσφέρουμε δωρεάν αποστολή σε παραγγελίες άνω των €50"
Ο βοηθός θα χρησιμοποιήσει το chatbot_add_instruction με τα κατάλληλα παραμέτρους.
Επισκόπηση Προτάσεων Βελτίωσης
"Δείξτε μου όλες τις εκκρεμείς προτάσεις βελτίωσης για το chatbot μου και εξηγήστε ποιες αλλαγές προτείνουν"
Ο βοηθός θα:
- Χρησιμοποιήσει το
improvement_proposals_pendingγια να αντλήσει τις προτάσεις - Αναλύσει και συνοψίσει κάθε πρόταση
- Τις εγκρίνει ή απορρίψει εκ μέρους σας με
improvement_proposal_approveήimprovement_proposal_reject
Ανάλυση Απόδοσης Συνομιλιών
"Δώστε μου εβδομαδιαία αναφορά για τον όγκο συνομιλιών και την ικανοποίηση πελατών για το chatbot μου"
Ο βοηθός θα χρησιμοποιήσει τα analytics_overview και analytics_chat_volume για να συντάξει μια ολοκληρωμένη αναφορά.
Ασφάλεια
- Τα API keys περιορίζονται στην εταιρεία σας
- Τα κλειδιά μπορούν να ανακληθούν οποιαδήποτε στιγμή από το dashboard
- Η πρόσβαση API είναι διαθέσιμη σε πληρωμένα πακέτα — δείτε τη Pricing page
Αντιμετώπιση Προβλημάτων
Απέτυχε η Σύνδεση
- Επιβεβαιώστε ότι το API key είναι σωστό
- Ελέγξτε ότι το κλειδί δεν έχει ανακληθεί
- Βεβαιωθείτε ότι το πλάνο σας περιλαμβάνει πρόσβαση API
- Επανεκκινήστε τον MCP client σας
Εργαλείο Δεν Βρέθηκε
Επανεκκινήστε τον MCP client σας μετά την αλλαγή της διαμόρφωσης ώστε να επαναφορτωθούν τα διαθέσιμα εργαλεία. Τα ονόματα εργαλείων είναι με πεζά και με κάτω παύλες (π.χ., faq_list).
Χρειάζεστε βοήθεια; Contact our support team →