Conectar un agente de IA

Cómo conectar

1. En su cliente de IA, agregue el servidor MCP con la URL https://<host-mcp>/mcp (su contacto comercial le indica el host de su datacenter; en producción es del tipo cl1mcp.fidelizador.com).
2. Al conectar, el cliente abre el login de Fidelizador (OAuth con PKCE). Inicie sesión con su usuario.
3. Tras autorizar, el agente queda conectado con los permisos de su usuario: solo las instancias a las que usted ya tiene acceso.

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

Clientes soportados

Cliente	Estado	Nota
Claude.ai / Cowork (web y escritorio)	Soportado	Las autorizaciones de terceros (Google Drive privado) se resuelven en un paso dentro del chat.
Claude Code (CLI)	Soportado	Las autorizaciones de terceros se resuelven en dos pasos: el servidor entrega un enlace, usted autoriza y pide continuar.
ChatGPT (conectores MCP)	En validación	Pendiente de confirmar contra el servidor real — en desarrollo.

Todos los clientes consultan y envían igual; lo que varía es cómo se conectan y cómo presentan una autorización externa (ver Cargar destinatarios de un envío).

Configuración por cliente

Claude.ai / Cowork: Configuración → Conectores → Agregar conector personalizado, con la URL del servidor (https://<host-mcp>/mcp). El login de Fidelizador se abre en el mismo flujo.

Claude Code (CLI): agregar el servidor con el comando, o declararlo en .mcp.json del proyecto:

claude mcp add --transport http fidelizador https://<host-mcp>/mcp

{
  "mcpServers": {
    "fidelizador": {
      "type": "http",
      "url": "https://<host-mcp>/mcp"
    }
  }
}

La primera llamada dispara el login de Fidelizador (OAuth PKCE) en el navegador.

Enviar correo transaccional

Pídale al agente que envíe; indique remitente, asunto y contenido, y los destinatarios (directamente o cargándolos desde un archivo, ver abajo). El servidor:

• Trocea internamente los envíos a varios destinatarios — usted no pagina.
• Pide confirmación en el chat cuando el envío supera un umbral de volumen, como salvaguarda contra disparos accidentales del agente. Un envío pequeño no la requiere.
• Devuelve un identificador de envío para luego consultar 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 el sistema: la carga es efímera (una referencia válida ~15 minutos, de un solo uso) 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. Según el cliente, la autorización se resuelve en un paso (Cowork) o en dos (Claude Code: abra el enlace, autorice y pida continuar).

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

Troubleshooting

Problema	Causa habitual	Qué hacer
El login de Fidelizador no abre, o el cliente pide autorizar de nuevo cada pocas horas	La conexión se cayó a la sesión de navegador (24h), en vez de quedar en modo offline	Vuelva a conectar el servidor desde cero en su cliente. Si el problema persiste tras varios días, avise a soporte — puede ser un ajuste del lado del servidor.
"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 llame primero list_instances y especifique el slug deseado en el pedido.
La importación de una lista de 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 rate limit configurado para la instancia	Espere unos momentos antes de la siguiente consulta. Si el límite es muy bajo para su uso habitual, contacte a soporte para ajustarlo.
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 — no es un error.
Un tool devuelve un error de disponibilidad (5xx)	El backend está temporalmente inaccesible	Reintente en unos momentos. Si persiste, contacte a soporte con la hora aproximada.