| 开发者 | suhanduman |
|---|---|
| 更新时间 | 2026年6月18日 00:49 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
/.well-known/ucp — agents auto-find your store/wp-json/agtc/v1/mcp — JWT-authenticated tools for product listing, search, and order lookup/wp-json/agtc/v1/acp/checkouts — agentic checkout sessions with Stripe payment_intent supportclient_credentials grant<link> tags, HTTP Link headers, robots.txt advisory, /llms.txt/merchant-feed/google.xml — a self-hosted, Google-spec product feed you register as a scheduled fetch/.well-known/ucp/oauth/register → receives client ID + secret/oauth/token/mcp (search, list)/acp/checkouts/.well-known/ucp on each domain it knows about. If that file doesn't exist, your store is invisible to the agent — not low-ranked, invisible.
This plugin publishes that file automatically, along with the MCP tools the agent uses to actually browse your catalog. You don't have to write a single line of integration code; activating the plugin is enough to put your store on the map for every agent that speaks UCP, MCP, or ACP.
A few complementary moves we recommend alongside this plugin: register your products in Google Merchant Center so the Google Shopping feed picks them up, keep product titles and descriptions clear and well-structured (the same SEO discipline that helps humans also helps AI parsing), and make sure your site runs on HTTPS end-to-end so agents trust the responses.
Once your store is published, agents can do three things that previously required a human: discover that you exist, browse your catalog in real time, and — with ACP enabled — create a real WooCommerce order on behalf of their user, with the same checkout, tax, shipping, and fulfillment plumbing your human customers go through today.
Google Merchant Center
The plugin publishes a Google-spec product feed at https://yourstore.com/merchant-feed/google.xml. It is fully self-hosted — the plugin contacts no external service. Instead, you register that URL in Google Merchant Center → Products → Feeds as a scheduled fetch, and Google pulls the feed on its own schedule. Once Google has the feed, your products become eligible for Google Shopping and Google's shopping AI.
The feed is built from your published, catalog-visible WooCommerce products and includes each product's title, description, price, availability, image, and — when set — brand and GTIN. Filling in brand and GTIN (Products → product → Inventory → Global Unique ID, on WooCommerce 9.2+) materially improves listing quality and how often Google can match your products. Variable products are expanded to their purchasable variations. The generated XML is cached for one hour to keep the endpoint fast.
Privacy & Data Handling
This plugin is built to be conservative about data:
read:orders scope cannot read any orders at all, and read:orders is never granted by open client registration unless it is explicitly requested.manage_woocommerce capability and a verified WordPress CSRF nonce.payment_intent flow is explicitly enabled by defining the AGTC_STRIPE_SECRET_KEY constant in wp-config.php. When an agent completes a checkout session under that flow, the plugin makes a server-to-server POST to https://api.stripe.com/v1/payment_intents to authorize the payment. No data is sent to Stripe unless this flow is activated. Stripe service terms: https://stripe.com/legal — Stripe privacy policy: https://stripe.com/privacy./wp-content/plugins/agtc-commerce (or install via WP admin → Plugins → Add New)AGTC_STRIPE_SECRET_KEY in wp-config.php to enable ACP payment intentsNo. WooCommerce 10.7+ ships internal ACP infrastructure with the agentic_checkout feature flag (default off). Our Coexistence detector activates our endpoints only when the WC native flag is off, and defers (410 + Location header) when on.
Only for ACP payment_intent flow. Without Stripe, agents can still discover, browse, and create checkout sessions — they just can't authorize payment through ACP directly. There are two flow models to choose from, and most stores can start without Stripe entirely:
payment_intent): Requires Stripe. The ACP protocol uses Stripe's PaymentIntent under the hood, so you must define AGTC_STRIPE_SECRET_KEY in wp-config.php. The agent never sees the customer's card; payment is captured server-side at session completion. This is the fully autonomous flow.By default, public product data only (name, price, description, images). An agent can additionally read its own orders if it holds the read:orders scope — but only orders it created itself through the ACP checkout flow. Agents never see other agents' orders or orders placed by human customers through normal checkout.
Order access is scoped to ownership and safe by default: an agent (OAuth client) can only ever read orders it created itself via the ACP checkout flow. It can never read another agent's orders or orders placed by human customers through normal checkout.
To read its own orders, an agent must request the read:orders scope at registration; dynamic client registration only ever grants read:products by default, so read:orders must always be requested explicitly. No server-side opt-in or wp-config.php constant is required.
Yes. Client secrets are hashed with password_hash(). Access tokens are RS256-signed JWTs with iat, exp (max 2h), aud, iss, and jti claims. Admin endpoints require WP nonce + manage_woocommerce.
Open the AI Readiness dashboard. If JWKS rotation is needed, click the "Rotate JWKS keypair now" button. Old key remains valid for a 24h grace period.
On WordPress 7.0 this plugin registers its tools as WordPress Abilities, making them available through the core MCP Adapter to clients such as Claude Desktop, Claude Code, Cursor, and VS Code. Those clients authenticate with standard WordPress application passwords — no OAuth setup is required on their side. The plugin's own OAuth MCP server remains active alongside the core adapter and continues to serve headless or autonomous agents that manage their own credentials. The AI Readiness dashboard shows a "Protocol exposure" card with two settings: MCP exposure controls which MCP path is active: "both" (default — core adapter and plugin server run side by side), "core" (plugin's own MCP server is disabled, traffic goes to the WP core adapter only), or "plugin" (core adapter integration is disabled, plugin MCP server only). ACP exposure controls ACP checkout availability: "auto" (default — plugin ACP is active when WooCommerce native ACP is off, deferred when on), "plugin" (plugin ACP is always active regardless of WC native state), or "off" (ACP checkout is fully disabled). Both settings can be overridden programmatically with the filters agtc_mcp_exposure_mode and agtc_acp_exposure_mode, which receive the stored option value and should return one of the accepted mode strings.
The plugin publishes a Google-spec product feed at https://yourstore.com/merchant-feed/google.xml. In Google Merchant Center, go to Products → Feeds, add a new feed, and choose the scheduled fetch option pointing at that URL. Google then fetches the feed on its own schedule — the plugin never contacts Google. The feed carries title, description, price, availability, image, and brand/GTIN when set; adding a brand and GTIN to each product improves listing quality and match rate. The dashboard's FEED-001 check flags products missing those attributes.
/merchant-feed/google.xml + dashboard feed-readiness audit/admin/fix REST endpoint with nonce + capability checksetAccessible, curl_close)iat claim and 2h max token lifetime