内容
# Brevo MCP 服务器
[](https://www.npmjs.com/package/@houtini/brevo-mcp)
[](https://www.npmjs.com/package/@houtini/brevo-mcp)
[](https://opensource.org/licenses/MIT)
[](https://github.com/houtini-ai/brevo-mcp/issues)
[](https://github.com/houtini-ai/brevo-mcp/stargazers)
Brevo 电子邮件营销平台的 MCP（模型上下文协议）服务器，具有全面的活动管理、分析和自动化功能。
<p align="center">
<a href="https://glama.ai/mcp/servers/@houtini-ai/brevo-mcp">
<img width="380" height="200" src="https://glama.ai/mcp/servers/@houtini-ai/brevo-mcp/badge" alt="Brevo MCP 服务器" />
</a>
</p>
## 🚀 主要功能
### 📧 **活动管理**
- **创建**具有 A/B 测试和分段的复杂电子邮件活动
- **更新**活动内容、收件人和发送时间
- **发送**活动立即或安排在最佳时间
- **测试**活动使用预配置的测试列表在全发送前
- **控制**活动状态（暂停、恢复、存档、复制）
- **分享**活动模板通过唯一 URL
### 📊 **高级分析**
- **活动性能** - 打开率、点击率、退信分析
- **联系人参与度** - 跟踪订阅者行为和偏好
- **比较分析** - 与行业平均值对比
- **实时洞察** - 改进的 AI 驱动建议
- **收件人级别的数据** - 单个交互的粒度跟踪
### 🔧 **自动化和集成**
- **事务性电子邮件** - 通过 API 发送个性化电子邮件
- **模板管理** - 使用和分享电子邮件模板
- **联系人分段** - 针对特定受众群体
- **智能发送时间** - 优化发送以获得最大参与度
- **UTM 跟踪** - 与分析平台集成
### 🎯 **智能功能**
- **测试列表集成** - 安全的测试工作流与预配置的测试列表
- **IP 预热** - 逐渐增加发送量
- **A/B 测试** - 测试主题行和内容变化（商业/企业计划仅限）
- **最佳发送时间** - 每个收件人的 AI 优化发送时间
- **列表管理** - 动态包含/排除列表
- **批量操作** - 高效处理数千个联系人
## 活动工作流
### 推荐的活动测试和发送流程
1. **在 Brevo 中设置测试列表**
- 在 [Brevo 设置](https://my.brevo.com/users/settings) 中配置测试列表
- 将测试电子邮件地址添加到列表中
- 这是一次性设置
2. **创建活动**
```javascript
使用：create_email_campaign
- 设置名称、主题
- 添加 HTML 内容或模板
- 配置收件人列表
- 发送者自动检测（或指定自定义）
```
3. **测试活动**
```javascript
使用：send_test_email
- 仅提供 campaignId
- 自动发送到您的测试列表
- 查看测试电子邮件
```
4. **更新如果需要**
```javascript
使用：update_email_campaign
- 修改内容、主题等
- 根据需要重新测试
```
5. **发送活动**
```javascript
使用：send_campaign_now
- 发送到所有配置的收件人
- 或使用 scheduledAt 参数安排
```
### 重要注意事项
- **测试列表**：MCP 假设您在 Brevo 中有一个预配置的测试列表
- **send_test_email**：默认发送到您的测试列表（省略 emailTo 参数）
- **安全性**：始终在发送到实际收件人之前进行测试
- **无重复**：Brevo API 中不提供重复活动功能
## 安装
### 快速入门
1. **通过 npm 安装：**
```bash
npm install -g @houtini/brevo-mcp
```
2. **配置 Claude Desktop：**
将以下内容添加到您的 `claude_desktop_config.json`：
```json
{
"mcpServers": {
"brevo": {
"command": "npx",
"args": ["-y", "@houtini/brevo-mcp"],
"env": {
"BREVO_API_KEY": "您的 Brevo API 密钥"
}
}
}
}
```
3. **重启 Claude Desktop**
### 手动安装
1. 克隆此仓库：
```bash
git clone https://github.com/houtini-ai/brevo-mcp.git
cd brevo-mcp
npm install
npm run build
```
2. 添加到 Claude Desktop 配置：
```json
{
"mcpServers": {
"brevo": {
"command": "node",
"args": ["C:/path/to/brevo-mcp/dist/index.js"],
"env": {
"BREVO_API_KEY": "您的 Brevo API 密钥"
}
}
}
}
```
## 配置
### 环境变量
- `BREVO_API_KEY` - 您的标准 Brevo v3 API 密钥（必填）
- 必须是以 `xkeysib-` 开头的标准 API 密钥
- 在 Brevo 仪表板 → 设置 → API 密钥中找到
- 注意：MCP 特定 API 密钥将在未来版本中支持
- `BREVO_BASE_URL` - 自定义 API 基本 URL（可选，默认为 https://api.brevo.com/v3）
### 获取您的 API 密钥
1. 登录您的 [Brevo 账户](https://app.brevo.com)
2. 进入 设置 → API 密钥
3. **使用标准 API 密钥**（不是 MCP API 密钥）
- 标准 v3 API 密钥以 `xkeysib-` 开头
- MCP API 密钥支持将在未来版本中添加
4. 创建新的 API 密钥或复制现有的一个
5. **重要**：您可能需要在 Brevo 的安全设置中允许您的 IP 地址
## 📮 发送者配置
### 智能发送者管理
MCP 自动检测并使用您的已验证发送者，使活动创建更简单、更安全：
#### **默认行为**
- **自动检测**：如果未指定发送者，MCP 自动使用您现有的已验证发送者
- **智能备用**：首先检查已发送的活动，然后检查草稿活动（如果需要）
- **安全第一**：所有测试电子邮件都使用已验证的发送者以防止交付问题
#### **工作原理**
```javascript
// 选项 1：自动检测发送者（推荐）
create_email_campaign({
name: "我的活动",
subject: "你好，世界",
htmlContent: "<h1>内容</h1>"
// 不需要发送者 - 自动使用已验证的发送者
})
// 选项 2：按 ID 指定发送者（用于特定的 IP 池）
create_email_campaign({
name: "我的活动",
subject: "你好，世界",
htmlContent: "<h1>内容</h1>",
sender: {
name: "自定义名称",
id: 2 // 您的 Brevo 发送者 ID
}
})
// 选项 3：按电子邮件指定发送者（必须已验证）
create_email_campaign({
name: "我的活动",
subject: "你好，世界",
htmlContent: "<h1>内容</h1>",
sender: {
name: "自定义名称",
email: "verified@yourdomain.com"
}
})
```
#### **查找您的发送者 ID**
要查找您的发送者 ID，请查看任何现有的活动：
```javascript
get_email_campaigns({ limit: 1 })
// 响应包含：sender: { id: 2, email: "...", name: "..." }
```
#### **重要注意事项**
- **仅限已验证的发送者**：电子邮件地址必须在 Brevo 中验证后才能使用
- **测试电子邮件**：始终从已验证的发送者发送以确保可靠性
- **IP 池**：使用发送者 ID（不是电子邮件）如果您有专用 IP 池
- **首次设置**：在 Brevo 仪表板中创建至少一个活动以建立已验证的发送者
## 🎯 快速入门指南
配置完成后，尝试以下命令来开始：
1. **检查您的设置**： "显示我的 Brevo 账户信息"
2. **查看活动**： "列出我的电子邮件活动"
3. **创建活动**： "创建一个名为‘新闻通讯’的新电子邮件活动"
4. **发送测试**： "为活动 ID 123 发送测试电子邮件"
5. **检查性能**： "显示我本周的活动分析"
6. **管理活动**： "暂停活动 ID 456"
MCP 服务器理解自然语言，因此您可以以对话方式表达您的请求！
## 可用工具
### 📋 账户和联系人
- **`get_account_info`** - 查看账户详细信息、计划、积分和功能
- **`get_contacts`** - 列出、搜索和过滤联系人，支持分页
- **`get_contact_analytics`** - 分析联系人参与度和活动历史
### 📧 活动创建和管理
- **`create_email_campaign`** - 创建活动，支持丰富的配置选项
- HTML 内容、模板或外部 URL
- 列表定位，支持包含/排除规则
- A/B 测试和发送时间优化
- 调度和自动化触发器
- **`update_email_campaign`** - 修改现有活动的任意方面
### 🚀 活动投递
- **`send_campaign_now`** - 立即向收件人发送活动
- **`send_test_email`** - 使用特定电子邮件地址测试活动
- **`update_campaign_status`** - 控制活动状态：
- `suspended` - 暂停发送
- `archive`/`darchive` - 存档或恢复
- `queued` - 加入发送队列
- `replicate` - 创建可编辑副本
### 📊 分析和洞察
- **`get_email_campaigns`** - 列出活动，支持按状态/类型筛选
- **`get_campaign_analytics`** - 特定活动的详细指标：
- 投递、打开和点击率
- 退信和取消订阅分析
- 地理和设备分析
- **`get_campaigns_performance`** - 比较多个活动：
- 性能评分和排名
- 时间趋势分析
- 顶级活动识别
- **`get_analytics_summary`** - 全面的仪表板视图：
- 账户范围的统计数据
- 时间段比较
- AI 驱动的洞察和建议
- **`get_campaign_recipients`** - 收件人级别的参与度数据
### 📨 事务性电子邮件
- **`send_email`** - 发送个性化的事务性电子邮件：
- 基于模板或自定义 HTML
- 动态个性化
- 附件支持
- 回复跟踪
### 🎨 模板管理
- **`get_shared_template_url`** - 生成可分享的模板链接
## 使用示例
### 活动创建工作流
```
用户： "为我们的黑色星期五促销活动创建一个新的电子邮件活动"
助手： "我将创建黑色星期五活动。您的发送者电子邮件和目标列表是什么？"
用户： "使用 marketing@company.com 并发送到列表 ID 5"
助手： [创建具有专业模板和调度选项的活动]
```
### 活动管理
```
用户： "更新我们的新闻通讯活动，添加新内容"
助手： [更新活动内容和配置]
用户： "在下周二上午 10 点安排它"
助手： [更新活动为最佳发送时间]
用户： "先发送 team@company.com 的测试邮件"
助手： [发送测试电子邮件进行审查]
```
### 分析和洞察
```
用户： "我们的电子邮件活动这个季度表现如何？"
助手： [显示综合指标和趋势以及建议]
用户： "哪些活动的参与度最高？"
助手： [显示表现最佳的活动，详细分析]
```
### 高级操作
```
用户： "暂停所有活跃的活动"
助手： [更新所有正在运行的活动状态]
用户： "为我们的欢迎电子邮件创建 A/B 测试"
助手： [设置具有主题行变化的分裂测试 - 需要商业/企业计划]
```
## 功能参考
### 活动创建参数
创建活动时，您可以指定：
- **内容选项**
- `htmlContent` - 直接 HTML 内容
- `htmlUrl` - 从 URL 获取 HTML
- `templateId` - 使用现有的 Brevo 模板
- **收件人配置**
- `listIds` - 目标特定列表
- `exclusionListIds` - 排除特定列表
- `segmentIds` - 使用动态分段
- **高级功能**
- `scheduledAt` - 指定时间安排
- `sendAtBestTime` - AI 优化的投递
- `abTesting` - 启用分段测试（需要商业/企业计划）
- `ipWarmupEnable` - 逐渐增加流量
- `utmCampaign` - 分析跟踪
### 活动状态值
使用以下状态选项控制您的活动：
- `suspended` - 暂时暂停发送
- `archive` - 移到存档（从主视图隐藏）
- `darchive` - 从存档恢复
- `queued` - 添加到发送队列
- `sent` - 标记为已发送
- `replicate` - 创建可编辑副本
### 分析周期
可用的分析时间范围：
- `today` - 今日统计数据
- `yesterday` - 前一日指标
- `last7days` - 截至今日的周统计
- `last30days` - 截至今日的月统计
- `custom` - 指定确切日期范围
### 性能指标
跟踪这些关键绩效指标：
- **投递指标**：已发送、已投递、退信
- **参与度指标**：打开、点击、转发
- **列表健康度**：取消订阅、投诉、列表增长
- **比较分析**：行业基准、趋势分析
## 故障排除
### 服务器无法启动
- 确保已安装 Node.js 18+
- 检查日志：`%APPDATA%\Claude\logs\mcp-server-brevo.log`
### API 密钥问题
- 服务器在没有 API 密钥的情况下启动，但会在需要时提示您
- 将密钥添加到您的 Claude 配置并重启 Claude Desktop
- 如果您遇到身份验证错误，请确保您的 IP 地址已在 Brevo 的安全设置中允许
### 常见错误
- **401 未授权**：检查 API 密钥和 IP 白名单（Brevo）
- **429 请求过多**：您已超出 Brevo 的 API 请求限制
- **404 未找到**：资源不存在或端点不正确
## 开发
### 从源代码构建
```bash
npm install
npm run build
npm test
```
### 运行测试
```bash
# 不使用 API 密钥进行测试
npm test
# 使用 API 密钥进行测试
BREVO_API_KEY=您的密钥 npm test
```
## 许可证
MIT © Houtini Ltd
## 支持
- 问题： [GitHub 问题](https://github.com/houtini-ai/brevo-mcp/issues)
- 电子邮件： brevo@houtini.ai
- 文档： [Brevo API 文档](https://developers.brevo.com/reference)
