Blaze MCP Toolkit for WooCommerce
| 开发者 | blazecommerce |
|---|---|
| 更新时间 | 2026年11月8日 10:52 |
| PHP版本: | 8.1 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv3 or later |
| 版权网址: | 版权信息 |
详情介绍:
- "Run my weekly store review."
- "Sales were down yesterday. Did anything change on the site?"
- "Are there failed orders I should chase?"
- "What's driving refunds this month?"
- "Is anything broken on the store right now?"
- "Who has API access to my store?"
- Store health (
health-summary): red, amber or green for PHP errors, background jobs and updates, plus your WordPress, WooCommerce and PHP versions. It reads the tail of your PHP and WooCommerce error logs, groups repeated errors, names the plugin or theme they come from, and strips out emails, card numbers, API keys and passwords before anything reaches the AI. If the site has no error log it can read (common on managed hosts), it says so and shows amber rather than a false green. Background jobs covers failed and overdue Action Scheduler jobs from the last 7 days, with order emails, subscription renewals, webhooks and stock syncs called out. - Update history (
update-history): a dated list of plugin, theme and WordPress updates, installs, activations, deactivations and theme switches, recorded from the day you activate the plugin and kept for 180 days. Changes made outside WordPress, such as a deploy over SSH or git, are not seen. - Access check (
access-check): WooCommerce REST API keys, webhooks and application passwords, with flags for write keys unused for 90 days and webhooks that send order data. It never returns keys, secrets, full webhook addresses or user names.
- Weekly store review: sales, orders, customers, refunds, top products and channels for the last 7 days against the week before, plus store health and this week's updates.
- Revenue drop triage: works out where a drop came from (order count, order value, customers, products, channels) and checks for updates or new PHP errors in the same window.
- Failed order triage: failed and on-hold orders, the ones to chase first, and a plain warning when failed orders outnumber paid ones (a common sign of card testing or a broken payment gateway).
- Refund triage: refund rate, the products and countries behind it, and whether it is getting worse.
- Workflows: anyone who can manage WooCommerce (Administrator, Shop Manager).
- Sales analytics and store tools: WooCommerce's own permissions (Administrator, Shop Manager).
- Store health and update history: Administrators. Shop Managers only if you switch that on in the plugin's settings.
- Access check: Administrators only.
- Customers, Subscribers and other roles get a permission error, never data.
- Option 1 (recommended): MCP Adapter and Enable Abilities for MCP. Enable Abilities provides the sign-in and connector URL for Claude and ChatGPT, and the switches for which tools are on.
- Option 2: Easy MCP AI, if you already use it.
- Install and activate this plugin (and WooCommerce, if WordPress asks).
- Install a connection plugin if you don't have one. Option 1 (recommended): MCP Adapter and Enable Abilities for MCP. Option 2: Easy MCP AI.
- Open WooCommerce > Blaze MCP Toolkit and read the Setup check. Each line is green, amber or red, with the fix in plain words. It shows the connector URL for the plugin you use.
- Option 1: open Settings > WP Abilities and turn on OAuth. For ChatGPT, also turn on "ChatGPT & Other OAuth Connectors". While you are there, switch off the tools from other plugins you don't want the AI to use. Option 2: tick this plugin's tools and the WooCommerce Analytics tools under Easy MCP AI › Tools › Abilities, then use Easy MCP AI's own Connect screen (link on our setup screen). When you click Connect, choose Custom and tick Abilities — Blaze-mcp-toolkit and Abilities — Wc-analytics under Customize permissions. Read-only does not include them.
- Add the connector URL in your assistant, if you didn't use Easy MCP AI's Connect screen. In Claude: Customize > Connectors > Add > Add custom connector. In ChatGPT: Plugins > Add > Add custom MCP server. Log in to wp-admin in the same browser first, then click Connect and click Allow once.
- Ask: "Run my weekly store review."
- Our diagnostics tools (store health, update history, access check) don't return customer contact details. They remove emails, phone numbers, card numbers and secrets from log lines, but log lines are free text and may still contain a name someone typed.
- The sales analytics tools (from WooCommerce for Claude) return totals, counts and, when asked, order rows with customers pseudonymised (Customer #N, never names or emails). They accept location filters such as billing city, state and postcode, but never filters on names or emails.
- Text that comes from the site (log lines, labels people typed in) is shortened and marked as untrusted, so the AI treats it as data and not as instructions.
- Each call to our tools is logged for 30 days: time, user ID, tool, a hash of the inputs, row count and duration. No customer data is logged. Store changes (updates, activations) are kept for 180 days.
- If you use Easy MCP AI, its other tools (such as its general read tool or its WooCommerce tools) can return customer details. The setup screen tells you where to switch them off.
- The plugin suggests wording for your privacy policy under Settings > Privacy.
- Nothing is added to your storefront: no scripts, styles or front-end hooks.
commerce-abilities package from WooCommerce for Claude by Automattic, bundled unmodified under GPL-3.0-or-later (tag v0.4.5, commit cdab921aab8d07ef813121ff78b3558af28f39fa). The four workflows are adapted from WooCommerce for Claude's workflow prompts and extended with Blaze's health and update checks. Thank you to Automattic and the WooCommerce for Claude contributors. The bundled files are not edited; Blaze adjusts tool names in instructions to match your connector.
Built by Blaze Commerce, a WooCommerce agency.
WooCommerce is a trademark of Automattic Inc. Blaze Commerce is not affiliated with or endorsed by Automattic, Anthropic or OpenAI.
安装:
- In wp-admin go to Plugins > Add New, search for "Blaze MCP Toolkit for WooCommerce", then install and activate it. If WooCommerce is missing, WordPress asks you to install and activate it first.
- Install a connection plugin (MCP Adapter and Enable Abilities for MCP, or Easy MCP AI), then follow the Setup steps in the Description: open WooCommerce > Blaze MCP Toolkit and add the connector URL in Claude or ChatGPT.
常见问题:
Does this plugin change my store?
No. Every tool in this plugin only reads. The AI connection as a whole can include write tools from WooCommerce and your connection plugin (for example, updating an order status). The setup screen lists them and links to where you switch them off.
I use Easy MCP AI. Does this work?
Yes. Install and activate this plugin, then tick this plugin's tools and the WooCommerce Analytics tools under Easy MCP AI › Tools › Abilities (on a store where Easy MCP AI was set up before this version, the analytics tools are not ticked for you; the setup screen lists any that are missing). Use Easy MCP AI's own Connect screen (the setup screen links to it) and choose Custom, then tick Abilities — Blaze-mcp-toolkit and Abilities — Wc-analytics under Customize permissions. Read-only does not include them, and Full access turns on Easy MCP AI's own tools that can change your site. If you approve with nothing ticked, the connection doesn't finish and your AI app asks you to connect again. The setup screen also tells you how to keep customer details out of AI chats, because some of Easy MCP AI's own tools can return them.
I have both connection plugins active. Which one is used?
New Claude and ChatGPT connections go through Easy MCP AI, because it takes over the sign-in when it is active. The setup screen shows Easy MCP AI's connection link and warns you that two are active. A connection made through MCP Adapter and Enable Abilities before Easy MCP AI was active can't be reconnected while Easy MCP AI is active: make a new connection with Easy MCP AI's link, or deactivate Easy MCP AI. To use MCP Adapter and Enable Abilities for new connections, deactivate Easy MCP AI.
How do I add it to ChatGPT?
In ChatGPT, open Plugins > Add > Add custom MCP server, paste the connector URL from WooCommerce > Blaze MCP Toolkit, and choose OAuth. With Enable Abilities for MCP, turn on "ChatGPT & Other OAuth Connectors" in Settings > WP Abilities first. In our testing this worked on a Free ChatGPT account.
How do I add it to Claude?
In claude.ai, open Customize > Connectors > Add > Add custom connector and paste the connector URL. The connector then works in Claude on the web, desktop and mobile. Claude may ask you to approve each tool call the first time; that's Claude's setting for the connector, not a sign that the tool writes anything.
Connecting fails with a 403 error
A firewall or CDN in front of your site (Cloudflare, Kinsta Bot Protection, a security plugin) is blocking the assistant's server. With Option 1 (Enable Abilities), add path exceptions for /.well-known/oauth-*, /oauth/* and /wp-json/mcp/*. With Option 2 (Easy MCP AI), add them for /.well-known/oauth-*, /.well-known/openid-configuration, /easy-mcp-ai/*, /wp-json/easy-mcp-ai/*, /authorize, /token and /register. The setup screen lists the exact paths for your connection. Don't allow it by matching a user agent: that lets anything claiming to be the assistant through.
With Easy MCP AI, your site also fetches the assistant's sign-in details (for Claude, from claude.ai) while you connect. A firewall or security plugin that blocks your site's own outgoing requests makes sign-in fail with an invalid_client error: allow outgoing requests to the assistant's domain.
The sign-in page says the session expired or the state is invalid
Log in to wp-admin in the same browser before clicking Connect, then click the approve button once (Allow with Enable Abilities, Approve & Continue with Easy MCP AI). Clicking it twice shows an error even though the first click worked, so check the connector before trying again.
Why are some tools off for a Shop Manager?
Store health and update history show error logs and plugin details, so they are for Administrators by default. You can let Shop Managers use them with the checkbox on WooCommerce > Blaze MCP Toolkit. The access check lists API keys and app passwords, so it stays Administrator-only. When a workflow skips a step for your role, the AI tells you which check was skipped.
Why does the AI say sales analytics are unavailable?
The analytics tools read WooCommerce Analytics, and the plugin refuses to report numbers it knows are incomplete. There are three usual reasons:
- Analytics is turned off: WooCommerce > Settings > Advanced > Features.
- The historical import hasn't finished: Analytics > Settings > Import historical data.
- Recent orders haven't synced because WooCommerce's background jobs are stalled: check WooCommerce > Status > Scheduled Actions for pending wc-admin jobs.
I already use WooCommerce for Claude. What happens?
This plugin steps aside for the tools the two share. While WooCommerce for Claude is active, the sales analytics and store tools come from it, and this plugin doesn't load its own copies, so you won't see duplicates or conflicts. Store health, update history, access check and the workflows keep working, and a notice on the setup screen explains this.
My host doesn't give me an error log. Will store health still work?
Yes. The PHP errors section shows amber and says no error log is available, rather than showing green, and the background jobs and updates sections work as normal. Turning on WP_DEBUG_LOG, or asking your host where PHP errors are written, gives it something to read.
Does it work with HPOS?
Yes, with High-Performance Order Storage on or off.
更新日志:
- Works with Easy MCP AI as well as MCP Adapter with Enable Abilities for MCP. You only need one of them.
- The setup screen now checks and explains the connection plugin you actually use, with its own connector URL and steps.
- Workflows now name the right tools for the connection they are used through.
- Fixed the confirmation prompt for ranges longer than 365 days so it names the correct tool.
- Privacy text and readme now cover both connection plugins.
- First release.
- Store health, update history and access check tools.
- Weekly store review, revenue drop, failed order and refund workflows.
- Setup check screen with fixes for each step, and a privacy warning for other tools that return customer details.
- Bundles the commerce-abilities package from WooCommerce for Claude by Automattic (https://github.com/woocommerce/woocommerce-claude, GPL-3.0-or-later), version 0.4.5, commit cdab921aab8d07ef813121ff78b3558af28f39fa, unmodified. It provides the wc-analytics tools and the store knowledge tools.