MCP Guide d'intégration

Lire TimesFM 2.5 Préparation à l'analyse agrégée des tendances/quantiles et à la fusion locataire-privé (7/30/90 jours). Formation/validation en attente (mention explicite). Nécessite : predictions:read.

Une prédiction des consommateurs : distribution/classement final du prochain événement plus CWM + TimesFM 7/30/90d purchaseWindowsModèle d'événements locataires acquis privilégié ; une référence interne publique a priori de repli. Pas de résultats d'experts individuels. Probabilités d'événements non calibrées ; fenêtres d'achat null jusqu'à formation/validation. Nécessite predictions:read; metrics:read permet en outre d'effectuer des achats en ligne.

Prévisions quotidiennes des indicateurs de marque/catégorie avec TimesFM 2,5 : point + q10…q90. En cas d'historique manquant, renvoie null. Les quantiles agrégés ne sont pas calibrés ; aucun intervalle personnalisé n'est fourni. Nécessite les options predictions:read et metrics:read.

Probabilités d'achat (locataire privé) CWM + TimesFM au 30/07/90 jours (0–1). Valeur nulle jusqu'à l'entraînement et la validation ; aucune valeur de repli artificielle. Nécessite les paramètres predictions:read et metrics:read.

Liste des indicateurs disponibles pour cette équipe à partir de la couche sémantique gouvernée (clé, étiquette, unité, certification, catégorie). Appel préalable pour découvrir les clés d'indicateurs valides. Nécessite l'autorisation `metrics:read`.

Obtenez les spécifications complètes d'une métrique : définition officielle, unité, certification, dimensions, champs filtrables, paramètres ajustables et guide d'utilisation. Nécessite metrics:read.

Exécutez une requête de métrique contrôlée et obtenez des chiffres avec leur définition officielle. Choisissez une clé de métrique, ainsi que des dimensions, des filtres, une plage de dates, une granularité et une comparaison d'une période à l'autre (optionnels) — sans utiliser SQL. Nécessite metrics:read.

Décomposer une métrique selon une seule dimension sur une période récente fixe, avec des libellés lisibles (noms de magasin/niveau/canal). Nécessite metrics:read.

Répondez à une question en langage naturel en sélectionnant les indicateurs clés de performance (KPI) appropriés, en les récupérant et en analysant l'indicateur principal. Pour un diagnostic ouvert. Nécessite l'accès à metrics:read.

Liste de tous les magasins de l'équipe actuelle. Filtre de statut, recherche et pagination optionnels.

Obtenir les détails d'un magasin spécifique grâce à son ID.

Liste des membres du programme de fidélité. Prise en charge du filtrage et de la pagination des programmes.

Accès aux informations d'un membre du programme de fidélité par son identifiant. Retourne les données personnelles décryptées.

Liste des groupes de coupons. Prend en charge les filtres de statut et de type.

Aperçu du tableau de bord opérationnel (captures, scans, taux de capture, coupons, magasins, abonnement). Cet indicateur n'est pas réglementé ; utilisez les outils de mesure pour obtenir des indicateurs commerciaux fiables.

Attribuez des points de fidélité à un membre. Renvoie l’ID de transaction et le nouveau solde.

Déduction des points de fidélité d'un membre (principe du premier entré, premier sorti).

Accéder au solde de points actuel du membre et à son historique de transactions récentes.

Obtenir les coupons disponibles (non utilisés, non expirés) d’un membre.

Consultez le niveau actuel du membre, les conditions de passage au niveau supérieur et tous les niveaux.

Accédez à l’historique des soumissions de reçus des membres, avec le statut OCR et les points attribués.

Échangez vos points de fidélité contre un coupon parmi ceux disponibles (opération atomique : points + coupon, ou aucun des deux).

Émettre un coupon à partir d'une réserve pour un membre (membre unique ; les audiences groupées passent par le processus de confirmation So). Nécessite l'outil coupons:write.

