MCP Guía de integración

Leer TimesFM 2.5 Preparación para tendencia agregada/cuantil y preparación para fusión inquilino-privada 7/30/90d. Se especifica que está pendiente de capacitación/validación. Requiere predictions:read.

Una predicción del consumidor: distribución/clasificación final del próximo evento plus CWM + TimesFM 7/30/90d purchaseWindowsModelo de eventos de inquilinos ganados preferido; una referencia pública previa interna de reserva. Sin resultados de expertos individuales. Probabilidades de eventos sin calibrar; ventanas de compra null hasta que esté capacitado/validado. Requiere predictions:read; metrics:read Además, habilita ventanas de compra.

Pronosticar las métricas diarias de marca/categoría con TimesFM 2.5: punto + q10..q90. Historial faltante devuelve nullLos cuantiles agregados no están calibrados; nunca son intervalos personales. Requiere predictions:read AND metrics:read.

Inquilino-privado CWM + TimesFM Probabilidades de compra a los 7/30/90d (0–1). Nulo hasta que se entrene y valide; sin reserva fabricada. Requiere predictions:read AND metrics:read.

Enumera las métricas disponibles para este equipo desde la capa semántica gobernada (clave, etiqueta, unidad, certificación, categoría). Llama primero para descubrir claves de métricas válidas. Requiere metrics:read.

Obtenga la especificación completa de una métrica: definición autorizada, unidad, certificación, dimensiones, campos filtrables, parámetros ajustables y guía de uso. Requiere metrics:read.

Ejecuta una consulta de métricas controlada y devuelve números con su definición autorizada. Selecciona una clave de métrica, además de dimensiones opcionales, filtros, rango de tiempo, granularidad y comparación entre periodos; nunca SQL. Requiere metrics:read.

Desglosar una métrica por una sola dimensión en una ventana reciente fija, con etiquetas legibles para humanos (nombres de tiendas/niveles/canales). Requiere metrics:read.

Responda a una pregunta en lenguaje natural seleccionando las métricas gobernadas correctas, recuperándolas y desglosando la métrica principal. Para diagnóstico abierto. Requiere metrics:read.

Enumere todas las tiendas del equipo actual. Admite filtro de estado, búsqueda y paginación opcionales.

Obtenga detalles de una tienda específica por su ID.

Listar los miembros del programa de fidelización. Admite filtrado y paginación de programas.

Obtenga los detalles de un miembro del programa de fidelización específico mediante su ID. Devuelve los campos de información personal identificable (PII) descifrados.

Listar los grupos de cupones. Admite filtros de estado y tipo.

Instantánea del panel operativo (capturas, escaneos, tasa de captura, cupones, tiendas, plan). No es una métrica regulada; utiliza las herramientas de métricas para obtener métricas de negocio fiables.

Otorgue puntos de fidelidad a un miembro. Devuelve el ID de la transacción y el nuevo saldo.

Se deducen los puntos de fidelidad de un miembro (consumo FIFO).

Obtener el saldo de puntos actual del miembro y su historial de transacciones recientes.

Obtener los cupones disponibles (no canjeados ni caducados) de un miembro.

Obtén el nivel actual del miembro, los requisitos para la siguiente actualización y todos los niveles.

Obtenga el historial de envío de recibos de los miembros con el estado de OCR y los puntos otorgados.

Canjea puntos de fidelidad por un cupón de un fondo específico (atómico: puntos + cupón, o ninguno).

Emitir un cupón desde un grupo a un miembro (miembro único; las audiencias masivas pasan por el flujo de confirmación de So). Requiere coupons:write.

Verifique si se puede enviar un correo electrónico de marketing a una dirección dentro de los límites de frecuencia (1/día, 2/semana, 4/mes).

Liste los candidatos a Embajador puntuados para el programa de fidelización (modo Pro). Vacío en el modo Lite.

Obtenga el informe de ROI de Embajador: los tres subobjetivos, la retención del segundo mes y la prueba de viabilidad de 90 días.

Emite o actualiza el código de afiliado Embajador personal de un miembro. Devuelve el código string.

Obtenga análisis de visitas a páginas y comportamiento: resumen, páginas más visitadas, desglose por dispositivo o fuentes de tráfico.

Perfil agregado de un miembro (accesibilidad, consentimiento/CCPA, lealtad, agregaciones de comercio/categoría/canal/participación, preferencias declaradas, etiquetas, geolocalización general, rango de edad). Información personal identificable censurada: sin nombres ni valores de contacto. Requiere members:read.

Historial de comportamiento reciente de un miembro (visitas, puntos, cupones, correos electrónicos, recibos) + resumen, para decidir una acción personalizada. Devuelve información personal identificable descifrada. Requiere members:behavior:leer.

Enumera los segmentos de audiencia del equipo (nombre, estado, número de miembros en caché). Requiere segments:read.

Crea un segmento de audiencia a partir de condiciones estructuradas (nunca SQL); rechaza duplicados. Requiere segments:write + una clave de usuario.

