Royal MCP

Servidor MCP con seguridad ante todo para WordPress. Conecta Claude, ChatGPT y Gemini a tu sitio WordPress con autenticación mediante clave API + OAuth 2.1, registro completo de actividad y acceso controlado por capacidades.

Descargar en WordPress.org · Documentación · Royal Plugins

Un plugin de WordPress que expone tu sitio como un servidor de Model Context Protocol. Los agentes de IA — Claude.ai web, Claude Desktop, ChatGPT, clientes personalizados — pueden leer y escribir entradas, páginas, medios, usuarios, menús, pedidos de WooCommerce y páginas de Elementor, con cada llamada pasando por control de capacidades, limitación de velocidad y un registro de auditoría. Distribuido a través del directorio oficial de plugins de WordPress.org.

Datos rápidos

Related MCP server: wp-mcp

Capacidades

WordPress core (84 herramientas, siempre disponibles)

• Contenido — Entradas, páginas, tipos de contenido personalizados (CRUD completo + revisiones + imágenes destacadas)

• Taxonomías — Categorías, etiquetas, taxonomías personalizadas, metadatos de términos, vinculación entrada-término

• Medios — Explorar, subir (URL o base64), actualizar metadatos, eliminar

• Comentarios — Crear, moderar (aprobar / spam / papelera)

• Usuarios — Leer nombres para mostrar + roles (los correos y nombres de usuario no se exponen)

• Menús — Leer, crear elementos, reordenar, actualizar con salvaguardas contra escrituras destructivas

• Tema — CSS personalizado, modificaciones del tema, detección del tema activo

• Sitio — Estructura de enlaces permanentes, opciones (en lista blanca), información del sitio

• Búsqueda — Búsqueda entre contenidos por consulta

• SEO — Lectura/escritura de metadatos de Yoast / Rank Math / AIOSEO donde el plugin esté activo

• Diagnóstico — Estado del sitio (WP/PHP/MySQL/plugins/temas/cron en una sola llamada), cola del registro de errores de PHP, programación de cron de WP y MCP royal_mcp_connection_health (devuelve ruta, método de autenticación, ID de sesión, versión del plugin y versiones activas de constructores de páginas para Divi + Elementor + Gutenberg)

Integraciones de plugins (80 herramientas, condicionales)

Se registran automáticamente solo cuando el plugin integrado está activo.

Puente con la WordPress Abilities API (WP 6.9+)

WordPress 6.9 incluyó la Abilities API — una primitiva que permite a los plugins registrar capacidades tipadas que los agentes de IA pueden llamar. Desde la versión 1.4.38, cada herramienta de Royal MCP también se registra como una capacidad de WordPress, lo que te da tres formas de llegar a los mismos manejadores:

1. Nativa — el endpoint Streamable HTTP /wp-json/royal-mcp/v1/mcp de Royal MCP (sin cambios, siempre disponible).

2. WP MCP Adapter — si el paquete wordpress/mcp-adapter está instalado, Royal MCP registra un royal-mcp-server con nombre en el hook mcp_adapter_init junto al servidor predeterminado del adaptador.

3. REST de WP core — invocación directa de capacidades en /wp-json/wp-abilities/v1/abilities/{name}/run para quienes prefieran el endpoint de WP core.

Los mismos manejadores, tres transportes, un único conjunto de puertas de capacidad por herramienta. El puente se puede desactivar con la opción royal_mcp_abilities_registration_enabled (por defecto: activado).

Lo que no hacemos

Límites de alcance explícitos — el modelo de integración es «herramientas estrechas que funcionan de forma fiable», no «exponer toda la superficie de la API».

• Sin generación de widgets de Elementor desde cero. Los widgets atómicos (Editor V4) pasan de forma opaca; nunca decodificamos esquemas atómicos porque Elementor mismo puede cambiarlos.

• Sin escrituras JSON de constructores de páginas Beaver Builder / Bricks. El contenido estándar de las entradas es legible y escribible; el almacenamiento JSON específico del constructor de páginas es opaco salvo que lo cubra una herramienta dedicada. (Elementor y Divi tienen herramientas dedicadas — consulta la tabla de integraciones anterior.)

• Sin creación de plantillas de theme builder (de Elementor ni de otros).

• Sin modificaciones de archivos del core — Royal MCP nunca escribe en wp-content/themes, wp-includes ni wp-admin.

• Sin instalación ni actualización de plugins a través de MCP. Descubrimiento sí; instalar/activar/desactivar no.

• Sin SQL en bruto. Las consultas pasan solo por WP_Query y $wpdb->prepare().

Royal MCP Pro (de pago)

El plugin gratuito está completamente equipado para propietarios de sitios individuales. Royal MCP Pro lo amplía para agencias y operadores multisitio:

• Suite Divi Pro — clonado de páginas, intercambio de imágenes, importación de plantillas, CRUD completo de biblioteca, migrador D4→D5, aplicación masiva de ajustes preestablecidos globales (8 herramientas)

• Profundidad de Elementor Pro — herramientas adicionales de Elementor más allá de la integración gratuita

• Registro de auditoría universal — cada operación de IA registrada con atribución + exportación

