MCP Setup Guide
Get the best AI-assisted WordPress development experience by combining WPZylos MCP with official WordPress and WooCommerce MCPs.
Overview
| MCP Server | Purpose | Maintainer |
|---|---|---|
| wpzylos-mcp | WPZylos framework code gen, validation, stubs | WPDigger Studio |
| mcp-adapter | WordPress core APIs, content, users, hooks | WordPress.org |
| WooCommerce MCP | Products, orders, payments, shipping | Automattic |
Step 1: Install WPZylos MCP
cd path/to/wpzylos/wpzylos-mcp
npm install && npm run build
Step 2: Install WordPress MCP Adapter
git clone https://github.com/WordPress/mcp-adapter.git
cd mcp-adapter
npm install && npm run build
For full setup instructions, see WordPress/mcp-adapter docs.
Requirements:
- WordPress 6.9+ (for Abilities API)
- Application Password for authentication
- Site must be accessible via HTTP
Step 3: WooCommerce MCP
Option A: Native (Recommended)
WooCommerce 10.3+ has built-in MCP support via the WordPress Abilities API. No additional installation needed — just enable the WordPress MCP adapter and WooCommerce abilities will be available automatically.
See WooCommerce MCP docs for configuration.
Option B: External (Headless/Multi-site)
git clone https://github.com/techspawn/woocommerce-mcp-server.git
cd woocommerce-mcp-server
npm install
Configure with your WooCommerce REST API keys (Consumer Key + Secret).
Step 4: Configure Your AI Client
Add all three MCPs to your AI client configuration.
Claude Desktop / Cursor / Windsurf
Edit your MCP configuration file:
{
"mcpServers": {
"wpzylos": {
"command": "node",
"args": ["D:/path/to/wpzylos-mcp/dist/index.js"],
"env": {
"WPZYLOS_FRAMEWORK_ROOT": "D:/path/to/wpzylos"
}
},
"wordpress": {
"command": "node",
"args": ["D:/path/to/mcp-adapter/build/index.js"],
"env": {
"WORDPRESS_URL": "https://your-site.test",
"WORDPRESS_USERNAME": "admin",
"WORDPRESS_APP_PASSWORD": "xxxx xxxx xxxx xxxx"
}
},
"woocommerce": {
"command": "node",
"args": ["D:/path/to/woocommerce-mcp-server/dist/index.js"],
"env": {
"WC_URL": "https://your-site.test",
"WC_CONSUMER_KEY": "ck_xxxxxxxx",
"WC_CONSUMER_SECRET": "cs_xxxxxxxx"
}
}
}
}
VS Code (Gemini / GitHub Copilot)
Add to your workspace .vscode/mcp.json:
{
"servers": {
"wpzylos": {
"command": "node",
"args": ["${workspaceFolder}/wpzylos-mcp/dist/index.js"],
"env": {
"WPZYLOS_FRAMEWORK_ROOT": "${workspaceFolder}"
}
}
}
}
What Each MCP Provides
WPZylos MCP (Framework Layer)
- 55 tools for code generation, validation, scaffolding
- 42 stub templates for all framework components
- DaisyUI/Vue/React/CssHelper/JsMount knowledge base
- WooCommerce hooks knowledge base (48 hooks)
- Framework compliance validation
- Plugin structure analysis
WordPress MCP (Core Layer)
- Post/Page/Media CRUD
- User and role management
- Taxonomy and term operations
- WordPress Options API
- REST API endpoint interaction
- Hook registration and management
- Plugin/Theme activation
WooCommerce MCP (E-commerce Layer)
- Product CRUD (simple, variable, grouped)
- Order management and fulfillment
- Customer data management
- Inventory tracking
- Payment gateway interaction
- Shipping method configuration
- Analytics and reporting
Verification
After setup, verify each MCP is working:
# In your AI assistant, try:
"List all WPZylos packages" -> wpzylos-mcp responds
"Get all WordPress posts" -> wordpress mcp responds
"List all WooCommerce products" -> woocommerce mcp responds
Troubleshooting
| Issue | Solution |
|---|---|
| MCP not connecting | Check command path points to correct dist/index.js |
| WordPress auth fails | Generate Application Password in WP Admin -> Users -> Profile |
| WooCommerce API 401 | Verify Consumer Key/Secret have read/write permissions |
| Tools not showing | Restart your AI client after config changes |