PlugsightDocs

Magento / Adobe Commerce

Connect a Magento Open Source or Adobe Commerce store so your AI can report on sales, orders, best sellers, low stock and customers.

Connect your Magento Open Source or Adobe Commerce 2.4 store and your AI can tell you how it's doing: sales, orders, best sellers, low stock and customers. You add Plugsight as an Integration in your Magento admin, with read-only resources. No extension is needed. Plugsight only reads: it can't change anything in your store.

What your AI can do

  • Sales report for any period, added up from your orders: revenue, orders, items sold, average order, discounts, shipping, tax and refunds, day by day, plus the best-selling products. Cancelled orders are left out.
  • List orders, newest first, by status (for example pending, processing, complete, canceled, closed or holded), date range or customer email.
  • Read one order in full, by the order number customers see (for example 000000123): items, totals, discounts, shipping, refunds, payment method, addresses and comments.
  • Search products by name or SKU, with price, type and status, or list products whose stock is at or below a quantity you choose.
  • Search customers by email or name, with when they joined and their default address.

Example questions

  • "How did the store do last month compared with the month before?"
  • "Which products sold best this week, and which are running low on stock?"
  • "List products with 5 or fewer in stock."
  • "Find order 000001042 and tell me what was bought and where it's shipping."
  • "Show every order from ann@example.com this year."
  • "Compare Google Ads spend last month with Magento revenue for the same days."

What you need

  • Any plan. Magento isn't a marketing connector.
  • A Magento Open Source or Adobe Commerce 2.4 store, on https and reachable from the internet.
  • An admin login that can create integrations, and your admin password.

Connect your store

This takes about 3 minutes, in your Magento admin.

1. Add a new integration

  1. In your Magento admin, go to System → Extensions → Integrations.
  2. Click Add New Integration.
  3. Name it "Plugsight" and enter your admin password.

2. Choose what it can read

  1. Open the API tab.
  2. Set Resource Access to Custom.
  3. Tick Sales → Operations → Orders, Catalog → Inventory → Products and Customers → All Customers.
  4. Click Save.

3. Activate it and copy the four keys

  1. Next to Plugsight in the list, click Activate, then Allow.
  2. Magento shows four keys: Consumer Key, Consumer Secret, Access Token and Access Token Secret.

You can see them again later with Edit → Integration Details.

4. Paste them into Plugsight

  1. In Plugsight, open Connections, click Add connection and choose Magento / Adobe Commerce.
  2. Type your Store web address, like shop.example.com.
  3. Optionally give the connection a Name, such as "Main shop".
  4. Paste each key into the matching box: Consumer Key, Consumer Secret, Access Token and Access Token Secret.
  5. 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 (5,210 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.

Magento gives every integration four keys, and Plugsight uses all four to sign each request. This works on every 2.4 store without changing settings.

What it can and can't change

Magento is read-only in Plugsight. Your AI can't create, edit, invoice, ship or cancel orders, or change products, prices, stock, customers or settings.

To cut access, delete the Plugsight integration in System → Extensions → Integrations, and remove the connection on Connections.

Limits

  • A sales report adds up at most 3,000 orders. If the period has more, your AI is told how many were included; ask for a shorter period.
  • Sales report dates and order date filters use UTC.
  • 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).
  • If you connect more than one store, name the one you mean 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.

How to fix it: Type your store's address, 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 didn't accept these keys. Copy all four again from the integration's details in Magento admin, and check the integration says Active.

What it means: One of the keys is wrong or incomplete, or the integration isn't activated.

How to fix it: In Magento admin, open Edit → Integration Details, copy all four keys again, and check the integration's status is Active.

The integration isn't allowed to read this. In Magento admin, edit the integration's API resources to include …, save, then reauthorize it.

What it means: The integration is missing one of the resources: orders, products or customers.

How to fix it: Edit the integration, open the API tab, tick the resource the message names (Sales → Operations → Orders, Catalog → Inventory → Products or Customers), click Save, then reauthorize the integration.

The store rejected Plugsight's integration keys; the integration may have been deleted or its keys renewed. Reconnect the store on the Connections page in Plugsight.

What it means: The integration was deleted or its keys changed. The connection shows Reconnect needed.

How to fix it: Copy the current four keys (or create the integration again) and connect the store again.

… didn't answer like a Magento store (HTTP …). Check the address, and that the REST API isn't blocked by a firewall or security module.

What it means: The address didn't return Magento data.

How to fix it: Check the address. If it's right, allow Magento's REST API (addresses under /rest/V1/) in your firewall or security module.

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.