Klaviyo MCP Server

O que o MCP Server “Klaviyo” faz?

O Klaviyo MCP Server revoluciona a automação de email marketing ao conectar a poderosa plataforma da Klaviyo com assistentes de IA e ferramentas de desenvolvimento através do Model Context Protocol (MCP). Esta integração capacita equipes de marketing a gerenciar campanhas sofisticadas de email, perfis de clientes, fluxos de automação e segmentos de audiência usando comandos em linguagem natural em vez de navegar por múltiplos painéis. Seja criando campanhas personalizadas, rastreando eventos de clientes, construindo segmentos complexos ou orquestrando fluxos de automação de múltiplas etapas, o Klaviyo MCP Server permite que você execute essas tarefas diretamente de ferramentas de IA como Claude, Cursor ou FlowHunt. Ao eliminar a troca de contexto e habilitar automação alimentada por IA, equipes de marketing podem reduzir o tempo de configuração de campanhas de horas para minutos enquanto mantêm controle total sobre sua estratégia de engajamento de clientes.

Lista de Prompts

Gerenciamento de Perfis e Clientes

Encontre todos os perfis de clientes que não abriram emails em 90 dias

Crie um novo perfil para customer@example.com com propriedades personalizadas para status VIP

Mostre-me todos os perfis que compraram nos últimos 30 dias mas não receberam um email de acompanhamento

Atualize todos os perfis no segmento VIP para adicionar uma propriedade de nível de fidelidade

Gerenciamento de Campanhas

Crie uma nova campanha de email para Black Friday com assunto 'Desconto Exclusivo de 40%' direcionando clientes VIP

Mostre-me todas as campanhas enviadas nos últimos 7 dias com taxas de abertura abaixo de 15%

Envie a campanha 'Série de Boas-Vindas Parte 1' imediatamente para todos os novos assinantes

Cancele a campanha agendada para amanhã e reagende-a para a próxima semana

Listas e Segmentação

Crie uma nova lista chamada 'Reengajamento Q1 2026' para assinantes inativos

Adicione todos os perfis que clicaram em nosso último email mas não compraram à lista 'Leads Quentes'

Mostre-me todos os segmentos com mais de 5000 perfis e seus critérios

Operações de Templates de Email

Crie um novo template de email para nosso lançamento de produto com conteúdo HTML

Mostre-me todos os templates usados em campanhas com taxas de conversão acima de 5%

Atualize o template 'Promoção de Férias' com novo código de desconto HOLIDAY2026

Rastreamento de Eventos e Análises

Rastreie um evento 'Produto Visualizado' para todos os perfis que visitaram nossa página de nova coleção

Mostre-me todos os eventos de 'Compra' dos últimos 30 dias com valores de pedido acima de $100

Obtenha todas as métricas de desempenho de email e mostre-me quais campanhas geraram mais receita

Automação de Fluxos

Mostre-me todos os fluxos de automação ativos e suas taxas de conversão

Pause o fluxo 'Abandono de Carrinho' enquanto atualizamos os templates de email

Defina o fluxo 'Série de Boas-Vindas' para status live e habilite-o para novos assinantes

Pronto para expandir seu negócio?

Comece seu teste gratuito hoje e veja resultados em dias.

Solicitar demo Entrar

Lista de Recursos

Nenhum recurso explícito está listado no repositório.

Lista de Ferramentas

O Klaviyo MCP Server fornece 39 ferramentas abrangentes organizadas em oito categorias:

Gerenciamento de Perfis (5 ferramentas)

• get_profiles - Recupere uma lista de perfis de clientes com filtragem opcional e paginação
• get_profile - Obtenha informações detalhadas sobre um perfil de cliente específico por ID
• create_profile - Crie um novo perfil de cliente com email, telefone, propriedades personalizadas e muito mais
• update_profile - Atualize atributos de perfis existentes como nome, email ou propriedades personalizadas
• Profile filtering - Capacidades avançadas de filtragem usando a sintaxe de filtro da Klaviyo

Gerenciamento de Listas (7 ferramentas)

