Klaviyo MCP Server

Co dělá “Klaviyo” MCP Server?

Klaviyo MCP Server revolucionalizuje e-mailovou marketingovou automatizaci tím, že spojuje výkonnou platformu Klaviyo s AI asistenty a vývojářskými nástroji prostřednictvím Model Context Protocol (MCP). Tato integrace umožňuje marketingovým týmům spravovat sofistikované e-mailové kampaně, zákaznické profily, automatizační toky a segmenty publika pomocí příkazů v přirozeném jazyce, místo proklikávání několika dashboardů. Ať už vytváříte personalizované kampaně, sledujete zákaznické události, budujete komplexní segmenty nebo orchestrujete více-krokové automatizační toky, Klaviyo MCP Server vám umožní provádět tyto úkoly přímo z AI nástrojů jako Claude, Cursor nebo FlowHunt. Eliminací přepínání kontextu a umožněním AI automatizace dokáží marketingové týmy zkrátit přípravu kampaní z hodin na minuty, přičemž si zachovávají plnou kontrolu nad strategií zákaznického engagementu.

Seznam promptů

Správa profilů a zákazníků

Najdi všechny zákaznické profily, které neotevřely e-mail za posledních 90 dní

Vytvoř nový profil pro customer@example.com s vlastním atributem pro VIP status

Ukáž mi všechny profily, které nakoupily za posledních 30 dní, ale nedostaly následný e-mail

Aktualizuj všem profilům v segmentu VIP vlastnost s úrovní loajality

Správa kampaní

Vytvoř novou e-mailovou kampaň pro Black Friday s předmětem 'Exkluzivní sleva 40%' cílenou na VIP zákazníky

Ukáž mi všechny kampaně odeslané za posledních 7 dní s mírou otevření pod 15 %

Odešli kampaň 'Welcome Series Part 1' ihned všem novým odběratelům

Zruš naplánovanou kampaň na zítra a přeplánuj ji na příští týden

Správa seznamů a segmentace

Vytvoř nový seznam s názvem 'Q1 2026 Re-engagement' pro neaktivní odběratele

Přidej všechny profily, které klikly v našem posledním e-mailu, ale nenakoupily, do seznamu 'Hot Leads'

Ukáž mi všechny segmenty s více než 5000 profily a jejich kritéria

Operace s e-mailovými šablonami

Vytvoř novou e-mailovou šablonu pro uvedení produktu s HTML obsahem

Ukáž mi všechny šablony použité v kampaních s konverzí nad 5 %

Aktualizuj šablonu 'Holiday Promotion' s novým slevovým kódem HOLIDAY2026

Sledování událostí a analytika

Sleduj událost 'Product Viewed' u všech profilů, které navštívily naši stránku nové kolekce

Ukáž mi všechny události 'Purchase' z posledních 30 dní s hodnotou objednávky nad 100 $

Získej všechny metriky výkonnosti e-mailu a ukaž mi, které kampaně generovaly nejvíce tržeb

Automatizace toků

Ukáž mi všechny aktivní automatizační toky a jejich konverzní míry

Pozastav tok 'Cart Abandonment', zatímco aktualizujeme e-mailové šablony

Nastav tok 'Welcome Series' do stavu live a povol ho pro nové odběratele

Připraveni rozšířit své podnikání?

Začněte svou bezplatnou zkušební verzi ještě dnes a viďte výsledky během několika dní.

Požádat o demo Přihlásit se

Seznam zdrojů

V repozitáři nejsou explicitně uvedené zdroje.

Seznam nástrojů

Klaviyo MCP server poskytuje 39 komplexních nástrojů rozdělených do osmi kategorií:

Správa profilů (5 nástrojů)

