Server MCP di Klaviyo

Cosa fa il Server MCP “Klaviyo”?

Il Server MCP di Klaviyo rivoluziona l’automazione dell’email marketing collegando la potente piattaforma Klaviyo con assistenti AI e strumenti per sviluppatori tramite il Model Context Protocol (MCP). Questa integrazione consente ai team marketing di gestire campagne email complesse, profili clienti, flussi di automazione e segmenti di pubblico con comandi in linguaggio naturale invece di navigare tra molteplici dashboard. Che tu stia creando campagne personalizzate, tracciando eventi cliente, costruendo segmenti avanzati o orchestrando flussi multi-step, il Server MCP di Klaviyo ti permette di svolgere tutto ciò direttamente da strumenti AI come Claude, Cursor o FlowHunt. Eliminando il cambio di contesto e abilitando l’automazione guidata dall’AI, i team marketing possono ridurre i tempi di configurazione delle campagne da ore a minuti mantenendo il pieno controllo sulla strategia di coinvolgimento clienti.

Esempi di Prompt

Gestione Profili e Clienti

Trova tutti i profili clienti che non hanno aperto email negli ultimi 90 giorni

Crea un nuovo profilo per customer@example.com con proprietà personalizzate per lo stato VIP

Mostrami tutti i profili che hanno acquistato negli ultimi 30 giorni ma non hanno ricevuto un'email di follow-up

Aggiorna tutti i profili nel segmento VIP per aggiungere una proprietà di livello fedeltà

Gestione Campagne

Crea una nuova campagna email per il Black Friday con oggetto 'Esclusivo 40% di sconto' destinata ai clienti VIP

Mostrami tutte le campagne inviate negli ultimi 7 giorni con tassi di apertura inferiori al 15%

Invia subito la campagna 'Welcome Series Parte 1' a tutti i nuovi iscritti

Annulla la campagna programmata per domani e riprogrammala per la prossima settimana

Liste e Segmentazione

Crea una nuova lista chiamata 'Q1 2026 Re-engagement' per gli iscritti inattivi

Aggiungi tutti i profili che hanno cliccato la nostra ultima email ma non hanno acquistato alla lista 'Hot Leads'

Mostrami tutti i segmenti con più di 5000 profili e i loro criteri

Operazioni su Template Email

Crea un nuovo template email per il lancio prodotto con contenuto HTML

Mostrami tutti i template usati in campagne con tassi di conversione superiori al 5%

Aggiorna il template 'Holiday Promotion' con il nuovo codice sconto HOLIDAY2026

Tracciamento Eventi e Analisi

Traccia un evento 'Product Viewed' per tutti i profili che hanno visitato la nostra nuova pagina collezione

Mostrami tutti gli eventi 'Purchase' degli ultimi 30 giorni con valore ordine superiore a $100

Ottieni tutte le metriche delle email e mostrami quali campagne hanno generato più ricavi

Automazione Flussi

Mostrami tutti i flussi di automazione attivi e i loro tassi di conversione

Metti in pausa il flusso 'Abbandono Carrello' mentre aggiorniamo i template email

Imposta il flusso 'Welcome Series' in stato live e abilitato per i nuovi iscritti

Pronto a far crescere il tuo business?

Inizia oggi la tua prova gratuita e vedi i risultati in pochi giorni.

Richiedi demo Accedi

Elenco delle Risorse

Nessuna risorsa esplicita elencata nel repository.

Elenco degli Strumenti

Il Server MCP di Klaviyo offre 39 strumenti completi organizzati in otto categorie:

Gestione Profili (5 strumenti)

• get_profiles - Recupera una lista di profili clienti con filtri e paginazione opzionali
• get_profile - Ottieni dettagli di un profilo cliente specifico tramite ID
• create_profile - Crea un nuovo profilo cliente con email, telefono, proprietà personalizzate e altro
• update_profile - Aggiorna attributi di profili esistenti come nome, email o proprietà custom
• Profile filtering - Filtri avanzati tramite la sintassi di Klaviyo

Gestione Liste (7 strumenti)

• get_lists - Recupera tutte le liste email del tuo account Klaviyo
• get_list - Ottieni dettagli di una lista specifica tramite ID
• create_list - Crea una nuova lista email per l’organizzazione dei contatti
• update_list - Aggiorna proprietà della lista incluso il nome
• delete_list - Rimuovi definitivamente una lista dal tuo account
• add_profile_to_list - Aggiungi un profilo cliente a una lista specifica
• remove_profile_from_list - Rimuovi un profilo da una lista

Gestione Campagne (7 strumenti)

