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: Paste the setup prompt into your AI client

Open Novamira > Connect in the WordPress admin. The page generates a setup prompt that contains your connection URL, username, application password, and the rules your AI client needs to write its own config.

Click Copy prompt, then paste it into a new conversation with your AI client (Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Zed, OpenCode, or any MCP-compatible client). The agent reads the details and writes the MCP server config for you. Restart or reload the MCP session when it asks, then verify it lists Novamira’s tools.

Note: the prompt contains an application password that grants access to your site. Don’t share it with anyone.

Alternative: write the config manually

If your client can’t modify its own config from inside a conversation, expand Need the JSON config for a specific client? on the Connect page to copy a ready-made snippet, then paste it into the client’s config 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/novamira",
        "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 three tools exposed by the MCP adapter: Discover Abilities, Get Ability Info, and Execute Ability. Through these, your AI client can discover and invoke all Novamira abilities (Execute PHP, Read/Write/Edit/Delete/Disable/Enable File, List Directory, and more).

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.