• get_lists - Recupere todas as listas de email em sua conta Klaviyo
• get_list - Obtenha detalhes de uma lista específica por ID
• create_list - Crie uma nova lista de email para organizar contatos
• update_list - Atualize propriedades de listas incluindo nome
• delete_list - Remova permanentemente uma lista de sua conta
• add_profile_to_list - Adicione um perfil de cliente a uma lista específica
• remove_profile_from_list - Remova um perfil de uma lista

Gerenciamento de Campanhas (7 ferramentas)

• get_campaigns - Recupere campanhas com filtragem opcional
• get_campaign - Obtenha informações detalhadas sobre uma campanha específica
• create_campaign - Crie uma nova campanha de email com assunto, detalhes do remetente e texto de visualização
• update_campaign - Atualize atributos de campanhas como nome, assunto ou conteúdo
• send_campaign - Envie uma campanha imediatamente para o público-alvo
• cancel_campaign - Cancele uma campanha agendada antes que ela seja enviada
• assign_template_to_campaign - Anexe um template de email a uma mensagem de campanha

Rastreamento de Eventos (2 ferramentas)

• create_event - Rastreie eventos personalizados para perfis com propriedades e timestamps
• get_events - Recupere eventos com filtragem e paginação para análise

Métricas e Análises (2 ferramentas)

• get_metrics - Recupere todas as métricas Klaviyo disponíveis para rastreamento de desempenho
• get_metric - Obtenha informações detalhadas sobre uma métrica específica por ID

Gerenciamento de Segmentos (2 ferramentas)

• get_segments - Recupere todos os segmentos de clientes em sua conta
• get_segment - Obtenha informações detalhadas sobre um segmento específico incluindo critérios

Automação de Fluxos (3 ferramentas)

• get_flows - Recupere todos os fluxos de automação com filtragem opcional e paginação
• get_flow - Obtenha informações detalhadas sobre um fluxo de automação específico
• update_flow_status - Mude o status do fluxo entre modos live, manual e draft

Gerenciamento de Templates (5 ferramentas)

• get_templates - Recupere todos os templates de email em sua conta
• get_template - Obtenha informações detalhadas sobre um template específico
• create_template - Crie um novo template de email com conteúdo HTML e texto
• update_template - Atualize atributos de templates incluindo HTML, texto e nome
• delete_template - Remova permanentemente um template de sua conta

Junte-se à nossa newsletter

Receba gratuitamente as últimas dicas, tendências e ofertas.

Endereço de e-mail

Inscrever-se

Casos de Uso deste MCP Server

Quando Você Tem 100+ Assinantes Inativos Precisando de Reengajamento

Você está olhando para milhares de assinantes inativos entupindo sua lista, prejudicando a capacidade de entrega. Em vez de criar manualmente segmentos, filtros e campanhas de múltiplos toques, pergunte: “Encontre todos os perfis que não abriram emails em 90 dias, crie um segmento chamado ‘Reengajamento Q1 2026’ e configure uma campanha de três emails de reconquista usando nosso template de reativação.” O servidor MCP constrói o segmento, cria as campanhas, atribui templates e prepara toda a sequência de reengajamento em menos de 2 minutos—trabalho que tradicionalmente leva 2-3 horas.

Quando um Lançamento de Produto Requer Segmentação por Histórico de Compras

Seu novo produto premium lança amanhã e você precisa direcionar clientes baseado em seu valor de vida útil e compras anteriores. Simplesmente diga: “Crie segmentos para clientes que gastaram mais de $500 no último ano mas não compraram em 60 dias, e outro para clientes que compraram nosso produto inicial mas nunca fizeram upgrade.” O servidor cria instantaneamente ambos os segmentos, permitindo que você adapte mensagens para cada grupo—trabalho crítico que normalmente requer construção de filtros complexos e múltiplas rodadas de QA.

Quando Analisando Quais Templates de Email Geram Mais Conversões

Você enviou dezenas de campanhas e precisa identificar seus templates de melhor desempenho para replicar o sucesso. Pergunte: “Mostre-me todas as campanhas enviadas no Q4 2025, seus templates atribuídos e suas métricas de conversão.” Em vez de exportar dados, fazer referência cruzada de IDs de templates e construir planilhas manualmente, você obtém análise instantânea mostrando quais templates consistentemente superam o desempenho, permitindo decisões criativas baseadas em dados sem o processo usual de análise de 4-5 horas.

