4 formas de conectar o Klaviyo ao Claude em 2026 (o jeito fácil)

Pré-requisitos

• Uma conta da Porter Metrics com sua conta do Klaviyo conectada (o plano gratuito é suficiente para testar de ponta a ponta)
• Uma conta do Claude — o plano gratuito funciona para o Claude Web; uma assinatura Pro é necessária para os recursos de Claude Code e MCP Desktop
• Acesso de administrador ou padrão às contas do Klaviyo que você deseja conectar

Conectar o Klaviyo ao Claude com MCP

Para este tutorial, vamos usar o método MCP. Aqui está uma explicação rápida do que é o MCP e por que é o melhor caminho para o Klaviyo.

MCP (Model Context Protocol) é o padrão aberto que permite que ferramentas de IA como Claude, ChatGPT, Claude Code e outras acessem e usem APIs externas — os elementos que fazem ferramentas como o Klaviyo funcionarem nos bastidores. Em vez de criar uma integração personalizada para cada ferramenta de IA que você usa, você instala um MCP e toda IA compatível obtém acesso aos mesmos dados.

Quatro motivos pelos quais o MCP vence para o Klaviyo:

A configuração completa leva menos de 5 minutos e se divide em três passos: conectar o Klaviyo à Porter, apontar o Claude para o MCP da Porter, e fazer sua primeira pergunta.

1. Conectar seus dados do Klaviyo à Porter

A Porter fica entre a API de Email e SMS do Klaviyo e o Claude. Ela gerencia OAuth, limitação de taxa, paginação e toda a infraestrutura para que o Claude veja apenas dados limpos e estruturados.

Cadastre-se na Porter. Crie uma conta gratuita em portermetrics.com. O plano gratuito é suficiente para executar este fluxo completo de ponta a ponta.

Conecte sua conta do Klaviyo. Na Porter, clique em Criar → escolha Claude como destino → selecione Klaviyo como fonte → faça login com o Klaviyo para conceder acesso às suas contas.

Selecione suas contas. Escolha as contas do Klaviyo que você deseja que o Claude consulte. Quando você seleciona várias contas em uma única conexão, a Porter mistura automaticamente os dados para que você possa consultá-los como um só.

Opcional: habilite o armazenamento no BigQuery se você estiver conectando várias contas com grandes volumes de dados. Isso mantém as respostas do Claude rápidas mesmo em escala.

2. Conectar o MCP ao Claude

A URL do MCP da Porter é o que você cola no Claude. Uma vez adicionada, o Claude pode consultar dados do Klaviyo sob demanda em qualquer conversa.

Vá para claude.ai e clique no + ícone no campo de chat para abrir o menu de ferramentas.

No menu que abre, passe o mouse sobre Conectores e clique em Gerenciar conectores.

No painel de Conectores, clique no + botão no topo da lista para começar a adicionar um novo conector.

Escolha Adicionar conector personalizado no menu suspenso que aparece.

Uma caixa de diálogo abre com os campos de nome e URL. Digite Porter no primeiro campo para nomear o conector.

No segundo campo, cole https://mcp.portermetrics.com/mcp. Não altere as configurações avançadas.

Clique em Adicionar no canto inferior direito da caixa de diálogo. O Claude abre uma janela de login — use a mesma conta do Google vinculada ao seu workspace da Porter e aprove o acesso.

Assim que a autorização terminar, você verá as ferramentas somente leitura da Porter aparecerem no painel de conectores. Você está pronto para começar a fazer perguntas.

Para um passo a passo mais completo com capturas de tela em cada etapa, consulte o tutorial do MCP da Porter.

3. Comece a criar perguntas e dashboards

Com a Porter conectada, abra um novo chat no Claude e pergunte qualquer coisa sobre seu Klaviyo em linguagem simples. O Claude chama a Porter nos bastidores, puxa dados em tempo real do Klaviyo, e responde com tabelas, gráficos ou resumos.

Experimente uma destas para verificar se a configuração está funcionando:

Para um catálogo completo de prompts de copiar e colar organizados por caso de uso (agências, DTC e e-commerce, profissionais de marketing B2B, multicanal), vá para a seção de prompts abaixo.

