How to Connect WowShipping to Desktop Apps and CLI Tools

Connect WowShipping to compatible desktop applications and command-line interface (CLI) tools using WordPress application passwords. These methods support reachable live and locally hosted websites.

ApplicationConnection Method
Claude Desktop, Cursor, WindsurfLocal bridge using mcpServers
VS CodeLocal bridge using servers and type: stdio
Claude Code, Gemini CLIDirect HTTP with an Authorization header

Before You Begin

  • Complete Getting Started with WowShipping MCP.
  • Set Access Mode to Read only and save.
  • Ensure your computer can reach your website.
  • Confirm that WordPress application-password authentication is available.

Use HTTPS for live or remote websites. Local development environments may use HTTP where authentication is supported.

Create a WordPress Application Password

  1. Navigate to WooCommerce → WowShipping → AI Tools → Connect an AI assistant.
  2. Select Desktop apps or CLI tools.
  3. Click Create an application password.
  4. Under Application Passwords, enter a name identifying the application.
  5. Click Add New Application Password.
  6. Copy and securely store the generated password.

WordPress displays the password only once. Create a separate application password for each client so you can revoke access individually.

Connect Desktop Apps Using the Local Bridge

Install Node.js on your computer and ensure npx is available to your application.

Claude Desktop, Cursor and Windsurf

  1. Select Desktop apps in the WowShipping connection panel.
  2. Copy the desktop app configuration.
  3. Replace the username and application-password placeholders.
  4. Add the configuration to your application’s MCP configuration file.
  5. Save the file and restart the application.
ApplicationConfiguration File
Claude Desktopclaude_desktop_config.json
Cursor.cursor/mcp.json
Windsurfmcp_config.json

Use the appropriate file location for your application.

Example configuration:

{
  "mcpServers": {
    "wowshipping": {
      "command": "npx",
      "args": ["-y", "@automattic/[email protected]"],
      "env": {
        "WP_API_URL": "http://example.local/wp-json/wtrs/mcp",
        "WP_API_USERNAME": "YOUR-WORDPRESS-USERNAME",
        "WP_API_PASSWORD": "YOUR-APPLICATION-PASSWORD",
        "OAUTH_ENABLED": "false"
      }
    }
  }
}

Replace the example server address with your actual WowShipping MCP server address. Preserve OAUTH_ENABLED as shown.

If mcpServers already exists, merge the wowshipping entry without removing existing servers.

Always prefer the configuration generated by your installed WowShipping version.

VS Code

VS Code uses a different MCP configuration format.

Copy the VS Code configuration from WowShipping and add it to .vscode/mcp.json.

{
  "servers": {
    "wowshipping": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@automattic/[email protected]"],
      "env": {
        "WP_API_URL": "http://example.local/wp-json/wtrs/mcp",
        "WP_API_USERNAME": "YOUR-WORDPRESS-USERNAME",
        "WP_API_PASSWORD": "YOUR-APPLICATION-PASSWORD",
        "OAUTH_ENABLED": "false"
      }
    }
  }
}

Replace the example server address and credential placeholders. Merge the WowShipping entry into any existing servers object, save the file and restart the application.

Local bridge connections use your application password directly. Base64 encoding is not required.

Connect CLI Tools Using Direct HTTP

Claude Code and Gemini CLI authenticate through an Authorization header containing your WordPress username and application password encoded in Base64.

Generate Your Base64 Credentials

Open Bash on macOS, Linux or Git Bash on Windows and run:

read -r -p "WordPress username: " wtrs_user
read -r -s -p "Application password: " wtrs_pass
printf '\n'
printf '%s:%s' "$wtrs_user" "$wtrs_pass" | base64 | tr -d '\r\n'
printf '\n'
unset wtrs_user wtrs_pass

Enter your actual WordPress username and generated application password when prompted.

Copy the resulting value and use it wherever the configuration says BASE64-CREDENTIALS.

Important: Base64 is encoding, not encryption. Treat the encoded value as a password and never use public online encoders.

Connect WowShipping to Claude Code

Copy the Claude Code command from the CLI tools tab in WowShipping or use this example:

claude mcp add --transport http wowshipping \
  'http://example.local/wp-json/wtrs/mcp' \
  --header 'Authorization: Basic BASE64-CREDENTIALS'

Replace the example URL and encoded credential placeholder before running the command.

Run claude mcp list, then use /mcp inside Claude Code to check the connection and available tools.

See Claude Code MCP documentation for additional configuration details.

Connect WowShipping to Gemini CLI

Open or create ~/.gemini/settings.json and add the Gemini CLI configuration from WowShipping.

{
  "mcpServers": {
    "wowshipping": {
      "httpUrl": "http://example.local/wp-json/wtrs/mcp",
      "headers": {
        "Authorization": "Basic BASE64-CREDENTIALS"
      }
    }
  }
}

Replace the example URL and encoded credential placeholder. Merge the WowShipping entry into any existing mcpServers object.

Save the file, restart Gemini CLI and run /mcp to check the connection and available tools.

See Gemini CLI MCP documentation.

Test Your Connection

Enable WowShipping in your application and send the prompt under Confirm your AI can read this store from the WowShipping AI Tools page.

An actual tool response containing your store information confirms read access but not write permissions.

Revoke Application Access

Navigate to Users → Profile → Application Passwords, revoke the relevant password and remove saved credentials from your application.

Keep authentication values, terminal history and configuration files private. Never commit credentials to shared repositories.

For additional configuration information, see the WordPress Application Passwords documentation and Automattic MCP WordPress Remote documentation.

For connection issues, see Troubleshooting WowShipping MCP Connections.