Servidor MCP de Klaviyo

¿Qué hace el Servidor MCP de “Klaviyo”?

El Servidor MCP de Klaviyo revoluciona la automatización de email marketing al conectar la potente plataforma de Klaviyo con asistentes de IA y herramientas de desarrollo mediante el Model Context Protocol (MCP). Esta integración permite a los equipos de marketing gestionar campañas sofisticadas, perfiles de clientes, flujos de automatización y segmentos de audiencia utilizando comandos en lenguaje natural en lugar de navegar por múltiples paneles. Ya sea creando campañas personalizadas, rastreando eventos de clientes, construyendo segmentos complejos u orquestando flujos de automatización de varios pasos, el Servidor MCP de Klaviyo te permite ejecutar estas tareas directamente desde herramientas de IA como Claude, Cursor o FlowHunt. Al eliminar los cambios de contexto y habilitar la automatización impulsada por IA, los equipos de marketing pueden reducir el tiempo de configuración de campañas de horas a minutos, manteniendo el control total sobre su estrategia de interacción con el cliente.

Lista de Prompts

Gestión de Perfiles y Clientes

Encuentra todos los perfiles de clientes que no han abierto emails en 90 días

Crea un nuevo perfil para customer@example.com con propiedades personalizadas para estado VIP

Muéstrame todos los perfiles que compraron en los últimos 30 días pero no han recibido un email de seguimiento

Actualiza todos los perfiles del segmento VIP para añadir una propiedad de nivel de lealtad

Gestión de Campañas

Crea una nueva campaña de email para Black Friday con asunto 'Exclusivo 40% de descuento' dirigida a clientes VIP

Muéstrame todas las campañas enviadas en los últimos 7 días con tasas de apertura por debajo del 15%

Envía la campaña 'Serie de Bienvenida Parte 1' inmediatamente a todos los nuevos suscriptores

Cancela la campaña programada para mañana y reprográmala para la próxima semana

Listas y Segmentación

Crea una nueva lista llamada 'Reactivación Q1 2026' para suscriptores inactivos

Añade todos los perfiles que hicieron clic en nuestro último email pero no compraron a la lista 'Leads Calientes'

Muéstrame todos los segmentos con más de 5000 perfiles y sus criterios

Operaciones de Plantillas de Email

Crea una nueva plantilla de email para el lanzamiento de nuestro producto con contenido HTML

Muéstrame todas las plantillas usadas en campañas con tasas de conversión superiores al 5%

Actualiza la plantilla 'Promoción Navideña' con el nuevo código de descuento HOLIDAY2026

Seguimiento de Eventos y Analítica

Rastrea un evento 'Producto Visto' para todos los perfiles que visitaron nuestra nueva página de colección

Muéstrame todos los eventos 'Compra' de los últimos 30 días con valores de pedido superiores a $100

Obtén todas las métricas de desempeño de email y dime qué campañas generaron más ingresos

Automatización de Flujos

Muéstrame todos los flujos de automatización activos y sus tasas de conversión

Pausa el flujo de 'Carrito Abandonado' mientras actualizamos las plantillas de email

Pon el flujo 'Serie de Bienvenida' en estado en vivo y habilítalo para nuevos suscriptores

¿Listo para hacer crecer tu negocio?

Comienza tu prueba gratuita hoy y ve resultados en días.

Solicitar demo Iniciar sesión

Lista de Recursos

No se listan recursos explícitos en el repositorio.

Lista de Herramientas

El Servidor MCP de Klaviyo proporciona 39 herramientas completas organizadas en ocho categorías:

Gestión de Perfiles (5 herramientas)

• get_profiles - Obtén una lista de perfiles de clientes con filtrado y paginación opcionales
• get_profile - Obtén información detallada de un perfil de cliente específico por ID
• create_profile - Crea un nuevo perfil de cliente con email, teléfono, propiedades personalizadas y más
• update_profile - Actualiza los atributos de un perfil existente como nombre, email o propiedades personalizadas
• Profile filtering - Capacidades avanzadas de filtrado usando la sintaxis de filtros de Klaviyo

Gestión de Listas (7 herramientas)

• get_lists - Recupera todas las listas de email en tu cuenta de Klaviyo
• get_list - Obtén detalles de una lista específica por ID
• create_list - Crea una nueva lista de email para organizar contactos
• update_list - Actualiza las propiedades de la lista incluyendo el nombre
• delete_list - Elimina permanentemente una lista de tu cuenta
• add_profile_to_list - Añade un perfil de cliente a una lista específica
• remove_profile_from_list - Elimina un perfil de una lista

