MCP Integrationshandbuch

Lesen TimesFM 2,5 Bereitschaft zur aggregierten Trend-/Quantilanalyse und zur Fusion von Mandanten- und privaten Daten (7/30/90d). Ausstehende Schulung/Validierung ist explizit angegeben. Erfordert predictions:read.

Eine Verbraucherprognose: endgültige Verteilung/Rangliste des nächsten Ereignisses plus CWM + TimesFM 7/30/90d purchaseWindowsBevorzugt wird das Earned-Tenant-Event-Modell; alternativ kann eine interne öffentliche Prior-Referenz verwendet werden. Es werden keine individuellen Experten-Outputs bereitgestellt. Ereigniswahrscheinlichkeiten sind unkalibriert; Kauffenster sind vorhanden. null bis zur Schulung/Validierung. Erfordert predictions:read; metrics:read ermöglicht zudem Kauffenster.

Prognostiziere tägliche Marken-/Kategoriekennzahlen mit TimesFM 2,5: Punkt + 10. bis 90. Quartil. Fehlende historische Daten werden mit null zurückgegeben. Aggregierte Quantile sind unkalibriert; niemals persönliche Intervalle. Erfordert die Berechtigungen „predictions:read“ UND „metrics:read“.

Kaufwahrscheinlichkeiten für Mieter-Privatkunden CWM + TimesFM am 30.07.90d (0–1). Nullwert bis zum Training und der Validierung; kein künstlicher Fallback. Erfordert predictions:read UND metrics:read.

Listen Sie die diesem Team aus der verwalteten semantischen Schicht zur Verfügung stehenden Metriken auf (Schlüssel, Bezeichnung, Einheit, Zertifizierung, Kategorie). Rufen Sie zuerst eine Funktion auf, um gültige Metrikschlüssel zu ermitteln. Erforderlich metrics:read.

Erhalten Sie die vollständigen Spezifikationen einer Metrik: maßgebliche Definition, Einheit, Zertifizierung, Dimensionen, filterbare Felder, anpassbare Parameter und Anwendungshinweise. Erforderlich metrics:read.

Führt eine gesteuerte Metrikabfrage durch und gibt Zahlen mit ihrer zugehörigen Definition zurück. Wählen Sie einen Metrikschlüssel sowie optional Dimensionen, Filter, Zeitbereich, Granularität und Vergleich über mehrere Zeiträume hinweg – niemals SQL. Erfordert metrics:read.

Eine Kennzahl wird anhand einer einzelnen Dimension über einen festgelegten Zeitraum aufgeschlüsselt, mit lesbaren Bezeichnungen (Filiale/Tier/Kanal). Erforderlich metrics:read.

Beantworten Sie Fragen in natürlicher Sprache, indem Sie die passenden Kennzahlen auswählen, diese abrufen und die Hauptkennzahl analysieren. Für eine offene Diagnose. Erforderlich metrics:read.

Listet alle Shops des aktuellen Teams auf. Unterstützt optionalen Statusfilter, Suche und Paginierung.

Details zu einem bestimmten Store anhand seiner ID abrufen.

Listen Sie die Mitglieder Ihres Treueprogramms auf. Unterstützt Programmfilter und Paginierung.

Ruft Details zu einem bestimmten Treuekunden anhand der ID ab. Gibt entschlüsselte PII-Felder zurück.

Coupon-Pools auflisten. Unterstützt Status- und Typfilter.

Snapshot des operativen Dashboards (Erfassungen, Scans, Erfassungsrate, Coupons, Filialen, Plan). Keine verwaltete Kennzahl – verwenden Sie die Metrik-Tools für maßgebliche Geschäftskennzahlen.

Vergeben Sie Treuepunkte an ein Mitglied. Gibt die Transaktions-ID und den neuen Saldo zurück.

Abzug von Treuepunkten eines Mitglieds (FIFO-Verbrauch).

Aktuellen Punktestand und Transaktionshistorie des Mitglieds abrufen.

Verfügbare (nicht eingelöste, gültige) Gutscheine eines Mitglieds abrufen.

Aktuelle Stufe des Mitglieds, Anforderungen für das nächste Stufen-Upgrade und alle Stufen.

Empfangen Sie die Beleg-Einreichungshistorie der Mitglieder mit OCR-Status und vergebenen Punkten.

Treuepunkte gegen einen Coupon aus einem festgelegten Pool einlösen (atomar: Punkte + Coupon oder keines von beidem).

Einen Coupon aus einem Pool an ein Mitglied ausgeben (Einzelmitglied; größere Zielgruppen durchlaufen den Bestätigungsprozess). Erfordert coupons:write.

