Integración con IA (servidor MCP)

Para desarrolladores

Fidelizador expone su operación de email como un servidor MCP (Model Context Protocol): un canal por el cual un agente de IA (por ejemplo Claude.ai / Cowork o Claude Code) consulta reportes y envía correos en lenguaje natural. Es un BFF para agentes — el cliente es un agente en vez de un navegador. No reemplaza la API pública REST; es una capa conversacional sobre las mismas operaciones.

Alcance (Etapa 1). Envíos puntuales, consulta de reportes, y lectura/activación de configuración existente (formularios, plantillas, remitentes, consentimiento). Un envío a varios destinatarios de una planilla también entra: es un envío masivo operado a mano, y el canal lo soporta. Lo que no hay es gestión de campañas ni de listas/audiencias persistentes — nada queda guardado como audiencia reutilizable ni se puede programar para más tarde. Crear, editar contenido o eliminar un recurso (una plantilla, un formulario, un remitente) sigue siendo exclusivo del panel — ver Qué puede hacer.

Qué es

Un asistente de IA autorizado por usted puede consultar y operar Fidelizador de forma controlada, sin acceso directo a sus credenciales ni a datos de otras instancias. Para eso, el agente se conecta al servidor MCP, usted inicia sesión con su cuenta de Fidelizador (la misma con la que accede a la plataforma) y a partir de ahí conversa con el asistente para operar. El servidor traduce cada intención a las operaciones de la plataforma.

Qué puede hacer

A través del agente, en lenguaje natural:

Sus instancias

• Listar las instancias de Fidelizador que usted administra, para indicar sobre cuál operar cuando tiene varias.

Reportes y análisis

• Entregabilidad por período: enviados, entregados, rebotes, quejas, con tasas y tendencia.
• Actividad: listado de eventos (enviados, rebotes, quejas, aperturas, clics), filtrable; incluye consultar el estado de un envío específico por su identificador.
• Estado y bitácora de un correo puntual: metadatos de un correo por su ID y su log de entrega.
• Aperturas y clics por país y por dispositivo.
• Desuscripciones: listado con fecha y motivo, y un desglose (breakdown) por período.
• Estadísticas por remitente: desempeño de un remitente en un período.
• Uso del plan: consumo actual vs el límite contratado (dominios, remitentes, cuota de envío, usuarios), por si necesita saber cuánto le queda antes de un envío grande.

Configuración — lectura y activación

• Remitentes: los verificados, el detalle de uno puntual (por nombre, email o ID), y su configuración de consentimiento.
• Dominios de envío y su verificación.
• Plantillas: disponibles, su contenido, su historial de versiones, y publicarlas o despublicarlas (habilitar/deshabilitar para envíos — no edita el contenido).
• Formularios: los que tiene la instancia y su detalle (ítems, link público, estado). Solo lectura — activar, desactivar o cambiar el link público de un formulario es exclusivo del panel: un formulario de captura de consentimiento que se desactiva por error es un evento de cumplimiento, no un ajuste menor, así que esa acción queda fuera de este canal a propósito.
• Consentimiento (Ley 21.719): el estado vigente por identificador (el mismo que consulta un envío antes de descartar un destinatario), el historial de eventos, los términos y las finalidades declaradas.
• Campos personalizados disponibles para armar formularios.

Crear, editar contenido (el HTML de una plantilla, la estructura de un formulario) o eliminar cualquiera de estos recursos sigue siendo exclusivo del panel.

Envío transaccional

• Enviar un correo transaccional a uno o varios destinatarios. Soporta envíos transaccionales a múltiples destinatarios a la vez (por ejemplo, una notificación a un conjunto de clientes) — el servidor los trocea internamente. No es una herramienta de campañas de marketing. Cuando el envío supera cierto volumen, pide confirmación en el chat (ver Enviar correo transaccional).

Sandbox

• Consultar el catálogo de escenarios simulables y simular un envío (entregas, rebotes, quejas, aperturas, clics) sin tocar destinatarios reales, viendo sus métricas. Útil para validar la integración antes de enviar de verdad.

El propio servidor expone al agente el catálogo vigente de herramientas y sus parámetros — la tabla de abajo es la referencia legible para una persona.

Catálogo de herramientas

Las categorías marcadas Modifica el estado agrupan herramientas que escriben; el resto son de solo lectura.

Cuenta

list_instances

Instancias que usted administra.

Métricas

get_delivery_metrics

Entregabilidad agregada del período, con tasas y tendencia.

get_geographic_stats

Aperturas/clics por país.

get_device_stats

Aperturas/clics por dispositivo.

get_unsubscribe_breakdown

Distribución de bajas por motivo.

get_sender_stats

Entregabilidad de un remitente específico.

Actividad

list_activity

Eventos individuales: enviados, rebotes, quejas, aperturas, clics.

list_unsubscribes

Bajas con fecha y motivo.

get_mail

Estado y metadatos de un correo puntual.

get_mail_logs

Bitácora de entrega SMTP de un correo.

Envío— Modifica el estadoEstas herramientas escriben en la cuenta del usuario — envían correos, importan destinatarios, publican plantillas. El agente pide confirmación antes de ejecutarlas.

send_mail

Envía a una lista de destinatarios, con plantilla o contenido propio.

import_recipients

Importa destinatarios desde una URL o Google Drive/Sheets y devuelve una referencia efímera para el envío.

Remitentes

list_senders

Remitentes verificados.

get_sendersearch_senders_by_namesearch_senders_by_email

Detalle o búsqueda de un remitente puntual.

get_sender_consent

Si un remitente exige consentimiento y contra qué finalidades.

Dominios

list_domains

Dominios de envío y su verificación.

Plantillas

list_templatesget_template

Plantillas disponibles y el contenido de una.

list_template_versionsget_template_version

Historial de versiones de una plantilla.

Modifica el estadoEstas herramientas escriben en la cuenta del usuario — envían correos, importan destinatarios, publican plantillas. El agente pide confirmación antes de ejecutarlas.

publish_templateunpublish_template

Habilita o deshabilita una plantilla para usarse en envíos.

Formularios

list_formsget_form

Formularios de la instancia y su detalle (ítems, estado, link público completo). Solo lectura — activar/desactivar y rotar el link se gestionan desde el panel.

Consentimiento

list_consent_rules

Estado vigente de consentimiento por identificador.

list_consent_events

Historial de eventos de consentimiento.

list_consent_termslist_consent_purposes

Términos y finalidades declaradas.

list_fields

Catálogo de campos personalizados.

Facturación

get_plan_usage

Uso actual vs el límite del plan, por entitlement.

Sandbox

sandbox_catalog

Escenarios que el sandbox puede simular.

Modifica el estadoEstas herramientas escriben en la cuenta del usuario — envían correos, importan destinatarios, publican plantillas. El agente pide confirmación antes de ejecutarlas.

simulate_scenario

Simula un escenario de entrega (envíos, rebotes, quejas, aperturas) sin tocar destinatarios reales.

Seguridad y límites

• Aislamiento por instancia: el agente opera solo sobre las instancias de su usuario; la autorización la valida el servidor a partir de su token, no se reimplementa en este canal. Un intento de operar una instancia ajena se rechaza.
• El agente no ve la lista de destinatarios: al cargar una lista recibe solo una referencia; los datos completos quedan en el servidor y se consumen al enviar.
• Sin paso de credenciales por el agente: las autorizaciones de terceros (Google) ocurren fuera del contexto del agente, con alcance de solo lectura.
• Confirmación de envíos de alto volumen: ver Enviar correo transaccional.
• Límites configurables por el operador: un tope de llamadas por minuto (rate limit) — un mismo valor global aplicado de forma independiente a cada instancia—, un tope de destinatarios por envío/carga, el umbral de volumen a partir del cual se pide confirmación, y un tope de destinatarios por simulación en sandbox. Al alcanzar un límite, el agente recibe un aviso.
• Cotas de la descarga al cargar una lista: un tamaño máximo de archivo — medido tanto en lo transferido como en lo descomprimido, para que un archivo comprimido no exceda el tope al expandirse— y un tiempo máximo total. El origen debe ser https: una URL http, o una https que redirija a http, se rechaza, porque sobre texto plano un tercero puede alterar la lista de destinatarios en tránsito.