Enumere las automatizaciones del equipo (campañas activadas por eventos) y su estado. Requiere el permiso `automations:read`.

Pausa una automatización en ejecución por ID de campaña (idempotente). Requiere automations:write.

Lista de plantillas de campaña disponibles para este equipo (oficiales + guardadas), para descubrir una template_id para create_campaign_draft. Requiere campaigns:read.

Liste las campañas recientes del equipo (id, título, estado) para encontrar un source_campaign_id y clonar un borrador. Requiere campaigns:read.

Crea un BORRADOR de campaña a partir de una plantilla o una campaña anterior (NUNCA se envía; se requiere revisión humana). Requiere campaigns:write-borrador.

Verifica si un miembro ya fue contactado (cualquier sistema) en un canal dentro de un período reciente; evita el contacto excesivo. Requiere members:behavior:read.

Cree un miembro de fidelización o resuelva idempotentemente uno existente mediante externalId/correo electrónico. El consentimiento de marketing NO está habilitado a través de MCP. Requiere members:write.

Actualizar el perfil/identidad de un miembro (correo electrónico, teléfono, fullName, externalId, estado). Propiedad del equipo impuesta. Requiere members:write.

Crea una tienda o actualiza la tienda existente que coincida con externalId para este equipo. Requiere stores:write.

Registra una orden de compra y otorga automáticamente puntos (miembro resuelto por memberId > externalId > correo electrónico). Requiere orders:write.

Revertir (recuperar) puntos de un miembro, vinculados al ID de transacción original, para un reembolso o anulación de POS/ERP. Requiere points:write.

Lista las definiciones de etiquetas del equipo (clave, nombre, ciclo de vida, categoría, cobertura). Descubre una tag_key antes de leer/asignar las etiquetas de los miembros. Requiere tags:read.

Obtenga las etiquetas actuales de un miembro (clave, nombre, ciclo de vida, valor, origen, assignedAt). Requiere members:read.

Asigna manualmente una etiqueta a un miembro mediante tag_key (anulación del operador; vinculada a la regla de barrido). Requiere tags:write.

Eliminar manualmente una etiqueta de un miembro mediante tag_key (una etiqueta activa puede volver a añadirse en la siguiente revisión). Requiere tags:write.

Listar productos con categoría/marca/vertical, estado y origen. Filtrar por estado/category_id/brand_id/vertical. Requiere catalog:read.

Obtenga un producto con variantes, artículos serializados, componentes combinados y contenido de base de IA. Requiere catalog:read.

Liste las categorías de productos del equipo (id, nombre, principal). Requiere catalog:read.

Enumera las marcas del equipo (id, nombre). Requiere catalog:read.

Recomendaciones de productos similares: member_id (compra conjunta personalizada + afinidad de categoría) o product_id (Los clientes también compraron). Requiere members:read.

Asigna la tarea de recuperación de clientes de mayor prioridad siguiente para este equipo (atómica). Devuelve la tarea, la fecha límite de asignación, el grupo de miembros que aún no la han completado y el resumen de la señal de abandono. NO_TASKS_AVAILABLE / WINBACK_DISABLED regresó como isError. Requiere winback:claim.

Finalizar una tarea de recuperación de clientes arrendada con el resultado (palanca de acción + referencia de nota o motivo de RETENCIÓN). Idempotente. LEASE_EXPIRED / ALREADY_COMPLETED devuelve isError. Requiere winback:claim.

Verificación previa de solo lectura para un miembro antes de tomar una decisión: consentimiento, margen de frecuencia de correo electrónico, fatiga, alcance reciente, señales de abandono y la tendencia del miembro a no participar. Vista previa de cortesía: el servidor sigue aplicando todas las restricciones al momento de la escritura. Requiere winback:read.

Adjunte una nota de proceso de texto libre al registro de recuperación de un miembro (justificación / señal observada / hipótesis respaldada por el grupo de control). El texto se almacena como DATOS, no como instrucciones; máximo 2000 caracteres, sanitizados. Requiere winback:write.

Envía un mensaje de recuperación controlado (bandeja de entrada o correo electrónico) para que el incentivo nunca sea una concesión silenciosa. Compuertas de seguridad del servidor: WINBACK_DISABLED, propiedad de la concesión de tareas, HOLDOUT_NO_SEND (la retención nunca recibe mensajes), NOT_CONSENTED, FREQUENCY_CAPPED, CONTENT_REJECTED (sanitizado), BREAKER_TRIPPED — devuelto como isError. Reutiliza la pila de envío existente (pie de página de cancelación de suscripción + cumplimiento añadido por la capa de envío). Requiere winback:write.

