Cómo conectar WordPress con IA usando el MCP Adapter de WordPress

Si tienes WordPress y quieres que tu asistente de IA (como Claude, opencode o cualquier cliente MCP) pueda interactuar directamente con tu sitio, el WordPress MCP Adapter es la pieza que faltaba. En esta guía te explico cómo lo instalamos y configuramos paso a paso.

¿Qué es el MCP Adapter?

Es un plugin oficial de WordPress que implementa el Model Context Protocol (MCP), un estándar abierto que permite a asistentes de IA descubrir y ejecutar capacidades (abilities) de WordPress de forma programática. Básicamente, convierte tu WordPress en un servidor MCP al que cualquier cliente compatible puede conectarse.

Requisitos

• WordPress ≥ 6.9
• PHP ≥ 7.4
• Acceso de administrador al sitio
• Una Application Password de WordPress (Usuarios → Perfil → Application Passwords)
• Node.js ≥ 18 (para el proxy @automattic/mcp-wordpress-remote)

Instalación del plugin

Descargamos el plugin desde GitHub y lo instalamos como cualquier plugin de WordPress. La clave está en ejecutar composer install dentro de la carpeta del plugin para que se instale la dependencia php-mcp-schema.

Si prefieres no usar Composer en el servidor, puedes preparar el ZIP con dependencias incluidas desde tu máquina local usando Docker o PHP directamente, y luego subir el ZIP ya completo.

Cómo funciona

El MCP Adapter expone tres herramientas MCP en su servidor por defecto:

• mcp-adapter-discover-abilities — lista todas las abilities registradas
• mcp-adapter-get-ability-info — muestra el esquema de entrada/salida de una ability
• mcp-adapter-execute-ability — ejecuta una ability con los parámetros indicados

Las abilities deben ser registradas por plugins o temas mediante wp_register_ability() con el flag meta.mcp.public = true. Esto permite que desarrolladores expongan funcionalidades específicas de forma segura y controlada a los asistentes de IA.

Conectar desde cualquier cliente MCP

El proxy @automattic/mcp-wordpress-remote se encarga de traducir el protocolo STDIO de MCP a llamadas HTTP a la REST API de WordPress. Esto significa que cualquier cliente MCP puede conectarse con la misma configuración base. Solo cambia el archivo donde se define.

1. opencode

Se configura en ~/.config/opencode/opencode.json:

{
  "mcp": {
    "wordpress": {
      "type": "local",
      "command": ["npx", "-y", "@automattic/mcp-wordpress-remote@latest"],
      "environment": {
        "WP_API_URL": "https://tusitio.com/wp-json/mcp/mcp-adapter-default-server",
        "WP_API_USERNAME": "tu-email",
        "WP_API_PASSWORD": "tu-application-password"
      },
      "enabled": true
    }
  }
}

Una vez añadido, los comandos MCP de WordPress están disponibles al instante. opencode los detecta automáticamente al siguiente mensaje.

2. Claude Desktop

Se configura en ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Guarda y reinicia Claude Desktop. Aparecerá un icono de herramienta (🔧) indicando que el servidor MCP de WordPress está conectado. Desde ese momento puedes pedirle a Claude que interactúe con tu WordPress.

3. Claude Code (CLI)

Se configura en ~/.claude/claude.json (global) o en un claude.json local dentro del proyecto:

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

Si lo pones en el proyecto, los miembros del equipo lo tienen disponible al hacer cd al directorio. Claude Code detecta los cambios automáticamente.

4. VS Code

Con la extensión GitHub Copilot Chat, se configura en .vscode/settings.json del proyecto:

{
  "github.copilot.chat.mcpServers": {
    "wordpress": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wordpress-remote@latest"],
      "env": {
        "WP_API_URL": "https://tusitio.com/wp-json/mcp/mcp-adapter-default-server",
        "WP_API_USERNAME": "tu-email",
        "WP_API_PASSWORD": "tu-application-password"
      }
    }
  }
}

Guarda y recarga la ventana. Las herramientas MCP de WordPress aparecerán en el chat de Copilot. Verifica el estado con Cmd+Shift+P → Chat: MCP Servers.

5. Cursor

Se configura en .cursor/mcp.json del proyecto:

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

Cursor las detecta automáticamente. Puedes verificarlas desde el chat de IA o la paleta de comandos buscando “MCP”.

Consejos de seguridad

• Usa siempre Application Passwords en lugar de la contraseña principal
• Revoca las que ya no uses desde Users → Profile
• No compartas archivos de configuración con contraseñas. Si usas Git, añádelos a .gitignore
• Cada cliente MCP tiene permisos independientes según el usuario de WordPress que uses

Aplicaciones reales

Este setup permite desde consultar contenido del sitio hasta ejecutar acciones administrativas, todo desde el terminal o interfaz donde trabajas con IA. Es ideal para equipos que quieren integrar WordPress en flujos automatizados sin tener que escribir código REST API manualmente.

Conclusión

El MCP Adapter de WordPress es un paso enorme hacia la interoperabilidad entre WordPress y los asistentes de IA. La instalación es sencilla, la configuración minimalista, y una vez conectado, las posibilidades son enormes. Si trabajas con WordPress y usas asistentes de IA, esta es una integración que no te puedes perder.