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
- Navigieren Sie zu Ihrem Dashboard → Unternehmen → API Tab
- Klicken Sie auf API-Schlüssel erstellen
- 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 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
| Tool | Beschreibung | Scope |
|---|---|---|
account_usage_get | Ermittelt 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_companies | Listet alle Firmen auf, auf die der aktuelle Benutzer Zugriff hat, mit der Rolle des Benutzers in jeder. | any |
user_notification_mark_read | Markiert eine der Benachrichtigungen des aktuellen Benutzers als gelesen. | any |
user_notification_preferences_get | Ruft 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_update | Aktualisiert die globalen Benachrichtigungseinstellungen des aktuellen Benutzers (E-Mail-/Push-Schalter, Digest-Plan, Ruhezeiten). | any |
user_notification_type_setting_update | Aktiviert oder deaktiviert E-Mail-/In-App-Zustellung für einen einzelnen Benachrichtigungstyp des aktuellen Benutzers (z. B. | any |
user_notification_types_list | Listet alle Benachrichtigungstypen gruppiert nach Kategorie (chatbot, leads, live chat, knowledge, team, billing). | any |
user_notification_unread_count | Ermittelt die Anzahl ungelesener Benachrichtigungen des aktuellen Benutzers. | any |
user_notifications | Listet die Benachrichtigungen des aktuellen Benutzers auf, neueste zuerst, mit Cursor-Paginierung. | any |
user_notifications_delete_old | Housekeeping: Löscht dauerhaft die Benachrichtigungen des aktuellen Benutzers, die bereits gelesen sind und älter als 30 Tage sind. | any |
user_notifications_mark_all_read | Markiert alle Benachrichtigungen des aktuellen Benutzers als gelesen. | any |
user_profile | Ruft das Profil des aktuellen Benutzers ab (id, name, email, role, subscription tier). | any |
Company & Team
| Tool | Beschreibung | Scope |
|---|---|---|
company_chatbots_list | Listet alle Chatbots einer bestimmten Firma mit zusammenfassenden Statistiken. | chatbots:read |
company_get | Ruft detaillierte Informationen zu einer Firma ab: Profil, Eigentümer, Brand-Einstellungen (Farben, Benachrichtigungs-E-Mail) und Zähler. | any |
company_invite_cancel | Widerruft (löscht) eine Teameinladung, sodass der Link nicht mehr funktioniert. | company:write |
company_invite_resend | Sendet 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_list | Listet Teameinladungen einer Firma auf (standardmäßig ausstehend; includeExpired zurückgeben, um auch abgelaufene zu erhalten). | company:read |
company_list | Listet alle Firmen auf, auf die der Benutzer Zugriff hat (API-Schlüssel und der Dashboard Assistant sehen nur ihre eigene Firma). | any |
company_logo_remove | Entfernt das Firmenlogo (löscht das gespeicherte Bild und entfernt die Logo-URL). | company:write |
company_member_invite | Lädt ein Teammitglied per E-Mail mit einer Rolle ein (ADMIN, MANAGER, AGENT oder VIEWER). | company:write |
company_member_remove | Entfernt 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_list | Listet die Mitglieder einer Firma mit ihren Rollen auf (OWNER, ADMIN, MANAGER, AGENT, VIEWER). | any |
company_settings_update | Aktualisiert die Brand-Einstellungen der Firma: primaryColor / secondaryColor (#RRGGBB) und die notificationEmail für Chat-Reviews. | company:write |
company_update | Aktualisiert 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
| Tool | Beschreibung | Scope |
|---|---|---|
chatbot_add_instruction | Fügt einer Chatbot-Core-Instruction hinzu (1-5000 Zeichen). | chatbots:write |
chatbot_confirm_embed | Markiert einen Chatbot als auf der Website eingebettet (versteckt die Setup-Erinnerung im Dashboard). | chatbots:write |
chatbot_create | Erstellt einen neuen Chatbot (wie der Dashboard-Wizard). | chatbots:write |
chatbot_delete | Löscht einen Chatbot dauerhaft mit allen seinen FAQs, Dokumenten, Chats, Leads und Formularen (nicht rückgängig). | chatbots:write |
chatbot_delete_instruction | Löscht eine Core-Instruction aus einem Chatbot. | chatbots:write |
chatbot_get | Ruft 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_code | Ruft 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_instructions | Ruft 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_get | Ruft 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_update | Setzt das Lernphase-Behaviour-Preset (CAUTIOUS = bei Unsicherheit an einen Menschen verweisen, BALANCED, CONFIDENT) und/oder einen benutzerdefinierten Lernphase-Prompt. | chatbots:write |
chatbot_list | Listet alle Chatbots auf, auf die der Benutzer Zugriff hat, mit zusammenfassenden Statistiken. | chatbots:read |
chatbot_reorder_instructions | Setzt die Reihenfolge der Core-Instructions eines Chatbots. | chatbots:write |
chatbot_templates_list | Listet 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_active | Aktiviert oder deaktiviert einen Chatbot. | chatbots:write |
chatbot_toggle_learning | Beendet (false) oder reaktiviert (true) die Lernphase eines Chatbots. | chatbots:write |
chatbot_update | Aktualisiert 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_instruction | Aktualisiert eine bestehende Core-Instruction (content, isActive, channel, sortOrder). | chatbots:write |
chatbot_update_personality | Aktualisiert 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_get | Ruft die aktuellen Widget-Einstellungen für einen Chatbot ab (alle Erscheinungsbild-, Branding-, Verhaltens- und Pre-Chat-Form-Felder). | chatbots:read |
widget_settings_update | Aktualisiert das Chat-Widget eines Chatbots: Position (inkl. | chatbots:write |
widget_translations_get | Ruft die pro Sprache vorhandenen Widget-Übersetzungen eines Chatbots ab: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }. | chatbots:read |
widget_translations_update | Setzt pro-sprachige Widget-Übersetzungen. | chatbots:write |
Wissensdatenbank
| Tool | Beschreibung | Scope |
|---|---|---|
crawler_job_cancel | Bricht einen PENDING- oder RUNNING-Crawl-Job ab; verbleibende Seiten werden übersprungen. | knowledge:write |
crawler_job_get | Ruft den Status eines Crawl-Jobs, Fortschritt (pagesCrawled/pagesFound, tokensUsed) und den Status jeder Seite ab. | knowledge:read |
crawler_jobs_list | Listet die Crawl-Jobs eines Chatbots (neueste zuerst) mit Status und Fortschritt. | knowledge:read |
crawler_limits | Ruft 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_scan | Scannt eine Website und listet crawlbare Seiten (url, title, isRecommended) ohne etwas zu importieren. | knowledge:write |
crawler_start | Startet 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_url | Lä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_text | Fügt ein Text- oder Markdown-Dokument aus Inline-Inhalt zur Wissensdatenbank eines Chatbots hinzu (max. 10 MB). | knowledge:write |
knowledge_document_delete | Löscht ein hochgeladenes Dokument aus der Wissensdatenbank. | knowledge:write |
knowledge_document_get | Ruft Details eines hochgeladenen Dokuments ab, einschließlich Verarbeitungsstatus, Fehlermeldung und einer kurzlebigen Download-URL. | knowledge:read |
knowledge_documents_list | Listet die hochgeladenen Dokumente (PDF, TXT, MD, CSV, JSON, DOCX) in der Wissensdatenbank eines Chatbots mit Status und Größe auf. | knowledge:read |
knowledge_page_add | Crawlt 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_delete | Löscht eine gecrawlte Seite aus der Wissensdatenbank (entfernt ihre Vector-Store-Datei). | knowledge:write |
knowledge_page_get | Ruft 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_recrawl | Holt eine gecrawlte Seite erneut und ersetzt ihren indexierten Inhalt (z. B. | knowledge:write |
knowledge_pages_delete | Löscht mehrere gecrawlte Seiten eines Chatbots auf einmal. | knowledge:write |
knowledge_pages_list | Listet 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_delete | Löscht jede gecrawlte Seite einer Website (Domain) aus der Wissensdatenbank des Chatbots. | knowledge:write |
knowledge_website_recrawl | Recrawlt jede Seite einer Website (Domain) in der Wissensdatenbank des Chatbots, um deren Inhalte zu aktualisieren. | knowledge:write |
knowledge_website_recrawl_cancel | Bricht 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_list | Listet 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.
| Tool | Beschreibung | Scope |
|---|---|---|
price_list | Paginierung durch Price Heads und separate Berechtigung für genehmigte Versionen. | prices:read |
price_get | Liest den vollständigen Zustand eines Artikels und Revisionen. | prices:read |
price_detail | Liest Artikel-Details mit paginierter Revisionshistorie. | prices:read |
price_suggestions_list | Paginierung durch Preisvorschläge. | prices:read |
price_reviews_list | Unklare Preisfunde auflisten, die eine Entscheidung brauchen. | prices:read |
price_create | Erstellt einen Entwurf mit servergenerierter Artikel-ID. | prices:write |
price_edit | Erstellt einen neuen Entwurf aus einer explizit erwarteten Artikelversion. | prices:write |
price_import_csv | Importiert Entwürfe mit explizitem Format und stabilem Import-ID für sichere Wiederholungen. | prices:write |
price_suggestion_apply | Wendet den ausgewählten Vorschlagskandidaten als Entwurf an. | prices:write |
price_suggestion_dismiss | Verwirft einen offenen Scan-Vorschlag; derselbe Fund wird nicht erneut vorgeschlagen. Ändert keinen Preis. | prices:write |
price_review_dismiss | Verwirft einen unklaren Fall aus einem Scan (runId und caseIndex); derselbe Fall erscheint nicht erneut. Ändert keinen Preis. | prices:write |
price_approve | Genehmigt eine explizit erwartete Artikelversion. | prices:approve |
price_approve_many | Genehmigt eine explizite ID/Versionsauswahl atomar; jede veraltete Version lehnt die gesamte Auswahl ab. | prices:approve |
price_archive | Archiviert 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
| Tool | Beschreibung | Scope |
|---|---|---|
faq_cache_purge | Löscht zwischengespeicherte FAQ-Widget-Daten auf allen verbundenen CMS-Seiten (WordPress-Plugin). | faqs:write |
faq_categories_list | Listet die FAQ-Kategorien eines Chatbots mit deren FAQ-Anzahlen, Slugs, Sortiermodus und Übersetzungen. | faqs:read |
faq_categories_reorder | Setzt die Reihenfolge der FAQ-Kategorien im Widget: Position in categoryIds wird zum sortOrder. | faqs:write |
faq_category_create | Erstellt eine FAQ-Kategorie für einen Chatbot (Slug wird aus dem Namen generiert). | faqs:write |
faq_category_delete | Löscht eine FAQ-Kategorie. | faqs:write |
faq_category_translations_update | Ersetzt die Übersetzungen einer FAQ-Kategorie, z. B. | faqs:write |
faq_category_update | Benennt eine FAQ-Kategorie um oder ändert deren Beschreibung, Icon oder Sortiermodus. | faqs:write |
faq_create | Erstellt eine FAQ für einen Chatbot. | faqs:write |
faq_delete | Löscht eine FAQ dauerhaft (entfernt sie auch aus der Wissensdatenbank des Chatbots und purgt CMS-Widget-Caches). | faqs:write |
faq_embed_code_get | Ruft 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_get | Ruft die vollständigen Details einer FAQ ab: Frage, Antwort, Kategorie, Veröffentlichungsstatus, Sortierreihenfolge, Übersetzungen, SEO-Felder und Feedback-Statistiken. | faqs:read |
faq_list | Listet FAQs eines Chatbots auf (use chatbot_list, um die chatbotId zu finden). | faqs:read |
faq_reorder | Setzt die Anzeigereihenfolge von FAQs im Widget. | faqs:write |
faq_suggestion_approve | Genehmigt 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_get | Ruft die vollständigen Details eines FAQ-Vorschlags ab (komplette Antwort, AI-Begründung, vorgeschlagene Kategorie, Prüfstatus). | faqs:read |
faq_suggestion_reject | Lehnt einen PENDING-FAQ-Vorschlag mit optionalem Grund ab. | faqs:write |
faq_suggestions_generate | Lässt die KI neue FAQs aus der Wissensdatenbank des Chatbots vorschlagen (gecrawlte Seiten / hochgeladene Dokumente), optional für eine Kategorie. | faqs:write |
faq_suggestions_list | Listet 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_update | Speichert Übersetzungen einer FAQ pro Sprache, z. B. | faqs:write |
faq_update | Aktualisiert Frage, Antwort, Kategorie, Veröffentlichungsstatus oder manuelle Sortierreihenfolge einer FAQ. | faqs:write |
faq_widget_settings_get | Ruft 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_update | Aktualisiert 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
| Tool | Beschreibung | Scope |
|---|---|---|
chat_feedback_dismiss | Markiert einen Chat als überprüft, ohne ihn zu bewerten (entfernt ihn aus der Pending-Queue, ändert nicht die Confidence-Score). | chats:write |
chat_feedback_get | Ruft eine Chat-Review (Feedback) mit AI-Analyse, Severity, Confidence-Kategorie, Score-Änderung und der verknüpften Improvement-Session ab. | chats:read |
chat_feedback_list | Listet 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_stats | Sitzungszä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_submit | Bewertet eine Chat-Sitzung als Good (isPositive=true) oder Needs Work (isPositive=false). | chats:write |
chat_session_get | Ruft 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_search | Durchsucht Chat-Sitzungen eines Chatbots nach Nachrichteninhalt und/oder Besucher-E-Mail. | chats:read |
chat_session_set_category | Weist 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_list | Listet Chat-Sitzungen eines Chatbots auf, neueste zuerst, mit denselben Review-Queue-Filtern wie die Dashboard-Chats-Seite. | chats:read |
Improvement Agent
| Tool | Beschreibung | Scope |
|---|---|---|
confidence_categories_list | Listet die Confidence-Kategorien eines Chatbots mit per-Kategorie Confidence-Score, Review-Anzahl und Review-E-Mail-Frequenz. | chats:read |
confidence_category_create | Erstellt eine Confidence-Kategorie für einen Chatbot. | chatbots:write |
confidence_category_delete | Löscht eine Confidence-Kategorie. | chatbots:write |
confidence_category_merge | Fü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_update | Bennennt 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_get | Confidence-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_approve | Genehmigt 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_reject | Lehnt einen PENDING-Improvement-Vorschlag ab. | chatbots:write |
improvement_proposal_simulate | Simuliert, wie der Chatbot auf die problematische Nachricht mit einem angewendeten Vorschlag antworten würde (original vs. | chatbots:write |
improvement_proposals_pending | Listet Improvement-Vorschläge, die auf Überprüfung warten (Status PENDING), firmenweit oder für einen Chatbot auf. | chatbots:read |
improvement_session_complete | Markiert 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_get | Ruft 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_reset | Startet 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_message | Sendet 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_list | Listet 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_assess | Bewertet 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
| Tool | Beschreibung | Scope |
|---|---|---|
live_chat_agents_available | Ruft 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_heartbeat | Aktualisiert 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_send | Sendet eine Nachricht an den Besucher als zugewiesener Agent. | chats:write |
live_chat_queue | Ruft 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_close | Beendet eine Live-Chat-Sitzung als Agent (jeder nicht-VIEWER-Firmenmitglied). | chats:write |
live_chat_session_get | Ruft eine Live-Chat-Sitzung mit Besucherinformationen, zugewiesenem Agent, allen Nachrichten und dem vorherigen Bot-Gespräch (Handoff-Kontext) ab. | chats:read |
live_chat_sessions_list | Listet Live-Chat-Sitzungen auf (neueste zuerst; WAITING-Sitzungen älteste zuerst) mit optionalen Filtern nach Chatbot, Status und zugewiesenem Agenten. | chats:read |
live_chat_set_availability | Schaltet den 'Available for Live Chat'-Schalter des aktuellen Benutzers für eine Firma um. | chats:write |
Leads
| Tool | Beschreibung | Scope |
|---|---|---|
lead_assign | Weist einen Lead einem Firmenmitglied zu oder entfernt die Zuordnung (assignedToId: null). | leads:write |
lead_bulk_update_status | Setzt den Status mehrerer Leads (max. 100) auf einmal. | leads:write |
lead_categories_list | Listet die Lead-Kategorien eines Chatbots mit Lead-Anzahlen und den pro Kategorie benachrichtigten Teammitgliedern. | leads:read |
lead_category_assign_user | Fügt ein Firmenmitglied zur Benachrichtigungsliste einer Lead-Kategorie hinzu (oder aktualisiert dessen Benachrichtigungsflags). | leads:write |
lead_category_create | Erstellt eine Lead-Kategorie für einen Chatbot. | leads:write |
lead_category_delete | Löscht eine Lead-Kategorie. | leads:write |
lead_category_remove_user | Entfernt ein Firmenmitglied aus der Benachrichtigungsliste einer Lead-Kategorie. | leads:write |
lead_category_update | Aktualisiert den Namen, die Beschreibung und/oder die Farbe einer Lead-Kategorie. | leads:write |
lead_create | Erstellt einen Lead manuell (z. B. | leads:write |
lead_delete | Löscht einen Lead dauerhaft. | leads:write |
lead_field_config_get | Ruft 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_update | Aktualisiert die Lead-Capture-Konfiguration eines Chatbots. | leads:write |
lead_get | Ruft 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_list | Listet Leads eines Chatbots auf (neueste zuerst) mit optionalen Filtern nach Status, Kategorie, Zuständigem und Freitextsuche (Name/E-Mail/Firma). | leads:read |
lead_stats | Ruft Lead-Statistiken für einen Chatbot ab: Zählungen nach Status, Leads der letzten 7 Tage und die Conversion-Rate (Prozent). | leads:read |
lead_update | Aktualisiert den Status, die Kategorie, Notizen, erfasste Daten und/oder den Zuständigen eines Leads. | leads:write |
Formulare
| Tool | Beschreibung | Scope |
|---|---|---|
form_create | Erstellt ein Kontaktformular für einen Chatbot (Basis, Felder, Design und Spam-Einstellungen in einem Aufruf). | forms:write |
form_delete | Löscht ein Kontaktformular und ALLE seine Einsendungen dauerhaft (Kaskade). | forms:write |
form_get | Ruft ein Kontaktformular vollständig ab: Felder, Übersetzungen, Styling, Spam-Einstellungen, aktiver Zustand, Einsendeanzahl und das Embed-Script-Tag (embedCode). | forms:read |
form_list | Listet die Kontaktformulare eines Chatbots mit Feldanzahlen, Einsendeanzahlen und Embed-Codes. | forms:read |
form_stats | Einsendeanzahlen eines Kontaktformulars: total, pending, approved, spam und rejected. | forms:read |
form_submission_delete | Löscht eine Einsendung eines Kontaktformulars dauerhaft (z. B. | forms:write |
form_submission_get | Ruft 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_status | Prüft eine Einsendung eines Kontaktformulars: setzt deren Status auf APPROVED, SPAM oder REJECTED mit optionaler Prüfnotiz. | forms:write |
form_submissions_list | Listet Einsendungen eines Kontaktformulars auf, neueste zuerst, optional gefiltert nach Status (PENDING, APPROVED, SPAM, REJECTED) und Erstellungsdatum. | forms:read |
form_update | Aktualisiert 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_translations | Ersetzt die Feld- und/oder UI-Übersetzungen eines Kontaktformulars. | forms:write |
Email Assistant
| Tool | Beschreibung | Scope |
|---|---|---|
email_activity_list | Listet 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_list | Listet die E-Mail-Kategorien einer Mailbox-Verbindung auf (geordnet nach sortOrder). | email:read |
email_category_create | Erstellt eine E-Mail-Kategorie für eine Mailbox-Verbindung (max. 20 pro Verbindung). | email:write |
email_category_delete | Löscht eine E-Mail-Kategorie. | email:write |
email_category_update | Aktualisiert eine E-Mail-Kategorie (partiell: nur die übergebenen Felder ändern sich). | email:write |
email_connection_disconnect | Trennt eine Mailbox dauerhaft. | email:write |
email_connection_get | Ruft eine Mailbox-Verbindung inkl. | email:read |
email_connection_update | Aktualisiert 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_list | Listet 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_delete | Löscht einen gelernten E-Mail-Kontakt (vergisst das Profil des Absenders, z. B. | email:write |
email_contact_get | Ruft 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_update | Aktualisiert einen gelernten E-Mail-Kontakt. | email:write |
email_contacts_list | Listet 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_create | Erstellt 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_list | Listet 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_list | Listet 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
| Tool | Beschreibung | Scope |
|---|---|---|
analytics_chat_volume | Chat-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_stats | Performance 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_forms | Statistiken 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_leads | Lead-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_overview | Analytics-Ü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_activity | Was 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:
improvement_proposals_pendingverwenden, um Vorschläge abzurufen- Jeden Vorschlag analysieren und zusammenfassen
- Sie in Ihrem Namen mit
improvement_proposal_approveoderimprovement_proposal_rejectgenehmigen 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
- Überprüfen Sie, ob Ihr API-Schlüssel korrekt ist
- Prüfen Sie, ob der Schlüssel nicht widerrufen wurde
- Stellen Sie sicher, dass Ihr Plan API-Zugriff enthält
- 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 →