Shopify integration: Approved · View on the Shopify App Store
StoreAdOps in Shopify Admin
Account Overview and Platform Connections
Install and open
Install or open StoreAdOps from Shopify Admin. Shopify provides your store identity and read-only permission request. Account Overview reads this store with your current staff permissions; no separate login or AI client is needed for Shopify reporting. Manage products, orders and inventory in Shopify Admin itself. The embedded app has no catalog editor or campaign-management screens.
Account Overview
Choose 7, 30 or 90 completed days in the store's time zone. Today and Shopify test orders are excluded. Order revenue is original product revenue after discounts, excluding tax, shipping, refunds and later edits. Average order value divides that revenue by eligible orders. Original order gross is not Shopify Analytics Gross sales. Zero is shown only for a verified empty result; unavailable or partial results are never replaced by zero or sampled totals.
Advertising snapshots use the same reporting services as the standalone dashboard. Only complete spend is aggregated, separately by currency. Provider attribution can overlap and is never added to Shopify revenue. Ad accounts are not mapped to the store; contribution and missing costs stay unknown.
Platform Connections
- Choose Connect workspace in Platform Connections to include your existing ad accounts.
- Sign in to StoreAdOps if needed. Check the displayed Shopify store and StoreAdOps account, then choose Connect workspace to approve reporting and account selection. Return to the original Shopify tab; it finishes connecting automatically. Requests expire after 10 minutes.
- View enabled advertising connections and explicitly choose an already-authorized account. This also updates your standalone workspace selection. Connect/reconnect and verified key-based account setup use the secure first-party workspace and provider authorization screens.
Linking is specific to your staff identity. Disconnect any time. A historical Google-only link must be removed and explicitly approved again; it is never silently expanded. The reporting link cannot create API keys, access administration, change Shopify permissions, create ads or modify campaigns.
Free plan and recovery
No payment method or automatic paid upgrade is required. Platform Connections displays the store's free allowance and reset date. Advertising reads use the linked workspace's allowance. Provider and rate limits still apply.
If access is denied, ask your store administrator to review staff permissions. Historical-order access is required for 90 days; 7 and 30 days remain available. Reopen after an expired session. Uninstalling revokes installation and workspace-link access. Reinstalling requires fresh authorization.
Contact support@storeadops.ai. See Privacy and Terms. Shopify controls suspension, installation availability and review approval.
User guide
Optional standalone dashboard and AI-client setup
Connect your store, review its performance, and use your AI assistant to plan advertising with live commerce data.
Work in StoreAdOps Agent
Open Agent in your standalone StoreAdOps workspace to review connected accounts, explore recommendations, and inspect proposed changes. No separate AI subscription or MCP setup is required.
Organize conversations into named sections, return to saved reports and Activity, and choose light or dark mode.
Once Agent accepts a background task, it can continue after you close the tab. Return to the saved conversation to see its result or status.
Schedule a recurring review
Ask Agent for a recurring report or open Scheduled tasks. Review the instructions, timezone, and daily message use, then choose Create. A proposal alone does not start a task.
Choose once, daily, selected weekdays, monthly, or an interval. Intervals start at one hour and must fit your daily allowance. Tasks can start a new conversation or continue one you own. Pause, edit, resume, or run a task now from Scheduled tasks.
Scheduled runs work with your browser closed. The results inbox and task history show completed, failed, and skipped runs, with links to saved conversations. Start times may vary. Scheduled-task results are saved in the app; they are not emailed as a recurring report.
Create an alert for what matters
Ask Agent to watch a metric, or open Alerts and describe your check or choose a template. Review the conditions, severity, schedule, and optional email setting before creating the monitor.
Alert checks run on your chosen schedule, no more often than hourly. They are not real-time monitoring. View the evidence and check history, acknowledge or snooze an alert, and continue its conversation. Alerts can resolve when a later check confirms the condition has cleared. Unavailable data is shown as an unverified check, not an all-clear.
Optional alert emails cover opened, escalated, resolved, and reminder events, plus a notice after repeated failed checks. Push notifications are not available.
Keep your daily allowance and approvals in view
Chat, scheduled runs, Run now, retries, and alert checks share the 10-message daily Agent allowance. It resets at midnight UTC. A due check with no allowance left is skipped and recorded in its history.
Scheduled reviews and alert checks cannot execute advertising changes. Open a proposed change in an ordinary chat, review the current plan, and explicitly confirm it. Past approvals do not carry into unattended runs.
Connect your advertising accounts
You can use StoreAdOps with an advertising account alone. Connect only the accounts you want to use.
- Sign in or create your StoreAdOps account using Google or an email code.
- Open Connections, choose Google Ads, Meta Ads, Microsoft Advertising or TikTok Ads, and authorize access to an available integration. Signing in with Google does not itself connect Google Ads.
- Select the advertising account you intend to use. For Meta, select a business and ad account you are authorized to manage; Page and catalog workflows need their specific permissions.
- Open Home, choose Advertising, select the account and period, and check the snapshot and any data-availability warnings.
- Choose an AI connection below, then ask it to check your selected accounts before doing analysis.
Choose your AI connection
StoreAdOps Agent
Open Agent to work directly in StoreAdOps. No separate AI subscription is required. Explore Agent workflows, or connect the tools to another AI client below.
ChatGPT
Check StoreAdOps in the ChatGPT directory for current installation availability and complete browser sign-in if offered. The server provides the same named-tool contract, but the installed client, granted scopes and enabled features determine which operations you can use. Directory review or installation alone does not prove access.
Claude Code plugin
Follow the StoreAdOps Claude Code plugin installation instructions, then complete browser sign-in when requested. The plugin includes guided account setup, performance reviews, profit briefs, and campaign drafts. Installation does not grant access to unconnected accounts or bypass provider permissions.
Direct MCP
Open Setup Guide for the API-key instructions for your client.
For API-key clients, choose your client in Setup Guide, generate a key, and follow its displayed command. Keep the key private. The main endpoint is https://app.storeadops.ai/mcp. It serves the same named tools as https://app.storeadops.ai/mcp/packs/ads-v3 and the retained installation URL https://app.storeadops.ai/mcp/packs/analyst-v1; the latter is not an analysis-only surface. Each URL retains its own OAuth resource binding. All changes require a prepared preview, explicit confirmation, accepted effects and an idempotency key; host permissions and provider gates still apply.
Ask: “Check my StoreAdOps connections and identify my selected Google and Meta accounts. Make no changes.” Then try a workflow prompt. Your AI provider may charge separately.
Microsoft Advertising: Available. TikTok Ads: Available. Use the advertising MCP connection at /mcp/packs/ads-v3. Select that pack in the app's Setup Guide for Microsoft or TikTok workflows.
The detailed Codex CLI walkthrough and existing store setup instructions follow below.
Before you start
- A Shopify account with permission to install apps on your store.
- A StoreAdOps account. Sign in with an email code or Google.
- StoreAdOps Agent works in your browser without an extra AI subscription. A compatible MCP client is optional for using the tools in another AI assistant.
- For Google Ads reporting or campaign actions, access to the Google Ads account that runs your campaigns. A Google Ads connection is not required for the Shopify commerce dashboard.
1. Install and connect your store
- Start from the StoreAdOps Shopify App Store listing or Shopify Admin and choose Install or Open app. Shopify supplies the store identity; do not enter a store domain into StoreAdOps.
- Review Shopify's permissions for products, inventory, orders, and store analytics, and complete the Shopify-owned install flow.
- When StoreAdOps asks you to sign in, use your StoreAdOps account, then continue the installation.
- Open Connections and check that your Shopify store is Active.
Shopify access is read-only. The Shopify API documentation explains the requested permissions and data handling.
2. Review store performance
- Open Home, select Commerce under Account snapshots, and expand your store.
- Select the last 7, 30, or 90 complete days. Check the displayed dates, store timezone and currency, then review exact non-test order count, original order gross before discounts, order revenue and average order value.
- Order revenue is original product revenue after discounts, excluding tax, shipping, refunds and later adjustments. Average order value is order revenue divided by eligible orders. Today and Shopify test orders are excluded; a new test order will not immediately change these totals.
- Original order gross is not Shopify Analytics Gross sales: later order edits can change the Analytics figure without changing original-order revenue or average order value. Compare the same dates and metric definitions, not just similar labels.
- Average order value is calculated before display rounding: divide order revenue by order count, then round to the currency's minor unit. Compare full-precision exports when another dashboard displays a different last decimal.
- An empty complete-day period has zero orders and revenue, with no average order value. Read any data-availability warning: denied access, missing history permission or incomplete pagination must not appear as zero sales or a sampled total.
- Product catalog and inventory are read-only AI-client features. Use the current Setup Guide and discovered Shopify tools to inspect tracked, untracked and multi-location stock; unavailable stock is not zero.
3. Connect Google Ads when needed
- Open Connections, choose Google Ads, and complete Google's consent flow.
- Select the account that runs your campaigns, then confirm it is Active.
- On Home, select Advertising and that account to review spend, conversions, conversion value, and campaign performance for the selected period.
4. Connect your AI client
- Open Setup Guide and choose the native MCP server integration option.
- Select your client, generate an API key, and follow the displayed setup command. Keep the key private; it is shown only when created.
- The production MCP server is
https://app.storeadops.ai/mcp. Other compatible clients can use this URL with bearer-token authentication. - Ask your client to check your StoreAdOps connections before requesting store or ad data.
Platform-directory plugins have separate availability. Direct MCP setup does not require a directory listing.
Codex CLI: install, sign in, and connect
- Use a macOS, Linux, or Windows WSL terminal with Node.js and npm installed. Run
npm install -g @openai/codex, thencodex --version. If npm is unavailable, use an installer from the official Codex installation guide. - Run
codex loginand complete the browser sign-in with your own ChatGPT account that has Codex access. This is separate from your StoreAdOps login and API key. Confirm withcodex login status. - In StoreAdOps, open Setup Guide, choose Native MCP server integration, then Codex. Click Generate key here and wait for your key and command to appear. Click Copy Codex command. The generated command contains your private key; do not share it.
- Paste and run the complete copied command in your terminal. It exports the API key and registers the
advantageMCP server athttps://app.storeadops.ai/mcp. It replaces any existing Codex server namedadvantage. Runcodex mcp listand confirm that name and URL. - Run
codexin the same terminal. Enter/mcpand confirm advantage connects and lists tools. Ask: “Use StoreAdOps to list my connected accounts and identify the selected store and ad account. Make no changes.” Compare the result with Connections in StoreAdOps. - If the key is missing, run the copied command again in the terminal that launches Codex. A new terminal needs the key exported again. For a 401 error, generate a new key and repeat setup. Never paste your StoreAdOps password into the command.
- After testing, revoke the temporary key from the same terminal:
curl -fsS -X DELETE https://app.storeadops.ai/api/keys/current -H "Authorization: Bearer $ADVANTAGE_MCP_API_KEY". Expect{"revoked":true}. Then runcodex mcp remove advantageandunset ADVANTAGE_MCP_API_KEY. On macOS, also runlaunchctl unsetenv ADVANTAGE_MCP_API_KEY.
Try these read-only prompts
- “Check my StoreAdOps connections and identify the selected store and ad account.”
- “Summarize my Shopify product, stock, and recent-order context. Make no changes.”
- “Rank my Shopify products for advertising and explain their readiness and stock risks.”
- “Review my Google Ads campaigns over the last 30 days and recommend improvements. Make no changes.”
Review actions before approving them
For an ad change, check the account, campaign, proposed change, and budget before approving. New campaigns start paused by default. Approved edits to existing campaigns can take effect immediately. StoreAdOps does not make Shopify changes.
Need help?
Read the FAQ or contact support@storeadops.ai. Include the page, action, and error message, but never send passwords, API keys, or customer contact data.