StartseiteDokumentation

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

  1. Navigieren Sie zu Ihrem DashboardCompany → Registerkarte API
  2. Klicken Sie auf Create API Key
  3. Geben Sie Ihrem Schlüssel einen beschreibenden Namen (z. B. „Claude Desktop“) und wählen Sie mindestens eine Berechtigung aus
  4. 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

ToolBeschreibung
user_profileInformationen zu Ihrem Profil abrufen
user_companiesDie Firma auflisten, für die Ihr API-Schlüssel gültig ist
user_notificationsIhre letzten Benachrichtigungen abrufen

Unternehmens- & Teamverwaltung

ToolBeschreibung
company_listDie Firma auflisten, für die Ihr API-Schlüssel gültig ist
company_getDetails zu einer bestimmten Firma abrufen
company_members_listFirmenmitglieder mit ihren Rollen auflisten
company_chatbots_listAlle Chatbots einer Firma auflisten
company_updateFirmenname, Beschreibung oder Einstellungen aktualisieren

Chatbot-Verwaltung

ToolBeschreibung
chatbot_listAlle Chatbots mit zusammenfassenden Statistiken auflisten
chatbot_getChatbot-Details und Konfiguration abrufen
chatbot_get_instructionsKernanweisungen für einen Chatbot abrufen
chatbot_add_instructionEine neue Kernanweisung hinzufügen
chatbot_update_instructionEine vorhandene Kernanweisung aktualisieren
chatbot_delete_instructionEine Kernanweisung löschen
chatbot_update_personalityTonalität, Sprache und Nachrichten aktualisieren
chatbot_toggle_activeEinen Chatbot aktivieren oder deaktivieren
chatbot_toggle_learningDie Lernphase aktivieren oder deaktivieren
widget_settings_getAktuelle Widget-Einstellungen abrufen
widget_settings_updateErscheinungsbild des Widgets aktualisieren (Farben, Größe, Position)

FAQ-Verwaltung

ToolBeschreibung
faq_listAlle FAQs für einen Chatbot auflisten
faq_getFAQ-Details abrufen
faq_createEine neue FAQ erstellen
faq_updateEine vorhandene FAQ aktualisieren
faq_deleteEine FAQ löschen
faq_categories_listFAQ-Kategorien auflisten
faq_suggestions_listAus Chat-Konversationen generierte ausstehende FAQ-Vorschläge auflisten

Knowledge Base

ToolBeschreibung
knowledge_documents_listDokumente in der Knowledge Base eines Chatbots auflisten
knowledge_document_getDetails zu einem bestimmten Dokument abrufen
knowledge_document_deleteEin Dokument aus der Knowledge Base löschen
knowledge_statsStatistiken zur Knowledge Base abrufen

Website-Crawling wird vom Dashboard aus verwaltet — siehe Knowledge Base.

Lead-Management

ToolBeschreibung
lead_listLeads mit optionalen Filtern nach Status oder Kategorie auflisten
lead_getVollständige Lead-Details einschließlich der Quell-Chat-Sitzung abrufen
lead_updateStatus, Kategorie oder Notizen eines Leads aktualisieren
lead_deleteEinen Lead dauerhaft löschen
lead_categories_listLead-Kategorien auflisten
lead_statsLead-Statistiken abrufen, einschließlich Zählungen nach Status
lead_field_config_getKonfiguration der Lead-Erfassungsfelder abrufen

Chatverlauf

ToolBeschreibung
chat_sessions_listChat-Sitzungen mit optionalen Filtern auflisten
chat_session_getEine Chat-Sitzung mit allen Nachrichten abrufen
chat_session_searchChat-Sitzungen nach Nachrichteninhalt oder Besucherinformationen durchsuchen

Analysen

ToolBeschreibung
analytics_overviewChat-Zahlen, Nachrichtenanzahlen und Zufriedenheitsraten abrufen
analytics_chat_volumeChat-Volumen über die Zeit für Diagramme und Trends abrufen

Improvement Agent

ToolBeschreibung
improvement_sessions_listImprovement-Sitzungen auflisten
improvement_session_getSitzungsdetails einschließlich Vorschlägen abrufen
improvement_proposals_pendingAusstehende Vorschläge zur Überprüfung auflisten
improvement_proposal_approveEinen Vorschlag genehmigen und die Änderung anwenden
improvement_proposal_rejectEinen Vorschlag ablehnen

Live-Chat

ToolBeschreibung
live_chat_sessions_listLive-Chat-Sitzungen auflisten
live_chat_session_getEine Live-Chat-Sitzung mit allen Nachrichten abrufen
live_chat_queueSitzungen 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:

  1. improvement_proposals_pending verwenden, um Vorschläge abzurufen
  2. Jede Suggestion analysieren und zusammenfassen
  3. Sie in Ihrem Auftrag mit improvement_proposal_approve oder improvement_proposal_reject genehmigen 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

  1. Überprüfen Sie, ob Ihr API-Schlüssel korrekt ist
  2. Prüfen Sie, ob der Schlüssel widerrufen wurde
  3. Stellen Sie sicher, dass Ihr Plan API-Zugriff enthält
  4. 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 →