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 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
  • Die Wissensdatenbank aufbauen — Dokumente hinzufügen, Websites crawlen, gecrawlte Seiten und Core-Instructions verwalten
  • FAQs verwalten — FAQs, Kategorien, Vorschläge, Übersetzungen und das FAQ-Widget
  • Chats prüfen — Konversationen bewerten, Confidence-Kategorien zuweisen, den Improvement Agent ausführen
  • Mit Leads und Formularen arbeiten — Leads, Lead-Kategorien, Erfassungseinstellungen, Kontaktformulare und Einsendungen
  • Als Live-Chat-Agent agieren — Verfügbarkeit setzen, wartende Chats übernehmen, antworten und Sitzungen schließen
  • Ihr Unternehmen administrieren — Profil, Markenfarben, Teammitglieder und Einladungen
  • Den Email Assistant nutzen — Postfachverbindungen, Kategorien, Kontakte und Aktivitäten
  • Analysen und Benachrichtigungen lesen

Alles, was Sie im Dashboard tun können, ist über MCP (und die REST API) verfügbar; nur browsergebundene Aktionen wie Zahlungen, Mailbox-OAuth, Passkeys, Kontolöschung und API-Schlüsselverwaltung bleiben im Dashboard.

Erste Schritte

1. Einen API-Schlüssel erstellen

  1. Navigieren Sie zu Ihrem Dashboard → Unternehmen → API Tab
  2. Klicken Sie auf API-Schlüssel erstellen
  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 keys are available on paid plans — see our Pricing page.

Bewahren Sie Ihren API-Schlüssel sicher auf. Er kann nach der Erstellung nicht wieder 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 Ihre Einstellungen in Cursor unter MCP 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 command-basierte Server, verwenden Sie also die standardmäßige mcp-remote Bridge, um die gehostete Endpoint 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"
      ]
    }
  }
}

Für dieses Setup muss Node.js installiert sein. Das Beispiel verwendet den X-API-Key Header, weil einige Clients Leerzeichen in Argumenten nicht zuverlässig verarbeiten.

3. Ihren KI-Assistenten neu starten

Nachdem Sie die Konfiguration gespeichert haben, starten Sie Claude Desktop oder Cursor neu, um die Verbindung herzustellen.

Verfügbare Tools

ChatReact MCP stellt die unten aufgeführten Tools bereit, gruppiert nach Bereich. Die Scope-Spalte zeigt die Berechtigung, die ein API-Schlüssel für ein Tool benötigt (any = jeder gültige Schlüssel). Tools laufen mit denselben anwendbaren Berechtigungen, Planlimits und Nebenwirkungen wie die unterstützten Dashboard-Operationen. Browsergebundene Zahlungs-, Mailbox-Autorisierungs-, Passkey-, Konto-Lösch- und Schlüsselverwaltungs-Workflows bleiben im Dashboard.

Destruktive Tools (löschen, zurücksetzen, schließen, zusammenführen) verlangen im Dashboard Assistant eine Bestätigung. Über den API-Schlüssel führen sie sofort aus.

Account