Vérifiez si un e-mail marketing peut être envoyé à une adresse en respectant les limites de fréquence (1/jour, 2/semaine, 4/mois).

Liste des candidats Ambassadeurs notés pour le programme de fidélité (mode Pro). Champ vide en mode Lite.

Obtenez le rapport de retour sur investissement des Ambassadeurs : les trois sous-objectifs, la fidélisation au deuxième mois et le critère de décision à 90 jours.

Émettre ou mettre à jour le code d'affiliation Ambassadeur personnel d'un membre. Renvoie le code string.

Accédez à l'analyse des visites et du comportement des utilisateurs : vue d'ensemble, pages les plus consultées, répartition par appareil et sources de trafic.

Profil agrégé d'un membre (accessibilité, consentement/CCPA, fidélisation, regroupements commerciaux/catégories/canaux/engagement, préférences déclarées, balises, géolocalisation approximative, tranche d'âge). Données personnelles masquées — aucun nom ni coordonnées. Nécessite members:read.

Historique récent des activités d'un membre (visites, points, coupons, courriels, reçus) + résumé, pour déterminer une action personnalisée. Renvoie les données personnelles décryptées. Nécessite : members:behavior:lire.

Afficher les segments d’audience de l’équipe (nom, statut, nombre de membres en cache). Nécessite l’option « segments:read ».

Créer un segment d'audience à partir de conditions structurées (jamais de SQL) ; rejeter les doublons. Nécessite : segments:write + une clé appartenant à l'utilisateur.

Lister les automatisations de l'équipe (campagnes déclenchées par des événements) et leur statut. Nécessite automations:read.

Mettre en pause une automatisation en cours par ID de campagne (idempotent). Nécessite automations:write.

Liste des modèles de campagne disponibles pour cette équipe (officiels + enregistrés), pour découvrir un template_id pour create_campaign_draft. Nécessite campaigns:read.

Répertoriez les campagnes récentes de l'équipe (identifiant, titre, statut) pour trouver un source_campaign_id pour cloner un brouillon. Nécessite campaigns:read.

Créez une version brouillon d'une campagne à partir d'un modèle ou d'une campagne précédente (ne sera jamais envoyée ; une vérification humaine est requise). campaigns:write-brouillon.

Vérifie si un membre a déjà été contacté (quel que soit le système) sur un canal récemment — évite les contacts excessifs. Nécessite members:behavior:read.

Créer un membre de fidélité, ou résoudre de manière idempotente un membre existant par externalId/email. Le consentement marketing n'est PAS activé via MCP. Nécessite members:write.

Mettre à jour le profil/l'identité d'un membre (courriel, téléphone, fullName, externalId, statut). Propriété de l'équipe imposée. Nécessite members:write.

Créez un magasin ou mettez à jour le magasin existant correspondant externalId pour cette équipe. Nécessite stores:write.

Enregistrez un bon de commande et attribuez automatiquement des points (membre, problème résolu par memberId > externalId > courriel). Nécessite orders:write.

Récupération des points d'un membre, liée à l'identifiant de transaction d'origine — pour un remboursement ou une annulation via un terminal de point de vente/ERP. Nécessite l'autorisation points:write.

Liste des définitions des balises de l'équipe (clé, nom, cycle de vie, catégorie, couverture). Découvrez un tag_key avant de lire/d'attribuer les étiquettes des membres. Nécessite tags:read.

Obtenir les tags actuels d'un membre (clé, nom, cycle de vie, valeur, source, assignedAt). Nécessite members:read.

