Klaviyo MCP 用 mcp.klaviyo.com/mcp,再完成 OAuth

官方页没有 Codex 专节。对照 Other Clients:mcp add klaviyo --url https://mcp.klaviyo.com/mcp。URL 带 /mcp。OAuth DCR,浏览器没弹再 mcp login klaviyo。不要发明 plugin add klaviyo@。不要抄 Cursor JSON。

Klaviyo 官方安装页列了 Claude、ChatGPT App、ChatGPT Custom MCP、Cursor JSON、VS Code JSON 和 Other Clients,没有 Codex 专节。不要把 Cursor 的 mcpServers JSON 或 Claude 的 --transport http 抄进来。对照 Other Clients:远程 URL 是 https://mcp.klaviyo.com/mcp,鉴权是 OAuth + Dynamic Client Registration,传输是 Streamable HTTP。Codex 主路径自己 add

codex mcp add klaviyo --url https://mcp.klaviyo.com/mcp
codex mcp login klaviyo

官方 Cursor JSON 表名就是 klaviyo,手册 CLI 也用这个。URL 带 /mcp 后缀,不要写成光 https://mcp.klaviyo.com,也不要把文档站 https://developers.klaviyo.com/mcp 当成 MCP 入口。mcp add 写进用户层 ~/.codex/config.toml。只写进了表、浏览器没弹时再跑 codex mcp login klaviyo

[mcp_servers.klaviyo]
url = "https://mcp.klaviyo.com/mcp"
enabled = true

账号角色要 Owner、Admin 或 Manager。默认会拉很多工具;窗口小或选工具不准时,把查询参数写进 url,不要另开配置键:

[mcp_servers.klaviyo]
url = "https://mcp.klaviyo.com/mcp?read-only=true&core-tools-only=true"
enabled = true

常用查询参数:

  • read-only=true:关掉会改账号的工具。默认是 false,建议先只读。
  • core-tools-only=true:大约 40 个核心工具。ChatGPT 默认 true,Codex 默认 false。
  • disable-tools-with-user-generated-content=true:关掉会读用户生成内容的工具。
  • include-output-schemas=false:工具列表里不带 output schema。ChatGPT 默认 false。
  • beta=true:打开可能不稳的新工具。
  • toolsets=profiles:read,campaigns:read:只暴露所需 API scope 都被覆盖的工具,格式是 resource:access
  • company=example-company:多账号时钉住公司名。Claude listed connector 和 ChatGPT App 控不了查询参数;Codex 手写 url 可以。

机构文档也用 https://mcp.klaviyo.com/mcp?company=example-company。空格要编码。每个账号一张表、各跑一次 mcp login,不要指望一台服务器同时挂所有客户。

不要发明 codex plugin add klaviyo@…。官方没给出 Codex marketplace id。不要抄 ChatGPT Developer Mode 的自定义 app。不要抄 npx mcp-remote。不要给这台 bearer_token_env_var

本地 uvx klaviyo-mcp-server@latest 不是主路径。网页客户端本来就该走远程。本地才要 PRIVATE_API_KEY;官方示例把密钥写进 env 表,Codex 改成 env_vars,不要字面量。READ_ONLYALLOW_USER_GENERATED_CONTENT 也只转发名字。Codex 不读 .env

先只读:问最近 30 天邮件活动表现,或哪些 flow 转化最好。改营销、改流程、发信会动账号,保持工具批准。不要一上来 --yolo。不要 required = true

不要做这些:

  • 不要发明 codex plugin add klaviyo@openai-curated
  • 不要抄 Claude 的 --transport http 或 Cursor JSON。
  • 不要把 PRIVATE_API_KEY 写进 env 表、http_headers 或 URL。
  • 不要给它 required = true 挂全局。

网页 Cloud 不读 ~/.codex/config.toml。改完彻底新开会话。用 codex mcp get klaviyo 看传输是 streamable_http。会话里 /mcp 应显示 Auth: OAuth。

来源