PlugsightDocs

WooCommerce

Connect your WooCommerce store so your AI can report on sales, orders, best sellers, stock and customers. Read-only, about a minute.

Connect your WooCommerce store and your AI can tell you how the shop is doing: sales, orders, best sellers, stock and customers. Plugsight gets read-only access: it can't change orders, products, prices or settings.

What your AI can do

  • Sales report for any period: gross and net sales, orders, items sold, average order, tax, shipping, refunds and discounts, broken down by day (or by month for long periods), plus the best-selling products.
  • List orders, newest first, by status (pending, processing, on hold, completed, cancelled, refunded, failed or checkout draft), date range, or a search for a customer name, email, order number or product.
  • Read one order in full: items, totals, coupons, discounts, shipping, refunds, payment method, customer, addresses, the customer's note and order notes.
  • Search products by name or SKU, or only those out of stock or on backorder, with price, sale price, stock level, total sales and rating. Sort by popularity to see all-time best sellers.
  • Search customers by name or email, with how many orders each placed and how much they spent.

Example questions

  • "How did the shop do last month compared with the month before?"
  • "Which products sold best this week, and are any of them running low on stock?"
  • "Find order 1042 and tell me what was bought and where it's shipping."
  • "Who are my ten biggest customers by total spent?"
  • "Which orders are still on hold?"
  • "Compare Google Ads spend last month with WooCommerce revenue for the same days."

What you need

  • Any plan. WooCommerce isn't a marketing connector.
  • Your store's web address. The store must use https and be reachable from the internet.
  • A WordPress login as an administrator or shop manager.

Connect by approving Plugsight in your store

This is the quickest way, and takes about a minute.

  1. Open Connections and click Add connection.
  2. Choose WooCommerce.
  3. Under Approve in your store, type your Store web address: the address customers visit, like shop.example.com.
  4. Click Continue to my store.
  5. Your store opens. Log in to WordPress as an administrator or shop manager, if you aren't already.
  6. WooCommerce shows "Plugsight would like to connect" with Read access. Click Approve.
  7. You come straight back to Connections, with the message "Connected shop.example.com."

Connect with REST API keys instead

Use this if your host blocks the approval screen (you'll see a message saying so).

  1. On the Connect WooCommerce page, open Connect with REST API keys instead.
  2. Type your Store web address.
  3. Click Open your store's REST API keys. Or, in WordPress, go to WooCommerce → Settings → Advanced → REST API and click Add key.
  4. Describe the key as "Plugsight", pick your user, set Permissions to Read and click Generate API key.
  5. Copy the Consumer key and Consumer secret. WooCommerce shows the secret only once, so copy both before leaving the page.
  6. Back in Plugsight, paste them into Consumer key (starts ck_) and Consumer secret (starts cs_). Optionally give the connection a Name, such as "Main shop".
  7. Click Test connection & save. Plugsight checks the keys with your store before saving anything.

When it works, you see a message like "Connected shop.example.com (1,234 orders), id "…"."

Then add the connection to an MCP server. If this is your first store, refresh the tools list in your AI app and start a new chat.

Connecting the same store again replaces its keys and keeps your settings. The message says "Reconnected" instead of "Connected".

What it can and can't change

WooCommerce is read-only in Plugsight, whichever way you connect. Your AI can't create, edit, refund or cancel orders, or change products, prices, stock or settings.

To cut access, delete the Plugsight key in WooCommerce → Settings → Advanced → REST API, and remove the connection on Connections.

Limits

  • Order, product and customer lists return up to 100 at a time (25 by default). Your AI can ask for the next page.
  • Sales reports list up to 50 best-selling products (10 by default).
  • Customer search covers registered customers. Guest checkouts appear in orders, not in the customer list.
  • If you connect more than one store, your AI needs to know which one you mean: name it in your question.

Troubleshooting

Enter your store's web address, like shop.example.com.

What it means: The address box was empty or the address wasn't valid. Addresses with a port number or without a dot aren't accepted.

How to fix it: Type the address customers visit, such as shop.example.com.

That address isn't a public website. Enter your store's web address, like shop.example.com.

What it means: The address points to a private or local network, which Plugsight can't reach.

How to fix it: Use your store's public address on the internet.

The store wasn't connected: the approval was cancelled. Click Connect and choose Approve.

What it means: You didn't click Approve on the WooCommerce screen.

How to fix it: Start again and click Approve.

… approved Plugsight but couldn't send us the keys (some hosts block this). Use "Connect with REST API keys" below instead.

What it means: Your hosting blocked WooCommerce from sending Plugsight the keys after you approved.

How to fix it: Use Connect with REST API keys instead.

… didn't answer like a WooCommerce store (HTTP …). Check the address, and that WooCommerce is installed and its REST API isn't blocked by a security plugin.

What it means: The address didn't return WooCommerce data. The address may be wrong, WooCommerce may not be installed, or a security plugin or firewall is blocking its REST API.

How to fix it: Check the address. If it's right, allow the WooCommerce REST API (addresses under /wp-json/wc/) in your security plugin or firewall.

The store didn't accept these keys. Copy both again in full from WooCommerce → Settings → Advanced → REST API, with Read access.

What it means: The consumer key or secret is wrong or incomplete.

How to fix it: Create a new key with Read permissions and paste both values again in full.

The store rejected Plugsight's keys; they may have been revoked. Reconnect the store on the Connections page in Plugsight.

What it means: The key was deleted or changed in WooCommerce. The connection shows Reconnect needed.

How to fix it: Connect the store again, by approving or with new keys.

The store's keys don't allow this. Reconnect and approve read access, or check a security plugin isn't blocking the WooCommerce API.

What it means: The key doesn't have read permission, or a plugin is blocking the request.

How to fix it: Connect again with Read access, and check your security plugin.

Couldn't find shop.example.com. Check the server name for typos.

What it means: The address doesn't exist on the internet.

How to fix it: Check the spelling of your store's address.

Couldn't reach shop.example.com in time. Check the server name and port, then try again.

What it means: Your store didn't answer within 20 seconds.

How to fix it: Check the store is online, then try again.