Brevo MCP 服务器
Brevo 在 mcp.brevo.com 提供官方托管的 MCP 服务器,把 27 个模块(联系人、营销活动、交易、模板、WhatsApp、短信等)暴露为任何 AI 代理都能调用的工具。无需本地安装。
Tip
Brevo MCP 服务器基于 Model Context Protocol (MCP),这是 Anthropic 推出的开放标准,用于把 AI 助手连接到外部工具和服务。
快速开始
1. 获取 MCP 令牌
Brevo MCP 使用专用的 MCP 令牌(不是普通的 API 密钥):
- 登录 app.brevo.com
- 进入 Account > SMTP & API > API Keys
- 点击 Generate a new API key,并打开 Create MCP server API key 开关
- 复制令牌并妥善保存
Caution
MCP 令牌拥有对你 Brevo 账号的完整读写权限。切勿提交到版本控制系统,也不要公开分享。
2. 连接 AI 工具
3. 测试连接
连接完成后,向你的 AI 助手提问:
> How many contacts do I have?> Create an email campaign for my product launch> Show me deals in the Negotiation stage> Add a contact to my newsletter list可用服务器
位于 /v1/brevo/mcp 的主服务器包含全部 27 个模块。如果使用场景比较聚焦,可以连接单独的服务器,让 AI 拿到更小、更有针对性的工具集,从而获得更好的回复质量。
主服务器
| 端点 | 说明 |
|---|---|
https://mcp.brevo.com/v1/brevo/mcp | 全部功能合集(27 个模块) |
单独服务器
只连接代理真正需要的模块。缩小工具面能提升 AI 的回复质量。
联系人与 CRM
| 服务器 | 端点 | 用途 |
|---|---|---|
| contacts | /v1/brevo_contacts/mcp | 管理联系人和列表 |
| lists | /v1/brevo_lists/mcp | 管理联系人列表 |
| segments | /v1/brevo_segments/mcp | 管理联系人细分 |
| attributes | /v1/brevo_attributes/mcp | 管理联系人属性 |
| groups | /v1/brevo_groups/mcp | 管理联系人分组 |
| contact_import_export | /v1/brevo_contact_import_export/mcp | 批量导入/导出联系人 |
营销活动与消息
| 服务器 | 端点 | 用途 |
|---|---|---|
| email_campaign_management | /v1/brevo_email_campaign_management/mcp | 创建和管理邮件营销活动 |
| campaign_analytics | /v1/brevo_campaign_analytics/mcp | 查看营销活动效果 |
| templates | /v1/brevo_templates/mcp | 管理邮件模板 |
| transac_templates | /v1/brevo_transac_templates/mcp | 管理事务性邮件模板 |
| sms_campaigns | /v1/brevo_sms_campaigns/mcp | 创建和发送短信营销活动 |
| whatsapp_campaigns | /v1/brevo_whatsapp_campaigns/mcp | 创建和发送 WhatsApp 营销活动 |
| whatsapp_management | /v1/brevo_whatsapp_management/mcp | 配置 WhatsApp 设置 |
销售 CRM
| 服务器 | 端点 | 用途 |
|---|---|---|
| deals | /v1/brevo_deals/mcp | 管理 CRM 交易 |
| companies | /v1/brevo_companies/mcp | 管理 CRM 公司 |
| tasks | /v1/brevo_tasks/mcp | 管理 CRM 任务 |
| pipelines | /v1/brevo_pipelines/mcp | 配置 CRM 流水线 |
| notes | /v1/brevo_notes/mcp | 为联系人和交易添加备注 |
账号与设置
| 服务器 | 端点 | 用途 |
|---|---|---|
| senders | /v1/brevo_senders/mcp | 管理发件人身份 |
| domains | /v1/brevo_domains/mcp | 管理发件域名 |
| ips | /v1/brevo_ips/mcp | 管理独立 IP |
| accounts | /v1/brevo_accounts/mcp | 管理账号和子账号 |
| users | /v1/brevo_users/mcp | 管理用户和权限 |
| webhooks_management | /v1/brevo_webhooks_management/mcp | 配置 Webhook |
| external_feeds | /v1/brevo_external_feeds/mcp | 管理 RSS 订阅源 |
| folders | /v1/brevo_folders/mcp | 用文件夹整理营销活动 |
| processes | /v1/brevo_processes/mcp | 监控后台任务 |
所有端点都使用基础 URL https://mcp.brevo.com。
为代理限定工具范围
对于 Tajo 代理,只连接该代理需要的服务器。这就是权限范围的实现方式:每个代理拿到一组不同的 MCP 服务器。
示例:购物车挽回代理
这个代理只需要联系人、邮件营销活动和短信:
{ "mcpServers": { "brevo_contacts": { "url": "https://mcp.brevo.com/v1/brevo_contacts/mcp", "headers": { "Authorization": "Bearer your-token" } }, "brevo_email": { "url": "https://mcp.brevo.com/v1/brevo_email_campaign_management/mcp", "headers": { "Authorization": "Bearer your-token" } }, "brevo_templates": { "url": "https://mcp.brevo.com/v1/brevo_templates/mcp", "headers": { "Authorization": "Bearer your-token" } }, "brevo_sms": { "url": "https://mcp.brevo.com/v1/brevo_sms_campaigns/mcp", "headers": { "Authorization": "Bearer your-token" } } }}示例:销售 CRM 代理
这个代理只处理交易和公司:
{ "mcpServers": { "brevo_deals": { "url": "https://mcp.brevo.com/v1/brevo_deals/mcp", "headers": { "Authorization": "Bearer your-token" } }, "brevo_companies": { "url": "https://mcp.brevo.com/v1/brevo_companies/mcp", "headers": { "Authorization": "Bearer your-token" } }, "brevo_pipelines": { "url": "https://mcp.brevo.com/v1/brevo_pipelines/mcp", "headers": { "Authorization": "Bearer your-token" } }, "brevo_tasks": { "url": "https://mcp.brevo.com/v1/brevo_tasks/mcp", "headers": { "Authorization": "Bearer your-token" } }, "brevo_notes": { "url": "https://mcp.brevo.com/v1/brevo_notes/mcp", "headers": { "Authorization": "Bearer your-token" } } }}Tajo 如何使用 Brevo MCP
Tajo 位于你的意图和 Brevo MCP 工具之间。编排流程如下:
Marketer Intent "Win back customers who haven't ordered in 90 days" ↓Tajo Agent Layer Selects: Win-Back Agent Agent reads its spec: tools, constraints, strategy ↓Brevo MCP Tools brevo_contacts → find churned customers brevo_segments → create target segment brevo_email → send recovery campaign brevo_sms → SMS follow-up for non-openers ↓Brevo Platform Emails delivered, SMS sent, events tracked每份 Tajo 代理规范都会声明自己需要哪些 Brevo MCP 服务器。编排层只连接这些服务器,从而落实最小权限访问。
故障排查
“Command not found: npx”
安装 Node.js。Claude Desktop 和 Claude Code 都需要 npx mcp-remote 这个桥接程序。
工具没有出现
- 完全重启应用(不只是重新加载)
- 检查 JSON 有没有语法错误(多余的逗号、缺失的括号)
- 确认 MCP 令牌前后没有多余空格
身份验证错误
- 在 Brevo Dashboard > SMTP & API 中确认 MCP 令牌仍然有效
- 确认
Authorization请求头的格式是Bearer <token>,中间有一个空格
后续步骤
- 构建你的第一个代理,用 Brevo MCP 工具打造营销代理
- 代理规范格式,定义具备限定工具权限的自定义代理
- Skills 参考,了解 Tajo Skills 如何在 MCP 工具之上组合
- Brevo 官方文档,完整的 Brevo MCP 文档