Chat (JSBOX) per MCP konfigurieren

Zuletzt aktualisiert: Sep 6, 2026Abschnitt: Erste Schritte

Agent-Skill: minimale Regeln zur Konfiguration einer JSBOX-Integration (Chat-Widget) über Mailoo MCP. Dieses Dokument nur anhand bestätigter Abläufe erweitern---keine Schritte erfinden, die über die genannten Tools hinausgehen.

Wann verwenden

  • Eine JSBOX-Integration anlegen oder finden und Widget-/Verbindungseinstellungen lesen oder aktualisieren.
  • Lifetime-Zähler für Nachrichten und Chat-Sessions einer JSBOX-Integration lesen (nur Zahlen).

Tools

  • list_projects / create_project
  • list_integrations mit type=JSBOX (oder create_integration mit type=JSBOX --- nur OWNER)
  • manage_jsbox_integration_settings --- action=get, action=update, upload_kb_file oder delete_kb_file
  • get_activity_digest --- optional; aktuelle Zähler im Zeitfenster (Filter integrationIds)
  • manage_blog_media --- nur wenn chatWidget.agent.imageMediaId gesetzt wird

Regeln

  1. Nach dem Anlegen Einstellungen über manage_jsbox_integration_settings pflegen. Nicht auf rohes config bei create_integration für laufende Änderungen setzen.
  2. Bei update: weggelassenes Feld bleibt; null auf eine Sektion löscht sie; weggelassenes chatWidget.agent behält den gespeicherten Agenten.
  3. Wenn chatWidget.agent.enabled true ist, sind name, kbIntegrationId, instructions, kbDigestPrompt und kbArticlePrompt Pflicht. kbIntegrationId muss eine BLOG-Integration im selben Projekt sein. KB-Dateien: upload_kb_file / delete_kb_file.
  4. get liefert Einstellungen plus counts (Nachrichten gesamt; Sessions gesamt und nach Status OPEN / PENDING / CLOSED). Keine Session-IDs, Besucherdaten oder Nachrichtentexte.
  5. Session-Liste, Antwort, Zuweisen und Schließen sind per MCP nicht verfügbar---dafür das Dashboard.
  6. Zugriff entspricht dem MCP-Token-Besitzer: Mitgliedschaft EDITOR oder höher.

Siehe auch

  • mailoo-mcp{.interpreted-text role="doc"} --- Tokens, Endpoint, vollständige Tool-Liste
  • chat-widget{.interpreted-text role="doc"} --- JSBOX-Produktverhalten