Gestión de Campañas (7 herramientas)

• get_campaigns - Recupera campañas con filtrado opcional
• get_campaign - Obtén información detallada de una campaña específica
• create_campaign - Crea una nueva campaña de email con asunto, detalles del remitente y texto de vista previa
• update_campaign - Actualiza atributos de la campaña como nombre, asunto o contenido
• send_campaign - Envía una campaña inmediatamente a la audiencia objetivo
• cancel_campaign - Cancela una campaña programada antes de que se envíe
• assign_template_to_campaign - Asocia una plantilla de email a un mensaje de campaña

Seguimiento de Eventos (2 herramientas)

• create_event - Registra eventos personalizados para perfiles con propiedades y marcas de tiempo
• get_events - Recupera eventos con filtrado y paginación para análisis

Métricas y Analítica (2 herramientas)

• get_metrics - Recupera todas las métricas disponibles de Klaviyo para seguimiento de desempeño
• get_metric - Obtén información detallada sobre una métrica específica por ID

Gestión de Segmentos (2 herramientas)

• get_segments - Recupera todos los segmentos de clientes en tu cuenta
• get_segment - Obtén información detallada de un segmento específico incluyendo criterios

Automatización de Flujos (3 herramientas)

• get_flows - Recupera todos los flujos de automatización con filtrado y paginación opcional
• get_flow - Obtén información detallada de un flujo de automatización específico
• update_flow_status - Cambia el estado del flujo entre modos en vivo, manual y borrador

Gestión de Plantillas (5 herramientas)

• get_templates - Recupera todas las plantillas de email en tu cuenta
• get_template - Obtén información detallada de una plantilla específica
• create_template - Crea una nueva plantilla de email con contenido HTML y de texto
• update_template - Actualiza atributos de la plantilla incluyendo HTML, texto y nombre
• delete_template - Elimina permanentemente una plantilla de tu cuenta

Únete a nuestro boletín

Obtén los últimos consejos, tendencias y ofertas gratis.

Dirección de correo electrónico

Suscribirse

Casos de Uso de este Servidor MCP

Cuando tienes más de 100 suscriptores inactivos que necesitan reactivación

Tienes miles de suscriptores inactivos saturando tu lista y afectando la entregabilidad. En lugar de crear manualmente segmentos, filtros y campañas multi-touch, pide: “Encuentra todos los perfiles que no han abierto emails en 90 días, crea un segmento llamado ‘Reactivación Q1 2026’ y configura una campaña de recuperación de tres emails usando nuestra plantilla de reactivación”. El servidor MCP construye el segmento, crea las campañas, asigna las plantillas y prepara toda la secuencia de reactivación en menos de 2 minutos—trabajo que tradicionalmente toma 2-3 horas.

Cuando el lanzamiento de un producto requiere segmentación por historial de compras

Tu nuevo producto premium se lanza mañana y necesitas dirigirte a clientes según el valor de vida e historial de compras. Simplemente di: “Crea segmentos para clientes que gastaron más de $500 en el último año pero no compraron en los últimos 60 días, y otro para quienes compraron nuestro producto inicial pero nunca mejoraron”. El servidor crea ambos segmentos al instante, permitiéndote adaptar mensajes para cada grupo—trabajo crítico que usualmente requiere filtros complejos y varias rondas de QA.

Cuando analizas qué plantillas de email generan más conversiones

Has enviado docenas de campañas y necesitas identificar tus plantillas más efectivas. Pide: “Muéstrame todas las campañas enviadas en Q4 2025, sus plantillas asignadas y sus métricas de conversión”. En vez de exportar datos y construir hojas de cálculo manualmente, recibes un análisis instantáneo que destaca las plantillas que consistentemente superan, permitiendo decisiones creativas basadas en datos sin el proceso manual habitual de 4-5 horas.

Cuando necesitas sincronizar eventos de tu app para disparar flujos automatizados

Tu aplicación SaaS rastrea comportamientos críticos—inicio de pruebas, adopción de funciones, hitos de uso—y necesitas estos eventos en Klaviyo para activar flujos personalizados. Ordena: “Crea un evento ‘Función X Activada’ para todos los perfiles de mi segmento usuarios avanzados con marca de tiempo y propiedades de función”. El servidor MCP crea los eventos en lote con la atribución adecuada, habilitando marketing sofisticado basado en comportamiento sin escribir scripts API personalizados ni esperar recursos de ingeniería.

