MCP Server Integration
ChatReact implementiert das Model Context Protocol (MCP), sodass Sie Ihr ChatReact-Konto mit KI-Assistenten wie Claude Desktop, Cursor und anderen MCP-kompatiblen Tools verbinden können.
Was ist MCP?
Das Model Context Protocol ist ein offener Standard, der es KI-Assistenten ermöglicht, mit externen Diensten und Datenquellen zu interagieren. Mit der MCP-Integration von ChatReact können Sie:
- Chatbots verwalten — Anweisungen, Persönlichkeit und Widget-Einstellungen aktualisieren
- FAQs erstellen und aktualisieren mit natürlicher Sprache
- Analysen, Chatverlauf und Leads einsehen
- Vorschläge des Improvement Agent überprüfen und genehmigen oder ablehnen
- Live-Chat-Sitzungen und die Warteschlange überwachen
Erste Schritte
1. API-Schlüssel generieren
- Navigieren Sie zu Ihrem Dashboard → Company → Registerkarte API
- Klicken Sie auf Create API Key
- Geben Sie Ihrem Schlüssel einen beschreibenden Namen (z. B. „Claude Desktop“) und wählen Sie mindestens eine Berechtigung aus
- Kopieren Sie den generierten Schlüssel (beginnt mit
cr_)
API-Schlüssel sind in kostenpflichtigen Plänen verfügbar — siehe unsere Pricing page.
Bewahren Sie Ihren API-Schlüssel sicher auf. Er kann nach der Erstellung nicht mehr abgerufen werden.
2. Ihren MCP-Client konfigurieren
Der ChatReact MCP-Server ist unter https://www.chatreact.ai/api/mcp gehostet und kommuniziert über HTTP (JSON-RPC). Authentifizieren Sie sich mit einem Authorization: Bearer-Header — ein X-API-Key-Header mit demselben Schlüssel wird ebenfalls akzeptiert.
Cursor IDE
Cursor unterstützt Remote-MCP-Server direkt. Fügen Sie die folgenden Einstellungen zu Ihren Cursor-MCP-Einstellungen hinzu:
{
"mcpServers": {
"chatreact": {
"url": "https://www.chatreact.ai/api/mcp",
"headers": {
"Authorization": "Bearer cr_your_api_key_here"
}
}
}
}
Claude Desktop
Die Konfigurationsdatei von Claude Desktop unterstützt befehlsbasierte Server, verwenden Sie also die standardmäßige mcp-remote-Brücke, um die gehostete Endpunktadresse zu verbinden:
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"
]
}
}
}
Diese Einrichtung erfordert eine installierte Node.js-Umgebung. Das Beispiel verwendet den X-API-Key-Header, da einige Clients Probleme mit Leerzeichen in Argumenten haben.
3. Starten Sie Ihren KI-Assistenten neu
Nachdem Sie die Konfiguration gespeichert haben, starten Sie Claude Desktop oder Cursor neu, um die Verbindung herzustellen.
Verfügbare Tools
ChatReact MCP stellt eine umfassende Reihe von Tools zur Verfügung, die in Kategorien organisiert sind:
Ihr Konto
| Tool | Beschreibung |
|---|---|
user_profile | Informationen zu Ihrem Profil abrufen |
user_companies | Die Firma auflisten, für die Ihr API-Schlüssel gültig ist |
user_notifications | Ihre letzten Benachrichtigungen abrufen |
Unternehmens- & Teamverwaltung
| Tool | Beschreibung |
|---|---|
company_list | Die Firma auflisten, für die Ihr API-Schlüssel gültig ist |
company_get | Details zu einer bestimmten Firma abrufen |
company_members_list | Firmenmitglieder mit ihren Rollen auflisten |
company_chatbots_list | Alle Chatbots einer Firma auflisten |
company_update | Firmenname, Beschreibung oder Einstellungen aktualisieren |
Chatbot-Verwaltung
| Tool | Beschreibung |
|---|---|
chatbot_list | Alle Chatbots mit zusammenfassenden Statistiken auflisten |
chatbot_get | Chatbot-Details und Konfiguration abrufen |
chatbot_get_instructions | Kernanweisungen für einen Chatbot abrufen |
chatbot_add_instruction | Eine neue Kernanweisung hinzufügen |
chatbot_update_instruction | Eine vorhandene Kernanweisung aktualisieren |
chatbot_delete_instruction | Eine Kernanweisung löschen |
chatbot_update_personality | Tonalität, Sprache und Nachrichten aktualisieren |
chatbot_toggle_active | Einen Chatbot aktivieren oder deaktivieren |
chatbot_toggle_learning | Die Lernphase aktivieren oder deaktivieren |
widget_settings_get | Aktuelle Widget-Einstellungen abrufen |
widget_settings_update | Erscheinungsbild des Widgets aktualisieren (Farben, Größe, Position) |
FAQ-Verwaltung
| Tool | Beschreibung |
|---|---|
faq_list | Alle FAQs für einen Chatbot auflisten |
faq_get | FAQ-Details abrufen |
faq_create | Eine neue FAQ erstellen |
faq_update | Eine vorhandene FAQ aktualisieren |
faq_delete | Eine FAQ löschen |
faq_categories_list | FAQ-Kategorien auflisten |
faq_suggestions_list | Aus Chat-Konversationen generierte ausstehende FAQ-Vorschläge auflisten |
Knowledge Base
| Tool | Beschreibung |
|---|---|
knowledge_documents_list | Dokumente in der Knowledge Base eines Chatbots auflisten |
knowledge_document_get | Details zu einem bestimmten Dokument abrufen |
knowledge_document_delete | Ein Dokument aus der Knowledge Base löschen |
knowledge_stats | Statistiken zur Knowledge Base abrufen |
Website-Crawling wird vom Dashboard aus verwaltet — siehe Knowledge Base.
Lead-Management
| Tool | Beschreibung |
|---|---|
lead_list | Leads mit optionalen Filtern nach Status oder Kategorie auflisten |
lead_get | Vollständige Lead-Details einschließlich der Quell-Chat-Sitzung abrufen |
lead_update | Status, Kategorie oder Notizen eines Leads aktualisieren |
lead_delete | Einen Lead dauerhaft löschen |
lead_categories_list | Lead-Kategorien auflisten |
lead_stats | Lead-Statistiken abrufen, einschließlich Zählungen nach Status |
lead_field_config_get | Konfiguration der Lead-Erfassungsfelder abrufen |
Chatverlauf
| Tool | Beschreibung |
|---|---|
chat_sessions_list | Chat-Sitzungen mit optionalen Filtern auflisten |
chat_session_get | Eine Chat-Sitzung mit allen Nachrichten abrufen |
chat_session_search | Chat-Sitzungen nach Nachrichteninhalt oder Besucherinformationen durchsuchen |
Analysen
| Tool | Beschreibung |
|---|---|
analytics_overview | Chat-Zahlen, Nachrichtenanzahlen und Zufriedenheitsraten abrufen |
analytics_chat_volume | Chat-Volumen über die Zeit für Diagramme und Trends abrufen |
Improvement Agent
| Tool | Beschreibung |
|---|---|
improvement_sessions_list | Improvement-Sitzungen auflisten |
improvement_session_get | Sitzungsdetails einschließlich Vorschlägen abrufen |
improvement_proposals_pending | Ausstehende Vorschläge zur Überprüfung auflisten |
improvement_proposal_approve | Einen Vorschlag genehmigen und die Änderung anwenden |
improvement_proposal_reject | Einen Vorschlag ablehnen |
Live-Chat
| Tool | Beschreibung |
|---|---|
live_chat_sessions_list | Live-Chat-Sitzungen auflisten |
live_chat_session_get | Eine Live-Chat-Sitzung mit allen Nachrichten abrufen |
live_chat_queue | Sitzungen abrufen, die auf einen Agenten warten |
Live-Chat-Tools sind schreibgeschützt. Um direkt mit Besuchern zu chatten, verwenden Sie das Live Chat-Dashboard.
Beispiel-Workflows
Hinzufügen einer Kernanweisung
Bitten Sie Ihren KI-Assistenten:
„Füge eine Kernanweisung zu meinem 'Support Bot'-Chatbot hinzu: wir bieten kostenlosen Versand ab €50 an"
Der Assistent wird chatbot_add_instruction mit den entsprechenden Parametern verwenden.
Überprüfen von Improvement-Vorschlägen
„Zeige mir alle ausstehenden Improvement-Vorschläge für meinen Chatbot und erkläre, welche Änderungen sie vorschlagen"
Der Assistent wird:
improvement_proposals_pendingverwenden, um Vorschläge abzurufen- Jede Suggestion analysieren und zusammenfassen
- Sie in Ihrem Auftrag mit
improvement_proposal_approveoderimprovement_proposal_rejectgenehmigen oder ablehnen
Analyse der Chat-Performance
„Geben Sie mir einen wöchentlichen Bericht über Chat-Volumen und Kundenzufriedenheit für meinen Chatbot"
Der Assistent wird analytics_overview und analytics_chat_volume verwenden, um einen umfassenden Bericht zu erstellen.
Sicherheit
- API-Schlüssel sind auf Ihre Firma beschränkt
- Schlüssel können jederzeit vom Dashboard widerrufen werden
- API-Zugriff ist in kostenpflichtigen Plänen verfügbar — siehe unsere Pricing page
Fehlerbehebung
Verbindung fehlgeschlagen
- Überprüfen Sie, ob Ihr API-Schlüssel korrekt ist
- Prüfen Sie, ob der Schlüssel widerrufen wurde
- Stellen Sie sicher, dass Ihr Plan API-Zugriff enthält
- Starten Sie Ihren MCP-Client neu
Tool nicht gefunden
Starten Sie nach einer Konfigurationsänderung Ihren MCP-Client neu, damit die verfügbaren Tools neu geladen werden. Tool-Namen sind kleingeschrieben und verwenden Unterstriche (z. B. faq_list).
Brauchen Sie Hilfe? Contact our support team →