• get_profiles – Získání seznamu zákaznických profilů s možností filtrování a stránkování
• get_profile – Detailní informace o konkrétním zákaznickém profilu podle ID
• create_profile – Vytvoření nového zákaznického profilu s e-mailem, telefonem, vlastními atributy a dalšími údaji
• update_profile – Aktualizace existujících atributů profilu, například jména, e-mailu či vlastních polí
• Profile filtering – Pokročilé filtrování pomocí Klaviyo filtrační syntaxe

Správa seznamů (7 nástrojů)

• get_lists – Získání všech e-mailových seznamů ve vašem Klaviyo účtu
• get_list – Detailní informace o konkrétním seznamu podle ID
• create_list – Vytvoření nového e-mailového seznamu pro organizaci kontaktů
• update_list – Aktualizace vlastností seznamu včetně názvu
• delete_list – Trvalé odstranění seznamu z vašeho účtu
• add_profile_to_list – Přidání zákaznického profilu do konkrétního seznamu
• remove_profile_from_list – Odebrání profilu ze seznamu

Správa kampaní (7 nástrojů)

• get_campaigns – Získání kampaní s možností filtrování
• get_campaign – Detailní informace o konkrétní kampani
• create_campaign – Vytvoření nové e-mailové kampaně s předmětem, údaji odesílatele a náhledem
• update_campaign – Aktualizace atributů kampaně jako název, předmět nebo obsah
• send_campaign – Okamžité odeslání kampaně cílové skupině
• cancel_campaign – Zrušení naplánované kampaně před odesláním
• assign_template_to_campaign – Připojení e-mailové šablony ke kampani

Sledování událostí (2 nástroje)

• create_event – Sledování vlastních událostí u profilů s vlastnostmi a časovými značkami
• get_events – Získání událostí s filtrováním a stránkováním pro analytiku

Metriky & analytika (2 nástroje)

• get_metrics – Získání všech dostupných metrik Klaviyo pro sledování výkonnosti
• get_metric – Detailní informace o konkrétní metrice podle ID

Správa segmentů (2 nástroje)

• get_segments – Získání všech zákaznických segmentů ve vašem účtu
• get_segment – Detailní informace o konkrétním segmentu včetně kritérií

Automatizace toků (3 nástroje)

• get_flows – Získání všech automatizačních toků s možností filtrování a stránkování
• get_flow – Detailní informace o konkrétním automatizačním toku
• update_flow_status – Změna stavu toku mezi režimy live, manual a draft

Správa šablon (5 nástrojů)

• get_templates – Získání všech e-mailových šablon ve vašem účtu
• get_template – Detailní informace o konkrétní šabloně
• create_template – Vytvoření nové e-mailové šablony s HTML a textovým obsahem
• update_template – Úprava atributů šablony včetně HTML, textu a názvu
• delete_template – Trvalé odstranění šablony z vašeho účtu

Přihlaste se k odběru newsletteru

Získejte nejnovější tipy, trendy a nabídky zdarma.

E-mailová adresa

Přihlásit se

Příklady použití tohoto MCP serveru

Když máte 100+ neaktivních odběratelů, které chcete znovu zapojit

Díváte se na tisíce neaktivních odběratelů, kteří vám zanášejí seznam a snižují doručitelnost. Místo ručního vytváření segmentů, filtrů a multi-touch kampaní řekněte: “Najdi všechny profily, které neotevřely e-mail za 90 dní, vytvoř segment s názvem ‘Re-engagement Q1 2026’ a nastav tříkrokovou winback kampaň s naším reaktivačním template.” MCP server segment vytvoří, připraví kampaně, přiřadí šablony a připraví celou sekvenci za méně než 2 minuty – práce, která tradičně trvá 2–3 hodiny.

Když potřebujete při uvedení produktu segmentovat podle historie nákupů

Zítra spouštíte nový prémiový produkt a chcete cílit na zákazníky dle jejich hodnoty a minulých nákupů. Stačí říct: “Vytvoř segmenty pro zákazníky, kteří utratili přes 500 dolarů za poslední rok, ale nenakoupili 60 dní, a další pro ty, kteří koupili základní produkt, ale nikdy neupgradovali.” Server okamžitě vytvoří oba segmenty, takže můžete přizpůsobit komunikaci každé skupině – zásadní práce, která běžně vyžaduje složité filtry a několik kol kontroly.

