如何通过 MCP 将 Braze 连接到 Cursor

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Braze、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Braze + Cursor

让你的 AI 使用 Braze：查看营销活动、Canvas 及其效果，检查分段、日活跃用户和收入，查询用户档案和订阅，记录属性和事件，并在你确认后触发 API 营销活动。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

BRAZE_REST_ENDPOINT, BRAZE_REST_API_KEY

步骤 1 — 获取凭证

1. 在 Braze 中打开 Settings → APIs and Identifiers → API Keys，点击 Create API Key。一个密钥只属于一个工作区。
2. 为它命名，并勾选工具需要的权限。读取需要：campaigns.list, campaigns.details, campaigns.data_series, sends.data_series, canvas.list, canvas.details, canvas.data_summary, segments.list, segments.details, segments.data_series, kpi.dau.data_series, kpi.mau.data_series, kpi.new_users.data_series, kpi.uninstalls.data_series, events.list, events.data_series, purchases.product_list, purchases.quantity_series, purchases.revenue_series, subscription.status.get, subscription.groups.get, users.export.ids。写入还需要 users.track, campaigns.trigger.send, canvas.trigger.send；只有要开启删除工具时才加上 users.delete。密钥的权限之后无法修改：如有需要，请新建一个密钥。
3. 把密钥复制到 BRAZE_REST_API_KEY，不要带 Bearer 前缀。
4. 把同一页面上显示的 REST endpoint 复制到 BRAZE_REST_ENDPOINT。它取决于你的 Braze 实例，并与仪表板地址对应：dashboard-01.braze.com 对应 https://rest.iad-01.braze.com，dashboard-01.braze.eu 对应 https://rest.fra-01.braze.eu，以此类推。美国实例运行在 rest.iad-01 到 rest.iad-08 以及 rest.us-10（.braze.com），欧盟实例运行在 rest.fra-01 和 rest.fra-02（.braze.eu），其他实例运行在 rest.au-01、rest.id-01、rest.jp-01 和 rest.kr-01（.braze.com）。密钥只能在自己的实例上使用。
5. 安装连接器。连接检查会列出你的营销活动，所以密钥需要 campaigns.list。

谁能看到什么：密钥代表整个工作区，而不是某个人。使用该连接器的人能看到密钥可读取的一切，包括用户档案。请只把 MCP 服务器分享给有权查看这些内容的人。

可读取的内容：营销活动和 Canvas 的设置、消息和每日效果（发送、送达、打开、点击、转化、收入），某一次通过 API 触发的发送的效果（保留 14 天），分段及其估算规模（适用于开启了分析跟踪的分段），日活跃和月活跃用户、新用户和卸载数，自定义事件、购买和收入，按 external id、别名、braze_id、邮箱或电话查询的用户档案，以及订阅组状态。时间序列覆盖 1 到 100 天，Canvas 汇总覆盖 1 到 14 天。

先确认：braze_track_users 每次最多记录 75 条属性、自定义事件和购买，并可能把用户带入分段或启动 Canvas，因此 AI 会先给你看改动并等你确认。braze_send_campaign 和 braze_send_canvas 会触发向真实的人发送真实消息的 API 营销活动和 Canvas：AI 会给你看营销活动或 Canvas、渠道以及具体收件人；如果是广播或多个收件人，它会等你明确回复“是的，发送”。braze_delete_users 在安装时默认关闭。

限制：大多数端点每小时允许 250,000 次请求。读取用户档案：2024 年 8 月以后开通的工作区每分钟 250 次（之前开通的为 2,500 次）；自定义事件列表和产品列表共享每小时 1,000 次；发送端点每分钟允许 250 次广播调用，每个受众每分钟 10 次。达到限制时 Braze 返回 429。

常见错误：401 "Invalid API key"：密钥错误或属于另一个实例；请检查 REST endpoint 是否与你的仪表板对应。403 "Access Denied"：密钥缺少该端点的权限，请新建一个具备该权限的密钥。400：缺少参数或参数无效，例如时长超出范围或营销活动 id 未知。429：达到速率限制；请稍等后重试一次。

该连接器不涉及内容块和模板、目录、邮件列表和硬退信、预定消息、偏好中心、SCIM、用户别名和 identify 端点、向云存储导出分段以及 Currents。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Cursor 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目：

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 Cursor。
3. 打开 Cursor → Settings → MCP，确认 anythingmcp 已列出并处于已连接状态。
4. 开始对话，智能体现在可以调用 Braze 的工具。

可用工具

示例提示

• “过去 30 天我们发送了哪些营销活动？哪一个的打开率和点击率最高？”
• “上周有多少用户进入了我们的新手引导 Canvas？每一步各有多少人转化？”
• “给我看过去 60 天的日活跃用户和新用户。”
• “为 external_id 为 4821 的用户记录自定义事件 webinar_attended，写入前先给我看要写的内容。”

FAQ

Cursor 免费套餐支持自定义 MCP 服务器吗？ 支持，Hobby、Pro 和 Business 套餐均可使用 MCP。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT