Connecting Your AI Client

This page explains how to connect any MCP-compatible AI client to your WordPress site running Novamira. You will create an application password for authentication and configure your AI client with the correct MCP server settings.

Step 1: Create an Application Password

Application Passwords are a WordPress feature that lets external applications authenticate without using your main login password. Each application password is a separate credential that can be revoked independently.

  1. In the WordPress admin, go to Novamira > Connect.
  2. Under Application Passwords, optionally enter a name (defaults to “Novamira”) and click Create New Application Password.
  3. Copy the password immediately. It will not be shown again after you leave the page.

Application Passwords require HTTPS. For local development without HTTPS, add this to your wp-config.php:

define( 'WP_ENVIRONMENT_TYPE', 'local' );

Step 2: Configure your AI client

The Novamira > Connect page generates ready-made configuration snippets for seven popular AI clients. Select your client from the tabs to get the exact JSON to paste into your client’s configuration file.

The configuration tells your AI client to run the MCP WordPress Remote proxy via npx. This proxy bridges the MCP protocol to your WordPress REST API.

The general configuration pattern (adapt the field names for your specific client):

{
  "mcpServers": {
    "novamira": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wordpress-remote@latest"],
      "env": {
        "WP_API_URL": "https://your-site.com/wp-json/mcp/mcp-adapter-default-server",
        "WP_API_USERNAME": "your-wordpress-username",
        "WP_API_PASSWORD": "your-application-password"
      }
    }
  }
}

Replace the placeholder values with your actual site URL, WordPress username, and the application password you created in Step 1.

Supported clients

The Connect page provides specific instructions and configuration file locations for:

Client Config file
Claude Code Run command in terminal
Claude Desktop claude_desktop_config.json (macOS/Windows paths shown)
Cursor Global or Project .cursor/mcp.json
VS Code Workspace .vscode/mcp.json or User settings via command palette
Windsurf mcp_config.json (macOS/Linux/Windows paths shown)
Zed settings.json (macOS/Linux path shown)
OpenCode Project .opencode/config.json or global config

Novamira works with any MCP-compatible client, not just the ones listed above. The protocol is standard. If your client supports MCP servers, you can configure it using the general pattern shown above.

Step 3: Verify the connection

After configuring your AI client, start a new session and look for the Novamira tools in your client’s tool list. You should see eight tools: Execute PHP, Read File, Write File, Edit File, Delete File, Disable File, Enable File, and List Directory.

Try a simple command to verify everything works: ask your AI to “list the plugins installed on this WordPress site.” It should use the Execute PHP tool to run a query and return the list of active plugins.

Local connections via STDIO

If WordPress runs locally on your machine and you have WP-CLI installed, you can connect via STDIO transport without Node.js. See the MCP Adapter documentation for STDIO setup instructions.

Troubleshooting

  • “Application Passwords require HTTPS”: Your site must be served over HTTPS, or you need WP_ENVIRONMENT_TYPE set to local.
  • Connection refused: Verify that AI abilities are enabled in Novamira > Settings.
  • Authentication failed: Double-check your WordPress username and application password. The username is case-sensitive.
  • “npx: command not found”: Node.js is not installed or not in your PATH. See Installing Node.js.
  • Tools not showing up: Restart your AI client after adding the MCP configuration. Some clients require a restart to pick up new MCP servers.