• get_campaigns - Recupera campagne con filtri opzionali
• get_campaign - Ottieni dettagli di una campagna specifica
• create_campaign - Crea una nuova campagna email con oggetto, mittente e testo di anteprima
• update_campaign - Aggiorna attributi della campagna come nome, oggetto o contenuto
• send_campaign - Invia immediatamente una campagna al pubblico target
• cancel_campaign - Annulla una campagna programmata prima dell’invio
• assign_template_to_campaign - Associa un template email a una campagna

Tracciamento Eventi (2 strumenti)

• create_event - Traccia eventi personalizzati per profili con proprietà e timestamp
• get_events - Recupera eventi con filtri e paginazione per analisi

Metriche & Analisi (2 strumenti)

• get_metrics - Recupera tutte le metriche Klaviyo disponibili per il monitoraggio delle performance
• get_metric - Ottieni dettagli di una metrica specifica tramite ID

Gestione Segmenti (2 strumenti)

• get_segments - Recupera tutti i segmenti clienti del tuo account
• get_segment - Ottieni dettagli di un segmento specifico inclusi i criteri

Automazione Flussi (3 strumenti)

• get_flows - Recupera tutti i flussi di automazione con filtri e paginazione opzionali
• get_flow - Ottieni dettagli di un flusso di automazione specifico
• update_flow_status - Cambia lo stato del flusso tra live, manuale e bozza

Gestione Template (5 strumenti)

• get_templates - Recupera tutti i template email del tuo account
• get_template - Ottieni dettagli di un template specifico
• create_template - Crea un nuovo template email con contenuto HTML e testo
• update_template - Aggiorna attributi del template incluso HTML, testo e nome
• delete_template - Rimuovi definitivamente un template dal tuo account

Iscriviti alla nostra newsletter

Ricevi gratuitamente gli ultimi consigli, tendenze e offerte.

Indirizzo email

Iscriviti

Casi d’Uso di questo Server MCP

Quando Hai 100+ Iscritti Inattivi da Riconquistare

Hai migliaia di iscritti inattivi che appesantiscono la tua lista e abbassano la deliverability. Invece di creare manualmente segmenti, filtri e campagne multi-touch, chiedi: “Trova tutti i profili che non hanno aperto email negli ultimi 90 giorni, crea un segmento chiamato ‘Re-engagement Q1 2026’ e imposta una campagna winback di tre email usando il nostro template di riattivazione.” Il server MCP costruisce il segmento, crea le campagne, assegna i template e prepara la sequenza di riattivazione in meno di 2 minuti—un lavoro che tradizionalmente richiede 2-3 ore.

Quando un Lancio Prodotto Richiede Segmentazione per Storico Acquisti

Il tuo nuovo prodotto premium esce domani e devi targettizzare clienti in base al valore vita e agli acquisti precedenti. Basta dire: “Crea segmenti per clienti che hanno speso più di $500 nell’ultimo anno ma non hanno acquistato da 60 giorni e un altro per chi ha comprato solo il prodotto base senza mai fare upgrade.” Il server crea istantaneamente entrambi i segmenti, permettendo di personalizzare i messaggi per ciascun gruppo—un lavoro normalmente complesso e soggetto a QA multipli.

Quando Analizzi Quali Template Email Generano Più Conversioni

Hai inviato decine di campagne e devi identificare i template più performanti. Chiedi: “Mostrami tutte le campagne inviate in Q4 2025, i template assegnati e le metriche di conversione.” Invece di esportare dati, incrociare ID template e costruire fogli Excel, ottieni un’analisi istantanea che mostra quali template rendono di più, permettendo decisioni creative guidate dai dati senza le solite 4-5 ore di analisi manuale.

Quando Devi Sincronizzare Eventi dall’App per Attivare Flussi Automatici

La tua SaaS traccia comportamenti critici degli utenti—avvio trial, adozione feature, milestone—e vuoi questi eventi su Klaviyo per attivare flussi personalizzati. Comando: “Crea un evento ‘Feature X Activated’ per tutti i profili nel segmento power users con timestamp e proprietà feature.” Il server MCP crea in batch gli eventi con corretta attribuzione, abilitando marketing comportamentale sofisticato senza scrivere script API o attendere gli sviluppatori.

Quando Gestisci Più Brand e Devi Duplicare Campagne Vincenti

Gestisci tre brand e la campagna natalizia del Brand A ha registrato il 42% di open rate. Invece di ricreare manualmente la struttura per i Brand B e C, chiedi: “Recupera la campagna ID abc123, mostrami struttura, template e impostazioni, poi aiutami a crearne di identiche per le liste Brand B e Brand C.” Il server recupera tutti i dettagli e ti aiuta a replicare il successo in pochi minuti invece che con ore di copia-incolla e controlli.

Quando Arriva il Black Friday e Servono 20 Varianti di Email Promozionali