Cuando gestionas varias marcas y necesitas duplicar campañas exitosas

Gestionas tres marcas distintas y la campaña navideña de la Marca A tuvo un 42% de apertura. En vez de recrear manualmente la estructura para las Marcas B y C, di: “Obtén la campaña ID abc123, muéstrame su estructura, plantilla y configuraciones, luego ayúdame a crear campañas idénticas para mis listas de Marca B y Marca C”. El servidor recupera todos los detalles y te ayuda a replicar el éxito en minutos en lugar de horas de copiar, pegar y verificar configuraciones.

Cuando llega Black Friday y necesitas 20 variaciones de emails promocionales

La temporada alta exige múltiples variaciones de email para distintos segmentos—nuevos clientes, VIPs, curiosos, carritos abandonados. En vez de crear 20 campañas por la UI, instruye: “Crea campañas para Black Friday dirigidas a estos 5 segmentos: clientes VIP, compradores recurrentes, compradores únicos, suscriptores que nunca compraron y abandonadores de carrito. Usa nuestra plantilla navideña y personaliza asuntos para cada uno.” El servidor genera todas las campañas con segmentación y plantillas apropiadas, reduciendo 6+ horas de trabajo repetitivo a 15 minutos de creación guiada por IA.

Cuando descubres un error crítico en la plantilla tras enviar a 10,000 suscriptores

Enviaste una campaña y notaste que el código promocional en tu plantilla es incorrecto. Tienes 15 campañas programadas usando la misma plantilla. En vez de actualizar manualmente cada campaña, di: “Muéstrame todas las campañas programadas en los próximos 7 días usando la plantilla ID xyz789, luego actualiza la plantilla para cambiar PROMO20 por PROMO25.” El servidor identifica las campañas afectadas y actualiza la plantilla al instante, previniendo 15 posibles errores sin auditar tu calendario manualmente.

Cuando construyes lógica de segmento compleja para una campaña multi-touch

Tu campaña de retención apunta a clientes que recibieron tu último email, lo abrieron, hicieron clic, pero no completaron compra—y además compraron en el pasado pero no en los últimos 45 días. Construir este segmento en la UI de Klaviyo implica filtros anidados y lógica condicional. En su lugar, describe tus criterios: “Crea un segmento de perfiles que abrieron la campaña ID abc123, hicieron clic en cualquier enlace, tienen al menos una compra pasada, pero ninguna en los últimos 45 días y sin checkout.” La IA traduce tu lenguaje natural a criterios segmentados, eliminando frustración en la construcción de filtros.

Cuando coordinar una secuencia de emails por descontinuación de producto

Vas a descontinuar una línea de producto y debes notificar a los clientes afectados, ofrecer alternativas y dar una última oportunidad de compra. Ordena: “Encuentra todos los perfiles que compraron el producto SKU 12345 en los últimos 2 años, crea una lista llamada ‘Descontinuación Producto - SKU 12345’ y configura una secuencia de 3 emails: anuncio, alternativas, última oportunidad.” El servidor identifica clientes, los organiza en una lista y estructura tu campaña—trabajo estratégico que normalmente requiere exportar datos, cargar CSVs y configurar campañas manualmente.

Cuando tus métricas de email caen y necesitas análisis de causa raíz

Tu tasa de apertura promedio del 25% cayó al 12% la última semana y dirección quiere respuestas. Pide: “Muéstrame todas las campañas enviadas en los últimos 14 días con tasas de apertura, clics y horarios de envío. Compáralo con campañas de los anteriores 30 días.” El servidor entrega métricas comparativas, ayudando a identificar patrones—quizá cambió el horario, ciertos segmentos dejaron de interactuar o plantillas específicas rinden menos—revelando insights sin exportar múltiples reportes manualmente.

Cuando gestionas estados de flujos durante migraciones o grandes actualizaciones

Migras a un nuevo CRM y debes pausar 30+ flujos automatizados para evitar comunicaciones duplicadas. En vez de pausar uno por uno en el panel de Klaviyo, di: “Muéstrame todos los flujos activos y cambia a borrador los que contengan ‘carrito abandonado’, ‘serie de bienvenida’ y ‘post-compra’.” El servidor actualiza en lote los estados de flujos, dando control preciso sin riesgo de omitir algún flujo manualmente.

Cuando creas campañas personalizadas basadas en eventos de asistentes a un webinar