Když analyzujete, které e-mailové šablony mají nejvyšší konverze

Poslali jste desítky kampaní a potřebujete zjistit, které šablony fungují nejlépe. Stačí se zeptat: “Ukáž mi všechny kampaně odeslané ve 4. čtvrtletí 2025, jejich přiřazené šablony a konverzní metriky.” Namísto exportování dat, párování ID šablon a ručního vytváření tabulek dostanete okamžitou analýzu, která ukáže, které šablony opakovaně dosahují nejlepších výsledků – bez obvyklých 4–5 hodin analýzy.

Když potřebujete synchronizovat eventy z aplikace pro spouštění automatizací

Vaše SaaS aplikace sleduje důležité chování uživatelů – začátek trialu, adopci funkcí, milníky v používání – a potřebujete tyto události dostat do Klaviyo, abyste spouštěli personalizované automatizace. Příkaz: “Vytvoř event ‘Feature X Activated’ pro všechny profily v segmentu power users s časovou značkou a vlastnostmi funkce.” MCP server hromadně vytvoří události s odpovídajícím přiřazením, což umožní pokročilý behaviorální marketing bez nutnosti programování API nebo čekání na vývojáře.

Když spravujete více značek a chcete duplikovat úspěšné kampaně

Spravujete tři různé značky v jedné firmě a vánoční kampaň značky A dosáhla 42% open rate. Místo ručního kopírování struktury pro značky B a C řekněte: “Získej kampaň ID abc123, ukáž mi její strukturu, šablonu a nastavení, a pomoz mi vytvořit totožné kampaně pro seznamy značek B a C.” Server stáhne všechny detaily kampaně a umožní vám úspěch jednoduše replikovat napříč značkami – během minut místo hodin ručního kopírování a kontroly.

Když před Black Friday potřebujete 20 variant promo e-mailů

V hlavní sezóně potřebujete různé varianty e-mailů pro různé segmenty – nové zákazníky, VIP, prohlížející, opuštěné košíky. Místo ručního vytváření 20 kampaní přes UI řekněte: “Vytvoř kampaně pro Black Friday pro těchto 5 segmentů: VIP zákazníci, opakovaní kupující, jednorázoví zákazníci, odběratelé kteří nenakoupili, a opuštěné košíky. Použij holiday template a přizpůsob předmět každému.” Server vygeneruje všechny kampaně s příslušným cílením a šablonami – 6+ hodin rutinní práce zvládnuto za 15 minut s pomocí AI.

Když objevíte chybu v šabloně po odeslání na 10 000 odběratelů

Odeslali jste kampaň a zjistili, že kód v šabloně je chybný. Máte dalších 15 naplánovaných kampaní se stejnou šablonou. Místo ruční aktualizace každé kampaně nebo paniky řekněte: “Ukáž mi všechny kampaně naplánované na příštích 7 dní s šablonou ID xyz789, pak aktualizuj šablonu z PROMO20 na PROMO25.” Server najde dotčené kampaně a aktualizuje hlavní šablonu okamžitě – zabrání 15 potenciálním chybám bez manuální kontroly kalendáře.

Když potřebujete složitou segmentaci pro multi-touch kampaň

Vaše retention kampaň cílí na zákazníky, kteří dostali minulý e-mail, otevřeli ho, klikli, ale nedokončili nákup – a zároveň už někdy nakoupili, ale ne za posledních 45 dní. Vytváření takového segmentu v UI znamená procházení složitých filtrů a podmínek. Místo toho jednoduše popište kritéria: “Vytvoř segment profilů, kteří otevřeli kampaň ID abc123, klikli na libovolný odkaz, mají alespoň jeden nákup v minulosti, ale žádný za posledních 45 dní a nedokončili checkout.” AI přeloží vaše požadavky do segmentačních kritérií a eliminuje frustraci z filtrování.

