Skip to content

Latest commit

 

History

History
172 lines (124 loc) · 4.13 KB

mcp-install.mdx

File metadata and controls

172 lines (124 loc) · 4.13 KB
title description
MCP Setup
Set up the Respira WordPress MCP server using dashboard-generated config, install commands, and AI setup prompts for Cursor, Codex, and Claude Code.

This page is specifically for the standalone Respira MCP server install flow.

If you want the official WordPress-native adapter path, see WordPress AI Stack Compatibility. If you want the Elementor browser path, see Elementor Angie.

Overview

This page explains how to install the Respira WordPress MCP server. Recommended path is the account dashboard MCP setup flow.

Quick Install Methods

Method 1: Dashboard MCP setup (Recommended)

Go to respira.press → Dashboard → MCP Setup and choose one:

  • Download client config
  • Copy one-time install command
  • Copy AI setup prompt

Supported generated client formats:

  • Cursor
  • Codex
  • Claude Code

Method 2: Interactive Setup Wizard

The fastest and easiest way to get started:

npx @respira/wordpress-mcp-server --setup

The setup wizard will:

  • Guide you through configuration step-by-step
  • Validate your WordPress URL and API key
  • Test your connection before saving
  • Generate the config file automatically
  • Show you what to add to your AI tool

Method 3: npm Installation

Install globally:

npm install -g @respira/wordpress-mcp-server

Or run without installing:

npx -y @respira/wordpress-mcp-server

CLI Options

npx @respira/wordpress-mcp-server --setup   # Run setup wizard
npx @respira/wordpress-mcp-server --list    # List configured sites
npx @respira/wordpress-mcp-server --test    # Test connection to default site
npx @respira/wordpress-mcp-server --help    # Show help

License Requirements

The MCP server requires a valid license and API key. The install link only adds the MCP server entry to your MCP client—it does not activate or configure the WordPress connection.

You must still:

  • Have an active Respira license or trial
  • Install and connect Respira plugin on your WordPress site
  • Keep your generated config/token secure

Manual Configuration

If you prefer manual setup, create a configuration file at ~/.respira/config.json:

{
  "sites": [
    {
      "id": "my-site",
      "name": "My WordPress Site",
      "url": "https://your-wordpress-site.com",
      "apiKey": "respira_your-api-key-here",
      "default": true
    }
  ]
}

Then configure your AI assistant:

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "respira-wordpress": {
      "command": "npx",
      "args": ["-y", "@respira/wordpress-mcp-server"]
    }
  }
}

Codex

Add to Codex MCP configuration:

[mcp_servers.respira-wordpress]
command = "npx"
args = ["-y", "@respira/wordpress-mcp-server"]

Claude Code

Add to ~/.claude.json:

{
  "mcpServers": {
    "respira-wordpress": {
      "command": "npx",
      "args": ["-y", "@respira/wordpress-mcp-server"]
    }
  }
}

Windsurf

Add to your Windsurf MCP configuration:

{
  "mcpServers": {
    "respira-wordpress": {
      "command": "npx",
      "args": ["-y", "@respira/wordpress-mcp-server"]
    }
  }
}

How MCP Install Links Work

An MCP install link uses a URL format recognized by Cursor and Claude Desktop. When you click a link:

  1. Your browser opens the deep link
  2. Cursor or Claude Desktop detects the installation request
  3. A new MCP server entry is added to your MCP settings
  4. You may need to restart your client for the new server to activate

These setup flows add the MCP server reference. Site auth and site inventory are still enforced by your connected Respira account/config.

Next Steps