内容
# Klaviyo MCP 服务器
**适用于 Claude 的电子邮件营销操作** — 通过自然语言控制 Klaviyo 配置文件、活动、流程、列表、细分、指标和模板。
由 [Md Rakibul Islam](https://mrakibulislam.com) 构建 · [mrakibulislam.com/mcp-tools/klaviyo](https://mrakibulislam.com/mcp-tools/klaviyo)
---
## 功能
连接 Claude 到您的 Klaviyo 账户，并询问以下问题：
- *"显示本周所有已安排的活动"*
- *"我的黑色星期五活动的打开率和收入是多少？"*
- *"查找流失概率超过 70% 的客户"*
- *"暂停欢迎系列流程"*
- *"跟踪此客户的 '订阅续期' 事件"*
- *"列出所有细分群体并找到针对 VIP 购买者的细分群体"*
## 工具（共 17 个）
### 配置文件
| 工具 | 描述 |
|---|---|
| `klaviyo_search_profiles` | 按电子邮件、电话号码或自定义筛选条件搜索 |
| `klaviyo_get_profile` | 包含 CLV 和流失概率的完整配置文件 |
| `klaviyo_update_profile` | 更新联系人详细信息和自定义属性 |
### 活动
| 工具 | 描述 |
|---|---|
| `klaviyo_list_campaigns` | 按状态筛选的活动列表（草稿/已安排/已发送） |
| `klaviyo_get_campaign` | 活动详情和发送策略 |
| `klaviyo_get_campaign_report` | 打开、点击、收入、转化率等统计数据 |
### 流程
| 工具 | 描述 |
|---|---|
| `klaviyo_list_flows` | 按状态列出的自动化流程 |
| `klaviyo_get_flow` | 流程详情和触发器类型 |
| `klaviyo_update_flow_status` | 暂停、恢复或草稿流程 |
| `klaviyo_get_flow_report` | 每个流程的性能统计数据 |
### 列表和细分
| 工具 | 描述 |
|---|---|
| `klaviyo_list_lists` | 所有订阅者列表 |
| `klaviyo_get_list` | 单个列表详情 |
| `klaviyo_create_list` | 创建新列表 |
| `klaviyo_add_profiles_to_list` | 将配置文件订阅到列表 |
| `klaviyo_list_segments` | 所有细分群体及其处理状态 |
| `klaviyo_get_segment` | 单个细分群体详情 |
### 指标和事件
| 工具 | 描述 |
|---|---|
| `klaviyo_list_metrics` | 所有跟踪的指标及其 ID |
| `klaviyo_get_metric_aggregate` | 任意指标的时间序列数据 |
| `klaviyo_get_profile_events` | 配置文件的事件历史 |
| `klaviyo_create_event` | 跟踪自定义事件以触发流程 |
### 模板
| 工具 | 描述 |
|---|---|
| `klaviyo_list_templates` | 所有电子邮件模板 |
| `klaviyo_get_template` | 带有 HTML 预览的模板 |
---
## 设置
### 1. 获取您的 Klaviyo API 密钥
Klaviyo → 设置 → API 密钥 → 创建私有 API 密钥
所需最小范围：
- 配置文件：读取 + 写入
- 活动：读取
- 流程：读取 + 写入
- 列表：读取 + 写入
- 细分：读取
- 指标：读取
- 事件：读取 + 写入
- 模板：读取
### 2. 配置 Claude 桌面版
添加到 `claude_desktop_config.json`：
```json
{
"mcpServers": {
"klaviyo": {
"command": "npx",
"args": ["klaviyo-mcp-server"],
"env": {
"KLAVIYO_API_KEY": "pk_your_private_key_here"
}
}
}
}
```
### 3. 或使用 Docker 运行
```bash
docker run -e KLAVIYO_API_KEY=pk_your_key -e TRANSPORT=http -p 3000:3000 klaviyo-mcp-server
```
---
## 环境变量
| 变量 | 是否必需 | 描述 |
|---|---|---|
| `KLAVIYO_API_KEY` | 是 | Klaviyo 私有 API 密钥 |
| `TRANSPORT` | 否 | `stdio`（默认）或 `http` |
| `PORT` | 否 | HTTP 端口（默认：3000） |
---
## 许可证
MIT
