ShopMy Connector — Team Guide

READ-ONLY

Ask Claude how our ambassador and affiliate program is performing — revenue, commissions, ROAS, and top creators — in plain English. Enriched with Shopify order detail. No exports, no spreadsheets.

Status: Live ✓ Updated: June 25, 2026 Access: read-only — reporting API, no writes API limit: daily report budget (results cached ~30 min to stay under it) Sign-in: your Google work account Questions: David
What it is Connect in 1 minute How to ask Example prompts Limits & risks Get help / request more Live artifacts Architecture How your data flows

What is the ShopMy connector?

ShopMy is where Melinda Maria's ambassador and affiliate program lives — the creators who share our links and earn commission on the sales they drive. The ShopMy connector lets Claude read that performance for you, enriched with Shopify order detail (SKUs, items, gross sales, ship-to, new vs. returning). Instead of pulling the numbers by hand for the weekly report, you just ask.

📊 What it knows

Revenue attributed, commission paid, ROAS (revenue ÷ commission), average order value, gross sales, item counts, the new-vs-returning customer split, top ambassadors (with their IG/TikTok handles), and a per-SKU breakdown.

🔒 What it can't do

It is read-only — it reports on the program but cannot change anything in ShopMy. Ask freely; nothing you do here touches creators, links, or payouts.

🧠 What makes it handy

It's already done the math: ask for a date range and it hands back totals, ROAS, top creators, and SKU breakdowns — the exact metrics that feed our Global Report's Ambassadors section.

Pairs with NuORDER: ShopMy is our ambassador / DTC picture; NuORDER is our wholesale picture. Ask Claude to combine them when you want the full revenue story across both channels.

Connect it in about a minute

How to connect in three steps Open Settings then Connectors in Claude, find this connector and click Connect, then sign in once with the account noted below. Settings Profile Connectors Data controls 1 · Open Settings → Connectors MM This connectornot connected Connect 2 · Find it · click Connect you@melindamaria.com •••••••• Sign in ✓ 3 · Sign in once — done
In Claude: Settings → Connectors → find it → click Connect → sign in. It’s already added for the team, so this is a one-time, ~1-minute step (see “Which login” below).

The ShopMy connector is already set up in Claude for the team — you just switch it on and sign in. Takes about 30 seconds.

1
In Claude, open SettingsConnectors (or click the + in the message box → Connectors). Find ShopMy in the list — it's already there.
2
Click the + (or Connect) next to ShopMy.
3
When prompted, sign in with your Google work account (your @melindamaria.com email — the same one you use for Gmail & Drive). A personal Gmail won't work.
4
Approve the connection. It shows Connected — then type "Using ShopMy, run shopmy_health" — you should see ok: true.
🔑 Which login? You only ever sign in with your Melinda Maria Google work account. You never enter any ShopMy password or key — those are stored securely on our side.
Don't see it in your Connectors list? Ask David — it gets enabled once for the team, then appears for everyone to switch on.

How to ask — just say "use ShopMy…"

The connector is named ShopMy. The simplest way to make sure Claude uses it is to mention it in your request:

"Using ShopMy, <your question>."

You don't have to memorize tool names — plain English works. A few tips that get great results:

Be specific about the window

"…last week", "…in Q2", "…last 30 days", "…month over month". Time frames make reports sharper.

Say what you want ranked

"…top 10 creators", "…by revenue", "…by commission", "…SKU breakdown". Tell Claude what to sort by.

Ask for the format you want

"…as a table", "…make a PDF", "…a short recap I can paste into the Global Report". Claude will shape it.

Chain connectors in one ask

Combine tools: "compare ambassador (ShopMy) to wholesale (NuORDER)", "match ShopMy top SKUs to Shopify sales". See the multi-connector examples below.

Heads up on actions: the ShopMy connector itself only reads. But when you ask Claude to draft an email, post to Slack, or build a PDF using our other tools, it drafts it and asks you to confirm before anything goes out. Nothing is sent without your OK.

Example prompts — from quick checks to full reports

Copy these, tweak them, make them yours. They get more advanced as you go down. The label shows the level, and the line under each shows which connectors get involved.

Simple one quick answer Analysis ShopMy does the math Multi-connector combines tools Takes action drafts an email / Slack / report (you confirm)
📊

Program performance

