用途:通过 Composio 的 Klaviyo 工具包(经 Rube MCP)自动化 Klaviyo 邮件与短信营销操作,包括管理活动、查看活动消息、跟踪标签和监控发送任务。工具包文档见 composio.dev/toolkits/klaviyo。
前提条件:Rube MCP 必须已连接(RUBE_SEARCH_TOOLS 可用);需通过 RUBE_MANAGE_CONNECTIONS 建立 toolkit 为 klaviyo 的有效连接;每次操作前应先调用 RUBE_SEARCH_TOOLS 获取当前工具结构。
设置:在客户端配置中添加 MCP 服务器 https://rube.app/mcp,无需 API 密钥;确认 RUBE_SEARCH_TOOLS 有响应;调用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit klaviyo;若连接非 ACTIVE,按返回的授权链接完成 Klaviyo 认证;确认状态为 ACTIVE 后再运行工作流。
主要能力与用法:
- 列出与筛选活动:KLAVIYO_GET_CAMPAIGNS,参数含 channel(email 或 sms,必填)、filter、sort、page_cursor、include_archived。需分页遍历 page_cursor 获取全部结果,状态过滤可能返回混合状态,应客户端校验 data[].attributes.status。
- 获取活动详情:先 KLAVIYO_GET_CAMPAIGNS 取 ID,再 KLAVIYO_GET_CAMPAIGN,参数 campaign_id、include_messages、include_tags。
- 查看活动消息:先取活动与消息 ID,再 KLAVIYO_GET_CAMPAIGN_MESSAGE,参数 id、fields__campaign__message 等稀疏字段集,include 可含 campaign、template。
- 管理活动标签:KLAVIYO_GET_CAMPAIGN_RELATIONSHIPS_TAGS,参数 id,仅返回标签 ID。
- 监控发送任务:KLAVIYO_GET_CAMPAIGN_SEND_JOB,参数 id,查看排队、进行中、完成或失败状态。
限制与注意事项:Klaviyo 使用版本化端点,响应结构可能随版本变化;数据嵌套为 response.data.data[].attributes;状态字符串区分大小写且可能为复合值;速率限制为突发 10/s(标签端点 3/s)、稳定 150/m(标签端点 60/m),需对 429 实现退避;所需权限范围为 campaigns:read。分页为游标式,默认每页约 10 条。