Use the Shopeaks Connector in Claude: Setup Guide
Ask about revenue, orders, Instant Stores, and campaigns in plain language. Five steps, your Shopeaks login, no API key. V1 is read-only.
Your Shopeaks numbers, one question away
Connect Shopeaks to Claude and ask about revenue, orders, Instant Stores, and campaigns in plain language. Five steps, your Shopeaks login, no API key.
https://mcp.shopeaks.com- What it is
- An MCP connector that lets Claude read your Shopeaks performance data.
- Setup
- Five steps in the Claude app with your Shopeaks login, no API key.
- Access
- V1 is read-only. Claude answers questions and changes nothing in your account.
- Server
mcp.shopeaks.com, OAuth 2.1, no customer data returned.
Why connect
Your engine, answered in the conversation
Shopeaks already runs the post-click for you. A real-time AI engine reads the intent behind every click from paid, organic, influencers, and email and builds a personalized Instant Store around it, on your own domain and Shopify checkout. The connector puts the results of that engine one question away. Instead of opening a dashboard or exporting a CSV to answer which campaign carried last week, you ask Claude and the number comes back with the context around it.
It is built for the people who run the traffic. Performance marketers compare channels and read split-test winners. Campaign managers see the orders and revenue behind Google Shopping, Meta, promo codes, and SMS. eCommerce managers pull the orders behind a campaign by source and date range, each with a direct link to the order in the store admin.
Step by step
Connect Claude to Shopeaks in five steps
You need a Shopeaks account with a connected business and a Claude plan that supports custom connectors. Copy the server address from the top of the page, then follow the steps in the Claude app, web or desktop.
Open Connectors
In Claude, go to Customize then Connectors. On desktop and web the path is the same.
Connectors
Add a custom connector
Click +, then choose Add custom connector from the menu.
Connectors +
Paste the server URL
Enter https://mcp.shopeaks.com exactly as shown, with no path after the host, and click Add.
Add custom connector
Sign in to Shopeaks
Click Connect and sign in with your Shopeaks login in the window that opens. Review the request and approve it. Your password is entered on Shopeaks only, never in Claude.
Claude is requesting access
This MCP client is requesting read access to your Shopeaks business.
Switch it on and ask
In a conversation, click +, choose Connectors, and switch Shopeaks on. Ask your first question and watch your own numbers come back.
On a Claude Team or Enterprise plan, an organization Owner adds the connector once under Organization settings, Connectors. Each member then connects their own Shopeaks account from Customize, Connectors.
Other MCP clients
Same server, any client
The connector uses OAuth, so any client that supports remote MCP servers works with the same address.
Claude CodeTerminal
Run one command, then run /mcp inside Claude Code and follow the prompt to sign in to Shopeaks.
claude mcp add --transport http shopeaks https://mcp.shopeaks.com
CursorJSON
Add this to ~/.cursor/mcp.json, then approve the login prompt Cursor shows.
{
"mcpServers": {
"shopeaks": { "url": "https://mcp.shopeaks.com" }
}
}VS CodeJSON
Add this to .vscode/mcp.json in your workspace.
{
"servers": {
"shopeaks": { "type": "http", "url": "https://mcp.shopeaks.com" }
}
}Other clientsmcp-remote
Any client that supports remote MCP servers with OAuth works with the same address. Clients that only support local servers connect through the mcp-remote bridge.
{
"mcpServers": {
"shopeaks": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.shopeaks.com"]
}
}
}ChatGPT and Gemini are next.
What Claude can do with Shopeaks
Eight things you can ask for today
Claude picks the right capability from your question. You never name a tool, you describe what you want to know.
Channel performance
Revenue, clicks, checkouts, and conversion rate across paid, organic, influencers, and email, for any date range.
Daily revenue timeline
A day-by-day series for the whole business or one channel, so you see which day carried the week.
Instant Store ranking
Your Instant Stores and links ranked by revenue, clicks, or conversion, with performance to date.
Split test winners
Every ADS+ split link with its variants and the one currently winning on revenue per session.
Order lookup
Orders behind a source, a period, or a creator, each with a direct link to the order in your store admin.
Campaign attribution
Orders and revenue behind Google Shopping, Meta, promo codes, and your campaigns, side by side.
Creator leaderboard
Your influencers ranked by revenue and orders over a period, active and inactive.
Creator report
The full report for one creator, matching the one you download from Shopeaks, in a sentence.
Example prompts
Questions that work on day one
Dates in plain language, money in your store's currency. Scroll through a real conversation, then start with any of these and follow up like you would with a colleague.
Your Google Shopping Instant Store led the week. Revenue rose against the previous seven days while clicks stayed flat, so the lift came from conversion rather than traffic.
One test has a clear winner. The Instant Store variant is ahead on revenue per session and traffic is already routing to it.
| Variant | Rev / session | Conv. rate |
|---|---|---|
| Instant StoreWinning | $3.42 | 4.1% |
| Collection page | $1.96 | 2.3% |
Paid leads on conversion, email is close behind, and organic trails both. The gap sits in organic social, where clicks are up and conversion is flat. That is the channel to point at an Instant Store next.
Three creators account for most of the quarter. The top one carried the biggest week in August on a single promo code.
| Creator | Revenue | Orders |
|---|---|---|
| @creator_one | $18.4K | 212 |
| @creator_two | $9.1K | 118 |
| @creator_three | $6.7K | 84 |
Here are the last 20 promo-code orders, newest first, each with its order number, total, attributed creator, and a link to the order in your store admin.
Revenue grew week over week with conversion doing the work. Google Shopping was the strongest channel, one ADS+ test picked a winner, and two creators went quiet after a strong July. Suggested next move: route the top organic post to an Instant Store and re-engage the quiet creators before the weekend.
FAQ
Before you connect
Can Claude change anything in my Shopeaks account?
No. This is V1 of the connector and it is read-only. Claude reads your data and answers questions. Nothing is created, edited, deleted, sent, or spent.
Does Shopeaks see my conversations?
No. The connector receives only the specific request Claude makes, such as orders from Instant Store in August, and returns the matching data.
Is customer data exposed?
No. Results never include customer names, emails, phone numbers, addresses, or payment details. Your Shopeaks password is entered only on the Shopeaks login page, never in Claude.
Which Claude plans support the connector?
Custom connectors are available on Claude Pro, Max, Team, and Enterprise while Shopeaks is under review for the Claude connectors directory. On Team and Enterprise, an organization Owner adds it once and each member signs in with their own Shopeaks login.
Can my team connect too?
Yes. Each team member connects with their own Shopeaks login and sees what their Shopeaks permissions allow.
What is MCP?
The Model Context Protocol is an open standard that lets AI assistants such as Claude, ChatGPT, and Cursor connect to outside systems. Shopeaks runs a remote MCP server at https://mcp.shopeaks.com, and any client that supports it can connect with the same address.
Something is not working. What do I check first?
Check that the URL is exactly https://mcp.shopeaks.com with nothing after the host. If you are asked to sign in again, approving once resolves it. For anything else, write to support and we will sort it out.
Ask your first question in five minutes
Connect Shopeaks to Claude with your regular login, then ask what carried last week.
https://mcp.shopeaks.comShopeaks is a dynamic eCommerce platform helping Shopify brands turn every click into a personalized shopping experience. Learn more at shopeaks.com.
More from the blog
Ready to
make your store dynamic?
Give every click a destination built around the shopper who made it.



