Developers & AI
Tutorial: First AI theme in 10 minutes
End-to-end path: console app → OAuth → context → draft theme → preview — without publishing.
Goal: connect an AI client and produce a private draft theme you can preview — without going live. Time: about 10 minutes if OAuth redirects are already correct.
Step 1 — Console: Sign in as the merchant → /dashboard/developer → Create app. Enable Claude and Cursor redirect presets → Create application → Copy Client ID and secret (once).
Step 2 — Connect: In Claude or Cursor, add Ettajer MCP at https://www.ettajer.com/api/v1/mcp with those credentials. Complete OAuth; approve theme scopes without themes:publish.
Step 3 — Context: Ask the agent to call get_context (or GET /api/v1/context). Confirm the store name and that workflow.next suggests a sensible next action.
Step 4 — Schema: Call get_theme_schema so the agent knows allowed sections and settings.
Step 5 — Draft: If no draft exists, create_theme with a clear name (for example Atlas Editorial). Reuse an existing draft from context when present.
Step 6 — Design: apply_theme_batch or update_section for a hero (headline, CTA). Keep changes presentation-only.
Step 7 — Preview: preview_theme and open the signed previewUrl on desktop and mobile. Iterate if needed.
Step 8 — Stop before publish: Do not call publish_theme. Open Dashboard → Themes → AI Designs and publish yourself when ready.
Verify in Console → Activity that create/preview actions appear. If OAuth fails, see Tutorial: Connect Claude and Fix MCP OAuth redirect mismatch.
Was this article helpful?
Contact support