MCP Setup Guide

Get the best AI-assisted WordPress development experience by combining WPZylos MCP with official WordPress and WooCommerce MCPs.

Overview

MCP ServerPurposeMaintainer
wpzylos-mcpWPZylos framework code gen, validation, stubsWPDigger Studio
mcp-adapterWordPress core APIs, content, users, hooksWordPress.org
WooCommerce MCPProducts, orders, payments, shippingAutomattic

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

IssueSolution
MCP not connectingCheck command path points to correct dist/index.js
WordPress auth failsGenerate Application Password in WP Admin -> Users -> Profile
WooCommerce API 401Verify Consumer Key/Secret have read/write permissions
Tools not showingRestart your AI client after config changes

Further Reading