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 — Chatbots erstellen, konfigurieren (Persona, Sprachen, Widget, Verhalten, Einschränkungen), einbetten und löschen
• Wissensdatenbank aufbauen — Dokumente hinzufügen, Websites crawlen, gecrawlte Seiten und Kernanweisungen verwalten
• FAQs verwalten — FAQs, Kategorien, Vorschläge, Übersetzungen und das FAQ-Widget
• Chats prüfen — Konversationen bewerten, Confidence-Kategorien zuweisen, den Improvement Agent nutzen
• Leads und Formulare bearbeiten — Leads, Lead-Kategorien, Erfassungseinstellungen, Kontaktformulare und Einsendungen
• Als Live-Chat-Agent arbeiten — Verfügbarkeit setzen, wartende Chats übernehmen, antworten und Sitzungen beenden
• Unternehmen administrieren — Profil, Markenfarben, Teammitglieder und Einladungen
• E-Mail-Assistent nutzen — Postfach-Verbindungen, Kategorien, Kontakte und Aktivität
• Analysen und Benachrichtigungen lesen

Alles, was Sie im Dashboard tun können, steht auch über MCP (und die REST-API) zur Verfügung; nur browsergebundene Aktionen wie Zahlungen, Postfach-OAuth, Passkeys, Kontolöschung und die Verwaltung von API-Schlüsseln bleiben im Dashboard.

Erste Schritte

1. API-Schlüssel generieren

1. Navigieren Sie zu Ihrem Dashboard → Company → 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_)

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"
      ]
    }
  }
}

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 die folgenden Tools bereit, gruppiert nach Bereich. Die Spalte Scope zeigt die Berechtigung, die der API-Schlüssel für ein Tool benötigt (any = jeder gültige Schlüssel). Alles, was im Dashboard möglich ist, steht auch hier zur Verfügung; die Tools laufen mit denselben Berechtigungen, Plan-Limits und Nebeneffekten wie das Dashboard.

Ihr Konto

Unternehmen & Team

Chatbot-Verwaltung

Wissensdatenbank

FAQ-Verwaltung

Chatverlauf & Feedback

Improvement Agent

Live-Chat

Lead-Management

Kontaktformulare

E-Mail-Assistent

Analysen

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.

Eine Website importieren

„Scanne https://example.com, importiere die Produkt- und Preisseiten in meinen 'Support Bot' und sag mir Bescheid, wenn der Crawl fertig ist"

Der Assistent ruft crawler_preview_scan auf, wählt die passenden Seiten aus, startet den Import mit crawler_start und fragt crawler_job_get ab, bis der Job abgeschlossen ist.

Leads und Formular-Einsendungen prüfen

„Zeig mir die neuen Leads dieser Woche, weise die qualifizierten Anna zu und genehmige die ausstehenden Kontaktformular-Einsendungen"

Der Assistent kombiniert lead_list, lead_assign, form_submissions_list und form_submission_update_status.

Einen Live-Chat übernehmen

„Setze mich für den Live-Chat auf verfügbar und übernimm die älteste wartende Konversation"

Der Assistent verwendet live_chat_set_availability, live_chat_queue und live_chat_session_assign; Antworten laufen über live_chat_message_send.

Sicherheit

• API-Schlüssel sind auf Ihre Firma und auf die beim Erstellen gewählten Berechtigungs-Scopes beschränkt (siehe Spalte Scope oben)
• Schlüssel arbeiten mit den Rechten des Firmeninhabers; Plan-Limits und Feature-Freischaltungen gelten genau wie im Dashboard
• 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 →