Para conectar Klaviyo a Claude vía MCP: copia mcp.portermetrics.com/mcp, ve a Claude.ai, abre Conectores → Gestionar conectores → Añadir conector personalizado, pega la URL e inicia sesión. A partir de ahí, pregúntale a Claude lo que quieras sobre tus campañas, flujos y segmentos de Klaviyo en lenguaje natural.
Una vez conectado, puedes automatizar tus informes y análisis de Klaviyo: haz preguntas sobre tus datos, crea dashboards, activa alertas o envía informes listos para el cliente como el que aparece a continuación.
Requisitos previos
- Una cuenta de Porter Metrics con tu cuenta de Klaviyo conectada (el plan gratuito es suficiente para probarlo de principio a fin)
- Una cuenta de Claude: el plan gratuito funciona para Claude Web; se necesita una suscripción Pro para Claude Code y las funciones MCP de escritorio
- Acceso de administrador o estándar a las cuentas de Klaviyo que quieras conectar
Conectar Klaviyo a Claude con MCP
En este tutorial usaremos el método MCP. Aquí tienes una breve explicación de qué es MCP y por qué es la mejor opción para Klaviyo.
MCP (Model Context Protocol) es el estándar abierto que permite a herramientas de IA como Claude, ChatGPT, Claude Code y otras acceder y usar APIs externas: los mecanismos que hacen funcionar herramientas como Klaviyo bajo el capó. En lugar de crear una integración personalizada para cada herramienta de IA que uses, instalas un MCP y cada IA compatible accede a los mismos datos.
Cuatro razones por las que MCP gana para Klaviyo:
La configuración completa lleva menos de 5 minutos y se divide en tres pasos: conectar Klaviyo a Porter, apuntar Claude al MCP de Porter y hacer tu primera pregunta.
1. Conecta tus datos de Klaviyo a Porter
Porter se sitúa entre la API de Email y SMS de Klaviyo y Claude. Gestiona OAuth, límites de velocidad, paginación y toda la infraestructura para que Claude solo vea datos limpios y estructurados.
Regístrate en Porter. Crea una cuenta gratuita en portermetrics.com. El plan gratuito es suficiente para ejecutar este flujo completo de principio a fin.
Conecta tu cuenta de Klaviyo. En Porter, haz clic en Crear → selecciona Claude como destino → selecciona Klaviyo como fuente → inicia sesión con Klaviyo para conceder acceso a tus cuentas.
Selecciona tus cuentas. Elige las cuentas de Klaviyo que quieras que Claude consulte. Cuando seleccionas varias cuentas bajo una sola conexión, Porter combina automáticamente sus datos para que puedas consultarlas como una sola.
Opcional: activa el almacenamiento automático en BigQuery si conectas varias cuentas con grandes volúmenes de datos. Esto mantiene las respuestas de Claude rápidas incluso a gran escala.
2. Conecta el MCP a Claude
La URL del MCP de Porter es lo que pegas en Claude. Una vez añadido, Claude puede consultar datos de Klaviyo bajo demanda en cualquier conversación.
Ve a claude.ai y haz clic en el + icono en el campo de chat para abrir el menú de herramientas.
En el menú que se abre, pasa el cursor sobre Conectores y haz clic en Gestionar conectores.
En el panel de Conectores, haz clic en el + botón en la parte superior de la lista para empezar a añadir un nuevo conector.
Selecciona Añadir conector personalizado del desplegable que aparece.
Se abre un cuadro de diálogo con los campos de nombre y URL. Escribe Porter en el primer campo para nombrar el conector.
En el segundo campo, pega https://mcp.portermetrics.com/mcp. No toques la configuración avanzada.
Haz clic en Añadir en la parte inferior derecha del cuadro de diálogo. Claude abre una ventana de inicio de sesión: usa la misma cuenta de Google vinculada a tu espacio de trabajo de Porter y aprueba el acceso.
Una vez finalizada la autorización, verás que las herramientas de solo lectura de Porter aparecen en el panel de conectores. Estás listo para empezar a hacer preguntas.
Para un tutorial más completo con capturas de pantalla en cada paso, consulta el tutorial de Porter MCP.
3. Empieza a crear preguntas y dashboards
Con Porter conectado, abre un nuevo chat de Claude y pregunta lo que quieras sobre tu Klaviyo en lenguaje natural. Claude llama a Porter en segundo plano, extrae datos en vivo de Klaviyo y responde con tablas, gráficos o resúmenes.
Prueba una de estas para verificar que la configuración funciona:
Para un catálogo completo de prompts listos para copiar y pegar organizados por caso de uso (agencias, DTC y e-commerce, marketers B2B, multicanal), salta a la sección de prompts más abajo.
Otras formas de conectar Klaviyo a Claude
MCP es el camino que acabamos de recorrer y el que recomendamos para la mayoría de marketers. Pero no es la única forma de poner los datos de Klaviyo delante de Claude. Las alternativas más comunes son la API directa de Klaviyo (o su MCP oficial), un puente en vivo con Google Sheets y BigQuery para escalar. Cada una tiene sus pros y contras: elige la que se adapte a cómo ya trabaja tu equipo.
- 🔌 API directa de Klaviyo (o MCP oficial) — Habla directamente con la API de Email y SMS de Klaviyo o instala el MCP nativo de Klaviyo si existe. Control máximo, pero tú gestionas la autenticación, los límites de velocidad y la paginación, y solo obtienes una fuente.
- 📊 Google Sheets — Hoja en vivo o carga puntual de CSV. Auditable, familiar, más rápido para grandes exportaciones, pero la agregación ocurre en la Hoja, no en la API.
- 🗄️ Google BigQuery — Para cuentas grandes o agencias que ejecutan análisis multicliente. BigQuery agrega; Claude solo consulta resúmenes preconstruidos.
Vía API directa de Klaviyo (o MCP oficial)
Si estás construyendo un producto alrededor de Klaviyo o eres un desarrollador que prefiere controlar cada capa de la integración, el camino más directo es hablar con la API de Email y SMS tú mismo, o instalar el MCP oficial de Klaviyo (si existe). Klaviyo ofrece un servidor MCP oficial. Puedes generar una URL de MCP única desde la configuración de tu cuenta de Klaviyo y añadirla directamente a Claude Desktop u otros clientes MCP. Deberás seguir los límites de velocidad y cuotas y solicitar un Token de desarrollador / acceso a la API cuando corresponda. De cualquier forma, omites Porter por completo y llamas a Klaviyo desde tu propio código o desde Claude Code con peticiones HTTP en bruto.
Vía Google Sheets (hoja en vivo o CSV manual)
Si tu equipo ya vive en Google Sheets o quieres un rastro de auditoría antes de que Claude toque nada, alimenta Klaviyo en una Hoja y luego deja que Claude lea la Hoja. Puedes automatizar el flujo Klaviyo → Sheets con Porter para que se actualice diariamente, o hacer exportaciones puntuales de CSV desde la interfaz nativa de Klaviyo para análisis estático.
Vía Google BigQuery (para escalar)
Este es el camino que la mayoría pasa por alto y es el que te salva cuando tu cuenta de Klaviyo se pone seria. Un solo marketer grande o una agencia que gestiona más de 10 cuentas alcanzará los límites de velocidad de la API y problemas de latencia al consultar Claude directamente. Claude literalmente te dirá que está tardando demasiado o que se agota el tiempo en extracciones grandes.
BigQuery soluciona eso. Cargas los datos de Klaviyo en tablas de BigQuery de forma programada, luego conectas BigQuery a Claude, ya sea a través de un MCP de BigQuery o vía Claude Code con consultas SQL. En lugar de pedirle a Claude que extraiga datos en bruto de Klaviyo, dejas que BigQuery agregue en tablas pequeñas y optimizadas, y Claude solo consulta el resultado resumido. Problema de escala resuelto.
Lee el tutorial completo de BigQuery →
Conectar Klaviyo a Claude Code
La mayoría de marketers agrupan a Claude y Claude Code juntos y pasan por alto la mayor ventaja de todo el ecosistema MCP. No son la misma herramienta, y la diferencia importa enormemente una vez que empiezas a trabajar seriamente con datos de Klaviyo.
Claude es una interfaz de chat. Haces una pregunta, Claude extrae datos en vivo a través del MCP, responde, tal vez crea un dashboard rápido dentro de la conversación. Genial para análisis puntuales. El problema: todo es efímero. ¿Quieres actualizar el dashboard mañana? Lo regeneras desde cero. ¿Quieres el mismo informe cada lunes? Vuelves a hacer la pregunta cada lunes.
Claude Code es Claude ejecutándose dentro del terminal de tu computadora. Como tiene acceso a tu sistema de archivos, tiempo de ejecución y otras herramientas de desarrollo, no solo responde preguntas: puede construir software real. Scripts persistentes, rutinas programadas, aplicaciones HTML, dashboards internos, integraciones que funcionan 24/7 sin tu intervención. Una vez conectado al MCP de Porter para Klaviyo, toda una categoría de trabajo se vuelve posible.
Conclusión: Claude es para preguntas rápidas y dashboards ad hoc. Claude Code es para construir aplicaciones, dashboards en vivo, alertas y herramientas reales: cualquier cosa que quieras que funcione por sí sola sin volver a preguntar. La misma URL del MCP de Porter funciona en ambos, así que no eliges una vez y te quedas atado.
Casos de uso: qué puedes hacer realmente una vez que Klaviyo está conectado a Claude
Conseguir la conexión correcta es la mitad de la batalla. El valor real aparece en lo que haces después. Aquí están los casos de uso que los usuarios de Porter construyen alrededor de sus datos de Klaviyo, desde preguntas y respuestas simples hasta flujos de trabajo completos orientados al cliente.
1. Chatea y haz preguntas directamente
El caso de uso más simple, y aun así el con el que el 80% de los marketers empieza. Abre Claude, haz una pregunta, obtén una respuesta basada en datos en vivo.
Es la forma más rápida de sustituir una revisión diaria del dashboard de Klaviyo. Pero el chat es lo básico: los casos de uso interesantes vienen a continuación.
2. Combina Klaviyo con tus datos de e-commerce y CRM (Shopify, Stripe, HubSpot)
Aquí es donde una visión 360° se vuelve real. Cuando conectas Klaviyo y tu plataforma de e-commerce (Shopify para e-commerce, Stripe para pagos, HubSpot para CRM), Claude puede mapear campañas a compras reales usando nombres de campaña, IDs de flujo y marcas de tiempo, y darte una atribución que ningún número de la plataforma puede ofrecer.
Claude gestiona el mapeo y las uniones de nombres de campaña, IDs de flujo y marcas de tiempo. Obtienes un informe de atribución listo para el cliente que ninguna plataforma individual puede generar por sí sola.
3. Alertas y notificaciones automatizadas en Slack o Gmail
Con Claude Code puedes convertir el monitoreo de Klaviyo en una rutina que funciona por sí sola. Conecta el MCP de Porter (para los datos) junto con un MCP de Slack o Gmail (para la entrega), luego escribe una tarea programada de Claude Code que extrae el rendimiento cada mañana y te avisa solo cuando algo realmente necesita atención.
Sin dashboards, sin revisiones diarias. El informe viene a ti, y solo cuando importa.
4. Presentaciones listas para el cliente con datos en vivo (Gamma, HTML, PDF)
Un dolor común de las agencias: envías a los clientes un informe PDF estático y pasas una hora explicando un dashboard roto. Con Claude puedes construir la presentación misma, ya sea como un deck de Gamma, una página HTML personalizada o un PDF, poblada con números en vivo cada vez.
La presentación se convierte en un artefacto de entrega que envías al cliente, no un dashboard que depende de que otra herramienta siga funcionando. Sin iframe roto, sin solicitudes de inicio de sesión, solo el contenido.
Campos y métricas de Klaviyo que puedes consultar con Claude
Antes de empezar a escribir prompts, ayuda saber qué datos están realmente disponibles. El MCP de Porter le da a Claude acceso a 84 campos y métricas de Klaviyo en cada nivel de informe, además de desgloses por fecha, día de la semana, mes y trimestre. Y la misma URL de MCP también desbloquea más de 25 fuentes adicionales, así que Claude puede combinar Klaviyo con Google Ads, GA4, Shopify, HubSpot y más en un solo prompt.
Campaña archivadaCanal de campañaCampaña creada elID de campañaCampaña ignorar desuscritosCampaña añadir UTMCampaña rastrear clicsCampaña rastrear aperturasMoneda del eventoFecha y hora del eventoTipo de dispositivo del eventoID de formulario del eventoTipo de formulario del eventoID del eventoAsunto del eventoUUID del eventoDirección 1 del perfilDirección 2 del perfilProfile Average Days Between OrdersProfile Average Order ValueProfile Churn ProbabilityCiudad del perfilPaís del perfilIcono de país del perfilFlujo creado elID de flujoFlujo archivadoID de mensaje de flujoNombre de flujoEstado de flujoTipo de activador de flujoFlujo actualizado elLista creada elID de listaNombre de listaLista actualizada elID de cuentaNombre de cuentaPrompts que puedes copiar y pegar hoy
1. Para agencias
Cuando necesitas post-mortems de campañas multicliente, identificación de cuellos de botella en flujos e informes de cliente con plantillas sin iniciar sesión manualmente en cada cuenta de Klaviyo.
2. Para DTC y e-commerce
Cuando monitoreas ingresos de flujo de carrito abandonado, niveles de CLV predicho y probabilidad de churn para programar envíos de recuperación.
3. Para marketers B2B
Cuando rastreas secuencias de email de lead a cliente, crecimiento de listas por segmento y haces referencia cruzada del engagement de email con las etapas de negociación del CRM.
4. Multicanal
Cuando combinas Klaviyo con otras fuentes de marketing para análisis unificado.
Límites, autenticación y mejores prácticas para Klaviyo vía Claude
Este post ilustra la acción de cumplimiento más severa que toma Klaviyo: suspensión de cuenta por cumplimiento después de que un nuevo usuario subiera una lista y enviara su primera campaña. Si bien esto es un problema de entregabilidad/cumplimiento de email en lugar de un caso de abuso de la API, demuestra que los sistemas automatizados de Klaviyo sí aplican límites estrictos cuando la calidad de los datos o los permisos son sospechosos. Para marketers que usan Klaviyo vía Claude, el riesgo paralelo no es “ser baneado por usar MCP”, sino alcanzar los techos de velocidad en medio del análisis y perder acceso a datos en vivo justo cuando se toman decisiones de campaña sensibles al tiempo. El costo se mide en flujo de trabajo interrumpido y insights retrasados, no en pérdida irreversible de cuenta.
Una segunda frustración documentada proviene de desarrolladores cuyas integraciones se rompieron cuando Klaviyo cambió los límites de la API sin avisar: “Los límites de la API cambiaron de nuevo” — Klaviyo Developer Community. Esto subraya que los límites de velocidad de Klaviyo son umbrales vivos que pueden cambiar, haciendo peligrosas las suposiciones codificadas de forma rígida.
La aplicación de límites de velocidad de Klaviyo es basada en cuotas y escalonada por endpoint, no basada en herramientas. Klaviyo no banea ni limita cuentas porque usaste Claude o un servidor MCP. Limita por cómo se usó la API: superar los umbrales de peticiones burst (por segundo) o steady (por minuto) por endpoint desencadena respuestas HTTP 429 con un encabezado `Retry-After`. Las consultas de solo lectura dentro del tier de tu cuenta son seguras. Las peticiones paralelas en ráfaga, operaciones de escritura a gran escala o mezclar endpoints de alto volumen sin conocer sus tiers respectivos no lo son. El sistema usa un algoritmo de ventana fija, lo que significa que los contadores se reinician en intervalos predecibles en lugar de ventanas deslizantes.
Las dos formas de agotar tu cuota de Klaviyo
Después de revisar documentación oficial y hilos de la comunidad, dos patrones aparecen una y otra vez.
1. Ráfagas de API paralelas en múltiples endpoints. Enviar peticiones concurrentes a varios endpoints de Klaviyo simultáneamente (por ejemplo, consultando campañas, flujos, segmentos y métricas a la vez vía Claude) puede superar el límite de ráfaga por cuenta de 1 petición por segundo para endpoints Tier XS o 3 peticiones por segundo para endpoints Tier S como métricas. Esto desencadena limitación 429 y obliga al servidor MCP a retroceder, dejando al usuario con datos parciales u obsoletos. Klaviyo Developer Community — Rate Limits Discussion
2. Superar los límites steady específicos de endpoint. Klaviyo asigna cada endpoint a un tier con umbrales de ráfaga y steady distintos. Por ejemplo, los endpoints Tier S permiten 60 peticiones por minuto steady después de la ventana de ráfaga inicial. Un marketer que le pide a Claude “extraer todas las campañas de los últimos 12 meses con desglose completo de eventos” puede agotar esta cuota sin saberlo en un solo hilo de conversación. El resultado no es un baneo, sino un corte duro en el acceso a datos hasta que la ventana se reinicia. Klaviyo API Overview — Rate Limit Tiers
3. Usar claves de API públicas para endpoints `/api` o configurar mal los scopes. Klaviyo distingue entre claves públicas (para endpoints `/client` como rastreo onsite) y claves privadas (para endpoints `/api` como campañas, flujos y segmentos). Intentar usar una clave pública para consultas MCP del lado del servidor devuelve errores 401 o 400. Además, las claves privadas deben tener los scopes correctos habilitados en Configuración de Klaviyo > Claves de API; los scopes faltantes producen 403 acceso denegado respuestas que aparecen como “Claude no puede acceder a mis datos” en la experiencia de usuario. Klaviyo Help Center — API Keys
Ambos comportamientos desencadenan limitación de velocidad y errores de acceso. Si quieres usar Claude para Klaviyo de forma segura, mantente dentro de los límites de ráfaga y steady de tu tier, usa claves de API privadas con los scopes correctos y deja que el MCP de Porter gestione el batching y el backoff automáticamente.
El protocolo de escalado de 5 reglas
Basado en los límites de velocidad documentados de Klaviyo y los comportamientos que realmente han causado limitación, no en conjeturas:
- Usa claves de API privadas exclusivamente para endpoints `/api`. Las claves públicas están restringidas solo a endpoints `/client`; todas las consultas del servidor MCP se enrutan a través de `/api` y requieren una clave privada. La configuración incorrecta desencadena errores 400/401 inmediatos. Klaviyo Help Center — API Keys
- Respeta el límite de ráfaga de 3 peticiones por segundo para endpoints Tier S (métricas, campañas, flujos). Tier S es el tier más común para endpoints de análisis de marketing. Superar 3 req/s de ráfaga desencadena limitación 429. Klaviyo Developer Community — Rate Limits
- Mantente por debajo del límite steady de 60 peticiones por minuto para endpoints Tier S. Después de la ventana de ráfaga inicial, la consulta sostenida debe mantenerse por debajo de 60 req/min. Para extracciones históricas grandes, pagina con `page_cursor` y pausa entre lotes. Klaviyo API Overview — Rate Limit Tiers
- Respeta el encabezado `Retry-After` en respuestas 429. La documentación de Klaviyo indica que los errores 429 incluyen un encabezado `Retry-After` que indica los segundos de espera. Ignorarlo y reintentar inmediatamente extiende la ventana de limitación.
- Concede solo los scopes mínimos requeridos en la configuración de claves de API de Klaviyo. El servidor MCP solo necesita acceso de lectura a Campaigns, Flows, Segments y Metrics. Los scopes de escritura (por ejemplo, `campaigns:write`, `profiles:write`) deben permanecer deshabilitados a menos que gestiones activamente campañas vía Claude.
Qué hace diferente el MCP de Porter: aplica estos límites de velocidad y salvaguardas a nivel de plataforma. El servidor MCP Universal de Porter implementa solo lectura por defecto para todas las consultas de Klaviyo, eliminando el riesgo de operaciones de escritura accidentales. Aplica batching automático de peticiones y backoff cuando Klaviyo devuelve respuestas 429, reintentando de forma transparente con retardo exponencial para que el marketer nunca vea una conversación rota. El aislamiento de conexiones por cuenta garantiza que el tráfico en ráfaga de un usuario nunca se filtre en la cuota de otro. Ese es el comportamiento que los sistemas automatizados de Klaviyo gestionan con elegancia y no señalan.
Preguntas frecuentes
Un Klaviyo MCP (Model Context Protocol) es un estándar abierto que permite a herramientas de IA — Claude, Claude Code, ChatGPT, Cursor — conectarse a tus datos de Klaviyo sin integraciones personalizadas. El servidor MCP de Porter pone a disposición tus campañas, flujos, segmentos y métricas a través de una URL: sin tokens, sin scripts, sin configuración de desarrollador.
Claude es el producto conversacional (web, app, móvil). Claude Code es una herramienta de desarrollo basada en terminal que puede escribir scripts, guardar archivos y automatizar flujos de trabajo. Ambos pueden conectarse a Klaviyo vía MCP.
Klaviyo actualiza los segmentos automáticamente basándose en datos en tiempo real, y las métricas de informes normalmente se reflejan en minutos. El MCP de Porter extrae en vivo, así que tus datos siempre están dentro de esa ventana.
Sí. Klaviyo aplica límites de velocidad escalonados: por ejemplo, los endpoints Tier S permiten 3 peticiones por segundo de ráfaga y 60 peticiones por minuto steady. El MCP de Porter hace batching y cachea las peticiones automáticamente para que raramente los alcances.
(Fuentes: Klaviyo Developer Community — Rate Limits; Klaviyo API Overview — Rate Limit Tiers)
Tres razones comunes: (1) Ventanas de atribución — el dashboard atribuye métricas a las fechas de envío de mensajes con ventanas personalizadas, mientras que la API devuelve eventos en bruto por ocurrencia. (2) Agregación temporal — el dashboard agrupa los datos de forma diferente a las consultas de la API. (3) Unicidad — el dashboard deduplica métricas únicas a lo largo del período, mientras que los datos en bruto de la API pueden inflar los recuentos. La solución: haz coincidir los filtros de consulta y los rangos de fechas con la configuración de vista del dashboard.
(Fuentes: Weld — Klaviyo Discrepancies; Klaviyo Community — Data Mismatch Between API and Dashboard)
No. Klaviyo no banea ni restringe cuentas por uso legítimo de la API, y el MCP de Porter es de solo lectura por defecto: se mantiene bien dentro de los límites normales de velocidad de Klaviyo. Lo que hay que vigilar es la limitación de velocidad en peticiones paralelas en ráfaga: consulta la sección de límites más arriba.
(Fuentes: Klaviyo Community — Account Disabled; Klaviyo Developer Community — API Limits Changed Again)
¿Listo para chatear con tu Klaviyo?
Abre Claude, añade el conector de Porter y haz tu primera pregunta. Si aún no tienes Porter, empieza una prueba gratuita y conecta tu cuenta de Klaviyo: estarás chateando con tus campañas, flujos y segmentos en menos de cinco minutos.
rocket_launch Prueba Porter gratisopen_in_new Abre Claude