Add the WooCommerce MCP server to Windsurf

Prerequisites

• Windsurf installed.
• WP_API_URL — Your store's WooCommerce MCP endpoint, e.g. https://yourstore.com/wp-json/woocommerce/mcp.
• CUSTOM_HEADERS — JSON object carrying the auth header, e.g. {"X-MCP-API-Key": "CONSUMER_KEY:CONSUMER_SECRET"} using WooCommerce REST API keys.

Setup

{
  "mcpServers": {
    "woocommerce": {
      "command": "npx",
      "args": [
        "-y",
        "@automattic/mcp-wordpress-remote@latest"
      ],
      "env": {
        "WP_API_URL": "<WP_API_URL>",
        "CUSTOM_HEADERS": "<CUSTOM_HEADERS>"
      }
    }
  }
}

Gotchas

Windsurf's Cascade reads MCP servers from an "mcpServers" object in ~/.codeium/windsurf/mcp_config.json. Unlike most clients, remote servers are configured with the "serverUrl" field rather than "url", so a config that uses "url" silently fails to connect. Native remote transport is supported without an OAuth flow.