Outras formas de conectar o Klaviyo ao Claude

O MCP é o caminho que acabamos de percorrer — e o que recomendamos para a maioria dos profissionais de marketing. Mas não é a única forma de colocar dados do Klaviyo diante do Claude. As alternativas mais comuns são a API direta do Klaviyo (ou seu MCP oficial), uma ponte ativa com o Google Sheets, e o BigQuery para escala. Cada uma tem seus prós e contras — escolha a que se adapta à forma como sua equipe já trabalha.

• 🔌 API direta do Klaviyo (ou MCP oficial) — Converse diretamente com a API de Email e SMS do Klaviyo, ou instale o MCP nativo do Klaviyo se houver um. Controle máximo, mas você gerencia a autenticação, limites de taxa e paginação — e obtém apenas uma fonte.
• 📊 Google Sheets — Planilha ativa ou upload pontual de CSV. Auditável, familiar, mais rápido para grandes exportações — mas a agregação acontece na planilha, não na API.
• 🗄️ Google BigQuery — Para contas grandes ou agências executando análise multiconta. O BigQuery agrega; o Claude consulta apenas resumos pré-construídos.

Via API direta do Klaviyo (ou MCP oficial)

Se você está construindo um produto em torno do Klaviyo — ou é um desenvolvedor que prefere controlar cada camada da integração — o caminho mais direto é conversar com a API de Email e SMS você mesmo, ou instalando o MCP oficial do Klaviyo (se houver um). O Klaviyo oferece um servidor MCP oficial. Você pode gerar uma URL de MCP única nas configurações da sua conta do Klaviyo e adicioná-la diretamente ao Claude Desktop ou a outros clientes MCP. Você precisará seguir os limites de taxa e cotas e solicitar um Token de Desenvolvedor / acesso à API quando aplicável. De qualquer forma, você pula a Porter completamente e chama o Klaviyo a partir do seu próprio código ou do Claude Code com requisições HTTP brutas.

Via Google Sheets (planilha ativa ou CSV manual)

Se sua equipe já trabalha no Google Sheets — ou você quer um rastro de auditoria antes que o Claude toque em qualquer coisa — alimente o Klaviyo em uma planilha, depois deixe o Claude ler a planilha. Você pode automatizar o pipeline Klaviyo → Sheets com a Porter para que ele atualize diariamente, ou fazer exportações pontuais de CSV da interface nativa do Klaviyo para análise estática.

Via Google BigQuery (para escala)

Este é o caminho que a maioria das pessoas ignora — e é o que te salva quando sua conta do Klaviyo fica séria. Um único profissional de marketing grande ou uma agência gerenciando 10+ contas atingirá limites de taxa da API e problemas de latência consultando o Claude diretamente. O Claude literalmente te dirá que está demorando demais ou expirando em grandes extrações.

O BigQuery resolve isso. Você carrega dados do Klaviyo em tabelas do BigQuery em uma programação, depois conecta o BigQuery ao Claude — seja através de um MCP do BigQuery ou via Claude Code com consultas SQL. Em vez de pedir ao Claude para puxar dados brutos do Klaviyo, você deixa o BigQuery agregar em tabelas pequenas e otimizadas, e o Claude consulta apenas a saída resumida. Problema de escala resolvido.

Leia o tutorial completo do BigQuery →

Conectar o Klaviyo ao Claude Code

A maioria dos profissionais de marketing agrupa Claude e Claude Code e perde a maior vantagem de todo o ecossistema MCP. Eles não são a mesma ferramenta — e a diferença importa enormemente quando você começa a trabalhar seriamente com dados do Klaviyo.

O Claude é uma interface de chat. Você faz uma pergunta, o Claude puxa dados em tempo real através do MCP, responde, talvez construa um dashboard rápido dentro da conversa. Ótimo para análise pontual. O problema: tudo é efêmero. Quer atualizar o dashboard amanhã? Você o regenera do zero. Quer o mesmo relatório toda segunda-feira? Você refaz a pergunta toda segunda-feira.