Quando Você Precisa Sincronizar Dados de Eventos do Seu App para Acionar Fluxos Automatizados

Seu aplicativo SaaS rastreia comportamentos críticos do usuário—início de trial, adoção de recursos, marcos de uso—e você precisa desses eventos na Klaviyo para acionar fluxos de nutrição personalizados. Comando: “Crie um evento ‘Recurso X Ativado’ para todos os perfis no meu segmento de usuários avançados com timestamp e propriedades de recurso.” O servidor MCP cria eventos em lote com atribuição adequada, permitindo marketing comportamental sofisticado sem escrever scripts de API personalizados ou esperar por recursos de engenharia.

Quando Gerenciando Múltiplas Marcas e Precisa Duplicar Campanhas Vencedoras

Você gerencia três marcas distintas sob uma empresa, e a campanha de férias da Marca A arrasou com 42% de taxas de abertura. Em vez de recriar manualmente a estrutura da campanha para as Marcas B e C, diga: “Obtenha o ID de campanha abc123, mostre-me sua estrutura, template e configurações, depois ajude-me a criar campanhas idênticas para minhas listas Marca B e Marca C.” O servidor recupera todos os detalhes da campanha e ajuda você a replicar o sucesso entre marcas em minutos em vez de horas de copiar, colar e verificar configurações.

Quando a Black Friday Está Chegando e Você Precisa de 20 Variações de Emails Promocionais

A temporada de pico exige múltiplas variações de email para diferentes segmentos—novos clientes, VIPs, curiosos, carrinhos abandonados. Em vez de criar manualmente 20 campanhas separadas através da UI, instrua: “Crie campanhas para Black Friday direcionando estes 5 segmentos: clientes VIP, compradores recorrentes, compradores únicos, assinantes de email que nunca compraram e abandonadores de carrinho. Use nosso template de férias e personalize linhas de assunto para cada.” O servidor MCP gera todas as campanhas com direcionamento e templates apropriados, reduzindo mais de 6 horas de trabalho repetitivo para 15 minutos de criação de campanha guiada por IA.

Quando Você Descobre um Erro Crítico de Template Após Enviar para 10.000 Assinantes

Você enviou uma campanha e percebeu que o código promocional no seu template está errado. Você tem mais 15 campanhas agendadas usando esse mesmo template. Em vez de atualizar manualmente cada campanha ou entrar em pânico, diga: “Mostre-me todas as campanhas agendadas para os próximos 7 dias usando o template ID xyz789, depois atualize o template para mudar PROMO20 para PROMO25.” O servidor identifica campanhas afetadas e atualiza o template mestre instantaneamente, prevenindo 15 desastres potenciais sem auditar manualmente seu calendário de campanhas.

Quando Construindo Lógica Complexa de Segmentos para uma Campanha Multi-Toque

Sua campanha de retenção direciona clientes que receberam seu último email, abriram, clicaram, mas não completaram a compra—e eles também compraram no passado mas não nos últimos 45 dias. Construir este segmento multi-condição através da UI da Klaviyo significa navegar filtros aninhados e lógica condicional. Em vez disso, descreva seus critérios naturalmente: “Crie um segmento de perfis que abriram a campanha ID abc123, clicaram em qualquer link, têm pelo menos um pedido passado, mas nenhum pedido nos últimos 45 dias e nenhuma conclusão de checkout.” A IA traduz sua linguagem natural em critérios de segmento adequados, eliminando a frustração de construir filtros.

Quando Coordenando uma Sequência de Email de Descontinuação de Produto

Você está descontinuando uma linha de produtos e precisa notificar clientes afetados, oferecer alternativas e fornecer uma janela de compra de última chance. Comando: “Encontre todos os perfis que compraram o produto SKU 12345 nos últimos 2 anos, crie uma lista chamada ‘Descontinuação de Produto - SKU 12345’ e configure uma sequência de 3 emails: anúncio, alternativas, última chance.” O servidor MCP identifica clientes afetados, organiza-os em uma lista direcionável e estrutura sua campanha de sunset—trabalho estratégico que tipicamente requer exportações de dados, uploads de CSV e configuração manual de campanhas.

