This tutorial wires Klaviyo into the BoostEcom platform end-to-end. After 5 minutes Klaviyo will appear under @Otis's connectors and you'll be able to ask things like "draft a 5-email welcome flow for new subscribers" or "audit my abandoned-cart series and tell me where it's leaking".
1. Open the connectors page
Inside your BoostEcom org, navigate to:
[orgSlug]/[storeSlug]/settings/connectors
Click Add connector and pick Klaviyo from the list.
2. Authorize the OAuth flow
You'll be redirected to Klaviyo's OAuth consent screen. The scopes we request are deliberate:
lists:read+lists:write: read your segments and create new onesflows:read+flows:write: read flows and draft / pause / resumecampaigns:write— send campaigns @Otis drafts (with your approval)metrics:read— read open / click / revenue metrics for the dashboard
Approve. You'll land back on the connectors page with a green "Connected" badge next to the Klaviyo row.
3. Verify the connection
Open the chat and type:
@Atlas, ask Otis to list my live Klaviyo flows.
@Otis will return the flows by name with their status (live / draft / archived) and the open rate of the last 30 days. If you see the list, the connection is healthy.
4. Draft your first flow
Now ask:
@Atlas, ask Otis to draft a 5-email welcome flow for new subscribers, branded for our brand voice.
@Otis will produce the flow as a structured artifact you can review inside the chat. Click Stage in Klaviyo to push it as a draft: nothing goes live without your explicit approval.
Common gotchas
- Klaviyo private API keys are not enough. The BoostEcom MCP
surface needs OAuth, not the long-lived API key. Don't paste a
pk_*key into the connector form. - Sandbox accounts work. If you want to test before wiring your prod account, create a Klaviyo sandbox first and connect that.
- Per-store scoping. Each store in your BoostEcom org gets its own Klaviyo connection. Connecting at the org level is not yet supported (planned for v0.0.9).