Simple
"Using ShopMy, how much ambassador revenue did we drive last week, and what was the commission?"
ShopMy — summary
Simple
"Using ShopMy, how many orders came through ambassadors this month, and what's the average order value?"
ShopMy — summary
Analysis
"Using ShopMy, what was our ROAS (revenue ÷ commission) last month, and how does that compare to the month before?"
ShopMy
Analysis
"Using ShopMy, give me the new-vs-returning customer split for ambassador-driven orders this quarter."
ShopMy
Analysis
"Using ShopMy, show me weekly ambassador revenue for the last 8 weeks and tell me whether the program is growing."
ShopMy

Top ambassadors

Simple
"Using ShopMy, who were our top 10 ambassadors by revenue last month, with their IG/TikTok handles?"
ShopMy — top creators
Analysis
"Using ShopMy, which ambassadors drove the most revenue but earned the least commission — our most efficient creators?"
ShopMy
Analysis
"Using ShopMy, which creators were strong last quarter but have gone quiet this one?"
ShopMy
Takes action
"Using ShopMy, find our top 5 ambassadors this month and draft a warm, on-brand thank-you note to each for me to review."
ShopMy + Gmail — drafts notes (you confirm)
💎

What's selling

Simple
"Using ShopMy, give me the SKU breakdown for ambassador orders this month — which pieces are creators actually selling?"
ShopMy — SKU breakdown
Analysis
"Using ShopMy, what are the top 10 ambassador-driven SKUs this quarter by units and by revenue?"
ShopMy
Multi-connector
"Match our top ambassador SKUs in ShopMy against total Shopify sales for the same pieces — which products do creators over-index on?"
ShopMy + Shopify
🔗

The bigger picture & reports

Multi-connector
"Give me the full revenue picture for last quarter: ambassador/DTC from ShopMy and wholesale from NuORDER, side by side with the split."
ShopMy + NuORDER
Multi-connector
"For the Ambassador Program review: combine ShopMy revenue and top creators with last month's top social posts from Sprout, and tell me if our best content matches our best sellers."
ShopMy + Sprout Social
Takes action
"Using ShopMy, build this week's Ambassadors section for the Global Report (orders, revenue, commission, ROAS, top ambassador, SKU breakdown) and draft it as a clean summary I can drop in."
ShopMy + PDF — draft (you confirm)
Takes action
"Each Monday, using ShopMy, summarize last week's ambassador performance and top creators and post it to #ambassadors in Slack as a draft."
ShopMy + Slack — recurring; draft (you confirm)
📊

Live artifacts, dashboards & spreadsheets

Analysis
“Create a live artifact: a creator revenue dashboard — orders, revenue and top creators, refreshed each open.”
ShopMy — live artifact
Analysis
“Build a per-creator ROAS tracker artifact with a 30-day trend line.”
ShopMy — ROAS
Analysis
“Make a spreadsheet (.xlsx) of this month's creator orders with the Shopify enrichment columns.”
ShopMy — xlsx
Multi-connector
“Build one artifact that merges ShopMy and LoudCrowd into a single creator leaderboard.”
ShopMy + LoudCrowd
Analysis
“Create a SKU-breakdown artifact: what creator traffic actually sells, refreshed on open.”
ShopMy — products

Limitations, caveats & risk (please read)

TopicWhat to knowStatus
Read-onlyThe connector reports on the program only — it cannot change creators, links, commissions, or payouts. It's completely safe to explore.Safe
30-day return windowAn order's revenue and commission can keep changing for up to 30 days after the sale as returns settle. For recent periods, treat the numbers as near-final, not locked — re-pull later for the exact figure.Settles
Link clicks not includedThis connector reads order data, not click data — so "total link clicks" isn't available here. If you need clicks, that's a separate ShopMy report.Gap
Actions in other appsWhen a prompt drafts an email, posts to Slack, or builds a report, Claude prepares it and asks you to confirm first. Always review before approving.You confirm
Confidential dataReal creator names, handles, revenue, and customer detail flow through. Don't paste exports into outside tools, and share reports only with people who should see them.Handle with care
Double-check headline numbersFor anything that goes in the Global Report or to leadership, sanity-check the figure or ask Claude to show the orders behind it.Verify

Get help, request features, or report something odd

Something looks wrong?

If a number seems off, a creator is missing, or the connector says it can't reach ShopMy — tell David. Include what you asked and what you got back (a screenshot helps).

Want a new capability or report?

Need link-click data, a recurring recap, or a new comparison? Send the idea to David. Some additions depend on ShopMy's reports; others are quick to add.

Quick built-in you can always run: shopmy_health — it confirms the key works and the domain is valid. If it errors, that's the thing to send David.

What is a live artifact and how to share it

Short version: a live artifact is a page Claude builds once and then refreshes every single time you open it — so a dashboard you ask for today is still accurate next month. Here is what one is, and the three ways to get it in front of your team.

