Klaviyo MCP — MCP-сервер для Claude Code: что делает и как установить
Подключает аналитику Klaviyo к ИИ-агенту через 24 инструмента только для чтения. Пригодится для проверки кампаний, метрик и баз подписчиков.
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Что делает Klaviyo MCP
Сервер собирает данные из одного или нескольких аккаунтов Klaviyo. Внутри реализовано 24 инструмента для инспекции: просмотр списков кампаний, цепочек автоматизаций (flows), сегментов, шаблонов писем, форм и профилей покупателей. Можно строить отчёты по доходу, кликам, открытиям или сравнивать результаты A/B-тестов. Все операции исключительно читающие, поэтому агент не сможет случайно отправить рассылку или изменить клиентскую базу.
Каждый аккаунт задаётся отдельной переменной окружения вида KLAVIYO_KEY_<name>. Сервер находит их при старте, после чего к нужной витрине можно обращаться по имени. Ответы приходят в формате JSON со статусом операции и результатом.
Сервер упирается в лимиты Klaviyo: отчёты ограничены двумя запросами в минуту на один аккаунт. Исторические данные доступны строго с 2023-06-01, а интервалы длиннее одного года сервер автоматически разбивает на части.
Какие задачи решает
- Собрать отчёт по доходу и отпискам для email-кампаний
- Проверить статус и структуру шагов в цепочках автоматизации
- Сравнить показатели разных вариантов в A/B-тестах
- Найти профиль клиента и проверить статус согласия на маркетинг
- Выгрузить сводку метрик сразу по нескольким аккаунтам
Примеры запросов агенту
- Покажи последние кампании и отчёт по выручке для аккаунта main
- Выгрузи список подавленных профилей с причиной отписки
- Сделай сводный отчёт по эффективности автоматизаций во всех аккаунтах
Как установить Klaviyo MCP
Командой платформы
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 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Вместо <…> подставьте свои значения
Файл настроек
{
"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>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"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 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Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Klaviyo MCP
Как установить Klaviyo MCP в Claude Code?
Выполните команду claude mcp add klaviyo-mcp -e KLAVIYO_KEY_MAIN=<KLAVIYO_KEY_MAIN> -- npx -y @scalably-io/klaviyo-mcp. Вместо плейсхолдера подставьте ваш приватный API-ключ.
Что делает Klaviyo MCP?
Предоставляет 24 инструмента только для чтения, чтобы просматривать аудитории, письма, метрики, формы и выгружать аналитику рассылок прямо в чат с агентом.
Можно ли подключить сразу несколько брендов?
Да, добавьте дополнительные переменные вида KLAVIYO_KEY_STOREONE, и сервер определит их на старте. После этого передавайте имя аккаунта в параметре инструмента.