O Claude Code é o Claude rodando dentro do terminal do seu computador. Porque ele tem acesso ao seu sistema de arquivos, runtime, e outras ferramentas de desenvolvedor, ele não apenas responde perguntas — ele pode construir software real. Scripts persistentes, rotinas agendadas, aplicativos HTML, dashboards internos, integrações que rodam 24/7 sem sua intervenção. Uma vez conectado ao MCP da Porter para o Klaviyo, toda uma categoria de trabalho se torna possível.

Conclusão: O Claude é para perguntas rápidas e dashboards ad hoc. O Claude Code é para construir aplicativos, dashboards em tempo real, alertas, e ferramentas reais — qualquer coisa que você queira executar por conta própria sem refazer perguntas. A mesma URL do MCP da Porter funciona em ambos, então você não escolhe uma vez e fica preso.

Casos de uso — o que você pode realmente fazer uma vez que o Klaviyo está conectado ao Claude

Acertar a conexão é metade da batalha. O valor real aparece no que você faz em seguida. Aqui estão os casos de uso que os usuários da Porter constroem em torno de seus dados do Klaviyo — de perguntas e respostas simples a fluxos de trabalho completos voltados para o cliente.

1. Conversar e fazer perguntas diretamente

O caso de uso mais simples — e ainda o com o qual 80% dos profissionais de marketing começam. Abra o Claude, faça uma pergunta, obtenha uma resposta baseada em dados em tempo real.

É a forma mais rápida de substituir uma verificação diária de dashboard do Klaviyo. Mas o chat é o básico — os casos de uso interessantes vêm a seguir.

2. Misturar o Klaviyo com seus dados de e-commerce e CRM (Shopify, Stripe, HubSpot)

É aqui que uma visão 360° se torna real. Quando você conecta o Klaviyo e sua plataforma de e-commerce (Shopify para e-commerce, Stripe para pagamentos, HubSpot para CRM), o Claude pode mapear campanhas para compras reais — usando nomes de campanhas, IDs de fluxo, e timestamps — e te dar atribuição que nenhum número de plataforma pode.

O Claude lida com os nomes de campanhas, IDs de fluxo, e mapeamento e junções de timestamps. Você obtém um relatório de atribuição pronto para o cliente que nenhuma plataforma individual pode gerar sozinha.

3. Alertas e notificações automatizados no Slack ou Gmail

Com o Claude Code, você pode transformar o monitoramento do Klaviyo em uma rotina que roda por conta própria. Conecte o MCP da Porter (para os dados) junto com um MCP do Slack ou Gmail (para entrega), depois escreva uma tarefa agendada do Claude Code que puxa o desempenho toda manhã e te notifica apenas quando algo realmente precisa de atenção.

Sem dashboards, sem verificações diárias. O relatório vem até você — e apenas quando importa.

4. Apresentações prontas para o cliente com dados em tempo real (Gamma, HTML, PDF)

Uma dor comum de agências: você envia aos clientes um relatório PDF estático — e gasta uma hora explicando um dashboard quebrado. Com o Claude, você pode construir a própria apresentação — como um deck Gamma, uma página HTML personalizada, ou um PDF — preenchida com números em tempo real a cada vez.

A apresentação se torna um artefato de entrega que você envia ao cliente, não um dashboard que depende de outra ferramenta permanecer ativa. Sem iframe quebrado, sem prompts de login, apenas o conteúdo.

Campos e métricas do Klaviyo que você pode consultar com o Claude

Antes de começar a escrever prompts, ajuda saber quais dados estão realmente disponíveis. O MCP da Porter dá ao Claude acesso a 84 campos e métricas do Klaviyo em todos os níveis de relatório, mais detalhamentos por data, dia da semana, mês, e trimestre. E a mesma URL de MCP também desbloqueia mais de 25 outras fontes — então o Claude pode misturar o Klaviyo com Google Ads, GA4, Shopify, HubSpot e mais em um único prompt.

Data

DataDia da semana (Seg – Dom)HoraMêsTrimestreSemanaAnoMês e ano

Campanha

Campanha ArquivadaCanal da CampanhaCampanha Criada EmID da CampanhaCampanha Ignorar CancelamentosCampanha Adicionar UTMCampanha Rastrear CliquesCampanha Rastrear Aberturas

Evento

Moeda do EventoData e Hora do EventoTipo de Dispositivo do EventoID do Formulário do EventoTipo de Formulário do EventoID do EventoAssunto do EventoUUID do Evento

Perfil

Perfil Endereço 1Perfil Endereço 2Perfil Média de Dias Entre PedidosPerfil Valor Médio do PedidoPerfil Probabilidade de ChurnPerfil CidadePerfil PaísPerfil Ícone do País

Fluxo

Fluxo Criado EmID do FluxoFluxo Está ArquivadoID da Mensagem do FluxoNome do FluxoStatus do FluxoTipo de Gatilho do FluxoFluxo Atualizado Em

Lista

Lista Criada EmID da ListaNome da ListaLista Atualizada Em

Informações da Conta

ID da ContaNome da Conta

Prompts que você pode copiar e colar hoje

1. Para agências

Quando você precisa de pós-mortem de campanhas multicliente, identificação de gargalos de fluxo, e relatórios de cliente modelados sem fazer login em cada conta do Klaviyo manualmente.

2. Para DTC e e-commerce

Quando você monitora a receita de fluxo de carrinho abandonado, níveis de CLV previsto, e probabilidade de churn para programar envios de recuperação.

3. Para profissionais de marketing B2B

Quando você rastreia sequências de email de lead para cliente, crescimento de lista por segmento, e faz referência cruzada de engajamento de email com estágios de negócio do CRM.

4. Multicanal

Quando você mistura o Klaviyo com outras fontes de marketing para análise unificada.

Limites, autenticação, e melhores práticas para o Klaviyo via Claude

Este post ilustra a ação de fiscalização mais severa que o Klaviyo toma: suspensão de conta por conformidade depois que um novo usuário carregou uma lista e enviou sua primeira campanha. Embora isso seja um problema de entregabilidade/conformidade de email em vez de um caso de abuso de API, isso demonstra que os sistemas automatizados do Klaviyo realmente aplicam limites rigorosos quando a qualidade dos dados ou as permissões são suspeitas. Para profissionais de marketing que usam o Klaviyo via Claude, o risco paralelo não é “ser banido por uso de MCP” mas sim atingir limites de taxa no meio da análise e perder acesso a dados em tempo real precisamente ao tomar decisões de campanha sensíveis ao tempo. O custo é medido em fluxo de trabalho interrompido e insights atrasados, não em perda irreversível de conta.

Uma segunda frustração documentada vem de desenvolvedores cujas integrações quebraram quando o Klaviyo mudou limites de API sem aviso: “Limites de API mudaram novamente” — Comunidade de Desenvolvedores do Klaviyo. Isso reforça que os limites de taxa do Klaviyo são limites dinâmicos que podem mudar, tornando suposições codificadas perigosas.

A aplicação de limites de taxa do Klaviyo é baseada em cotas e escalonada por endpoint, não baseada em ferramenta. O Klaviyo não bane ou limita contas porque você usou o Claude ou um servidor MCP. Ele limita por causa de como a API foi usada: exceder os limites de requisição por endpoint de burst (por segundo) ou estável (por minuto) dispara respostas HTTP 429 com um cabeçalho `Retry-After`. Consultas somente leitura dentro do tier da sua conta são seguras. Requisições paralelas em burst, operações de escrita em escala, ou misturar endpoints de alto volume sem consciência de seus respectivos tiers não são. O sistema usa um algoritmo de janela fixa, o que significa que os contadores reiniciam em intervalos previsíveis em vez de janelas deslizantes.

As duas formas de esgotar sua cota do Klaviyo

Após revisar documentos oficiais e tópicos da comunidade, dois padrões aparecem repetidamente.

1. Bursts de API paralelos em múltiplos endpoints. Enviar requisições simultâneas para vários endpoints do Klaviyo ao mesmo tempo (por exemplo, consultando campanhas, fluxos, segmentos, e métricas de uma vez via Claude) pode exceder o limite de burst por conta de 1 requisição por segundo para endpoints Tier XS ou 3 requisições por segundo para endpoints Tier S como métricas. Isso dispara limitação 429 e força o servidor MCP a recuar, deixando o usuário com dados parciais ou desatualizados. Comunidade de Desenvolvedores do Klaviyo — Discussão sobre Limites de Taxa

