charlieai.co  ›  docs  ›  connect your ai

Connect your AI to Charlie

Charlie has no dashboard to learn — your AI is the interface. Claude, ChatGPT, or any MCP-capable client connects to one endpoint and gets 13 typed tools: browse templates, check deliverability, import contacts, activate flows, send campaigns. Setup takes about a minute.

Endpoint: https://charlieai.co/mcp
Transport: Streamable HTTP (MCP spec)
Auth: OAuth 2.1 with PKCE, or an X-Charlie-API-Key header

Step 1 — the free test-send (do this first)

Before any trial or plan, prove the thing that matters: where the mail lands. Test-sends to your own inbox are free forever. Once connected (steps below), say:

Browse Charlie's templates, pick a welcome email that fits my store,
adapt the copy, and send a test to my own inbox.

Then open your inbox and check the tab. That's the product demo. The mechanism behind it is documented, not magic.

Step 2a — Claude (custom connector)

  1. Open Claude → SettingsConnectorsAdd custom connector.
  2. Paste https://charlieai.co/mcp.
  3. Claude runs the OAuth flow: you'll be asked which .myshopify.com workspace to authorize. Allow.
  4. Charlie's 13 tools appear in the connector list. Ask Claude to "list Charlie's tools" to confirm.

Works in Claude on web, desktop, and mobile, and in Claude Code via claude mcp add --transport http charlie https://charlieai.co/mcp.

Step 2b — ChatGPT

  1. Open ChatGPT → SettingsConnectors (enable Developer mode if you don't see the option to add a custom one).
  2. Add a connector with the same endpoint: https://charlieai.co/mcp.
  3. Complete the same OAuth flow, authorizing your Shopify workspace.
  4. Enable the connector in a conversation and ask it to list Charlie's templates.

Step 2c — API key (custom agents, scripts, testing)

For integrations that can't do OAuth, request an API key from hello@charlieai.co and pass it as a header on every request — no OAuth dance:

curl https://charlieai.co/mcp \
  -X POST \
  -H 'X-Charlie-API-Key: <your-key>' \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

OAuth discovery for client authors follows the standards: /.well-known/oauth-authorization-server (RFC 8414) and /.well-known/oauth-protected-resource (RFC 9728).

What your AI can do once connected

Free (read scope)Trial / paid (write scope)
Browse & search all 448 templatesSend campaigns
Read the four flow blueprintsActivate / pause flows
Check workspace status & deliverabilityCreate / import contacts
Review campaign history
Test-sends to your own inbox

Every write call is recorded in an audit log — you can always see what your AI did, when, with which token. Full tool reference: MCP docs.

Things worth knowing


Home · Template library · FAQ · How sending works · Pricing · Migrate from Klaviyo · MCP · vs Klaviyo · vs Mailchimp · vs Omnisend · Privacy · DPA · Terms