Attribuez manuellement une étiquette à un membre via tag_key (remplacement de l'opérateur ; lié à la règle de balayage). Nécessite tags:write.

Supprimer manuellement une étiquette d'un membre par tag_key (Une étiquette active peut être rajoutée lors du prochain balayage). Nécessite tags:write.

Afficher les produits par catégorie/marque/secteur, statut et source. Filtrer par statut.category_id/brand_id/vertical. Nécessite catalog:read.

Obtenez un produit avec des variantes, des articles sérialisés, des composants combinés et du contenu d'ancrage IA. Nécessite catalog:read.

Liste des catégories de produits de l'équipe (identifiant, nom, catégorie parente). Obligatoire catalog:read.

Liste des marques de l'équipe (identifiant, nom). Obligatoire catalog:read.

Recommandations de produits similaires : member_id (achat groupé personnalisé + affinité de catégorie) ou product_id (Les clients ont également acheté). Nécessite members:read.

Attribuer la prochaine tâche prioritaire de reconquête pour cette équipe (atomique). Renvoie la tâche, la date limite d'attribution, le membre récalcitrant et un résumé des signaux de désabonnement. NO_TASKS_AVAILABLE / WINBACK_DISABLED renvoyé comme isError. Nécessite winback:claim.

Finaliser une tâche de reconquête client avec le résultat (levier actionné + référence de la note, ou motif de maintien). Idempotent. LEASE_EXPIRED / ALREADY_COMPLETED renvoyé comme isError. Nécessite winback:claim.

Vérification préliminaire unique en lecture seule pour un membre avant toute décision : consentement, marge de manœuvre pour la fréquence d'envoi d'e-mails, lassitude, portée récente, signaux de désabonnement et réticence du membre. Aperçu de courtoisie — le serveur applique toujours chaque contrôle lors de l'écriture. Nécessite winback:read.

Joignez une note de processus en texte libre au dossier de reconquête d'un membre (justification / signal observé / hypothèse soutenue par les récalcitrants). Le texte est stocké sous forme de DONNÉES et non d'instructions ; max 2000 caractères, désinfectés. Nécessite winback:write.

Envoyez un message de relance contrôlé (boîte de réception ou e-mail) afin qu'une incitation ne soit jamais une attribution silencieuse. Mécanismes de sécurité côté serveur : WINBACK_DISABLED, attribution de la propriété de la tâche, HOLDOUT_NO_SEND (aucun message n'est envoyé aux utilisateurs en attente), NOT_CONSENTED, FREQUENCY_CAPPED, CONTENT_REJECTED (nettoyé), BREAKER_TRIPPED — renvoyé comme isError. Réutilise la pile d'envoi existante (pied de page de désabonnement + conformité ajoutée par la couche d'envoi). Nécessite winback:write.

Analyse les comportements actifs d'un membre sur une période récente (Couche 3, du plus récent au plus ancien) afin d'en déduire son intention (Couche 4). Renvoie uniquement les actions intentionnelles du client (navigation, ouverture/clic, enregistrement, achat, utilisation d'un code, parrainage, soumission de contenu) avec l'étiquette du catalogue et sa signification intégrées, ainsi qu'un résumé (nombre d'actions par type et par période). Raisonnement sur toute la période ; l'intention est une hypothèse à confirmer, et non un fait avéré. Lecture seule. Nécessite l'autorisation winback:read.

Attribuer la prochaine tâche de décision à cet agent (atomique ; possibilité de filtrer par type). Renvoie l’identifiant de la tâche, son type, les informations la concernant et une date limite de location. NO_TASKS_AVAILABLE / AGENT_TASKS_DISABLED renvoyé comme isError. Nécessite agent_tasks:réclamer.

Lisez les faits relatifs à la tâche de décision d'un agent (type, sujet, motif du signalement, statut) avant de prendre une décision. AGENT_TASK_NOT_FOUND renvoyé comme isError. Nécessite agent_tasks:lire.

Finalisez une tâche louée en prenant une décision et en appliquant son effet via les écritures idempotentes existantes. fraud_household_referral : bloquer (récupérer les deux parties) / autoriser (ignorer le signalement) / escalader (laisser à un humain). ALREADY_COMPLETED / NOT_LEASE_OWNER / LEASE_EXPIRED renvoyé comme isError. Nécessite agent_tasks:claim.