Il picco stagionale richiede più varianti per segmenti diversi—nuovi clienti, VIP, visitatori, carrelli abbandonati. Invece di creare 20 campagne manualmente, istruisci: “Crea campagne Black Friday per questi 5 segmenti: clienti VIP, acquirenti ricorrenti, monoacquisto, iscritti mai acquirenti, abbandonatori carrello. Usa il nostro template festivo e personalizza l’oggetto per ciascuno.” Il server genera tutte le campagne con il giusto targeting in 15 minuti, risparmiando oltre 6 ore di lavoro ripetitivo.

Quando Scopri un Errore Critico nel Template Dopo l’Invio a 10.000 Iscritti

Hai inviato una campagna e noti che il codice promo nel template è sbagliato. Ci sono altre 15 campagne in programma con quel template. Invece di aggiornare tutto a mano, chiedi: “Mostrami tutte le campagne programmate nei prossimi 7 giorni che usano il template ID xyz789, poi aggiorna il template cambiando PROMO20 in PROMO25.” Il server individua le campagne coinvolte e aggiorna il master template istantaneamente, prevenendo 15 potenziali disastri senza controlli manuali.

Quando Costruisci Segmenti Complessi per una Campagna Multi-Touch

La tua retention punta a clienti che hanno ricevuto l’ultima email, l’hanno aperta, hanno cliccato ma non completato il checkout—e che hanno acquistato in passato ma non negli ultimi 45 giorni. In Klaviyo UI dovresti usare filtri nidificati, qui invece descrivi: “Crea un segmento di profili che hanno aperto la campagna ID abc123, cliccato un link, almeno un ordine passato, ma nessun ordine negli ultimi 45 giorni e nessun checkout completato.” L’AI traduce in criteri segmentali senza frustrazioni.

Quando Coordini una Sequenza Email per Discontinuità Prodotto

Stai dismettendo una linea e vuoi avvisare i clienti, offrire alternative e un’ultima chance. Comanda: “Trova tutti i profili che hanno acquistato SKU 12345 negli ultimi 2 anni, crea una lista ‘Product Discontinuation - SKU 12345’ e imposta una sequenza di 3 email: annuncio, alternative, last chance.” Il server individua i clienti, li organizza in lista e struttura la campagna sunset—un lavoro che normalmente richiede esportazioni, upload CSV e configurazioni manuali.

Quando le Metriche Email Crollano e Devi Fare Root Cause Analysis

Il tuo open rate tipico del 25% è sceso al 12% e i manager vogliono risposte. Chiedi: “Mostrami tutte le campagne degli ultimi 14 giorni con open/click rate e orari di invio. Confronta con le campagne dei 30 giorni precedenti.” Il server fornisce metriche comparative, aiutando a individuare pattern—magari è cambiato l’orario, certi segmenti non ingaggiano o i template non performano—senza esportare report e costruire grafici a mano.

Quando Gestisci Stati Flussi Durante Migrazioni o Aggiornamenti

Stai migrando CRM e devi mettere in pausa 30+ flussi di automazione per evitare comunicazioni duplicate. Invece di cliccare ogni flusso su Klaviyo, chiedi: “Mostrami tutti i flussi attivi, poi metti in stato bozza quelli che contengono ‘abandoned cart’, ‘welcome series’ e ‘post-purchase’.” Il server aggiorna in batch gli stati dei flussi, dandoti controllo preciso senza rischi di dimenticanze.

Quando Crei Campagne Personalizzate Basate su Eventi Webinar

Hai ospitato un webinar con 500 partecipanti, vuoi tracciare chi ha assistito, gli argomenti seguiti e attivare follow-up personalizzati. Istruisci: “Crea evento ‘Webinar Attended - AI Marketing’ per questi 500 profili con durata presenza e risposte ai sondaggi, poi crea segmento per chi è rimasto oltre 30 minuti.” Il server processa eventi e segmenti bulk, abilitando follow-up comportamentali senza inserimenti manuali o CSV.

Quando Auditi la Deliverability su Più Liste

Sospetti problemi di deliverability perché il coinvolgimento varia tra le tue 15 liste. Alcune hanno 35% di open rate, altre appena l'8%. Chiedi: “Mostrami tutte le liste, i conteggi iscritti e le performance campagne negli ultimi 30 giorni.” Il server aggrega dati e metriche, individuando liste da pulire e quelle più ingaggiate—senza esportare report e incrociare dati manualmente.

Quando Scali Campagne Personalizzate per il Ciclo di Vita Cliente

Passi dal batch alle campagne lifecycle e vuoi creare 8 serie diverse per prospect, nuovi clienti, utenti attivi, clienti a rischio, churned, VIP, referrer e ambassador. Invece di costruire tutto manualmente, collabora con l’AI: “Aiutami a creare strutture campagne per 8 stadi lifecycle. Per ciascuno ti darò criteri e messaggio, tu crea campagne con template e orari.” Il server accelera la costruzione di programmi lifecycle da settimane a giorni.

