# Klaviyo MCP

Подключает аналитику Klaviyo к ИИ-агенту через 24 инструмента только для чтения. Пригодится для проверки кампаний, метрик и баз подписчиков.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: scalably-io
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/scalably-io/klaviyo-mcp
- Обновлён: 2026-10-20
- HTML: https://affpapa.org/nevibecode/mcp/klaviyo-mcp

## Что делает

Сервер собирает данные из одного или нескольких аккаунтов Klaviyo. Внутри реализовано 24 инструмента для инспекции: просмотр списков кампаний, цепочек автоматизаций (flows), сегментов, шаблонов писем, форм и профилей покупателей. Можно строить отчёты по доходу, кликам, открытиям или сравнивать результаты A/B-тестов. Все операции исключительно читающие, поэтому агент не сможет случайно отправить рассылку или изменить клиентскую базу.

Каждый аккаунт задаётся отдельной переменной окружения вида `KLAVIYO_KEY_<name>`. Сервер находит их при старте, после чего к нужной витрине можно обращаться по имени. Ответы приходят в формате JSON со статусом операции и результатом.

Сервер упирается в лимиты Klaviyo: отчёты ограничены двумя запросами в минуту на один аккаунт. Исторические данные доступны строго с 2023-06-01, а интервалы длиннее одного года сервер автоматически разбивает на части.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `KLAVIYO_KEY_MAIN`, `KLAVIYO_API_BASE`, `KLAVIYO_RETRY_BASE_MS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env KLAVIYO_KEY_MAIN=<KLAVIYO_KEY_MAIN> --env KLAVIYO_API_BASE=<KLAVIYO_API_BASE> --env KLAVIYO_RETRY_BASE_MS=<KLAVIYO_RETRY_BASE_MS> --transport stdio klaviyo-mcp -- npx -y @scalably-io/klaviyo-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add klaviyo-mcp --env KLAVIYO_KEY_MAIN=<KLAVIYO_KEY_MAIN> --env KLAVIYO_API_BASE=<KLAVIYO_API_BASE> --env KLAVIYO_RETRY_BASE_MS=<KLAVIYO_RETRY_BASE_MS> -- npx -y @scalably-io/klaviyo-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "klaviyo-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@scalably-io/klaviyo-mcp"
            ],
            "env": {
                "KLAVIYO_KEY_MAIN": "<KLAVIYO_KEY_MAIN>",
                "KLAVIYO_API_BASE": "<KLAVIYO_API_BASE>",
                "KLAVIYO_RETRY_BASE_MS": "<KLAVIYO_RETRY_BASE_MS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "klaviyo-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@scalably-io/klaviyo-mcp"
            ],
            "env": {
                "KLAVIYO_KEY_MAIN": "<KLAVIYO_KEY_MAIN>",
                "KLAVIYO_API_BASE": "<KLAVIYO_API_BASE>",
                "KLAVIYO_RETRY_BASE_MS": "<KLAVIYO_RETRY_BASE_MS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e KLAVIYO_KEY_MAIN=<KLAVIYO_KEY_MAIN> -e KLAVIYO_API_BASE=<KLAVIYO_API_BASE> -e KLAVIYO_RETRY_BASE_MS=<KLAVIYO_RETRY_BASE_MS> klaviyo-mcp npx -y @scalably-io/klaviyo-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- Собрать отчёт по доходу и отпискам для email-кампаний
- Проверить статус и структуру шагов в цепочках автоматизации
- Сравнить показатели разных вариантов в A/B-тестах
- Найти профиль клиента и проверить статус согласия на маркетинг
- Выгрузить сводку метрик сразу по нескольким аккаунтам

## Примеры запросов агенту
- Покажи последние кампании и отчёт по выручке для аккаунта main
- Выгрузи список подавленных профилей с причиной отписки
- Сделай сводный отчёт по эффективности автоматизаций во всех аккаунтах

## Похожие
- [labelhead-artist-momentum](https://affpapa.org/nevibecode/mcp/labelhead-artist-momentum.md) — MCP-сервер · ★ 107701
- [openshorts](https://affpapa.org/nevibecode/mcp/openshorts.md) — MCP-сервер · ★ 7132
- [OpenScreen](https://affpapa.org/nevibecode/mcp/openscreen.md) — MCP-сервер · ★ 4963
- [Usertour MCP Server](https://affpapa.org/nevibecode/mcp/usertour-mcp-server.md) — MCP-сервер · ★ 2329
- [Appllama](https://affpapa.org/nevibecode/mcp/appllama.md) — MCP-сервер · ★ 3228
- [obsei](https://affpapa.org/nevibecode/mcp/obsei.md) — MCP-сервер · ★ 1441

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md