2. Exceder limites estáveis específicos de endpoint. O Klaviyo atribui cada endpoint a um tier com limites distintos de burst e estável. Por exemplo, endpoints Tier S permitem 60 requisições por minuto estáveis após a janela de burst inicial. Um profissional de marketing pedindo ao Claude para “puxar todas as campanhas dos últimos 12 meses com detalhamento completo de eventos” pode inadvertidamente esgotar esta cota em uma única thread de conversa. O resultado não é um banimento mas um bloqueio rigoroso no acesso a dados até que a janela reinicie. Visão Geral da API do Klaviyo — Tiers de Limite de Taxa

3. Usar chaves de API públicas para endpoints `/api` ou configurar escopos incorretamente. O Klaviyo distingue entre chaves públicas (para endpoints `/client` como rastreamento onsite) e chaves privadas (para endpoints `/api` como campanhas, fluxos, e segmentos). Tentar usar uma chave pública para consultas MCP do lado do servidor retorna erros 401 ou 400. Além disso, chaves privadas devem ter os escopos corretos habilitados em Configurações do Klaviyo > Chaves de API; escopos ausentes produzem 403 acesso negado respostas que aparecem como “Claude não consegue acessar meus dados” na experiência do usuário. Central de Ajuda do Klaviyo — Chaves de API

Ambos os comportamentos disparam limitação de taxa e erros de acesso. Se você quer usar o Claude para o Klaviyo com segurança, mantenha-se dentro dos limites de burst e estável do seu tier, use chaves de API privadas com escopos corretos, e deixe o MCP da Porter lidar com loteamento e recuo automaticamente.

O protocolo de escalabilidade de 5 regras

Baseado nos limites de taxa documentados do Klaviyo e nos comportamentos que realmente causaram limitação — não em suposições:

• Use chaves de API privadas exclusivamente para endpoints `/api`. Chaves públicas são restritas a endpoints `/client` apenas; todas as consultas do servidor MCP roteiam através de `/api` e exigem uma chave privada. Configuração incorreta dispara erros 400/401 imediatos. Central de Ajuda do Klaviyo — Chaves de API

• Respeite o limite de burst de 3 requisições por segundo para endpoints Tier S (métricas, campanhas, fluxos). Tier S é o tier mais comum para endpoints de análise de marketing. Exceder 3 req/s de burst dispara limitação 429. Comunidade de Desenvolvedores do Klaviyo — Limites de Taxa

• Mantenha-se abaixo do limite estável de 60 requisições por minuto para endpoints Tier S. Após a janela de burst inicial, consultas sustentadas devem permanecer abaixo de 60 req/min. Para grandes extrações históricas, pagine com `page_cursor` e pause entre lotes. Visão Geral da API do Klaviyo — Tiers de Limite de Taxa

• Respeite o cabeçalho `Retry-After` em respostas 429. A documentação do Klaviyo afirma que erros 429 incluem um cabeçalho `Retry-After` indicando segundos para esperar. Ignorar isso e tentar novamente imediatamente estende a janela de limitação.

• Conceda apenas os escopos mínimos necessários nas configurações de Chave de API do Klaviyo. O servidor MCP precisa apenas de acesso de leitura a Campanhas, Fluxos, Segmentos, e Métricas. Escopos de escrita (por exemplo, `campaigns:write`, `profiles:write`) devem permanecer desabilitados a menos que você esteja gerenciando campanhas ativamente via Claude.

O que o MCP da Porter faz de diferente: ele aplica esses limites de taxa e salvaguardas no nível da plataforma. O servidor MCP Universal da Porter implementa somente leitura por padrão para todas as consultas do Klaviyo, eliminando o risco de operações de escrita acidentais. Ele aplica loteamento automático de requisições e recuo quando o Klaviyo retorna respostas 429, tentando novamente de forma transparente com atraso exponencial para que o profissional de marketing nunca veja uma conversa quebrada. O isolamento de conexão por conta garante que o tráfego em burst de um usuário nunca vaze para a cota de outro. Esse é o comportamento que os sistemas automatizados do Klaviyo tratam graciosamente e não sinalizam.

Perguntas frequentes