Quando Lanci A/B Test su Più Segmenti Contemporaneamente

Stai testando oggetti—urgenza, vantaggio, personalizzazione—su 6 segmenti clienti. Invece di creare 18 campagne manualmente, chiedi: “Crea campagne A/B test per questi 6 segmenti usando tre varianti oggetto: urgenza, vantaggio, personalizzazione. Usa il template promozionale standard.” Il server genera tutta la matrice test, abilitando test multivariati avanzati senza sovraccarico.

Come si configura

Windsurf

1. Assicurati che Python 3.10 o superiore sia installato sul tuo sistema.
2. Installa il server MCP di Klaviyo dal repository.
3. Ottieni le credenziali OAuth dal tuo account Klaviyo:
   • Vai su Impostazioni Account > Chiavi API in Klaviyo
   • Crea una nuova chiave API con i permessi necessari
   • Prendi nota di Client ID, Client Secret, Access Token
4. Aggiungi il server MCP di Klaviyo alla configurazione 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. Salva il file di configurazione e riavvia Windsurf.
6. Verifica che il server MCP sia accessibile dal pannello MCP di Windsurf.

Claude

1. Assicurati che Python 3.10 o superiore sia installato.
2. Installa il server MCP di Klaviyo.
3. Configura le credenziali OAuth di Klaviyo come sopra.
4. Aggiungi o aggiorna il campo mcpServers nella configurazione di 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. Salva la configurazione e riavvia Claude.
6. Conferma la connessione dal pannello integrazioni di Claude.

Cursor

1. Installa Python 3.10+ e il server MCP di Klaviyo.
2. Configura le credenziali OAuth di Klaviyo.
3. Trova il file di configurazione di Cursor e aggiungi la voce server 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. Salva la configurazione e riavvia Cursor.
5. Verifica che il server sia tra i MCP disponibili su Cursor.

Cline

1. Assicurati che Python 3.10+ sia presente sul sistema.
2. Scarica o installa il server MCP di Klaviyo.
3. Ottieni le credenziali OAuth di Klaviyo.
4. Modifica la configurazione di Cline per includere:

   {
     "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. Salva la configurazione, riavvia Cline e verifica la connettività MCP.

Protezione delle API Key (uso variabili d’ambiente):

Per proteggere le credenziali Klaviyo, usa sempre variabili d’ambiente invece di hardcodarle. Esempio di configurazione sicura:

{
  "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}"
      }
    }
  }
}

Imposta queste variabili d’ambiente nel tuo sistema o profilo della shell prima di avviare il client MCP.

Come usare questo MCP nei flussi

Utilizzo di MCP in FlowHunt

Per integrare il server MCP di Klaviyo nel tuo workflow FlowHunt, aggiungi il componente MCP al tuo flow e collegalo al tuo agente AI:

Clicca sul componente MCP per aprire il pannello di configurazione. Nella sezione configurazione MCP di sistema, inserisci i dettagli del server Klaviyo in formato JSON:

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

Una volta configurato, il tuo agente AI avrà accesso a tutti i 39 strumenti Klaviyo, potendo così creare campagne, gestire profili clienti, tracciare eventi, orchestrare flussi e analizzare metriche—tutto all’interno dei tuoi workflow automatizzati. Questo trasforma i flussi FlowHunt in potenti motori di marketing automation in grado di rispondere a trigger, segmentare audience ed eseguire campagne senza intervento manuale.

Panoramica

Tra documentazione e codice, il Server MCP di Klaviyo offre una copertura completa con 39 operazioni distinte che spaziano dalla gestione profili, automazione campagne, gestione liste, tracciamento eventi, analisi metriche, segmentazione, orchestrazione flussi e gestione template. Il server usa autenticazione OAuth con gestione sicura delle credenziali tramite variabili d’ambiente.

La nostra opinione

Questo server MCP eccelle per ampiezza e profondità delle funzionalità di automazione marketing, offrendo la più completa integrazione Klaviyo disponibile tramite Model Context Protocol. Grazie a 39 strumenti ben documentati in categorie logiche, i team marketing ottengono un controllo senza precedenti sulle operazioni email tramite interfacce in linguaggio naturale. L’implementazione OAuth garantisce sicurezza enterprise, mentre la ricchezza di strumenti elimina la necessità di lavoro manuale sulla dashboard nella maggior parte degli scenari. È ideale per team marketing, professionisti marketing operations e sviluppatori che desiderano usare l’AI per gestione campagne, segmentazione clienti e ottimizzazione del coinvolgimento. La mancanza di template prompt predefiniti è compensata dalla nomenclatura intuitiva degli strumenti e le descrizioni chiare che rendono naturale l’interazione in linguaggio naturale.

MCP Score