HomeDocumentation

MCP Server Integration

Το ChatReact υλοποιεί το Model Context Protocol (MCP), επιτρέποντάς σας να συνδέσετε τον λογαριασμό ChatReact με AI assistants όπως το Claude Desktop, το Cursor και άλλα εργαλεία συμβατά με MCP.

Τι είναι το MCP;

Το Model Context Protocol είναι ένα ανοιχτό πρότυπο που επιτρέπει στα AI assistants να αλληλεπιδρούν με εξωτερικές υπηρεσίες και πηγές δεδομένων. Με την ενσωμάτωση MCP του ChatReact, μπορείτε να:

  • Διαχειρίζεστε chatbots απευθείας από το AI assistant σας
  • Δημιουργείτε και ενημερώνετε FAQs χρησιμοποιώντας φυσική γλώσσα
  • Προβάλετε analytics και ιστορικό συνομιλιών
  • Ελέγχετε τον Improvement Agent για την βελτιστοποίηση του chatbot
  • Διαχειρίζεστε live chat sessions χωρίς να εγκαταλείπετε το AI εργαλείο σας

Ξεκινώντας

1. Δημιουργία API Key

  1. Μεταβείτε στον DashboardSettingsAPI Keys
  2. Κάντε κλικ στο Create API Key
  3. Δώστε στο κλειδί σας ένα περιγραφικό όνομα (π.χ. "Claude Desktop")
  4. Αντιγράψτε το δημιουργημένο κλειδί (ξεκινάει με cr_)

Αποθηκεύστε το API key σας με ασφάλεια. Δεν μπορεί να ανακτηθεί μετά τη δημιουργία.

2. Διαμόρφωση του MCP Client σας

Claude Desktop

Προσθέστε τα παρακάτω στο αρχείο ρυθμίσεων του 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

Προσθέστε στις ρυθμίσεις Cursor MCP σας:

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

Τοπική Ανάπτυξη (stdio)

Για τοπική ανάπτυξη, μπορείτε να χρησιμοποιήσετε το npm package μας:

npm install -g @chatreact/mcp

Ρυθμίστε στον MCP client σας:

{
  "mcpServers": {
    "chatreact": {
      "command": "chatreact-mcp",
      "args": ["--api-key", "cr_your_api_key_here"]
    }
  }
}

3. Επανεκκινήστε τον AI Assistant σας

Αφού αποθηκεύσετε τη διαμόρφωση, επανεκκινήστε το Claude Desktop ή το Cursor για να καθιερώσετε τη σύνδεση.

Διαθέσιμα Εργαλεία

Το ChatReact MCP παρέχει πάνω από 30 εργαλεία οργανωμένα σε κατηγορίες:

Company & Team Management

ToolDescription
company_listList all companies you have access to
company_getGet details of a specific company
company_team_listList team members of a company

Chatbot Management

ToolDescription
chatbot_listList all chatbots in a company
chatbot_getGet chatbot details and configuration
chatbot_createCreate a new chatbot
chatbot_updateUpdate chatbot settings
chatbot_get_instructionsGet core instructions for a chatbot
chatbot_add_instructionAdd a new core instruction

FAQ Management

ToolDescription
faq_listList all FAQs for a chatbot
faq_getGet FAQ details
faq_createCreate a new FAQ
faq_updateUpdate an existing FAQ
faq_deleteDelete an FAQ
faq_categories_listList FAQ categories
faq_suggestGenerate AI-suggested FAQs

Knowledge Base

ToolDescription
knowledge_list_documentsList uploaded documents
knowledge_list_websitesList crawled websites
knowledge_crawl_websiteStart a website crawl
knowledge_get_crawl_statusCheck crawl progress

Analytics

ToolDescription
analytics_overviewGet overall performance metrics
analytics_chat_volumeGet chat volume over time
analytics_feedbackGet feedback and ratings
analytics_chat_historyBrowse chat sessions
analytics_get_sessionGet detailed session data

Improvement Agent

ToolDescription
improvement_list_sessionsList improvement sessions
improvement_start_sessionStart a new analysis session
improvement_list_proposalsList improvement proposals
improvement_get_proposalGet proposal details
improvement_create_proposalCreate a custom proposal
improvement_simulate_proposalPreview proposal effects
improvement_apply_proposalApply a proposal
improvement_reject_proposalReject a proposal

Live Chat

ToolDescription
livechat_get_queueGet waiting chat sessions
livechat_get_active_sessionsList active human agent sessions
livechat_get_sessionGet session details
livechat_assign_sessionAssign yourself to a session
livechat_send_messageSend a message as agent
livechat_close_sessionClose a chat session
livechat_check_availabilityCheck agent availability

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

Δημιουργία Νέου Chatbot

Ρωτήστε τον AI assistant σας:

"Create a new chatbot called 'Support Bot' for my company 'acme-corp' with a friendly, professional tone"

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

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

"Show me all pending improvement proposals for my chatbot and explain what changes they suggest"

Ο assistant θα:

  1. Χρησιμοποιήσει improvement_list_proposals για να λάβει τις προτάσεις
  2. Αναλύσει και να συνοψίσει κάθε πρόταση
  3. Σας βοηθήσει να αποφασίσετε ποιες να εφαρμόσετε

Ανάλυση Απόδοσης Chat

"Give me a weekly report of chat volume and customer satisfaction for my chatbot"

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

Ασφάλεια

  • Τα API keys είναι συνδεδεμένα με τον λογαριασμό χρήστη και την πρόσβαση στην εταιρεία σας
  • Όλα τα αιτήματα καταγράφονται στο audit trail
  • Τα keys μπορούν να ανακληθούν ανά πάσα στιγμή από το dashboard
  • Ισχύουν όρια ρυθμού: 60 requests/minute

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

Αποτυχία Σύνδεσης

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

Tool Not Found

Ορισμένα εργαλεία απαιτούν συγκεκριμένα δικαιώματα. Βεβαιωθείτε ότι έχετε τον κατάλληλο ρόλο στην εταιρεία (Owner, Admin, or Manager).

Rate Limited

Αν δείτε σφάλματα rate limit, περιμένετε ένα λεπτό πριν επαναδοκιμάσετε. Σκεφτείτε να ομαδοποιήσετε τις ενέργειες όταν είναι δυνατόν.


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