Integración con IA (servidor MCP)

Para desarrolladores

Con un agente de IA compatible puede consultar reportes y solicitar envíos utilizando lenguaje natural. La conexión utiliza MCP (Model Context Protocol), un estándar que permite al agente acceder únicamente a las funciones autorizadas de Fidelizador. Es un canal adicional que complementa la API pública REST y SMTP.

Alcance. Puede enviar a muchos destinatarios de una vez, como una notificación a un conjunto grande de clientes. Este canal tiene dos límites. No guarda listas: los destinatarios se indican en cada envío. Tampoco programa envíos: cada uno sale en el momento. El detalle de cada operación está en Qué puede hacer.

Qué es

Un agente 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. 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. Desde ahí conversa con el agente, y 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 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 filtrable de eventos (enviados, rebotes, quejas, aperturas, no aperturas, clics). Incluye consultar el estado de un envío por su identificador.
• Estado y bitácora de un correo puntual: los metadatos de un correo y su bitácora de entrega, por el ID del correo.
• Aperturas y clics por país y por dispositivo.
• Desuscripciones: listado con fecha y motivo, y un desglose por período.
• Estadísticas por remitente: desempeño de un remitente en un período.
• Uso del plan: consumo actual frente al límite de cada recurso (dominios, remitentes, cuota de envío, usuarios). El límite ya considera los complementos. Sirve para saber cuánto le queda antes de un envío grande.

Configuración: lectura y publicació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 (habilitarlas o deshabilitarlas para envíos).
• Formularios: los que tiene la instancia y su detalle (ítems, link público, estado).
• Consentimiento (Ley 21.719): el estado vigente por identificador, el historial de eventos, los términos y las finalidades declaradas. Ese estado es el que consulta un envío antes de descartar un destinatario.
• Ficha de un contacto: lo que la instancia tiene registrado de un email, teléfono o código único, en una sola respuesta: si se le puede enviar correo, su consentimiento por finalidad y lo más reciente de sus envíos (con el motivo de un descarte), desuscripciones y quejas, formularios y datasets. Es la misma información que la Ficha de contacto del panel, con los mismos permisos, y cada consulta que encuentra datos queda en el log de actividad.
• Campos personalizados que usan los formularios.

Diseño de plantillas

• Crear una plantilla desde cero: el agente escribe el diseño a partir de la especificación del formato y de sus ejemplos, lo revisa con el validador y crea la plantilla como borrador.
• Editarla por partes: cambiar un texto, un botón o una imagen sin reescribir el resto. Cada cambio se apoya en la versión que el agente leyó; si alguien la modificó entretanto, el cambio no se aplica y el agente vuelve a leerla.
• Corregirla con el validador: un diseño con errores no se guarda, y el agente recibe dónde está cada error y cómo corregirlo.
• Previsualizarla antes de guardarla.
• Partir de la biblioteca de plantillas de Fidelizador, cuando usted lo pide.

El agente le muestra la plantilla cuando la crea y cuando un cambio afecta más de dos bloques o reemplaza el diseño completo. Un ajuste menor, como corregir un texto o el enlace de un botón, no la muestra; si quiere verla igual, pídaselo.

El agente trabaja solo con plantillas en borrador: una plantilla publicada no se edita. Cada cambio queda en el historial de versiones. Una plantilla en modo HTML crudo, que guarda su propio HTML tal cual, no se edita por bloques: para cambiarla use el panel o la API. La importación de un HTML existente también se hace desde el panel o la API.

Datasets

• Ver los datasets de la instancia, sus columnas y sus contactos. Buscar por el identificador, exacto o por cómo empieza, responde al instante. Otras búsquedas pueden tardar en un dataset muy grande.
• Crear un dataset con sus columnas, y sumarle columnas después. Si los canales del dataset no definen por cuál identificador reconoce a un contacto (correo, teléfono o código único) y usted no lo indicó, el agente se lo pregunta. Ese identificador no se puede cambiar después.
• Agregar un contacto. Se valida igual que desde un formulario o la API, contra las columnas y las reglas de cada campo. Puede tardar hasta un minuto en aparecer en el dataset.
• Crear un campo en el catálogo, para usarlo como columna.

Desde el agente las columnas y los campos solo se agregan: quitar una columna, volverla obligatoria, o editar o desactivar un campo se hace en el panel.

Crear, editar o eliminar remitentes y dominios, y eliminar cualquier recurso (una plantilla, un dataset, una columna o un campo), solo se puede hacer desde el panel. Los formularios son de solo lectura en este canal: crearlos, editarlos, activarlos, desactivarlos o cambiar su link público se hace desde el panel.

Envío transaccional

• Enviar un correo transaccional a uno o varios destinatarios, por ejemplo una notificación a un conjunto de clientes. El servidor divide automáticamente los destinatarios en grupos compatibles con los límites de envío. Si el envío supera el umbral de volumen (por defecto, más de 5 destinatarios), se pide confirmación en el chat (ver Enviar correo transaccional).

Sandbox