Quando Suas Métricas de Email Subitamente Caem e Você Precisa de Análise de Causa Raiz

Sua taxa de abertura típica de 25% despencou para 12% na última semana e a liderança quer respostas. Pergunte: “Mostre-me todas as campanhas enviadas nos últimos 14 dias com suas taxas de abertura, taxas de cliques e horários de envio. Compare isso com campanhas dos 30 dias anteriores.” O servidor entrega métricas comparativas entre campanhas, ajudando você a identificar padrões—talvez o horário de envio mudou, certos segmentos pararam de engajar, ou templates específicos têm desempenho inferior—revelando insights que normalmente requerem exportar múltiplos relatórios e construir gráficos de comparação.

Quando Gerenciando Status de Fluxos Durante Migrações de Plataforma ou Atualizações Importantes

Você está migrando para um novo CRM e precisa pausar mais de 30 fluxos de automação para prevenir comunicações duplicadas durante a transição. Em vez de clicar através de cada fluxo individualmente no painel da Klaviyo, diga: “Mostre-me todos os fluxos ativos, depois defina fluxos contendo ‘carrinho abandonado’, ‘série de boas-vindas’ e ‘pós-compra’ para status draft.” O servidor MCP atualiza status de fluxos em lote, dando controle preciso durante operações críticas sem o risco de perder um fluxo em atualizações manuais.

Quando Criando Campanhas Personalizadas Orientadas por Eventos para Participantes de Webinar

Você hospedou um webinar com 500 participantes, e você precisa rastrear quem participou, quais tópicos eles engajaram e acionar campanhas de acompanhamento personalizadas. Instrua: “Crie um evento ‘Webinar Participado - Marketing IA’ para esses 500 IDs de perfil com propriedades incluindo duração de participação e respostas de enquetes, depois crie um segmento de participantes que ficaram mais de 30 minutos.” O servidor processa criação de eventos em massa com propriedades personalizadas e constrói segmentos acionáveis, permitindo acompanhamento comportamental sofisticado sem entrada manual de dados ou imports complexos de CSV.

Quando Auditando Capacidade de Entrega de Email Através de Múltiplas Listas

Você suspeita de problemas de capacidade de entrega porque o engajamento varia muito entre suas 15 listas de email diferentes. Algumas listas têm taxas de abertura de 35%, outras mal chegam a 8%. Pergunte: “Mostre-me todas as minhas listas, suas contagens de assinantes e desempenho recente de campanhas para cada lista nos últimos 30 dias.” O servidor MCP agrega dados de listas e métricas de campanhas associadas, revelando quais listas precisam de limpeza, quais são altamente engajadas e onde focar esforços de capacidade de entrega—insights que tipicamente requerem exportar múltiplos relatórios e horas de referência cruzada manual.

Quando Escalando Campanhas Personalizadas Baseadas em Estágio do Ciclo de Vida do Cliente

Você está mudando de enviar para todos para marketing de ciclo de vida e precisa criar 8 séries de campanhas diferentes para prospects, novos clientes, usuários ativos, clientes em risco, clientes perdidos, VIPs, indicadores e defensores de marca. Em vez de construir manualmente cada série através da UI, colabore com a IA: “Ajude-me a criar estruturas de campanhas para 8 estágios de ciclo de vida. Para cada estágio, fornecerei os critérios de segmento e ângulo de mensagem, e você cria as campanhas com templates apropriados e cronogramas de envio.” O servidor MCP acelera a construção sofisticada de programas de ciclo de vida de semanas para dias.

Quando Executando Testes A/B Através de Múltiplos Segmentos de Audiência Simultaneamente

Você está testando abordagens de linha de assunto—urgência vs. orientado a benefícios vs. personalização—através de 6 diferentes segmentos de clientes para entender o que ressoa com cada grupo. Em vez de criar 18 campanhas manualmente, diga: “Crie campanhas de teste A/B para estes 6 segmentos usando três variações de linha de assunto: urgência, benefício e personalização. Use nosso template promocional padrão para todos.” O servidor MCP gera toda a matriz de testes, permitindo testes multivariados sofisticados sem se afogar em trabalho de criação de campanhas.

Como Configurar

Windsurf

