Connect Claude Desktop | WP Visibility Docs

Claude Desktop reaches the site through a local bridge, @automattic/mcp-wordpress-remote, that runs on your computer, holds the site address and the Application Password, and talks to the plugin’s MCP endpoint for you. The plugin prints the block you need; you paste it into Claude Desktop’s configuration file and restart the app.

Before you start

An Application Password for the WordPress user the assistant will act as.
The Assistant connection module turned on in WP Visibility → Settings → Modules, with Autopilot on and Assistant changes set to Hold for my review if you want writes to wait for you.
Node.js 22 or newer on the computer running Claude Desktop. The bridge starts with npx, which comes with Node.

1. Print the block

On the site, from WP-CLI, with the assistant’s username:

wp visibility mcp-config --user=seo-agent

It prints a mcpServers entry like this one, with your site filled in:

{
  "mcpServers": {
    "your-site-com": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wordpress-remote@latest"],
      "env": {
        "WP_API_URL": "https://your-site.com/wp-json/wp-visibility/mcp",
        "WP_API_USERNAME": "seo-agent",
        "WP_API_PASSWORD": "<application password>"
      }
    }
  }
}

WP_API_URL must be the full endpoint address ending in /wp-json/wp-visibility/mcp. Given only the site’s home address, the bridge assumes an older WordPress MCP plugin and looks for a route this plugin does not provide.

If you do not have WP-CLI, write the block by hand from the example: the site address, the username, and the password from the previous doc.

2. Add it to Claude Desktop

Open Claude Desktop → Settings → Developer → Edit Config. That opens claude_desktop_config.json (on macOS under ~/Library/Application Support/Claude/, on Windows under %APPDATA%\Claude\). Paste the block. If the file already has a mcpServers object, add your site as another entry inside it rather than a second object. Replace <application password> with the real one, save, and quit and reopen Claude Desktop.

Keep this file private. It now contains a login to your site.

3. Check it

Start a new conversation. The tools icon lists the site’s tools. Ask for a read first:

What are the SEO title and meta description of the post called “About us”?

Then ask for one change:

Propose a better meta description for that post.

With Hold for my review selected, the reply names a proposal ID and nothing on the site has changed. Open WP Visibility → Review queue and the proposal is there with its diff. If it is not, this doc finds out why.

Several sites in one Claude

Run mcp-config on each site and put each block in the same mcpServers object, with its own name. Claude sees one tool set per site and asks which you mean when a request is ambiguous.

Why not the custom connector form

Claude’s Add custom connector form takes a server URL and, optionally, OAuth client details. The plugin’s endpoint authenticates with a WordPress Application Password, which that form has no field for, so the bridge is the supported route for Claude Desktop today. Checked September 21, 2026 against Anthropic’s connector documentation dated August 11, 2026.