Conectar un agente de IA

Para usuarios de agentes de IA e integradores

Cómo conectar

El uso de un agente de IA es opcional. También puede enviar correos desde sus sistemas mediante API o SMTP.

En su cliente de IA, agregue el servidor MCP con la URL https://mcp.fidelizador.com/mcp. Es la misma para todos los clientes: no hay que elegir un servidor según dónde esté alojada su cuenta.
Inicie sesión en Fidelizador con su usuario cuando el cliente se lo pida (OAuth con PKCE). Si su cuenta tiene segundo factor, se le pide en este paso, igual que al entrar a la plataforma.

Al terminar, el agente queda conectado con los permisos de su usuario y solo accede a las instancias a las que usted ya tiene acceso. Si su cliente corre en su propio equipo, el navegador queda en una dirección http://localhost:<puerto>/callback: es el cierre normal del inicio de sesión.

No se requieren API keys ni credenciales nuevas: la sesión usa su identidad de usuario.

Por qué el login termina en `localhost`

Un cliente de IA que corre en su propia máquina abre un receptor temporal ahí y le pide a Fidelizador que devuelva la respuesta del login a esa dirección. El comprobante de autorización viaja del navegador a la aplicación sin salir de su equipo: nunca pasa por un servidor intermedio. Es el mecanismo que prescribe el estándar de OAuth para aplicaciones nativas (RFC 8252).

Dos consecuencias prácticas:

El puerto es distinto cada vez. Se elige uno libre al momento de conectar, así que no hay un número fijo que valga la pena anotar ni permitir en un firewall.
La página solo sirve durante el login. Si vuelve a abrir esa dirección más tarde verá un error de conexión, porque el receptor ya se cerró. No indica ninguna falla.

Clientes verificados

MCP es un estándar abierto y este servidor usa HTTP con OAuth, así que cualquier cliente compatible se conecta con la misma URL. La tabla indica con qué clientes se probó el flujo completo, no cuáles están permitidos.

Cliente	Verificado	Nota
Claude.ai / Cowork (web y escritorio)	Sí	Las autorizaciones de terceros (Google Drive privado) se resuelven en dos pasos, igual que en los demás clientes.
Claude Code (CLI)	Sí	Las autorizaciones de terceros se resuelven igual que en los demás clientes (ver Cargar destinatarios de un envío).
Codex (CLI)	Sí	Requiere dos parámetros en el alta, ver Configuración por cliente. Sin ellos la conexión se establece pero las herramientas dejan de responder a los pocos minutos.
Copilot en Visual Studio Code	Sí	No requiere parámetros adicionales en el alta. Requiere una suscripción de GitHub Copilot con modo agente, igual que cualquier otro cliente necesita la suya.
Cualquier otro cliente MCP (ChatGPT y demás)	No	Sin verificar contra el servidor real. La conexión se hace igual, con la URL de Cómo conectar; lo que puede variar es cómo el cliente presenta el login y una autorización externa.

Un cliente pasa a verificado cuando se probó contra el servidor real y cumple las dos condiciones de las que depende la conexión:

Habla MCP sobre HTTP.
Resuelve el login con OAuth y PKCE.

Todos los clientes reciben las mismas respuestas, con los mismos permisos y los mismos límites. Lo que varía es el alta de cada uno (ver Configuración por cliente) y cómo presenta el login, los paneles y una autorización externa. La autorización de un archivo de Google se resuelve de la misma forma en todos.

Configuración por cliente

Conector personalizado desde la configuración

ConfiguraciónConectoresAgregar, con la URL del servidor:
No lleva parámetros de autenticación: deje vacíos el Client ID y el Client Secret, y el cliente se da de alta solo.
El login de Fidelizador se abre en el mismo flujo.

Planes Team o Enterprise

En un plan Team o Enterprise, solo un Owner de la organización puede agregar un conector personalizado; a un miembro no le aparece la opción. En ese caso el alta la hace el Owner desde Configuración de la organizaciónConectores, y después cada persona se autentica con su propia cuenta de Fidelizador.

Lo que ve en pantalla

Algunas respuestas no llegan como un párrafo de números sino como un panel dentro de la conversación: una tabla, un gráfico o una ficha que, en varios casos, se puede operar sin escribirle nada al agente.

Hoy traen panel propio:

Lo que pregunta	Qué ve	Qué puede hacer en él
Métricas de entregabilidad	Recibidos y entregados, el cumplimiento del compromiso de entrega, las cuatro tasas, agrupadas según la base sobre la que se calculan, y la serie diaria del período	Cambiar el período y encender o apagar series del gráfico
Actividad	Los registros individuales del tipo de evento que pidió, con su estado, y un recuento de cómo se reparten los de esa página	Cambiar el tipo de evento y avanzar de página
Uso del plan	La cuota de envío del ciclo con lo que le queda y cuándo renueva, los recursos con tope, y qué características incluye su plan	—
Un correo puntual	A quién iba, en qué terminó y por qué, sus contadores, y la cronología completa de intentos de entrega	—
Una plantilla	Su asunto, su preheader, su estado (Borrador o Público) y una vista previa del cuerpo como se vería en un computador o en un móvil	Cambiar entre escritorio y móvil, ver versiones anteriores del cuerpo, y abrir la plantilla en la plataforma para editarla
Un envío	La confirmación pendiente cuando el envío es masivo, o el comprobante del que ya salió, con el código que identifica todos sus grupos	Confirmar el envío

Lo que conviene saber:

Depende del cliente de IA, no de su cuenta. Los paneles usan una extensión del protocolo que no todos los clientes implementan. Hoy los muestra Claude.ai. Un cliente que no la admite recibe la misma respuesta completa en texto. No hay nada que configurar ni activar.
En Claude.ai, la excepción es Cowork desde el móvil. Ahí por ahora llega solo el texto. En el resto los paneles se ven: el chat de la web, la aplicación de escritorio y el chat de la aplicación móvil, tanto en una conversación normal como en Cowork.
Un panel no es una segunda pantalla del producto. Muestra exactamente lo que respondió la operación que usted pidió, con los mismos permisos y los mismos límites; los controles que trae vuelven a consultar, igual que si se lo pidiera al agente. No sale a internet: todo lo que dibuja viaja dentro de la propia respuesta. La única excepción son las imágenes de sus plantillas guardadas en Fidelizador, que se descargan desde el almacenamiento de la plataforma.
Un correo recién enviado tarda un momento en aparecer en Actividad. El registro de lo que pasa con cada correo se arma en segundo plano, así que si pregunta por la actividad en el mismo instante en que envió, puede ver la lista vacía. Vuelva a preguntar pasado un minuto, o pida el envío por el código que le devolvió el propio envío.
La vista previa de una plantilla muestra solo las imágenes guardadas en Fidelizador. Se ven las de la galería de la plataforma y las que su equipo subió a Mis imágenes. Una imagen alojada en otro sitio aparece como un recuadro del mismo tamaño con su texto alternativo, y el panel indica cuántas hay; en el correo enviado se ve normalmente. Para ver el correo completo, use la vista previa de la plataforma o envíese una prueba. Los enlaces se ven, pero no responden al clic.
El agente recibe la misma información que muestra el panel. Por eso usted puede leer el panel y, además, preguntarle al agente por un día puntual del período. Un cliente sin panel recibe lo mismo.

Ejemplos de uso

Escríbale al agente con sus propias palabras. Estos son ejemplos del tipo de pregunta o instrucción que entiende:

Reportes

¿Cómo viene la entregabilidad de esta semana?
Muéstrame los correos que rebotaron hoy
¿Cuánto abrieron e hicieron clic en los envíos del mes pasado, por país?
¿Cuánto llevo usado de mi cuota de envío este mes?

Envío— Modifica estado

Envía un correo de bienvenida a [email protected] usando la plantilla Onboarding
Envía esta notificación a los 200 emails de esta planilla de Google Sheets

Formularios y consentimiento

¿Qué formularios tiene la instancia y cuáles están activos?
¿Este contacto tiene consentimiento vigente para marketing?
¿Qué tenemos registrado de [email protected] y por qué no le llegó el último correo?
¿Qué ítems tiene el formulario de newsletter y a qué término de consentimiento apunta?

Plantillas y remitentes

¿Qué dice el contenido de la plantilla Bienvenida?
Publica la plantilla que acabamos de revisar
Crea una plantilla de bienvenida con un título, un párrafo y un botón azul que diga Empezar
En la plantilla Bienvenida, cambia el texto del botón a Empezar ahora
Muéstrame plantillas de la biblioteca para Navidad y crea un borrador con la que me guste
¿El remitente [email protected] exige consentimiento?

Sandbox

Simula 100 envíos con 10% de rebotes y 60% de apertura, sin tocar destinatarios reales

Enviar correo transaccional

Pídale el envío al agente en lenguaje natural. El procedimiento, paso a paso:

Elija la instancia sobre la que va a operar
Solo hace falta si administra más de una. Puede pedirle al agente que se las liste.
Indique el remitente
Debe ser uno ya creado y verificado en esa instancia.
Defina el asunto y el contenido
También puede indicar una plantilla publicada en lugar del contenido.
Indique los destinatarios
Pueden ser una o varias direcciones en el propio pedido, o un archivo del que cargarlas.
Cargar destinatarios de un envío
Revise la confirmación cuando aparezca
Lo que ve en pantalla
Guarde el identificador que devuelve el envío
Con él se consulta después su estado en los reportes.

Dos ejemplos del mismo procedimiento:

Una dirección: "Envía un correo de bienvenida a [email protected] desde [email protected] con la plantilla Onboarding".
Una planilla: "Envía esta notificación a los contactos de esta planilla de Google Sheets, desde [email protected]".

En cualquiera de los dos, el servidor:

Divide automáticamente los destinatarios en grupos compatibles con los límites de envío. No se requiere ninguna acción adicional.
Pide confirmación en el chat cuando el envío supera un umbral de volumen, para evitar envíos accidentales del agente. Por defecto son más de 5 destinatarios. Fidelizador puede fijar otro valor: si necesita el que rige en su cuenta, consúltelo con soporte.
Devuelve un identificador de envío para consultar después su estado en los reportes.

Cargar destinatarios de un envío

Cuando los destinatarios vienen de un archivo, el agente los carga para ese envío. No se guarda ninguna lista ni audiencia en Fidelizador. La carga es de un solo uso, vale aproximadamente 15 minutos y sirve únicamente para el envío en curso. Orígenes reconocidos automáticamente:

URL pública con los destinatarios en CSV (incluido un Google Sheet publicado como CSV). Se descarga directamente.
Archivo privado de Google Drive / Google Sheets (la URL de edición o el ID). Requiere su autorización de solo lectura mediante una ventana de Google; sus credenciales nunca pasan por el agente. La autorización se resuelve en dos pasos y de la misma forma en todos los clientes: el agente le entrega un enlace, usted autoriza en la ventana de Google y le pide continuar.

La carga detecta la columna de correo automáticamente (email, correo, ...) y descarta destinatarios duplicados.

Troubleshooting

Problema	Causa habitual	Qué hacer
Al iniciar sesión, el navegador queda en una página `http://localhost:<puerto>/callback`	Es el comportamiento normal de un cliente que corre en su equipo: recibe ahí la respuesta del login (ver Por qué el login termina en `localhost`)	No se requiere ninguna acción. Vuelva a su cliente de IA, que ya quedó conectado.
`ERR_CONNECTION_REFUSED` (o "no se puede acceder a este sitio") en una dirección `localhost`	El receptor temporal del inicio de sesión ya se cerró: la sesión ya estaba iniciada, o pasó demasiado tiempo entre abrir el navegador e ingresar la contraseña	Vuelva a lanzar la conexión desde su cliente para que abra un receptor nuevo. Si el agente ya funciona, ignórelo.
En Claude.ai no aparece la opción de agregar un conector personalizado	Su cuenta es miembro de una organización Team o Enterprise, donde solo un Owner puede agregarlos	Pida a quien administre la organización que lo agregue desde Configuración de la organización → Conectores. Después usted se autentica con su propia cuenta.
El cliente pide autorizar de nuevo cada pocas horas	La conexión no quedó habilitada para renovar la sesión sin volver a iniciar sesión en el navegador	Vuelva a conectar el servidor desde cero en su cliente. En Codex, revise que el login lleve `--scopes offline_access` (ver Configuración por cliente). Si el problema persiste, avise a soporte.
"Esta cuenta no tiene instancias asociadas"	Su usuario no tiene acceso a ninguna instancia de Fidelizador	Verifique con quien administra su cuenta que su usuario tenga acceso a al menos una instancia.
"Este usuario administra varias instancias. Indique el parámetro `slug`..."	Administra más de una instancia y no indicó sobre cuál operar	Pídale al agente que liste sus instancias e indique en el pedido sobre cuál operar.
La carga de destinatarios desde Google Drive queda "pendiente" tras abrir el enlace y autorizar	La autorización aún no llegó al servidor (demora normal de unos segundos)	Espere unos segundos y pida al agente que reintente. No hace falta abrir el enlace de nuevo.
"Se alcanzó el límite de N llamadas por minuto para esta instancia"	Se superó el tope de llamadas por minuto de la instancia	Espere unos momentos antes de la siguiente consulta.
El agente pide confirmar un envío y no continúa	Salvaguarda esperada: los envíos sobre el umbral de volumen piden confirmación explícita en el chat	Confirme (o rechace) cuando el agente se lo pregunte.
"La instancia `<slug>` no permite conexiones desde la red de origen de esta llamada"	La instancia tiene una lista de IPs permitidas y la dirección desde la que llega el cliente de IA no está en ella	Conéctese desde una red permitida. Si usa un conector remoto, pida a quien administra la cuenta que agregue la red del proveedor del conector (ver Seguridad y límites).
Una herramienta devuelve un error de disponibilidad (5xx)	El servicio no está disponible temporalmente	Reintente en unos momentos. Si persiste, contacte a soporte con la hora aproximada.

Cómo conectar​

Por qué el login termina en localhost​

Clientes verificados​

Configuración por cliente​

Lo que ve en pantalla​

Ejemplos de uso​