1. Certifique-se de que Python 3.10 ou superior está instalado em seu sistema.
2. Instale o servidor Klaviyo MCP do seu repositório.
3. Obtenha credenciais OAuth de sua conta Klaviyo:
   • Navegue até Configurações de Conta > Chaves de API na Klaviyo
   • Crie uma nova chave de API com permissões apropriadas
   • Anote seu Client ID, Client Secret e Access Token
4. Adicione o servidor Klaviyo MCP à sua configuração 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. Salve o arquivo de configuração e reinicie o Windsurf.
6. Verifique se o servidor MCP está listado e acessível no painel MCP do Windsurf.

Claude

1. Certifique-se de que Python 3.10 ou superior está instalado.
2. Instale o servidor Klaviyo MCP.
3. Configure suas credenciais OAuth da Klaviyo conforme descrito acima.
4. Adicione ou atualize o campo mcpServers em sua configuração do 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. Salve a configuração e reinicie o Claude.
6. Confirme a conexão do servidor MCP no painel de integrações do Claude.

Cursor

1. Instale Python 3.10+ e o servidor Klaviyo MCP.
2. Configure suas credenciais OAuth da Klaviyo.
3. Localize o arquivo de configuração do Cursor e adicione a entrada do 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. Salve a configuração e reinicie o Cursor.
5. Certifique-se de que o servidor aparece nos servidores MCP disponíveis do Cursor.

Cline

1. Certifique-se de que Python 3.10+ está presente em seu sistema.
2. Baixe ou instale o servidor Klaviyo MCP.
3. Obtenha suas credenciais OAuth da Klaviyo.
4. Modifique a configuração do 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. Salve a configuração, reinicie o Cline e verifique a conectividade do servidor MCP.

Protegendo Chaves de API (usando variáveis de ambiente):

Para proteger suas credenciais da Klaviyo, sempre use variáveis de ambiente em vez de codificá-las. Exemplo de configuração 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}"
      }
    }
  }
}

Defina essas variáveis de ambiente em seu sistema ou perfil shell antes de iniciar seu cliente MCP.

Como usar este MCP dentro de fluxos

Usando MCP no FlowHunt

Para integrar o servidor Klaviyo MCP em seu fluxo de trabalho FlowHunt, comece adicionando o componente MCP ao seu fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração do sistema MCP, insira os detalhes do seu servidor Klaviyo MCP usando este formato JSON:

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

Uma vez configurado, seu agente de IA ganha acesso a todas as 39 ferramentas da Klaviyo, permitindo criar campanhas, gerenciar perfis de clientes, rastrear eventos, orquestrar fluxos e analisar métricas—tudo dentro de seus fluxos de trabalho automatizados. Isso transforma seus fluxos FlowHunt em poderosos motores de automação de marketing que podem responder a gatilhos, segmentar audiências e executar campanhas sem intervenção manual.

Visão Geral

Entre a documentação e o código, o Klaviyo MCP Server fornece cobertura abrangente de ferramentas com 39 operações distintas abrangendo gerenciamento de perfis, automação de campanhas, gerenciamento de listas, rastreamento de eventos, análise de métricas, segmentação, orquestração de fluxos e gerenciamento de templates. O servidor usa autenticação OAuth com gerenciamento seguro de credenciais através de variáveis de ambiente.

Nossa Opinião

Este servidor MCP se destaca em amplitude e profundidade de capacidades de automação de marketing, oferecendo a integração Klaviyo mais abrangente disponível através do Model Context Protocol. Com 39 ferramentas bem documentadas organizadas em categorias lógicas, equipes de marketing ganham controle sem precedentes sobre suas operações de email marketing através de interfaces de linguagem natural. A implementação OAuth garante segurança de nível empresarial, enquanto a extensa cobertura de ferramentas elimina a necessidade de trabalho manual em painéis na maioria dos cenários. Este servidor é ideal para equipes de marketing, profissionais de operações de marketing e desenvolvedores construindo fluxos de trabalho de automação de marketing que querem aproveitar IA para gerenciamento de campanhas, segmentação de clientes e otimização de engajamento. A falta de templates de prompt integrados é compensada pela nomenclatura intuitiva de ferramentas e descrições claras que tornam a interação em linguagem natural direta.

MCP Score