Liste des objets métier sur lesquels cette équipe peut raisonner : les objets principaux de la plateforme (membre, commande, magasin, coupon, campagne, produit, segment, étiquette) plus ceux de cette équipe. MCP-Objets personnalisés visibles : clé, étiquette et signification concise. Appelez d’abord pour découvrir les objets valides. object clés. Nécessite introspection:read.

Décrivez une entreprise object À partir du registre géré : signification faisant autorité et propriétés partitionnées en faits (basés sur des colonnes), dérivés (références de métriques/balises/agrégats actualisées – jamais de recalcul de la qualité) et personnalisés (champs personnalisés de cette équipe). Les propriétés PII renvoient uniquement des métadonnées, jamais de valeurs. champs=résumé (par défaut) ou complet. Nécessite introspection:read.

Liste des actions de l'agent régi (ce qu'un agent peut faire) : cible object, effet secondaire, engrenage (auto/examen/interdit), clés de précondition côté serveur, limite de valeur et réversibilité — auto-vérification avant de proposer une écriture. Filtre optionnel par object. Nécessite introspection:read.

Liste des cartes de fidélité de l'équipe (eStampProgrammes : identifiant, nom, nombre de timbres requis, type de récompense (coupon/points/manuel), réinitialisation automatique et statut. Appelez d’abord pour obtenir un numéro. program_id. Nécessite stamp:read.

Obtenez les cartes de fidélité actives d'un membre : nom du programme, tampons actuels, tampons manquants, programmes complétés à ce jour et récompense. Nécessite stamp:read.

Accorder des timbres à un membre pour un programme de fidélité (par exemple, une visite en magasin). Idempotent avec idempotency_keyUne fois la carte complétée, la récompense (coupon/points) est émise automatiquement. Montant plafonné par appel. Nécessite stamp:write.

Points d'un membre : solde disponible, cumul total, échanges, niveau actuel, lot expirant le plus rapidement. Clé liée au membre → points personnels (omettre member_id) ; clé d'équipe → transmettre member_id. Nécessite loyalty:self:read.

Transactions récentes d'un membre (points gagnés/utilisés/ajustés), de la plus récente à la plus ancienne. Clé personnelle → historique ; clé d'équipe → laissez-passer member_id. Nécessite loyalty:self:lire.

Récompenses pour lesquelles un membre peut échanger des points — catalogue avec coût en points, classées par accessibilité en fonction du solde du membre. Clé personnelle → personnelle ; clé d’équipe → partagée member_id. Nécessite loyalty:self:lire.

Fonctionnement du programme de fidélité : taux d’accumulation, bonus de bienvenue, valeur des points, modalités d’inscription, et FAQ approuvée par la marque. Informations publiques. Clé d’accès réservée aux membres. Nécessite l’inscription à loyalty:self:read.

Listez les scénarios de simulation de panel synthétique en précisant pour chacun leurs limites d'utilisabilité, leur niveau de confiance maximal et leurs champs de saisie. Appelez d'abord pour choisir un type. Nécessite metrics:read.

étalonnage du panel synthétique de la marque (taux de réussite des prédictions synthétiques passées par rapport à la réalité ; null (jusqu'à ce que des backtests existent). Nécessite metrics:read.

Lisez le rapport honnête gelé pour une analyse par panel synthétique — lecture directionnelle, plafond de confiance, indicateurs de suppression, thèmes — ou un blockReason si ce n'est pas prêt. Nécessite metrics:read.

Exécuter un panel synthétique : des jumeaux numériques anonymisés d'un segment réagissent à un stimulus, produisant un rapport directionnel fiable (jamais de valeurs absolues réelles). Renvoie un identifiant d'exécution (run_id) à interroger. Limité par un nombre maximal d'exécutions quotidiennes + ≤ 50 jumeaux. Nécessite le module synthetic:write.