ΑρχικήΤεκμηρίωση

Ενσωμάτωση 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

  1. Πλοηγηθείτε στο DashboardCompany → καρτέλα API
  2. Κάντε κλικ στο Create API Key
  3. Δώστε στο κλειδί σας ένα περιγραφικό όνομα (π.χ. "Claude Desktop") και επιλέξτε τουλάχιστον μία άδεια
  4. Αντιγράψτε το δημιουργημένο κλειδί (ξεκινά με 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 παρέχει ένα πλήρες σύνολο εργαλείων οργανωμένων σε κατηγορίες:

Ο Λογαριασμός σας

ToolDescription
user_profileΛάβετε πληροφορίες του προφίλ σας
user_companiesΛίστα της εταιρείας στην οποία περιορίζεται το API key σας
user_notificationsΛάβετε τις πρόσφατες ειδοποιήσεις σας

Διαχείριση Εταιρείας & Ομάδας

ToolDescription
company_listΛίστα της εταιρείας στην οποία περιορίζεται το API key σας
company_getΛάβετε λεπτομέρειες μιας συγκεκριμένης εταιρείας
company_members_listΛίστα μελών εταιρείας με τους ρόλους τους
company_chatbots_listΛίστα όλων των chatbots μιας εταιρείας
company_updateΕνημέρωση ονόματος εταιρείας, περιγραφής ή ρυθμίσεων

Διαχείριση Chatbot

ToolDescription
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

ToolDescription
faq_listΛίστα όλων των FAQs για ένα chatbot
faq_getΛάβετε λεπτομέρειες FAQ
faq_createΔημιουργία νέου FAQ
faq_updateΕνημέρωση υπάρχοντος FAQ
faq_deleteΔιαγραφή FAQ
faq_categories_listΛίστα κατηγοριών FAQ
faq_suggestions_listΛίστα εκκρεμών προτάσεων FAQ που δημιουργήθηκαν από συνομιλίες

Βάση Γνώσης

ToolDescription
knowledge_documents_listΛίστα εγγράφων στη βάση γνώσης ενός chatbot
knowledge_document_getΛάβετε λεπτομέρειες συγκεκριμένου εγγράφου
knowledge_document_deleteΔιαγραφή εγγράφου από τη βάση γνώσης
knowledge_statsΛάβετε στατιστικά της βάσης γνώσης

Η ανίχνευση ιστοσελίδας (website crawling) διαχειρίζεται από το dashboard — δείτε το Knowledge Base.

Διαχείριση Leads

ToolDescription
lead_listΛίστα leads με προαιρετική φιλτράρισμα κατά κατάσταση ή κατηγορία
lead_getΛάβετε πλήρεις λεπτομέρειες lead συμπεριλαμβανομένης της συνομιλίας πηγής
lead_updateΕνημέρωση κατάστασης, κατηγορίας ή σημειώσεων ενός lead
lead_deleteΜόνιμη διαγραφή lead
lead_categories_listΛίστα κατηγοριών lead
lead_statsΛάβετε στατιστικά leads συμπεριλαμβανομένων μετρήσεων κατά κατάσταση
lead_field_config_getΛάβετε τη διαμόρφωση πεδίων σύλληψης lead

Ιστορικό Συνομιλιών

ToolDescription
chat_sessions_listΛίστα συνεδριών συνομιλιών με προαιρετικά φίλτρα
chat_session_getΛάβετε μια συνομιλία με όλα τα μηνύματά της
chat_session_searchΑναζήτηση συνομιλιών με βάση το περιεχόμενο μηνυμάτων ή πληροφορίες επισκέπτη

Analytics

ToolDescription
analytics_overviewΛάβετε αριθμούς συνομιλιών, πλήθος μηνυμάτων και ποσοστά ικανοποίησης
analytics_chat_volumeΛάβετε τον όγκο συνομιλιών με την πάροδο του χρόνου για διαγράμματα και τάσεις

Improvement Agent

ToolDescription
improvement_sessions_listΛίστα συνεδριών βελτίωσης
improvement_session_getΛάβετε λεπτομέρειες συνεδρίας συμπεριλαμβανομένων προτάσεων
improvement_proposals_pendingΛίστα εκκρεμών προτάσεων που περιμένουν έλεγχο
improvement_proposal_approveΕγκρίνετε μια πρόταση και εφαρμόστε την αλλαγή
improvement_proposal_rejectΑπορρίψτε μια πρόταση

Ζωντανή Συνομιλία (Live Chat)

ToolDescription
live_chat_sessions_listΛίστα ζωντανών συνομιλιών
live_chat_session_getΛάβετε μια ζωντανή συνομιλία με όλα τα μηνύματα
live_chat_queueΛάβετε τις συνεδρίες που περιμένουν για έναν πράκτορα

Τα εργαλεία ζωντανής συνομιλίας είναι μόνο για ανάγνωση. Για να συνομιλήσετε άμεσα με επισκέπτες, χρησιμοποιήστε το dashboard Live Chat.

Παραδείγματα Ροών Εργασίας

Προσθήκη Βασικής Οδηγίας

Ζητήστε από τον βοηθό AI σας:

"Προσθέστε μια βασική οδηγία στο chatbot 'Support Bot' μου: προσφέρουμε δωρεάν αποστολή σε παραγγελίες άνω των €50"

Ο βοηθός θα χρησιμοποιήσει το chatbot_add_instruction με τα κατάλληλα παραμέτρους.

Επισκόπηση Προτάσεων Βελτίωσης

"Δείξτε μου όλες τις εκκρεμείς προτάσεις βελτίωσης για το chatbot μου και εξηγήστε ποιες αλλαγές προτείνουν"

Ο βοηθός θα:

  1. Χρησιμοποιήσει το improvement_proposals_pending για να αντλήσει τις προτάσεις
  2. Αναλύσει και συνοψίσει κάθε πρόταση
  3. Τις εγκρίνει ή απορρίψει εκ μέρους σας με improvement_proposal_approve ή improvement_proposal_reject

Ανάλυση Απόδοσης Συνομιλιών

"Δώστε μου εβδομαδιαία αναφορά για τον όγκο συνομιλιών και την ικανοποίηση πελατών για το chatbot μου"

Ο βοηθός θα χρησιμοποιήσει τα analytics_overview και analytics_chat_volume για να συντάξει μια ολοκληρωμένη αναφορά.

Ασφάλεια

  • Τα API keys περιορίζονται στην εταιρεία σας
  • Τα κλειδιά μπορούν να ανακληθούν οποιαδήποτε στιγμή από το dashboard
  • Η πρόσβαση API είναι διαθέσιμη σε πληρωμένα πακέτα — δείτε τη Pricing page

Αντιμετώπιση Προβλημάτων

Απέτυχε η Σύνδεση

  1. Επιβεβαιώστε ότι το API key είναι σωστό
  2. Ελέγξτε ότι το κλειδί δεν έχει ανακληθεί
  3. Βεβαιωθείτε ότι το πλάνο σας περιλαμβάνει πρόσβαση API
  4. Επανεκκινήστε τον MCP client σας

Εργαλείο Δεν Βρέθηκε

Επανεκκινήστε τον MCP client σας μετά την αλλαγή της διαμόρφωσης ώστε να επαναφορτωθούν τα διαθέσιμα εργαλεία. Τα ονόματα εργαλείων είναι με πεζά και με κάτω παύλες (π.χ., faq_list).


Χρειάζεστε βοήθεια; Contact our support team →