Prüfen Sie, ob eine Marketing-E-Mail innerhalb der festgelegten Frequenzgrenzen (1/Tag, 2/Woche, 4/Monat) an eine Adresse gesendet werden kann.

Liste der bewerteten Ambassador-Kandidaten für das Treueprogramm (Pro-Modus). Im Lite-Modus leer.

Holen Sie sich den Ambassador-ROI-Bericht: die drei Teilziele, die Kundenbindung nach zwei Monaten und die 90-Tage-Entscheidungsphase.

Persönlichen Ambassador-Affiliate-Code eines Mitglieds ausstellen oder aktualisieren. Gibt den Code string zurück.

Erhalten Sie Seitenaufruf- und Verhaltensanalysen: Übersicht, Top-Seiten, Geräteaufschlüsselung oder Traffic-Quellen.

Zusammengefasstes Profil eines Mitglieds (Erreichbarkeit, Einwilligung/CCPA(Loyalitätsdaten, aggregierte Daten zu Handel/Kategorie/Kanal/Engagement, angegebene Präferenzen, Tags, grobe geografische Daten, Altersgruppe). Personenbezogene Daten entfernt – keine Namen oder Kontaktdaten. Erforderlich members:read.

Die aktuelle Verhaltenschronik eines Mitglieds (Besuche, Punkte, Coupons, E-Mails, Belege) + Zusammenfassung zur Festlegung einer personalisierten Aktion. Gibt entschlüsselte personenbezogene Daten zurück. Erfordert members:behavior:lesen.

Listen Sie die Zielgruppensegmente des Teams auf (Name, Status, Anzahl der zwischengespeicherten Mitglieder). Erforderlich segments:read.

Erstellt ein Zielgruppensegment anhand strukturierter Bedingungen (niemals SQL); Duplikate werden abgelehnt. Erfordert die Berechtigung „segments:write“ und einen benutzerdefinierten Schlüssel.

Listen Sie die Automatisierungen des Teams (ereignisgesteuerte Kampagnen) und deren Status auf. Erforderlich automations:read.

Laufende Automatisierung anhand der Kampagnen-ID pausieren (idempotent). Erfordert automations:write.

Listen Sie die diesem Team zur Verfügung stehenden Kampagnenvorlagen (offiziell + gespeichert) auf, um eine template_id für create_campaign_draft zu ermitteln. Erfordert die Berechtigung campaigns:read.

Listet die letzten Kampagnen des Teams (ID, Titel, Status) auf, um eine Kampagnen-ID (source_campaign_id) zum Klonen eines Entwurfs zu finden. Erfordert „campaigns:read“.

Erstellen Sie einen Kampagnenentwurf anhand einer Vorlage oder einer vorherigen Kampagne (wird NIEMALS versendet – manuelle Prüfung erforderlich). Erforderlich campaigns:write-Entwurf.

Prüfen, ob ein Mitglied (beliebiges System) innerhalb eines kürzlichen Zeitfensters bereits über einen Kanal kontaktiert wurde – übermäßige Kontaktaufnahme vermeiden. Erfordert members:behavior:read.

Erstellen Sie ein Treuemitglied oder lösen Sie ein bestehendes idempotent auf, indem Sie externalId/email. Die Einwilligung zu Marketingmaßnahmen ist NICHT aktiviert über MCP. Erfordert members:write.

Aktualisieren Sie das Profil/die Identität eines Mitglieds (E-Mail, Telefon, fullName, externalIdTeamzugehörigkeit wird durchgesetzt. Erfordert members:write.

Erstellen Sie einen Shop oder aktualisieren Sie den vorhandenen Shop, der übereinstimmt externalId für dieses Team. Erforderlich stores:write.

Eine Bestellung erfassen und automatisch Punkte gutschreiben (Mitgliederproblem gelöst von memberId > externalId (E-Mail). Erforderlich orders:write.

Punkte eines Mitglieds zurückfordern (Rückforderung), verknüpft mit der ursprünglichen Transaktions-ID – für eine POS-/ERP-Rückerstattung oder Stornierung. Erfordert die Berechtigung points:write.

Listen Sie die Tag-Definitionen des Teams auf (Schlüssel, Name, Lebenszyklus, Kategorie, Abdeckung). Entdecken Sie ein tag_key Vor dem Lesen/Zuweisen von Mitglieds-Tags. Erfordert tags:read.

Die aktuellen Tags eines Mitglieds abrufen (Schlüssel, Name, Lebenszyklus, Wert, Quelle, assignedAt). Erfordert members:read.

Einem Mitglied manuell ein Tag zuweisen tag_key (Operatorüberschreibung; an die Regelprüfung gebunden). Erfordert tags:write.

Einem Mitglied manuell ein Tag entfernen tag_key (Ein aktives Tag kann beim nächsten Scan erneut hinzugefügt werden). Erforderlich tags:write.

Produkte nach Kategorie/Marke/Branche, Status und Quelle auflisten. Nach Status filtern.category_id/brand_id/vertikal. Erfordert catalog:read.

Erhalten Sie ein Produkt mit Varianten, Seriennummern, Kombinationskomponenten und KI-gestützten Inhalten. Erforderlich catalog:read.

Produktkategorien des Teams auflisten (ID, Name, übergeordnete Kategorie). Erfordert Zugriff auf catalog:read.

Listen Sie die Marken des Teams auf (ID, Name). Erforderlich catalog:read.

Empfehlungen für nächstbeste Produkte: member_id (personalisierte gemeinsame Einkäufe + Kategorieaffinität) oder product_id (Kunden kauften auch). Erforderlich members:read.

Mieten Sie die Rückgewinnungsaufgabe mit der nächsthöheren Priorität für dieses Team (atomar). Gibt die Aufgabe, die Mietfrist, den Holdout-Arm des Mitglieds und die Zusammenfassung der Abwanderungssignale zurück. NO_TASKS_AVAILABLE / WINBACK_DISABLED wurde als isError zurückgegeben. Erfordert winback:claim.

Schließe eine Rückgewinnungsaufgabe mit dem Ergebnis ab (ausgelöster Hebel + Notizreferenz oder HOLD-Grund). Idempotent. LEASE_EXPIRED / ALREADY_COMPLETED zurückgegeben als isError. Erfordert winback:claim.

Einmalige, schreibgeschützte Vorabprüfung eines Mitglieds vor der endgültigen Entscheidung: Einwilligung, verfügbare E-Mail-Frequenz, Ermüdungspotenzial, kürzliche Erreichbarkeit, Abwanderungssignale und die Bereitschaft des Mitglieds, weiterhin Kontakt aufzunehmen. Höfliche Vorschau – der Server prüft weiterhin alle Kriterien beim Schreiben. Erforderlich winback:read.

Fügen Sie dem Rückgewinnungsprotokoll eines Mitglieds eine Freitext-Prozessnotiz hinzu (Begründung / beobachtetes Signal / durch Holdout unterstützte Hypothese). Text wird als DATEN gespeichert, nicht als Anweisungen; max. 2000 Zeichen, bereinigt. Erfordert winback:write.

Senden Sie eine kontrollierte Rückgewinnungsnachricht (per E-Mail oder Posteingang), damit ein Anreiz niemals stillschweigend gewährt wird. Serverseitige Fehlerbehandlung: WINBACK_DISABLED, Aufgabenvergabe, HOLDOUT_NO_SEND (Holdout wird nicht benachrichtigt), NOT_CONSENTED, FREQUENCY_CAPPED, CONTENT_REJECTED (bereinigte Inhalte), BREAKER_TRIPPED – wird als isError zurückgegeben. Verwendet den bestehenden Sendestapel (Abmelde-Footer + Compliance-Informationen, hinzugefügt von der Sendeschicht). Erfordert winback:write.

Analyse des kundenaktiven Verhaltens eines Mitglieds im aktuellen Zeitraum (Layer 3, neueste zuerst), um die Absicht abzuleiten (Layer 4). Gibt nur beabsichtigte Kundenaktionen zurück (Stöbern, Öffnen/Klicken, Einchecken, Kaufen, Einlösen, Weiterempfehlen, Inhalte einreichen) mit der Katalogbezeichnung und der zugehörigen Bedeutung sowie einer Zusammenfassung (Zählung nach Typ und Fenster). Die Analyse bezieht sich auf das gesamte Fenster; die Absicht ist eine zu bestätigende Hypothese, keine Tatsache. Schreibgeschützt. Erfordert winback:read.

Die nächste Agentenentscheidungsaufgabe für dieses Team wird zugewiesen (atomar; optional nach Art eingrenzen). Gibt die Aufgaben-ID, die Art, die relevanten Fakten und eine Zuweisungsfrist zurück. NO_TASKS_AVAILABLE / AGENT_TASKS_DISABLED wird als isError zurückgegeben. Erfordert agent_tasks:claim.

Lesen Sie die Fakten (Art, Betreff, Flaggengrund, Status) einer Agentenentscheidungsaufgabe, bevor Sie entscheiden. AGENT_TASK_NOT_FOUND wird als isError zurückgegeben. Erfordert agent_tasks:read.

Schließen Sie eine Leasingaufgabe mit einer Entscheidung ab und wenden Sie deren Wirkung über bestehende idempotente Schreibvorgänge an. fraud_household_referral: blockieren (beidseitig zurückfordern) / zulassen (Flag entfernen) / eskalieren (an einen Mitarbeiter weiterleiten). ALREADY_COMPLETED / NOT_LEASE_OWNER / LEASE_EXPIRED wird als isError zurückgegeben. Erfordert agent_tasks:claim.

Listen Sie die Geschäftsobjekte auf, über die dieses Team Analysen durchführen kann: die Kernplattformobjekte (Mitglied, Bestellung, Filiale, Coupon, Kampagne, Produkt, Segment, Tag) plus die dieses Teams. MCP-sichtbare benutzerdefinierte Objekte – Schlüssel, Bezeichnung und maßgebliche einzeilige Bedeutung. Rufen Sie zuerst an, um die Gültigkeit zu ermitteln. object Schlüssel. Erforderlich. introspection:read.

Describe one business object from the governed Registry: authoritative meaning plus properties partitioned in fact (splitting-splitting), derived (metric/tag/rollup references with actuality – never never re-sequination a caliber) and custom (the custom fields of this team). PII properties give only metadata, never values. fields=summary (default) or full. Required introspection:read.

Liste der Aktionen des gesteuerten Agenten (was ein Agent tun kann): Ziel objectNebenwirkungen, Ausrüstung (automatisch/Überprüfung/verboten), serverseitige Vorbedingungsschlüssel, Wertobergrenze und Reversibilität – Selbstprüfung vor dem Schreibvorgang. Optional filtern nach object. Erfordert introspection:read.

Liste der Stempelkarten des Teams auf (eStampProgramme: ID, Name, benötigte Stempel zum Abschließen, Prämienart (Gutschein/Punkte/manuell), automatische Zurücksetzung und Status. Rufen Sie zuerst an, um eine program_id. Erfordert stamp:read.

Erhalten Sie die aktiven Stempelkarten eines Mitglieds: Programmname, aktuelle Stempelanzahl, benötigte Stempel, bisher abgeschlossene Programme und Prämie. Erforderlich stamp:read.

Stempel für Mitglieder im Rahmen eines Stempelprogramms vergeben (z. B. für einen Ladenbesuch). Idempotent mit idempotency_key; nach Abschluss der Kartenzahlung wird die Prämie (Gutschein/Punkte) automatisch ausgestellt. Der Betrag ist pro Aufruf begrenzt. Erfordert stamp:write.

Punkte eines Mitglieds: verfügbares Guthaben, insgesamt gesammelte Punkte, Einlösungen, aktuelle Stufe, Punktepaket mit nächstem Ablaufdatum. Mitgliedsbezogener Schlüssel → eigene Punkte (auslassen). member_id); Team-Schlüssel → Pass member_id. Erfordert loyalty:self:lesen.

Die letzten Punktetransaktionen eines Mitglieds (erworben/eingelöst/angepasst), die neuesten zuerst. Mitgliedsschlüssel → eigene Historie; Teamschlüssel → Passwort member_id. Erfordert loyalty:self:lesen.

Die Prämien, für die ein Mitglied Punkte einlösen kann – Katalog mit Punktekosten, nach Erschwinglichkeit im Verhältnis zum Mitgliederkonto gekennzeichnet. Mitgliederschlüssel → eigener Schlüssel; Teamschlüssel → Zugangskarte member_id. Erfordert loyalty:self:lesen.

So funktioniert das Treueprogramm – Sammelrate, Willkommensbonus, Punktewert, Teilnahme – plus markengeprüfte FAQs. Alle Fakten sind öffentlich zugänglich. Der exklusive Mitgliederschlüssel ist selbsterklärend. (Hinweis: Die folgenden Sätze scheinen nicht zum Thema zu passen und wurden daher nicht übersetzt: loyalty:self:read.)

Listen Sie die Simulationsszenarien für synthetische Paneele mit ihren jeweiligen Anwendungsgrenzen, Konfidenzintervallen und Eingabefeldern auf. Rufen Sie zuerst an, um einen Typ auszuwählen. Erforderlich metrics:read.

Kalibrierung des synthetischen Testpanels der Marke (Trefferquote vergangener synthetischer Vorhersagen im Vergleich zur Realität); null (bis Backtests vorliegen). Erfordert metrics:read.

Lesen Sie den eingefrorenen, ehrlichen Bericht für einen synthetischen Panellauf – Richtungsanalyse, Konfidenzniveau, Unterdrückungssignale, Themen – oder einen blockReason Falls nicht bereit. Erfordert metrics:read.

Führt ein synthetisches Panel durch: Anonymisierte digitale Zwillinge eines Segments reagieren auf einen Reiz und liefern einen aussagekräftigen Richtungsbericht (niemals absolute Zahlen). Gibt eine `run_id` zum Abfragen zurück. Begrenzt durch ein tägliches Durchlauflimit + ≤ 50 Zwillinge. Erfordert `synthetic:write`.