Braze MCP 用 mcp.braze.com/mcp,再完成 OAuth
官方已验证 OpenAI Codex。mcp add braze --url https://mcp.braze.com/mcp。URL 带 /mcp。OAuth DCR,不要 API key。欧盟用 mcp.braze.eu/mcp。不要发明 plugin add braze@。本地 beta 已弃用。
Braze 官方已验证 OpenAI Codex。主路径是远程 Streamable HTTP + OAuth,客户端自己做 Dynamic Client Registration,不要 client ID、client secret 或 API key。安装页把 Codex 指到官方 MCP 文档,CLI 写成:
codex mcp add braze --url https://mcp.braze.com/mcp
codex mcp login braze
手册表名用 braze。远程 URL 是 https://mcp.braze.com/mcp,带 /mcp 后缀。欧盟账号用 https://mcp.braze.eu/mcp;非欧盟可以用美区或欧盟,任一入口都能打到各集群。mcp add 写进用户层 ~/.codex/config.toml。只写进了表、浏览器没弹时再跑 codex mcp login braze。
桌面 / IDE:Settings → MCP servers → Add server,传输选 Streamable HTTP,URL 填上面那条。Bearer token env var 和 Headers 留空。第一次用工具时会打开浏览器,用平时的 Braze 账号登录,含 SSO / SAML。
[mcp_servers.braze]
url = "https://mcp.braze.com/mcp"
enabled = true
公司管理员先在 Settings → Admin Settings → OAuth 打开 MCP OAuth。用户还要有 Use MCP Server 权限,默认没有。权限跟着仪表盘账号走:你在仪表盘看不到的,代理也看不到。开了 IP allowlisting 的账号现在用不了远程 MCP。
多 workspace 时在提示里写出仪表盘上的准确名字。不确定就先问可用 workspace,走 get_workspaces。公司是第一次授权时定的;要换同一集群的另一家公司,先在客户端断开 Braze 再重新 login。
本地 beta(本机装包 + API key)已经弃用,不要当主路径。远程和本地可以短暂并存,迁完关掉本地。不要发明 codex plugin add braze@…。不要抄 Claude 的 --transport http、Cursor JSON 或 ChatGPT Developer Mode 自定义 connector。不要给这台 bearer_token_env_var。工具不返回用户档案 PII。
先只读:问列出这个 workspace 可用的 Braze 工具,或列出 Production workspace 最近的 Canvas。创建邮件模板、改 Canvas、发信会动账号,保持工具批准。官方也不要用客户端的 auto-mode。不要一上来 --yolo。不要 required = true。
不要做这些:
- 不要发明
codex plugin add braze@openai-curated。 - 不要抄 Claude 的
--transport http或 Cursor JSON。 - 不要把 API key 写进
env表、http_headers或 URL。 - 不要给它
required = true挂全局。
网页 Cloud 不读 ~/.codex/config.toml。改完彻底新开会话。用 codex mcp get braze 看传输是 streamable_http。会话里 /mcp 应显示 Auth: OAuth。