Realizaste un webinar con 500 asistentes y necesitas registrar quién asistió, qué temas les interesaron y activar seguimientos personalizados. Instruye: “Crea un evento ‘Webinar Asistido - IA Marketing’ para estos 500 IDs de perfil con propiedades de duración de asistencia y respuestas a encuestas, luego crea un segmento de quienes estuvieron más de 30 minutos.” El servidor procesa creación masiva de eventos y construye segmentos accionables, permitiendo seguimiento sofisticado sin entrada manual ni importaciones CSV complejas.

Cuando auditas entregabilidad de emails en múltiples listas

Sospechas problemas de entregabilidad porque el engagement varía mucho entre tus 15 listas. Algunas tienen 35% de apertura, otras apenas 8%. Pide: “Muéstrame todas mis listas, su cantidad de suscriptores y el desempeño de campañas recientes para cada una en los últimos 30 días.” El servidor agrega datos y métricas asociadas, revelando qué listas limpiar, cuáles están comprometidas y dónde enfocar esfuerzos—insights que normalmente requieren exportar reportes y horas de cruce manual.

Cuando escalas campañas personalizadas según el ciclo de vida del cliente

Pasas de envíos masivos a marketing por ciclo de vida y necesitas crear 8 series de campañas para prospectos, nuevos clientes, usuarios activos, clientes en riesgo, clientes perdidos, VIPs, referidores y defensores de marca. En vez de construir cada serie manualmente, colabora con la IA: “Ayúdame a crear estructuras de campaña para 8 etapas del ciclo de vida. Para cada una, te doy criterios y mensaje, y tú creas las campañas con plantillas y cronogramas apropiados.” El servidor acelera la construcción sofisticada de programas de ciclo de vida de semanas a días.

Cuando ejecutas tests A/B en segmentos simultáneamente

Estás probando asuntos—urgencia vs. beneficio vs. personalización—en 6 segmentos para ver qué resuena más. En vez de crear 18 campañas manualmente, di: “Crea campañas de test A/B para estos 6 segmentos usando tres asuntos: urgencia, beneficio y personalización. Usa nuestra plantilla promocional estándar para todos.” El servidor genera la matriz de tests, permitiendo pruebas multivariantes sin ahogarte en trabajo manual.

Cómo configurarlo

Windsurf

1. Asegúrate de tener Python 3.10 o superior instalado.
2. Instala el servidor MCP de Klaviyo desde tu repositorio.
3. Obtén credenciales OAuth en tu cuenta de Klaviyo:
   • Ve a Configuración de Cuenta > Claves API en Klaviyo
   • Crea una nueva clave API con permisos adecuados
   • Anota tu Client ID, Client Secret y Access Token
4. Añade el servidor MCP de Klaviyo a tu configuración mcpServers:

   {
     "mcpServers": {
       "klaviyo-mcp": {
         "command": "python3",
         "args": ["-m", "klaviyo_mcp_server"],
         "env": {
           "KLAVIYO_CLIENT_ID": "your_client_id",
           "KLAVIYO_CLIENT_SECRET": "your_client_secret",
           "KLAVIYO_ACCESS_TOKEN": "your_access_token"
         }
       }
     }
   }
   

5. Guarda el archivo de configuración y reinicia Windsurf.
6. Verifica que el servidor MCP aparezca y sea accesible en el panel MCP de Windsurf.

Claude

1. Asegúrate de tener Python 3.10 o superior instalado.
2. Instala el servidor MCP de Klaviyo.
3. Configura tus credenciales OAuth de Klaviyo como se describió antes.
4. Añade o actualiza el campo mcpServers en tu configuración de Claude:

   {
     "mcpServers": {
       "klaviyo-mcp": {
         "command": "python3",
         "args": ["-m", "klaviyo_mcp_server"],
         "env": {
           "KLAVIYO_CLIENT_ID": "your_client_id",
           "KLAVIYO_CLIENT_SECRET": "your_client_secret",
           "KLAVIYO_ACCESS_TOKEN": "your_access_token"
         }
       }
     }
   }
   

5. Guarda la configuración y reinicia Claude.
6. Confirma la conexión al servidor MCP en el panel de integraciones de Claude.

Cursor

1. Instala Python 3.10+ y el servidor MCP de Klaviyo.
2. Configura tus credenciales OAuth de Klaviyo.
3. Localiza el archivo de configuración de Cursor y añade la entrada para el servidor MCP:

   {
     "mcpServers": {
       "klaviyo-mcp": {
         "command": "python3",
         "args": ["-m", "klaviyo_mcp_server"],
         "env": {
           "KLAVIYO_CLIENT_ID": "your_client_id",
           "KLAVIYO_CLIENT_SECRET": "your_client_secret",
           "KLAVIYO_ACCESS_TOKEN": "your_access_token"
         }
       }
     }
   }
   

4. Guarda la configuración y reinicia Cursor.
5. Asegúrate de que el servidor aparece entre los MCP servers disponibles en Cursor.

Cline

1. Asegúrate de tener Python 3.10+ en tu sistema.
2. Descarga o instala el servidor MCP de Klaviyo.
3. Obtén tus credenciales OAuth de Klaviyo.
4. Modifica la configuración de Cline para incluir:

   {
     "mcpServers": {
       "klaviyo-mcp": {
         "command": "python3",
         "args": ["-m", "klaviyo_mcp_server"],
         "env": {
           "KLAVIYO_CLIENT_ID": "your_client_id",
           "KLAVIYO_CLIENT_SECRET": "your_client_secret",
           "KLAVIYO_ACCESS_TOKEN": "your_access_token"
         }
       }
     }
   }
   

5. Guarda la configuración, reinicia Cline y verifica la conectividad al servidor MCP.

Protegiendo claves API (usando variables de entorno):

Para proteger tus credenciales de Klaviyo, usa siempre variables de entorno en lugar de insertarlas en el código. Ejemplo de configuración segura:

{
  "mcpServers": {
    "klaviyo-mcp": {
      "command": "python3",
      "args": ["-m", "klaviyo_mcp_server"],
      "env": {
        "KLAVIYO_CLIENT_ID": "${KLAVIYO_CLIENT_ID}",
        "KLAVIYO_CLIENT_SECRET": "${KLAVIYO_CLIENT_SECRET}",
        "KLAVIYO_ACCESS_TOKEN": "${KLAVIYO_ACCESS_TOKEN}",
        "KLAVIYO_REFRESH_TOKEN": "${KLAVIYO_REFRESH_TOKEN}"
      }
    }
  }
}

Define estas variables de entorno en tu sistema o perfil de shell antes de lanzar tu cliente MCP.

Cómo usar este MCP dentro de flujos

Uso de MCP en FlowHunt

Para integrar el servidor MCP de Klaviyo en tu flujo de trabajo de FlowHunt, comienza añadiendo el componente MCP a tu flujo y conectándolo a tu agente de IA:

Haz clic en el componente MCP para abrir el panel de configuración. En la sección de configuración MCP del sistema, inserta los detalles de tu servidor Klaviyo MCP usando este formato JSON:

{
  "klaviyo-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/klaviyo-mcp"
  }
}

Una vez configurado, tu agente de IA obtiene acceso a las 39 herramientas de Klaviyo, pudiendo crear campañas, gestionar perfiles de clientes, rastrear eventos, orquestar flujos y analizar métricas, todo dentro de flujos automatizados. Esto transforma tus flujos de FlowHunt en potentes motores de automatización de marketing capaces de responder a disparadores, segmentar audiencias y ejecutar campañas sin intervención manual.

Resumen

Entre la documentación y el código, el Servidor MCP de Klaviyo ofrece cobertura completa con 39 operaciones distintas que abarcan gestión de perfiles, automatización de campañas, gestión de listas, seguimiento de eventos, análisis de métricas, segmentación, orquestación de flujos y gestión de plantillas. El servidor utiliza autenticación OAuth y gestión segura de credenciales mediante variables de entorno.

Nuestra opinión

Este servidor MCP destaca por la amplitud y profundidad de sus capacidades de automatización de marketing, ofreciendo la integración más completa de Klaviyo disponible a través del Model Context Protocol. Con 39 herramientas bien documentadas organizadas en categorías lógicas, los equipos de marketing obtienen un control sin precedentes sobre sus operaciones de email marketing mediante interfaces en lenguaje natural. La implementación OAuth garantiza seguridad de nivel empresarial, mientras que la cobertura de herramientas elimina la necesidad de trabajo manual en el panel en la mayoría de los escenarios. Este servidor es ideal para equipos de marketing, profesionales de operaciones de marketing y desarrolladores que construyen flujos de automatización y desean aprovechar la IA para la gestión de campañas, segmentación de clientes y optimización del engagement. La ausencia de plantillas de prompts integradas se compensa con nombres de herramientas intuitivos y descripciones claras que permiten una interacción en lenguaje natural sencilla.

Puntuación MCP