Connect Desktop Apps Using The Local Bridge

Some desktop AI applications require a local MCP bridge rather than a direct HTTP or remote OAuth connection.

WholesaleX provides a local bridge configuration using Automattic’s MCP WordPress Remote package and WordPress application-password authentication.

This method can be used with desktop AI applications that support the supplied local MCP configuration.

Before You Begin

Make sure you have:

  • Completed the Getting Started with WholesaleX MCP guide.
  • Copied your WholesaleX server address.
  • Installed Node.js with npx available to your desktop application.
  • Created an application password by following How to Create a WordPress Application Password for WholesaleX MCP.

You do not need to generate a Base64 authentication value for this connection method.

Unlike remote web connectors, a local bridge may connect to a website accessible only from your computer, provided its network and authentication requirements are satisfied.

Configure the Local MCP Bridge

  1. Navigate to WholesaleX → AI Tools.
  2. Under Connect an AI assistant, select Desktop apps.
  3. Locate the provided Setup snippet.
  4. Open your desktop application’s MCP configuration file.
  5. Merge the supplied configuration into the existing mcpServers object.

The configuration follows this format:

{

  "mcpServers": {

    "wholesalex": {

      "command": "npx",

      "args": [

        "-y",

        "@automattic/[email protected]"

      ],

      "env": {

        "WP_API_URL": "https://example.com/wp-json/wholesalex/mcp",

        "WP_API_USERNAME": "YOUR-WORDPRESS-USERNAME",

        "WP_API_PASSWORD": "YOUR-APPLICATION-PASSWORD"

      }

    }

  }

}

Replace the following values with your own information:

  • WP_API_URL: Your WholesaleX MCP server address.
  • WP_API_USERNAME: Your WordPress administrator username.
  • WP_API_PASSWORD: Your generated WordPress application password.

Save the configuration file and restart your desktop application.

Always prefer the Setup snippet provided by your installed version of WholesaleX.

The configuration file location may vary between applications. For Claude Desktop versions supporting manual MCP configuration, the file is named claude_desktop_config.json.

Verify Your Connection

Open your desktop application and check whether the WholesaleX MCP server is connected.

Follow the Verify Your WholesaleX MCP Connection instructions in the Getting Started guide to confirm that your application can retrieve store information.

Keep the configuration file private because it contains your WordPress application password.

For more information about the local bridge, see the Automattic MCP WordPress Remote documentation.