ToolBeschreibungScope
account_usage_getErmittelt den aktuellen Plan (Tier, Status), die Nutzungszähler des aktuellen Abrechnungszeitraums (companies, chatbots, team members, chats, tokens) und die Planlimits sowie die effektiven Limits und Feature-Flags der Firma, auf die der Aufruf bezogen ist.any
user_companiesListet alle Firmen auf, auf die der aktuelle Benutzer Zugriff hat, mit der Rolle des Benutzers in jeder.any
user_notification_mark_readMarkiert eine der Benachrichtigungen des aktuellen Benutzers als gelesen.any
user_notification_preferences_getRuft die Benachrichtigungseinstellungen des aktuellen Benutzers ab: globale E-Mail-/Push-Schalter, Digest-Frequenz/-Zeit/-Wochentag/-Zeitzone, Ruhezeiten und kanalbezogene Einstellungen pro Typ.any
user_notification_preferences_updateAktualisiert die globalen Benachrichtigungseinstellungen des aktuellen Benutzers (E-Mail-/Push-Schalter, Digest-Plan, Ruhezeiten).any
user_notification_type_setting_updateAktiviert oder deaktiviert E-Mail-/In-App-Zustellung für einen einzelnen Benachrichtigungstyp des aktuellen Benutzers (z. B.any
user_notification_types_listListet alle Benachrichtigungstypen gruppiert nach Kategorie (chatbot, leads, live chat, knowledge, team, billing).any
user_notification_unread_countErmittelt die Anzahl ungelesener Benachrichtigungen des aktuellen Benutzers.any
user_notificationsListet die Benachrichtigungen des aktuellen Benutzers auf, neueste zuerst, mit Cursor-Paginierung.any
user_notifications_delete_oldHousekeeping: Löscht dauerhaft die Benachrichtigungen des aktuellen Benutzers, die bereits gelesen sind und älter als 30 Tage sind.any
user_notifications_mark_all_readMarkiert alle Benachrichtigungen des aktuellen Benutzers als gelesen.any
user_profileRuft das Profil des aktuellen Benutzers ab (id, name, email, role, subscription tier).any

Company & Team

ToolBeschreibungScope
company_chatbots_listListet alle Chatbots einer bestimmten Firma mit zusammenfassenden Statistiken.chatbots:read
company_getRuft detaillierte Informationen zu einer Firma ab: Profil, Eigentümer, Brand-Einstellungen (Farben, Benachrichtigungs-E-Mail) und Zähler.any
company_invite_cancelWiderruft (löscht) eine Teameinladung, sodass der Link nicht mehr funktioniert.company:write
company_invite_resendSendet eine ausstehende Teameinladung erneut: erstellt ein neues Token, verlängert die Gültigkeit um 7 Tage und sendet die Einladung erneut per E-Mail.company:write
company_invites_listListet Teameinladungen einer Firma auf (standardmäßig ausstehend; includeExpired zurückgeben, um auch abgelaufene zu erhalten).company:read
company_listListet alle Firmen auf, auf die der Benutzer Zugriff hat (API-Schlüssel und der Dashboard Assistant sehen nur ihre eigene Firma).any
company_logo_removeEntfernt das Firmenlogo (löscht das gespeicherte Bild und entfernt die Logo-URL).company:write
company_member_inviteLädt ein Teammitglied per E-Mail mit einer Rolle ein (ADMIN, MANAGER, AGENT oder VIEWER).company:write
company_member_removeEntfernt ein Teammitglied aus der Firma.company:write
company_member_update_roleÄndert die Rolle eines Teammitglieds (ADMIN, MANAGER, AGENT oder VIEWER).company:write
company_members_listListet die Mitglieder einer Firma mit ihren Rollen auf (OWNER, ADMIN, MANAGER, AGENT, VIEWER).any
company_settings_updateAktualisiert die Brand-Einstellungen der Firma: primaryColor / secondaryColor (#RRGGBB) und die notificationEmail für Chat-Reviews.company:write
company_updateAktualisiert das Firmenprofil: Name (2-100 Zeichen), Beschreibung (max. 1000 Zeichen) oder Website (https:// wird automatisch hinzugefügt; leeren String übergeben, um Website/Beschreibung zu löschen).company:write

Chatbot-Verwaltung

ToolBeschreibungScope
chatbot_add_instructionFügt einer Chatbot-Core-Instruction hinzu (1-5000 Zeichen).chatbots:write
chatbot_confirm_embedMarkiert einen Chatbot als auf der Website eingebettet (versteckt die Setup-Erinnerung im Dashboard).chatbots:write
chatbot_createErstellt einen neuen Chatbot (wie der Dashboard-Wizard).chatbots:write
chatbot_deleteLöscht einen Chatbot dauerhaft mit allen seinen FAQs, Dokumenten, Chats, Leads und Formularen (nicht rückgängig).chatbots:write
chatbot_delete_instructionLöscht eine Core-Instruction aus einem Chatbot.chatbots:write
chatbot_getRuft detaillierte Informationen zu einem Chatbot ab: allgemeine Einstellungen, Persönlichkeit (Persona, Tonalität, Sprachen, Einschränkungen), Widget-Einstellungen, Live-Chat, Lernphase, Embed-Status und Zähler.chatbots:read
chatbot_get_embed_codeRuft das HTML-Snippet zum Installieren eines Chatbots auf einer Website ab (Script-URL + <script>-Tag) und ob das Embed bestätigt wurde.chatbots:read
chatbot_get_instructionsRuft alle Core-Instructions eines Chatbots ab.chatbots:read
chatbot_improve_instructionsÜberarbeitet den Core-Instruction-Text mit dem Plattform-AI-Verbesserer (wie 'Improve with AI' im Dashboard).chatbots:write
chatbot_learning_phase_getRuft die Lernphasen-Einstellungen eines Chatbots ab: Behaviour-Preset (CAUTIOUS, BALANCED, CONFIDENT), benutzerdefinierter Prompt und ob der Bot noch in der Lernphase ist.chatbots:read
chatbot_learning_phase_updateSetzt das Lernphase-Behaviour-Preset (CAUTIOUS = bei Unsicherheit an einen Menschen verweisen, BALANCED, CONFIDENT) und/oder einen benutzerdefinierten Lernphase-Prompt.chatbots:write
chatbot_listListet alle Chatbots auf, auf die der Benutzer Zugriff hat, mit zusammenfassenden Statistiken.chatbots:read
chatbot_reorder_instructionsSetzt die Reihenfolge der Core-Instructions eines Chatbots.chatbots:write
chatbot_templates_listListet die Chatbot-Templates (Voreinstellungen für Persona, Tonalität, Nachrichten und Widget-Verhalten), die als templateId an chatbot_create übergeben werden können, und ob der Firmenplan sie nutzen darf.chatbots:read
chatbot_toggle_activeAktiviert oder deaktiviert einen Chatbot.chatbots:write
chatbot_toggle_learningBeendet (false) oder reaktiviert (true) die Lernphase eines Chatbots.chatbots:write
chatbot_updateAktualisiert allgemeine Einstellungen eines Chatbots: Name, Beschreibung, isActive, Live-Chat (liveChatEnabled/liveChatMode, Plan-Feature), showBranding (White-Label-Pläne), Chat-Review-E-Mails, automatische FAQ-Generierung, legacy coreInstructions Text, Lernphase (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt).chatbots:write
chatbot_update_instructionAktualisiert eine bestehende Core-Instruction (content, isActive, channel, sortOrder).chatbots:write
chatbot_update_personalityAktualisiert die Persönlichkeit eines Chatbots: Persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), Tonalität-Slider 1-5, Sprachen (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), Nachrichten (welcomeMessage, fallbackMessage, proactive greeting) und Einschränkungen (blacklistTopics, complianceRules, maxResponseLength, human handoff).chatbots:write
widget_settings_getRuft die aktuellen Widget-Einstellungen für einen Chatbot ab (alle Erscheinungsbild-, Branding-, Verhaltens- und Pre-Chat-Form-Felder).chatbots:read
widget_settings_updateAktualisiert das Chat-Widget eines Chatbots: Position (inkl.chatbots:write
widget_translations_getRuft die pro Sprache vorhandenen Widget-Übersetzungen eines Chatbots ab: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }.chatbots:read
widget_translations_updateSetzt pro-sprachige Widget-Übersetzungen.chatbots:write

Wissensdatenbank

ToolBeschreibungScope
crawler_job_cancelBricht einen PENDING- oder RUNNING-Crawl-Job ab; verbleibende Seiten werden übersprungen.knowledge:write
crawler_job_getRuft den Status eines Crawl-Jobs, Fortschritt (pagesCrawled/pagesFound, tokensUsed) und den Status jeder Seite ab.knowledge:read
crawler_jobs_listListet die Crawl-Jobs eines Chatbots (neueste zuerst) mit Status und Fortschritt.knowledge:read
crawler_limitsRuft die Crawl-Limits des Plans für einen Chatbot ab (max Seiten pro Crawl, Tokens pro Seite, Crawls pro Monat) und ob in diesem Monat ein neuer Crawl gestartet werden kann.knowledge:read
crawler_preview_scanScannt eine Website und listet crawlbare Seiten (url, title, isRecommended) ohne etwas zu importieren.knowledge:write
crawler_startStartet einen Crawl-Job, der die ausgewählten URLs in die Wissensdatenbank des Chatbots importiert (wird im Hintergrund verarbeitet; poll crawler_job_get).knowledge:write
knowledge_document_add_from_urlLädt ein Dokument (PDF, TXT, MD, CSV, JSON, DOCX; max. 10 MB) von einer öffentlichen http(s)-URL herunter und fügt es der Wissensdatenbank eines Chatbots hinzu.knowledge:write
knowledge_document_add_textFügt ein Text- oder Markdown-Dokument aus Inline-Inhalt zur Wissensdatenbank eines Chatbots hinzu (max. 10 MB).knowledge:write
knowledge_document_deleteLöscht ein hochgeladenes Dokument aus der Wissensdatenbank.knowledge:write
knowledge_document_getRuft Details eines hochgeladenen Dokuments ab, einschließlich Verarbeitungsstatus, Fehlermeldung und einer kurzlebigen Download-URL.knowledge:read
knowledge_documents_listListet die hochgeladenen Dokumente (PDF, TXT, MD, CSV, JSON, DOCX) in der Wissensdatenbank eines Chatbots mit Status und Größe auf.knowledge:read
knowledge_page_addCrawlt eine einzelne URL und fügt sie der Wissensdatenbank des Chatbots hinzu (fehlschlägt mit CONFLICT, wenn die URL bereits indexiert ist, FORBIDDEN, wenn das Token-Limit erreicht ist).knowledge:write
knowledge_page_deleteLöscht eine gecrawlte Seite aus der Wissensdatenbank (entfernt ihre Vector-Store-Datei).knowledge:write
knowledge_page_getRuft eine gecrawlte Seite ab, einschließlich des für den Chatbot indexierten Markdown-Inhalts (nützlich, um zu überprüfen, was der Bot über eine Seite weiß).knowledge:read
knowledge_page_recrawlHolt eine gecrawlte Seite erneut und ersetzt ihren indexierten Inhalt (z. B.knowledge:write
knowledge_pages_deleteLöscht mehrere gecrawlte Seiten eines Chatbots auf einmal.knowledge:write
knowledge_pages_listListet gecrawlte Seiten in der Wissensdatenbank eines Chatbots auf, optional gefiltert nach Domain, Status oder Suchbegriff (URL/Titel).knowledge:read
knowledge_statsÜbersicht über die Wissensdatenbank eines Chatbots: Dokumente (nach Status, Größe), gecrawlte Seiten und Websites (nach Status), Crawl-Jobs, Core-Instructions nach Quelle (manuell vs. Improvement Agent), FAQs, Vector-Store-Status/Größe und Speicherplatznutzung vs.knowledge:read
knowledge_website_deleteLöscht jede gecrawlte Seite einer Website (Domain) aus der Wissensdatenbank des Chatbots.knowledge:write
knowledge_website_recrawlRecrawlt jede Seite einer Website (Domain) in der Wissensdatenbank des Chatbots, um deren Inhalte zu aktualisieren.knowledge:write
knowledge_website_recrawl_cancelBricht einen laufenden Website-Re-Crawl ab: in der Warteschlange (PENDING) befindliche Seiten der Domain werden in ihren vorherigen indexierten Zustand zurückversetzt.knowledge:write
knowledge_websites_listListet die Websites (Domains) auf, deren Seiten sich in der Wissensdatenbank eines Chatbots befinden, mit Seitenanzahlen nach Status und Token-Summen.knowledge:read

Preisverwaltung

Diese Tools verwalten strukturierte Preis-Entwürfe und explizite Genehmigungen. Das Speichern eines Entwurfs ist getrennt von der Genehmigung der exakten Version; die Berechtigung hängt auch vom Status und der Gültigkeit ab. Bestehende API-Schlüssel erhalten nicht automatisch Preis-Berechtigungen. Nur der Firmeninhaber kann prices:write oder prices:approve gewähren. API-Key-Aufrufe führen direkt aus, prüfen Sie daher die genaue Eingabe, bevor Sie eine Mutation aufrufen. Siehe Prices & services für den Kunden-Workflow.

ToolBeschreibungScope
price_listPaginierung durch Price Heads und separate Berechtigung für genehmigte Versionen.prices:read
price_getLiest den vollständigen Zustand eines Artikels und Revisionen.prices:read
price_detailLiest Artikel-Details mit paginierter Revisionshistorie.prices:read
price_suggestions_listPaginierung durch Preisvorschläge.prices:read
price_reviews_listUnklare Preisfunde auflisten, die eine Entscheidung brauchen.prices:read
price_createErstellt einen Entwurf mit servergenerierter Artikel-ID.prices:write
price_editErstellt einen neuen Entwurf aus einer explizit erwarteten Artikelversion.prices:write
price_import_csvImportiert Entwürfe mit explizitem Format und stabilem Import-ID für sichere Wiederholungen.prices:write
price_suggestion_applyWendet den ausgewählten Vorschlagskandidaten als Entwurf an.prices:write
price_suggestion_dismissVerwirft einen offenen Scan-Vorschlag; derselbe Fund wird nicht erneut vorgeschlagen. Ändert keinen Preis.prices:write
price_review_dismissVerwirft einen unklaren Fall aus einem Scan (runId und caseIndex); derselbe Fall erscheint nicht erneut. Ändert keinen Preis.prices:write
price_approveGenehmigt eine explizit erwartete Artikelversion.prices:approve
price_approve_manyGenehmigt eine explizite ID/Versionsauswahl atomar; jede veraltete Version lehnt die gesamte Auswahl ab.prices:approve
price_archiveArchiviert einen Artikel in seiner explizit erwarteten Version.prices:approve

Entwurfsänderungen bewahren die vorherige genehmigte Revision. CSV-Format und Dezimaltrennzeichen müssen explizit sein; geänderter CSV-Inhalt erfordert eine neue Import-ID. Alle Operationen sind an die Firma des API-Schlüssels und den angegebenen Chatbot gebunden.

FAQ-Verwaltung

ToolBeschreibungScope
faq_cache_purgeLöscht zwischengespeicherte FAQ-Widget-Daten auf allen verbundenen CMS-Seiten (WordPress-Plugin).faqs:write
faq_categories_listListet die FAQ-Kategorien eines Chatbots mit deren FAQ-Anzahlen, Slugs, Sortiermodus und Übersetzungen.faqs:read
faq_categories_reorderSetzt die Reihenfolge der FAQ-Kategorien im Widget: Position in categoryIds wird zum sortOrder.faqs:write
faq_category_createErstellt eine FAQ-Kategorie für einen Chatbot (Slug wird aus dem Namen generiert).faqs:write
faq_category_deleteLöscht eine FAQ-Kategorie.faqs:write
faq_category_translations_updateErsetzt die Übersetzungen einer FAQ-Kategorie, z. B.faqs:write
faq_category_updateBenennt eine FAQ-Kategorie um oder ändert deren Beschreibung, Icon oder Sortiermodus.faqs:write
faq_createErstellt eine FAQ für einen Chatbot.faqs:write
faq_deleteLöscht eine FAQ dauerhaft (entfernt sie auch aus der Wissensdatenbank des Chatbots und purgt CMS-Widget-Caches).faqs:write
faq_embed_code_getRuft die Embed-Snippets für das FAQ-Widget ab: Script-Tag und WordPress-Shortcode sowie per-Kategorie-Varianten (use categorySlug from faq_categories_list, um nur eine Kategorie einzubetten).chatbots:read
faq_getRuft die vollständigen Details einer FAQ ab: Frage, Antwort, Kategorie, Veröffentlichungsstatus, Sortierreihenfolge, Übersetzungen, SEO-Felder und Feedback-Statistiken.faqs:read
faq_listListet FAQs eines Chatbots auf (use chatbot_list, um die chatbotId zu finden).faqs:read
faq_reorderSetzt die Anzeigereihenfolge von FAQs im Widget.faqs:write
faq_suggestion_approveGenehmigt einen PENDING-FAQ-Vorschlag: erstellt eine veröffentlichte FAQ (optional mit bearbeiteter Frage/Antwort/Kategorie) und markiert den Vorschlag als APPROVED.faqs:write
faq_suggestion_getRuft die vollständigen Details eines FAQ-Vorschlags ab (komplette Antwort, AI-Begründung, vorgeschlagene Kategorie, Prüfstatus).faqs:read
faq_suggestion_rejectLehnt einen PENDING-FAQ-Vorschlag mit optionalem Grund ab.faqs:write
faq_suggestions_generateLässt die KI neue FAQs aus der Wissensdatenbank des Chatbots vorschlagen (gecrawlte Seiten / hochgeladene Dokumente), optional für eine Kategorie.faqs:write
faq_suggestions_listListet AI-generierte FAQ-Vorschläge eines Chatbots auf (aus Chats oder faq_suggestions_generate).faqs:read
faq_translateÜbersetzt Frage und Antwort einer FAQ mit AI in die anderen unterstützten Sprachen des Chatbots (oder die angegebenen targetLanguages) und speichert das Ergebnis.faqs:write
faq_translations_updateSpeichert Übersetzungen einer FAQ pro Sprache, z. B.faqs:write
faq_updateAktualisiert Frage, Antwort, Kategorie, Veröffentlichungsstatus oder manuelle Sortierreihenfolge einer FAQ.faqs:write
faq_widget_settings_getRuft die Erscheinungs- und Verhaltenseinstellungen des einbettbaren FAQ-Widgets ab (Farben, Border-Radius, Titel, Abstände, maxWidth, allowMultipleOpen, autoOpenFirst, Sortiermodus, Titelübersetzungen).chatbots:read
faq_widget_settings_updateAktualisiert die FAQ-Widget-Einstellungen: Farben (Hex), borderRadius 0-32, Titel (max. 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0-2000 (0 = volle Breite), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name und Titelübersetzungen pro Sprache.chatbots:write

Chatverlauf & Feedback

ToolBeschreibungScope
chat_feedback_dismissMarkiert einen Chat als überprüft, ohne ihn zu bewerten (entfernt ihn aus der Pending-Queue, ändert nicht die Confidence-Score).chats:write
chat_feedback_getRuft eine Chat-Review (Feedback) mit AI-Analyse, Severity, Confidence-Kategorie, Score-Änderung und der verknüpften Improvement-Session ab.chats:read
chat_feedback_listListet Chat-Reviews (Feedback-Zeilen) eines Chatbots mit Statusfilter und Zählern auf.chats:read
chat_feedback_set_severityÜberschreibt die Severity-Klassifikation (MINOR|MODERATE|MAJOR|CRITICAL) eines überprüften negativen Chats; Severity gewichtet den Confidence-Score-Abfall.chats:write
chat_feedback_statsSitzungszählungen pro Review-Bucket für einen Chatbot (total, none, pending, positive, negative, reviewed, improved) — die Statistik-Karten der Dashboard-Chats-Seite.chats:read
chat_feedback_submitBewertet eine Chat-Sitzung als Good (isPositive=true) oder Needs Work (isPositive=false).chats:write
chat_session_getRuft eine Chat-Sitzung mit vollständigem Transkript (pro Nachricht Token/Modell/Latenz/pageUrl), Besucherinformationen, gestarteter Seiten-URL, Confidence-Kategorie, Feedback (Severity, AI-Analyse, verknüpfte Improvement-Session) und Tags ab.chats:read
chat_session_searchDurchsucht Chat-Sitzungen eines Chatbots nach Nachrichteninhalt und/oder Besucher-E-Mail.chats:read
chat_session_set_categoryWeist einer Chat-Sitzung eine Confidence-Kategorie zu oder ändert sie (korrigiert die AI-Kategorisierung; per Kategorie Confidence wird neu berechnet, wenn der Chat überprüft wurde).chats:write
chat_sessions_listListet Chat-Sitzungen eines Chatbots auf, neueste zuerst, mit denselben Review-Queue-Filtern wie die Dashboard-Chats-Seite.chats:read

Improvement Agent

ToolBeschreibungScope
confidence_categories_listListet die Confidence-Kategorien eines Chatbots mit per-Kategorie Confidence-Score, Review-Anzahl und Review-E-Mail-Frequenz.chats:read
confidence_category_createErstellt eine Confidence-Kategorie für einen Chatbot.chatbots:write
confidence_category_deleteLöscht eine Confidence-Kategorie.chatbots:write
confidence_category_mergeFührt das Zusammenführen einer Confidence-Kategorie in eine andere desselben Chatbots durch: alle Chats/Reviews werden in das Ziel verschoben, die Quelle wird gelöscht und Scores neu berechnet.chatbots:write
confidence_category_updateBennennt eine Confidence-Kategorie um und/oder setzt ihre Review-E-Mail-Frequenz (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1-24 nur für HOURLY).chatbots:write
confidence_status_getConfidence-Status eines Chatbots: Score, Graduation-Threshold, Lernphasen-Flag, Lernphase-Behaviour (CAUTIOUS|BALANCED|CONFIDENT) und benutzerdefinierter Prompt, Review-Zählungen und per-Kategorie Confidence-Scores.analytics:read
improvement_proposal_approveGenehmigt einen PENDING-Improvement-Vorschlag und wendet die Änderung auf den Chatbot an (Core-Instruction hinzufügen/aktualisieren, FAQ erstellen/aktualisieren oder Persona aktualisieren) — gleiche Logik und Plan-Limits wie im Dashboard.chatbots:write
improvement_proposal_rejectLehnt einen PENDING-Improvement-Vorschlag ab.chatbots:write
improvement_proposal_simulateSimuliert, wie der Chatbot auf die problematische Nachricht mit einem angewendeten Vorschlag antworten würde (original vs.chatbots:write
improvement_proposals_pendingListet Improvement-Vorschläge, die auf Überprüfung warten (Status PENDING), firmenweit oder für einen Chatbot auf.chatbots:read
improvement_session_completeMarkiert eine Improvement-Session als COMPLETED (der Chat zählt dann als Improved in der Review-Queue).chatbots:write
improvement_session_createÖffnet den Improvement Agent für einen als Needs Work bewerteten Chat.chatbots:write
improvement_session_getRuft eine Improvement-Session ab mit dem Original-Chat (Nachrichten haben einen 1-basierten Index, nutzbar als targetMessageIndex), dem Agenten-Dialog, allen Vorschlägen (mit deren letzter Simulation) und Simulationen.chatbots:read
improvement_session_resetStartet eine Improvement-Session neu: löscht alle Agenten-Nachrichten, Simulationen und PENDING/REJECTED-Vorschläge (angewendete werden beibehalten) und beginnt eine neue Konversation.chatbots:write
improvement_session_send_messageSendet eine Nachricht an den Improvement Agent (beschreiben Sie, was an der Antwort des Bots falsch war; optional targetMessageIndex = der 1-basierte Index der Bot-Nachricht in originalChat.messages).chatbots:write
improvement_sessions_listListet Improvement-Sessions (Improvement Agent-Konversationen, die aus negativen Chat-Reviews gestartet wurden) für einen Chatbot oder die gesamte Firma, neueste zuerst, mit Vorschlagsanzahl.chatbots:read
improvement_simulation_assessBewertet ein Simulationsergebnis: isApproved=true, wenn die simulierte Antwort gut ist (der Vorschlag kann dann angewendet werden), false wenn noch Arbeit nötig ist (Kommentar 'almost' = fast richtig).chatbots:write

Live Chat

ToolBeschreibungScope
live_chat_agents_availableRuft die Live-Chat-Verfügbarkeit des aktuellen Benutzers ab, die derzeit verfügbaren Agenten für Live-Chat (frischer Heartbeat, dasselbe Signal, das das Widget verwendet) und ob der Firmenplan Live-Chat beinhaltet.chats:read
live_chat_heartbeatAktualisiert den Live-Chat-Presence-Heartbeat des aktuellen Benutzers (nur während er als verfügbar markiert ist via live_chat_set_availability).chats:write
live_chat_message_sendSendet eine Nachricht an den Besucher als zugewiesener Agent.chats:write
live_chat_queueRuft die Live-Chat-Warteschlange ab: Sitzungen, die auf einen Agenten warten, älteste zuerst (FIFO).chats:read
live_chat_session_assignÜbernimmt eine WAITING-Live-Chat-Sitzung aus der Warteschlange: weist sie dem aktuellen Benutzer zu (Firmeninhaber für API-Schlüssel) und benachrichtigt den Besucher, dass der Agent beigetreten ist.chats:write
live_chat_session_closeBeendet eine Live-Chat-Sitzung als Agent (jeder nicht-VIEWER-Firmenmitglied).chats:write
live_chat_session_getRuft eine Live-Chat-Sitzung mit Besucherinformationen, zugewiesenem Agent, allen Nachrichten und dem vorherigen Bot-Gespräch (Handoff-Kontext) ab.chats:read
live_chat_sessions_listListet Live-Chat-Sitzungen auf (neueste zuerst; WAITING-Sitzungen älteste zuerst) mit optionalen Filtern nach Chatbot, Status und zugewiesenem Agenten.chats:read
live_chat_set_availabilitySchaltet den 'Available for Live Chat'-Schalter des aktuellen Benutzers für eine Firma um.chats:write

Leads

ToolBeschreibungScope
lead_assignWeist einen Lead einem Firmenmitglied zu oder entfernt die Zuordnung (assignedToId: null).leads:write
lead_bulk_update_statusSetzt den Status mehrerer Leads (max. 100) auf einmal.leads:write
lead_categories_listListet die Lead-Kategorien eines Chatbots mit Lead-Anzahlen und den pro Kategorie benachrichtigten Teammitgliedern.leads:read
lead_category_assign_userFügt ein Firmenmitglied zur Benachrichtigungsliste einer Lead-Kategorie hinzu (oder aktualisiert dessen Benachrichtigungsflags).leads:write
lead_category_createErstellt eine Lead-Kategorie für einen Chatbot.leads:write
lead_category_deleteLöscht eine Lead-Kategorie.leads:write
lead_category_remove_userEntfernt ein Firmenmitglied aus der Benachrichtigungsliste einer Lead-Kategorie.leads:write
lead_category_updateAktualisiert den Namen, die Beschreibung und/oder die Farbe einer Lead-Kategorie.leads:write
lead_createErstellt einen Lead manuell (z. B.leads:write
lead_deleteLöscht einen Lead dauerhaft.leads:write
lead_field_config_getRuft die Lead-Capture-Konfiguration eines Chatbots ab: Felder (ids entsprechen Schlüsseln in lead.data), Bestätigungsnachricht, Feld-/UI-Übersetzungen und AI-Erkennungs-Einstellungen.leads:read
lead_field_config_updateAktualisiert die Lead-Capture-Konfiguration eines Chatbots.leads:write
lead_getRuft vollständige Details eines Leads ab, einschließlich Zuständiger, Kategorie und des Quell-Chat-Transkripts (paginiert mit messageOffset/messageLimit, standardmäßig die ersten 20 Nachrichten).leads:read
lead_listListet Leads eines Chatbots auf (neueste zuerst) mit optionalen Filtern nach Status, Kategorie, Zuständigem und Freitextsuche (Name/E-Mail/Firma).leads:read
lead_statsRuft Lead-Statistiken für einen Chatbot ab: Zählungen nach Status, Leads der letzten 7 Tage und die Conversion-Rate (Prozent).leads:read
lead_updateAktualisiert den Status, die Kategorie, Notizen, erfasste Daten und/oder den Zuständigen eines Leads.leads:write

Formulare

ToolBeschreibungScope
form_createErstellt ein Kontaktformular für einen Chatbot (Basis, Felder, Design und Spam-Einstellungen in einem Aufruf).forms:write
form_deleteLöscht ein Kontaktformular und ALLE seine Einsendungen dauerhaft (Kaskade).forms:write
form_getRuft ein Kontaktformular vollständig ab: Felder, Übersetzungen, Styling, Spam-Einstellungen, aktiver Zustand, Einsendeanzahl und das Embed-Script-Tag (embedCode).forms:read
form_listListet die Kontaktformulare eines Chatbots mit Feldanzahlen, Einsendeanzahlen und Embed-Codes.forms:read
form_statsEinsendeanzahlen eines Kontaktformulars: total, pending, approved, spam und rejected.forms:read
form_submission_deleteLöscht eine Einsendung eines Kontaktformulars dauerhaft (z. B.forms:write
form_submission_getRuft eine Einsendung eines Kontaktformulars vollständig ab: übermittelte Feld-Daten, Spam-Score und AI-Spam-Analyse, IP/User-Agent/Referrer-Metadaten und Prüfungsinformationen.forms:read
form_submission_update_statusPrüft eine Einsendung eines Kontaktformulars: setzt deren Status auf APPROVED, SPAM oder REJECTED mit optionaler Prüfnotiz.forms:write
form_submissions_listListet Einsendungen eines Kontaktformulars auf, neueste zuerst, optional gefiltert nach Status (PENDING, APPROVED, SPAM, REJECTED) und Erstellungsdatum.forms:read
form_updateAktualisiert ein Kontaktformular: Name, Beschreibung, aktiver Zustand (isActive steuert, ob das Embed gerendert wird), Felder (vollständiger Ersatz), Design (Farben, Button-Text, Erfolgsmeldung) und Spam-Einstellungen (spamThreshold, autoRejectSpam, notificationEmail).forms:write
form_update_translationsErsetzt die Feld- und/oder UI-Übersetzungen eines Kontaktformulars.forms:write

Email Assistant

ToolBeschreibungScope
email_activity_listListet das verarbeitete E-Mail-Aktivitätsprotokoll einer Mailbox-Verbindung (neueste zuerst): Absender, Betreff, zugewiesene Kategorie, Ergebnis (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) und outcomeDetail.email:read
email_categories_listListet die E-Mail-Kategorien einer Mailbox-Verbindung auf (geordnet nach sortOrder).email:read
email_category_createErstellt eine E-Mail-Kategorie für eine Mailbox-Verbindung (max. 20 pro Verbindung).email:write
email_category_deleteLöscht eine E-Mail-Kategorie.email:write
email_category_updateAktualisiert eine E-Mail-Kategorie (partiell: nur die übergebenen Felder ändern sich).email:write
email_connection_disconnectTrennt eine Mailbox dauerhaft.email:write
email_connection_getRuft eine Mailbox-Verbindung inkl.email:read
email_connection_updateAktualisiert eine Mailbox-Verbindung: pausiert/setzt die Synchronisierung fort (paused true/false; toggelt nur ACTIVE<->DISABLED, überschreibt niemals TOKEN_EXPIRED/ERROR), schaltet Reply-Drafting (draftingEnabled) und Kategorisieren/Organisieren (organizingEnabled) um, zeigt auf den betreibenden Chatbot um (chatbotId derselben Firma) oder setzt die HTML-Antwortsignatur (signatureHtml, max. 20000 Zeichen; leerer String löscht sie).email:write
email_connections_listListet die Mailbox-Verbindungen des Unternehmens für den Email Assistant auf (Adresse, Status ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, letzte Synchronisierung, letzte Fehlermeldung, Drafting/Organizing-Toggles, betreibender Chatbot, draftReadyCategoryCount = Kategorien, die Entwürfe liefern können, baseRuleCount = chatbot-weite 'Chat + Email'-Regeln, die jedem Entwurf zugeordnet sind) zusammen mit den Plan-Limits (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth).email:read
email_contact_deleteLöscht einen gelernten E-Mail-Kontakt (vergisst das Profil des Absenders, z. B.email:write
email_contact_getRuft einen gelernten E-Mail-Kontakt mit allen gelernten Fakten, internen Notizen, Beziehung, Formal-/Informal-Ansprache-Einstellung und E-Mail-Statistiken ab.email:read
email_contact_updateAktualisiert einen gelernten E-Mail-Kontakt.email:write
email_contacts_listListet die gelernten E-Mail-Kontakte der Firma auf (neueste E-Mail zuerst) mit Beziehung, formal/informal Address (formalAddress: true = formelles 'Sie', false = informelles 'Du', null = automatisch), Faktenanzahl und einer Notizvorschau.email:read
email_folder_createErstellt einen Mail-Ordner unter dem Posteingang (gibt den bestehenden zurück, falls der Name vergeben ist), der als Ziel für Kategorie-Verschiebungen verwendet werden kann.email:write
email_folders_listListet die Ordner auf, in die eine E-Mail-Kategorie Mails verschieben kann, live aus dem Postfach: Inbox-Subfolders, benutzerdefinierte Top-Level-Ordner, Archive, Junk und Trash (id 'deleteditems').email:read
email_general_rules_listListet die chatbot-weiten Regeln auf, die auf jeden Antwort-Entwurf einer Mailbox angewendet werden: aktive Core-Instructions mit Kanal BOTH ("Chat + Email"), plus legacy E-Mail-only, die noch nicht in eine Kategorie migriert wurden.email:read

Analytics

ToolBeschreibungScope
analytics_chat_volumeChat-Volumen (gestartete Sitzungen) über die Zeit für Diagramme und Trends: Zeitraum week/month/quarter/year, Granularität hour/day/week/month, optional für einen Chatbot.analytics:read
analytics_chatbot_statsPerformance pro Chatbot einer Firma in einem Aufruf (die Chatbot-Performance-Tabelle im Dashboard): id, name, slug, isActive, sessions, messages, FAQs und leads pro Chatbot, sortiert nach Sessions.analytics:read
analytics_formsStatistiken zu Kontaktformular-Einsendungen für eine Firma oder einen Chatbot (Dashboard-Analytics-Widget): Einsendungen nach Status (pending/approved/rejected/spam), Anzahl Formulare, Gesamtanzahl, Spam-Rate in Prozent und die Einsendungen-pro-Tag-Reihe der letzten 7 Tage.analytics:read
analytics_leadsLead-Funnel für eine Firma oder einen Chatbot (Dashboard-Analytics-Widget): Leads nach Status (new/contacted/qualified/converted/lost), Gesamtanzahl, Conversion-Rate in Prozent und die Leads-pro-Tag-Reihe der letzten 7 Tage.analytics:read
analytics_overviewAnalytics-Übersicht für eine Firma oder einen Chatbot: Chats, Nachrichten, Zufriedenheitsrate und Top-Fragen für einen rollierenden Zeitraum (day/week/month/year), plus das Dashboard-Overview-Widget (insgesamt Chatbots/published FAQs/leads, Sitzungen heute/diese Woche/diesen Monat, Leads heute/diese Woche, Form-Einsendungen gesamt/heute/pending).analytics:read
dashboard_activityWas derzeit Aufmerksamkeit benötigt (die Dashboard-Startansicht): pro Firma die Chatbots mit neuen Leads heute, ausstehenden FAQ-Vorschlägen, ausstehenden Form-Einsendungen, wartenden/aktiven Live-Chats oder einer laufenden Lernphase.any

Beispiel-Workflows

Hinzufügen einer Core-Instruction

Fragen Sie Ihren KI-Assistenten:

"Füge meinem 'Support Bot' eine Core-Instruction hinzu: wir bieten kostenlosen Versand bei Bestellungen über €50 an"

Der Assistent wird chatbot_add_instruction mit den entsprechenden Parametern verwenden.

Überprüfen von Improvement-Vorschlägen

"Zeig 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. Jeden Vorschlag analysieren und zusammenfassen
  3. Sie in Ihrem Namen mit improvement_proposal_approve oder improvement_proposal_reject genehmigen oder ablehnen

Analyse der Chat-Performance

"Gib 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.

Importieren einer Website

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

Der Assistent wird crawler_preview_scan aufrufen, die relevanten Seiten auswählen, den Import mit crawler_start starten und crawler_job_get pollen, bis der Job beendet ist.

Überprüfen von Leads und Form-Einsendungen

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

Der Assistent kombiniert lead_list, lead_assign, form_submissions_list und form_submission_update_status.

Übernehmen eines Live-Chats

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

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

Sicherheit

  • API-Schlüssel sind auf Ihre Firma und die Berechtigungs-Scope eingeschränkt, die Sie bei der Erstellung auswählen (siehe die Scope-Spalte oben)
  • Schlüssel führen mit den Berechtigungen des Firmeninhabers aus; Planlimits und Feature-Gates gelten exakt wie im Dashboard
  • Schlüssel können jederzeit im Dashboard widerrufen werden
  • API-Zugriff ist in kostenpflichtigen Plänen verfügbar — siehe unsere Pricing page

Problemlösung

Verbindung fehlgeschlagen

  1. Überprüfen Sie, ob Ihr API-Schlüssel korrekt ist
  2. Prüfen Sie, ob der Schlüssel nicht 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 Ihren MCP-Client nach Änderung der Konfiguration neu, damit er die verfügbaren Tools neu lädt. Tool-Namen sind kleingeschrieben mit Unterstrichen (z. B. faq_list).


Brauchen Sie Hilfe? Kontaktieren Sie unser Support-Team →