• Deshacer de 72 horas en cada escritura — cada herramienta Pro destructiva devuelve un token de deshacer; revierte cualquier operación dentro de la ventana

• Actualizaciones controladas por licencia a través del actualizador estándar de WordPress — sin dependencias en tiempo de ejecución de servidores de licencias externos

Más información en royalplugins.com/royal-mcp-pro

Conectar

Instalación

1. Instala desde WordPress.org (recomendado — actualizaciones automáticas a través del admin de WP) o sube el zip de la release de GitHub.

2. Royal MCP → Ajustes → haz clic en Generar clave API.

3. Elige un cliente a continuación.

Claude.ai web (OAuth — recomendado)

La vía más fácil — sin editar archivos de configuración, sin clave API en tu cliente.

1. En Claude.ai → Ajustes → Conectores → Añadir conector personalizado.

2. URL: https://yoursite.com/wp-json/royal-mcp/v1/mcp

3. Aprueba la pantalla de consentimiento de OAuth cuando se te pida. Claude.ai gestiona el registro dinámico de clientes + el flujo PKCE contra tu sitio.

Claude Desktop (paquete .mcpb de un clic — nuevo en 1.4.38)

La vía más fácil para Claude Desktop — sin mcp-remote, sin npx, sin editar archivos de configuración.

1. Descarga royal-mcp-1.4.38.mcpb desde la última release de GitHub.

2. Haz doble clic en el archivo .mcpb — Claude Desktop abre el aviso de instalación.

3. Introduce la URL de tu sitio + la clave API cuando se te pida. La conexión queda activa.

El paquete incluye un puente stdio-a-HTTPS sin dependencias en Node ≥18, que Claude Desktop ya incluye. Consulta Claude Desktop MCP Bundles para la especificación .mcpb.

Claude Desktop (OAuth a través de mcp-remote)

{
  "mcpServers": {
    "my-wordpress": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://yoursite.com/wp-json/royal-mcp/v1/mcp"]
    }
  }
}

Ruta de configuración: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows).

Claude Desktop (clave API)

Omita OAuth y autentíquese mediante el encabezado:

{
  "mcpServers": {
    "my-wordpress": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://yoursite.com/wp-json/royal-mcp/v1/mcp",
        "--header", "X-Royal-MCP-API-Key:YOUR_API_KEY"
      ]
    }
  }
}

ChatGPT

El conector MCP personalizado de ChatGPT utiliza la misma URL que la web de Claude.ai. Siga el flujo del conector de ChatGPT y pegue https://yoursite.com/wp-json/royal-mcp/v1/mcp.

HTTP sin procesar (clientes personalizados)

# 1. Initialize a session. -i prints headers so you can grab Mcp-Session-Id.
curl -i -X POST https://yoursite.com/wp-json/royal-mcp/v1/mcp \
  -H "X-Royal-MCP-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "method": "initialize",
    "id": 1,
    "params": {
      "protocolVersion": "2025-11-25",
      "capabilities": {},
      "clientInfo": {"name": "my-app", "version": "1.0"}
    }
  }'

# 2. List available tools using the session id from the response header.
curl -X POST https://yoursite.com/wp-json/royal-mcp/v1/mcp \
  -H "X-Royal-MCP-API-Key: YOUR_KEY" \
  -H "Mcp-Session-Id: <session_id>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 2}'

Modelo de seguridad

Arquitectura de seguridad completa: royalplugins.com/support/royal-mcp/

Estado del proyecto

• Mantenimiento activo — lanzamientos aproximadamente semanales. Consulte releases para el registro de cambios.

• Cumplimiento de la especificación MCP — implementa el transporte HTTP Streamable (2025-11-25).

• Problemas — github.com/royalplugins/royal-mcp/issues. Los problemas que afectan a los clientes suelen reconocerse en 24 horas y se clasifican con objetivos de versión.

• Contribuciones — se aceptan PRs. El código fuente del plugin está comprometido tanto en este repositorio como en el tronco SVN de wp.org; los lanzamientos se coordinan mediante el proceso de revisión de wp.org.

Lecturas adicionales

• Edición de Elementor con Claude: Los cuatro flujos de trabajo que funcionan hoy — las cuatro arquitecturas reales para editar páginas de Elementor con IA y cuándo usar cada una. Versión orientada al usuario con indicaciones, ejemplos y una demostración en vídeo del flujo de clonar y personalizar.

• Edición de Elementor con Claude: 4 arquitecturas MCP — versión para ingenieros en Hashnode. El PHP detrás de elementor_clone_page, las seis firmas de herramientas y el equilibrio entre los modelos de autenticación HTTP-Basic y OAuth-2.1.

Proyectos relacionados

• GuardPress — endurecimiento de seguridad de WordPress

• SiteVault — copias de seguridad y migración de WordPress

• ForgeCache — almacenamiento en caché y rendimiento

• FormForge — constructor de formularios con generación de PDF

• SEObolt — kit de herramientas SEO para WordPress

Licencia

GPLv2 o posterior — consulte LICENSE o el sitio GNU.

Royal MCP se proporciona tal cual. Las claves API protegen sus endpoints; protéjalas como cualquier otra credencial. Usted es responsable del contenido, los comandos y las acciones que cualquier plataforma de IA pueda realizar en su sitio de WordPress.