• Consultar el catálogo de escenarios que se pueden simular.
• Simular un envío sin tocar destinatarios reales y ver sus métricas. Sirve para validar la integración antes de un envío real.

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 administra.

Métricas

get_delivery_metrics

Entregabilidad del período, con tasas y tendencia.

get_geographic_stats

Aperturas y clics por país.

get_device_stats

Aperturas y clics por dispositivo.

get_unsubscribe_breakdown

Desglose de desuscripciones por motivo.

get_sender_stats

Entregabilidad de un remitente específico.

Actividad

list_activity

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

list_unsubscribes

Desuscripciones 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 asunto, el preheader, el estado y el HTML de una, con su vista previa.

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.

Diseño de plantillas

get_template_formatget_template_format_example

Especificación del formato de diseño y sus ejemplos.

get_template_outlineget_template_essential

Estructura y diseño de una plantilla, para ubicar lo que se quiere cambiar.

validate_template_documentpreview_template_document

Revisa un diseño contra el formato y muestra el HTML resultante, sin guardar.

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.

create_templateupdate_template

Crea una plantilla en borrador o cambia sus datos o su diseño completo. El nombre no puede repetir el de otra plantilla (template_name_taken).

patch_template_document

Cambia partes del diseño de un borrador.

Biblioteca

list_catalog_templatesget_catalog_template

Plantillas de la biblioteca de Fidelizador y su diseñ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.

create_template_from_catalog

Crea un borrador a partir de una plantilla de la biblioteca.

Formularios

list_formsget_form

Formularios de la instancia y su detalle (ítems, estado, link público completo).

Datasets

list_datasetsget_dataset

Datasets de la instancia y el detalle de uno, con sus columnas y cuál es su identificador.

list_dataset_contacts

Contactos de un dataset, con búsqueda opcional por el identificador o por otra columna según su tipo.

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.

create_dataset

Crea un dataset, con sus columnas si se indican. Pregunta el identificador cuando los canales del dataset no lo definen.

add_dataset_columns

Suma columnas a un dataset. Una columna ya declarada queda como estaba. Si una columna nueva es obligatoria y un formulario conectado no la pide, el asistente le pregunta si agrega la columna a esos formularios o los deja como están.

add_dataset_contact

Agrega un contacto a un dataset; la política de colisión del dataset decide qué pasa si ya existía.

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.

Campos

list_fields

Catálogo de campos personalizados.

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.

create_field

Crea un campo en el catálogo, con sus opciones si es de selección.

Contactos

get_contact_record

Ficha de un contacto: si se le puede enviar correo, su consentimiento por finalidad y lo más reciente de sus envíos, bajas, quejas, formularios y datasets. Cada consulta que encuentra datos queda en el log de actividad.

Facturación

get_plan_usage

Uso actual frente al límite efectivo (plan más complementos), por cada recurso del plan. Un límite de 0 significa que el plan no incluye el recurso.

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 sin tocar destinatarios reales.

Seguridad y límites

• Aislamiento por instancia: el agente opera solo sobre las instancias a las que su usuario tiene acceso. El servidor valida la autorización con su sesión. Un intento de operar una instancia ajena se rechaza.
• Al cargar una lista, el agente no recibe la lista completa: recibe una referencia, la cantidad de destinatarios, el tipo de origen y una vista previa de los primeros 5. La lista completa queda almacenada temporalmente en el servidor y send_mail la utiliza mediante esa referencia. Los destinatarios que escriba directamente en el chat pasan por el agente, como todo lo que le escribe.
• Respeta la restricción de red de la instancia: si la instancia tiene una lista de IPs permitidas, el servidor la aplica a cada llamada del agente, igual que a la aplicación web. La dirección que evalúa es la del cliente de IA:
  • Un cliente que corre en su equipo, como Claude Code, llega con la IP de su red.
  • Un conector remoto, como el de Claude.ai, llega desde la red de su proveedor. Para usarlo con una instancia restringida, agregue esa red a la lista. El rango de salida de los conectores de Claude.ai es 160.79.104.0/21.
• La ficha de un contacto contiene datos personales: la respuesta reúne lo que la instancia guarda de esa persona y llega al proveedor del asistente, como cualquier otra respuesta. El agente la consulta solo cuando usted nombra al contacto. La consulta exige el mismo acceso operativo que la Ficha de contacto del panel y, si encuentra datos, queda en el log de actividad igual que desde ahí.
• Las credenciales de terceros no pasan por el agente: la autorización de Google se hace fuera del agente y solo otorga permiso de lectura.
• Confirmación sobre el umbral de volumen: ver Enviar correo transaccional.
• Límites que fija Fidelizador: al alcanzar uno, el agente recibe un aviso.
  • Llamadas por minuto. El valor es el mismo para todas las instancias y se cuenta por separado en cada una.
  • Destinatarios por envío o por carga.
  • Volumen a partir del cual se pide confirmación.
  • Destinatarios por simulación en sandbox.
• Límites de la descarga al cargar una lista: un tamaño máximo de archivo y un tiempo máximo total. El tamaño se mide tanto en lo transferido como en lo descomprimido, para que un archivo comprimido no exceda el tope al expandirse. 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.