📊 NEW — build live artifacts, dashboards & spreadsheets with this connector

A live artifact is a small interactive page Claude builds and saves for you — a dashboard, tracker, or report that pulls fresh data from this connector every time you open it, instead of being a frozen snapshot. In a Cowork session, just ask: “create a live artifact that…” — it lands in your Artifacts list, reusable forever, and its charts and tables refresh themselves on open.

Sharing with the team: artifacts are saved to your Claude account. Three easy ways to share: (1) ask Claude to export a snapshot (PDF, image, or .xlsx) and drop it in Slack; (2) send a teammate the prompt that built it — their copy fills with live data through their own connector sign-in; (3) for a permanent all-team dashboard, that’s the MM Intelligence project on the AI roadmap.

How it works — architecture

ShopMy has a clever twist most of our connectors don't: it pulls the headline numbers from ShopMy, then quietly enriches every order with detail from Shopify so you get a fuller picture in one answer. Here's the build:

ShopMy MCP Connector — Architecture ShopMy connector architecture: a Google-gated read-only Cloudflare Worker that fetches the ShopMy Brand Partner order report, then enriches each order from the Shopify Admin API (SKU, items, ship-to), joining on Order ID. Enrichment fails safe. Results cached ~30 minutes. No database. ShopMy MCP Connector — Architecture (live + enrichment)Live + Shopify enrichment · shopmy-mcp.melindamaria.ai/mcp · Google-gated · 6 read-only toolsLIVEYou + the teamin Claude (Cowork,Desktop, Web, Code)ask in plain Englishplain EnglishClaudepicks the rightshopmy_ tool &fills in filtersMCP · OAuth 2.1shopmy-mcp — Cloudflare WorkerREAD-ONLY🔐 Google sign-in gateonly @melindamaria.com / @7ate9.com accounts get in6 named read-only toolsorder report · orders · SKU breakdown · summary · top creators · healthMerge + cache enginejoins on Order ID == Shopify order name (#1219194)results cached ~30 min (respects ShopMy daily budget)🛟 Enrichment fails safeif Shopify is unreachable, still returns core ShopMy numbers🔑 ShopMy + Shopify keys in Cloudflare secrets · No DB1 · FETCHShopMy BrandPartner APIapi.shopmy.us/v1headline order report2 · ENRICHShopify Admin APIclient-credentials24h token, cached ~23hSKU · items · ship-toEnriched answerShopMy creator earnings+ Shopify order detail,merged on Order ID.You / ShopMyOur connectorShopify (enrichment)Flow1. Ask → 2. Worker (Google-gated) fetches the ShopMy order report → 3. enriches each order from Shopify →4. merges on Order ID and answers. No database; each call is live (cached ~30 min). Enrichment is fail-safe.
Self-hosted on Melinda Maria’s own Cloudflare account at shopmy-mcp.melindamaria.ai/mcp — the same hosting + Google sign-in pattern as our other connectors. All traffic over HTTPS/TLS.

Why enrich with Shopify?

ShopMy reports the affiliate side — who drove a sale and the commission — but not the full order. By matching each ShopMy order to its Shopify twin (same order number), Claude can also tell you the SKUs, order value, destination, and whether the buyer was new. One question, a complete answer.

Fails safe

The Shopify enrichment is a bonus layer, not a dependency. If Shopify is ever unreachable, the connector still returns ShopMy's core numbers rather than erroring out — so you always get the headline figures.

Live & budget-aware

There's no stored copy — each call reads fresh — but results are cached ~30 minutes so repeat questions are instant and we stay within ShopMy's daily request budget. Both API keys stay server-side, never in Claude.

How your data flows (the 30-second version)

You don't need to understand the plumbing to use it — but here's the simple picture:

When you ask for the numbers

e.g. "how much ambassador revenue last week?" → Claude pulls ShopMy's order report for that range and totals revenue, commission, ROAS, and active creators.

When you want detail

e.g. "top creators and what sold" → Claude ranks ambassadors and breaks orders down by SKU, using the Shopify-enriched detail.

Everything happens behind a secure sign-in. The connector only works for people signing in with a @melindamaria.com or @7ate9.com Google account. The ShopMy key stays server-side and is never visible to you or to Claude. Creator and order data is confidential — handle exports with care.
Melinda Maria · ShopMy Connector Team Guide · June 25, 2026 · read-only · 6 tools · sign in with your Google work account.
Questions, anomalies, and feature requests → David. This guide is updated as the connector grows. · ← Back to all connectors
The Future Is Already Here. Predict faster, decide smarter, move first.