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
- Μεταβείτε στον Dashboard → Settings → API Keys
- Κάντε κλικ στο Create API Key
- Δώστε στο κλειδί σας ένα περιγραφικό όνομα (π.χ. "Claude Desktop")
- Αντιγράψτε το δημιουργημένο κλειδί (ξεκινάει με
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
| Tool | Description |
|---|---|
company_list | List all companies you have access to |
company_get | Get details of a specific company |
company_team_list | List team members of a company |
Chatbot Management
| Tool | Description |
|---|---|
chatbot_list | List all chatbots in a company |
chatbot_get | Get chatbot details and configuration |
chatbot_create | Create a new chatbot |
chatbot_update | Update chatbot settings |
chatbot_get_instructions | Get core instructions for a chatbot |
chatbot_add_instruction | Add a new core instruction |
FAQ Management
| Tool | Description |
|---|---|
faq_list | List all FAQs for a chatbot |
faq_get | Get FAQ details |
faq_create | Create a new FAQ |
faq_update | Update an existing FAQ |
faq_delete | Delete an FAQ |
faq_categories_list | List FAQ categories |
faq_suggest | Generate AI-suggested FAQs |
Knowledge Base
| Tool | Description |
|---|---|
knowledge_list_documents | List uploaded documents |
knowledge_list_websites | List crawled websites |
knowledge_crawl_website | Start a website crawl |
knowledge_get_crawl_status | Check crawl progress |
Analytics
| Tool | Description |
|---|---|
analytics_overview | Get overall performance metrics |
analytics_chat_volume | Get chat volume over time |
analytics_feedback | Get feedback and ratings |
analytics_chat_history | Browse chat sessions |
analytics_get_session | Get detailed session data |
Improvement Agent
| Tool | Description |
|---|---|
improvement_list_sessions | List improvement sessions |
improvement_start_session | Start a new analysis session |
improvement_list_proposals | List improvement proposals |
improvement_get_proposal | Get proposal details |
improvement_create_proposal | Create a custom proposal |
improvement_simulate_proposal | Preview proposal effects |
improvement_apply_proposal | Apply a proposal |
improvement_reject_proposal | Reject a proposal |
Live Chat
| Tool | Description |
|---|---|
livechat_get_queue | Get waiting chat sessions |
livechat_get_active_sessions | List active human agent sessions |
livechat_get_session | Get session details |
livechat_assign_session | Assign yourself to a session |
livechat_send_message | Send a message as agent |
livechat_close_session | Close a chat session |
livechat_check_availability | Check 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 θα:
- Χρησιμοποιήσει
improvement_list_proposalsγια να λάβει τις προτάσεις - Αναλύσει και να συνοψίσει κάθε πρόταση
- Σας βοηθήσει να αποφασίσετε ποιες να εφαρμόσετε
Ανάλυση Απόδοσης 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
Αντιμετώπιση Προβλημάτων
Αποτυχία Σύνδεσης
- Επαληθεύστε ότι το API key σας είναι σωστό
- Ελέγξτε ότι το key δεν έχει ανακληθεί
- Βεβαιωθείτε ότι έχετε ενεργή σύνδεση στο διαδίκτυο
- Επανεκκινήστε τον MCP client σας
Tool Not Found
Ορισμένα εργαλεία απαιτούν συγκεκριμένα δικαιώματα. Βεβαιωθείτε ότι έχετε τον κατάλληλο ρόλο στην εταιρεία (Owner, Admin, or Manager).
Rate Limited
Αν δείτε σφάλματα rate limit, περιμένετε ένα λεπτό πριν επαναδοκιμάσετε. Σκεφτείτε να ομαδοποιήσετε τις ενέργειες όταν είναι δυνατόν.
Χρειάζεστε βοήθεια; Contact our support team →