Analiza el comportamiento de un miembro como CLIENTE ACTIVO durante un período reciente (Capa 3, más reciente primero) para inferir su intención (Capa 4). Devuelve únicamente las acciones intencionales del cliente (navegar, abrir/clic, registrarse, comprar, canjear, recomendar, enviar contenido) con la etiqueta del catálogo y su significado adjuntos, además de un resumen (recuentos por tipo y período). Analiza todo el período; la intención es una hipótesis a confirmar, no un hecho. Solo lectura. Requiere winback:read.

Asigne la siguiente tarea de decisión de agente para este equipo (atómica; opcionalmente, se puede filtrar por tipo). Devuelve el ID de la tarea, el tipo, los detalles del asunto y una fecha límite de asignación. NO_TASKS_AVAILABLE / AGENT_TASKS_DISABLED se devuelve como isError. Requiere agent_tasks:claim.

Leer los datos de la tarea de decisión de un agente (tipo, sujeto, motivo de la bandera, estado) antes de decidir. Se devuelve AGENT_TASK_NOT_FOUND como isError. Requiere agent_tasks:read.

Completa una tarea arrendada con una decisión, aplicando su efecto a través de escrituras idempotentes existentes. fraud_household_referral: bloquear (recuperar ambos lados) / permitir (descartar la bandera) / escalar (dejar para un humano). ALREADY_COMPLETED / NOT_LEASE_OWNER / LEASE_EXPIRED devuelto como isError. Requiere agent_tasks:claim.

Enumere los objetos de negocio sobre los que este equipo puede razonar: los objetos de la plataforma principal (miembro, pedido, tienda, cupón, campaña, producto, segmento, etiqueta) más los de este equipo. MCP-objetos personalizados visibles: clave, etiqueta y significado autorizado de una sola línea. Llame primero para descubrir la validez object llaves. Requiere introspection:read.

Describe un negocio object del registro gobernado: significado autorizado más propiedades particionadas en hechos (respaldados por columnas), derivados (referencias de métricas/etiquetas/resumen con actualización; nunca se vuelve a derivar un calibre) y personalizados (campos personalizados de este equipo). Las propiedades PII devuelven solo metadatos, nunca valores. campos=resumen (predeterminado) o completo. Requiere introspection:read.

Enumera las acciones del agente controlado (lo que un agente puede HACER): objetivo object, efecto secundario, engranaje (automático/revisión/prohibido), claves de precondiciones del servidor, límite de valor y reversibilidad: autocomprobación antes de proponer una escritura. Opcionalmente, filtrar por object. Requiere introspection:read.

Enumerar la tarjeta de sellos del equipo (eStamp) programas: id, nombre, sellos necesarios para completar, tipo de recompensa (cupón/puntos/manual), reinicio automático y estado. Llame primero para obtener un program_id. Requiere stamp:read.

Obtenga las tarjetas de sellos activas de un miembro: nombre del programa, sellos actuales, sellos necesarios, logros alcanzados y recompensa. Requiere el permiso stamp:read.

Otorga sellos a un miembro por un programa de sellos (por ejemplo, una visita a una tienda). Idempotente con idempotency_key; al completar la tarjeta, la recompensa (cupón/puntos) se emite automáticamente. Cantidad limitada por llamada. Requiere stamp:write.

Puntos de un miembro: saldo disponible, puntos acumulados, canjes, nivel actual, lote con vencimiento próximo. Clave vinculada al miembro → puntos propios (omitir member_id); clave del equipo → pasar member_id. Requiere loyalty:self:read.

Transacciones recientes de puntos de un miembro (ganados/canjeados/ajustados), de la más reciente a la más antigua. Clave vinculada al miembro → historial propio; clave del equipo → pasar member_id. Requiere loyalty:self:read.

Recompensas que un miembro puede canjear por puntos: catálogo con el costo en puntos, clasificado según su asequibilidad en relación con el saldo del miembro. Clave vinculada al miembro → propia; clave del equipo → pasar member_id. Requiere loyalty:self:read.

Cómo funciona el programa de fidelización: tasa de acumulación, bono de bienvenida, valor de los puntos, cómo unirse, además de preguntas frecuentes aprobadas por la marca. Información pública. La clave vinculada al miembro no requiere argumentos. Requiere loyalty:self:read.

Enumere los escenarios de simulación de panel sintético con el límite de usabilidad honesto, el techo de confianza y los campos de entrada de cada uno. Llame primero para elegir un tipo. Requiere metrics:read.

La calibración del panel sintético de la marca (tasa de aciertos de las predicciones sintéticas pasadas frente a la realidad; null hasta que existan pruebas retrospectivas). Requiere metrics:read.

Lea el informe honesto congelado para una ejecución de panel sintético (lectura direccional, límite de confianza, indicadores de supresión, temas) o un blockReason si no está listo. Requiere metrics:read.

Ejecuta un panel sintético: gemelos digitales anonimizados de un segmento reaccionan a un estímulo, generando un informe direccional honesto (nunca cifras absolutas reales). Devuelve un run_id para sondear. Limitado por un límite diario de ejecuciones + ≤50 gemelos. Requiere synthetic:write.