Když koordinujete sekvenci e-mailů při ukončení produktu

Rušíte produktovou řadu a potřebujete informovat dotčené zákazníky, nabídnout alternativy a umožnit poslední nákup. Příkaz: “Najdi všechny profily, které koupily produkt SKU 12345 za poslední 2 roky, vytvoř seznam ‘Product Discontinuation - SKU 12345’ a připrav tříkrokovou e-mailovou sekvenci: oznámení, alternativy, poslední šance.” Server identifikuje zákazníky, vytvoří cílový seznam a strukturuje vaši rozlučkovou kampaň – práce, která běžně vyžaduje export dat, CSV uploady a ruční konfiguraci.

Když prudce klesnou metriky e-mailů a potřebujete najít příčinu

Obvyklá 25% open rate spadla na 12 % a vedení chce znát důvod. Zeptejte se: “Ukáž mi všechny kampaně odeslané za posledních 14 dní s open rate, click rate a časem odeslání. Porovnej s kampaněmi z předchozích 30 dní.” Server dodá srovnávací metriky, pomůže najít vzorce – možná se změnil čas odeslání, přestaly reagovat určité segmenty, nebo je problém v šabloně – a odhalí, co by jinak vyžadovalo exporty a manuální reporty.

Když potřebujete hromadně měnit stav toků při migraci nebo velkých změnách

Migrujete na nové CRM a chcete pozastavit přes 30 automatizačních toků, aby nedocházelo k duplicitní komunikaci. Místo klikání na každý tok v dashboardu Klaviyo řekněte: “Ukáž mi všechny aktivní toky, poté nastav stavy ‘abandoned cart’, ‘welcome series’ a ‘post-purchase’ na draft.” Server hromadně změní stav toků – precizní kontrola během klíčových operací bez rizika, že na některý tok zapomenete.

Když tvoříte personalizované event-driven kampaně pro účastníky webináře

Pořádali jste webinář s 500 účastníky a potřebujete sledovat, kdo se zúčastnil, o jaká témata měl zájem a spustit personalizované následné kampaně. Příkaz: “Vytvoř event ‘Webinar Attended - AI Marketing’ pro těchto 500 ID profilů s vlastnostmi včetně doby účasti a odpovědí na ankety, poté vytvoř segment účastníků, kteří vydrželi přes 30 minut.” Server zpracuje hromadné vytvoření událostí s parametry a postaví segmenty – bez ručního zadávání nebo CSV importů.

Když auditujete doručitelnost e-mailů napříč seznamy

Máte podezření na doručitelnost, protože engagement na 15 různých seznamech je velmi odlišný – některé mají 35% open rate, jiné sotva 8 %. Zeptejte se: “Ukáž mi všechny mé seznamy, jejich počet odběratelů a výkonnost kampaní za posledních 30 dní.” Server agreguje data o seznamech a kampaních, ukáže které seznamy je třeba čistit a kde je engagement vysoký – poznatky, které jinak vyžadují exporty a hodiny ručního porovnávání.

Když škálujete personalizaci podle fáze životního cyklu zákazníka

Přecházíte z hromadného rozesílání na lifecycle marketing a potřebujete 8 různých sekvencí pro potenciální zákazníky, nové klienty, aktivní uživatele, ohrožené zákazníky, odpadlíky, VIP, referrery a ambasadory značky. Místo ručního budování každé sekvence spolupracujte s AI: “Pomoz mi vytvořit struktury kampaní pro 8 fází životního cyklu. Pro každý stupeň zadám segmentační kritéria a messaging, ty vytvoř kampaně s šablonami a rozvrhem.” MCP server urychlí výstavbu komplexního programu z týdnů na dny.

