On this page

Brevo MCP 服务器

Brevo 在 mcp.brevo.com 提供官方托管的 MCP 服务器，暴露 27 个模块, 联系人、营销活动、商机、模板、WhatsApp、短信等, 作为任何 AI 代理都能调用的工具。无需本地安装。

Tip

Brevo MCP 服务器使用模型上下文协议 (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 工具

添加到 Claude Desktop 配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "brevo": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.brevo.com/v1/brevo/mcp",
        "--header",
        "Authorization: Bearer ${BREVO_MCP_TOKEN}"
      ],
      "env": {
        "BREVO_MCP_TOKEN": "paste-your-mcp-token-here"
      }
    }
  }
}

保存后重启 Claude Desktop。需要已安装 Node.js。

添加到 ~/.claude/config.json：

{
  "mcpServers": {
    "brevo": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.brevo.com/v1/brevo/mcp",
        "--header",
        "Authorization: Bearer ${BREVO_MCP_TOKEN}"
      ],
      "env": {
        "BREVO_MCP_TOKEN": "paste-your-mcp-token-here"
      }
    }
  }
}

使用以下命令验证：

claude mcp list

添加到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（每个项目）：

{
  "mcpServers": {
    "brevo": {
      "url": "https://mcp.brevo.com/v1/brevo/mcp",
      "headers": {
        "Authorization": "Bearer paste-your-mcp-token-here"
      }
    }
  }
}

添加到 .vscode/mcp.json（每个项目）或用户级 mcp.json：

{
  "servers": {
    "brevo": {
      "type": "http",
      "url": "https://mcp.brevo.com/v1/brevo/mcp",
      "headers": {
        "Authorization": "Bearer paste-your-mcp-token-here"
      }
    }
  }
}

添加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "brevo": {
      "serverUrl": "https://mcp.brevo.com/v1/brevo/mcp",
      "headers": {
        "Authorization": "Bearer paste-your-mcp-token-here"
      }
    }
  }
}

3. 测试连接

连接后，向您的 AI 助手询问：

> 我有多少联系人？
> 为我的产品发布创建邮件营销活动
> 显示谈判阶段的商机
> 将联系人添加到我的新闻通讯列表

可用服务器

/v1/brevo/mcp 处的主服务器包含所有 27 个模块。

主服务器

端点	描述
`https://mcp.brevo.com/v1/brevo/mcp`	所有功能合并（27 个模块）

单独服务器

联系人和 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`	管理邮件模板
sms_campaigns	`/v1/brevo_sms_campaigns/mcp`	创建和发送短信营销活动
whatsapp_campaigns	`/v1/brevo_whatsapp_campaigns/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`	为联系人和商机添加备注

故障排查

”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 工具构建营销代理
代理规范格式, 定义具有范围工具访问的自定义代理
Brevo 官方文档, 完整的 Brevo MCP 文档

Brevo MCP 服务器