Když spouštíte A/B testy napříč segmenty současně

Testujete přístupy v předmětu – urgence vs. benefit vs. personalizace – na 6 různých segmentech. Místo ručního vytvoření 18 kampaní řekněte: “Vytvoř A/B testovací kampaně pro těchto 6 segmentů s třemi variantami předmětu: urgence, benefit, personalizace. Vše naší promo šablonou.” Server vygeneruje celou testovací matici – umožní pokročilé testování bez zahlcení rutinní prací.

Jak to nastavit

Windsurf

1. Ujistěte se, že máte na systému nainstalovaný Python 3.10 nebo vyšší.
2. Nainstalujte Klaviyo MCP server z vašeho repozitáře.
3. Získejte OAuth údaje ze svého Klaviyo účtu:
   • Přejděte do Account Settings > API Keys v Klaviyo
   • Vytvořte nový API klíč s požadovanými oprávněními
   • Zaznamenejte Client ID, Client Secret a Access Token
4. Přidejte Klaviyo MCP server do konfigurace 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. Uložte konfigurační soubor a restartujte Windsurf.
6. Ověřte, že MCP server je uveden a dostupný v MCP panelu Windsurfu.

Claude

1. Ujistěte se, že máte nainstalovaný Python 3.10 nebo vyšší.
2. Nainstalujte Klaviyo MCP server.
3. Nakonfigurujte OAuth údaje Klaviyo dle výše uvedeného postupu.
4. Přidejte nebo aktualizujte pole mcpServers ve vaší konfiguraci 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. Uložte konfiguraci a restartujte Claude.
6. Ověřte připojení MCP serveru v panelu integrací Claude.

Cursor

1. Nainstalujte Python 3.10+ a Klaviyo MCP server.
2. Nastavte své OAuth údaje Klaviyo.
3. Najděte konfigurační soubor Cursor a přidejte MCP server:

   {
     "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. Uložte konfiguraci a restartujte Cursor.
5. Ujistěte se, že server se zobrazuje mezi dostupnými MCP servery v Cursoru.

Cline

1. Ujistěte se, že máte na systému Python 3.10+.
2. Stáhněte nebo nainstalujte Klaviyo MCP server.
3. Získejte OAuth údaje Klaviyo.
4. Upravte konfiguraci Cline takto:

   {
     "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. Uložte konfiguraci, restartujte Cline a ověřte konektivitu serveru MCP.

Zabezpečení API klíčů (přes proměnné prostředí):

Pro ochranu Klaviyo údajů vždy používejte proměnné prostředí místo jejich pevného zadání v konfiguračních souborech. Ukázka bezpečné konfigurace:

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

Před spuštěním MCP klienta nastavte tyto proměnné prostředí ve vašem systému nebo shell profilu.

Jak používat MCP ve FlowHunt flow

Použití MCP ve FlowHunt

Pro integraci Klaviyo MCP serveru do vašeho workflow ve FlowHunt začněte přidáním MCP komponenty do flow a jejím propojením s AI agentem:

Klikněte na MCP komponentu pro otevření konfiguračního panelu. V sekci systémové MCP konfigurace vložte údaje o vašem Klaviyo MCP serveru v tomto JSON formátu:

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

Po konfiguraci získá váš AI agent přístup ke všem 39 nástrojům Klaviyo, což mu umožní vytvářet kampaně, spravovat zákaznické profily, sledovat události, orchestraci toků a analyzovat metriky – to vše v rámci vašich automatizovaných workflow. Tím proměníte vaše FlowHunt toky v mocné marketingové automatizační stroje, které reagují na triggery, segmentují publikum a spouštějí kampaně bez manuálního zásahu.

Přehled

Kombinace dokumentace a kódu poskytuje Klaviyo MCP Server komplexní pokrytí nástroji s 39 různými operacemi napříč správou profilů, automatizací kampaní, správou seznamů, sledováním udál