Respira for WordPress

Respira WordPress MCP Server

Herramientas MCP y capacidades de WordPress en 18 constructores de páginas. La capa de infraestructura de IA para WordPress.
Edición a nivel de elemento, creación de páginas completas, conversión de HTML y Figma a constructores nativos, direcciones de diseño, memoria del sitio, escaneo de accesibilidad y seguridad, gobernanza por herramienta, instantáneas y reversión.

Sitio web • Documentación • Plugin • Configuración MCP • Habilidades • Soporte

Qué es este repositorio y qué no es

Este repositorio es el listado público del servidor MCP de Respira para WordPress. El código fuente del servidor se distribuye en npm como @respira/wordpress-mcp-server. Ese código envoltorio tiene licencia MIT y eres bienvenido a leerlo, bifurcarlo o incorporarlo.

El servidor es un cliente para el plugin de WordPress de Respira, no un producto independiente. Para hacer trabajo real necesita:

• El plugin Respira for WordPress instalado en tu sitio
• Una clave API de Respira válida vinculada a una licencia

El plugin no es de código abierto. Se distribuye bajo una licencia comercial. Prueba gratuita en respira.press, sin necesidad de tarjeta. Los planes de pago comienzan en 9 EUR al mes.

En resumen: el envoltorio que npx -y es abierto. El producto detrás no lo es, y eso es deliberado. Si quieres una pila autónoma de "IA edita WordPress" sin dependencia comercial, esto no es para ti. El plugin es construido y mantenido a tiempo completo por una persona, y las tarifas de licencia son cómo eso sucede.

Para informes de seguridad, consulta SECURITY.md.

Qué hace diferente a Respira

La mayoría de los servidores MCP de WordPress envuelven la API REST. Pueden crear entradas y páginas, pero no pueden tocar el contenido de los constructores de páginas, que es donde vive el sitio real.

Respira incluye un plugin de WordPress que da a un agente de IA acceso nativo a las estructuras de datos propias del constructor, además de las barreras de seguridad que hacen que escribir en un sitio en vivo sea viable.

Inicio rápido

1. Instala el plugin de WordPress

Descárgalo desde respira.press/plugin, súbelo a WordPress, actívalo y luego ve a Respira > Claves API y genera una clave.

2. Conecta tu herramienta de IA

El camino más rápido es el comando generado en respira.press/dashboard/mcp, que completa tu sitio y tu clave por ti. Configuraciones manuales a continuación.

claude mcp add respira-wordpress -- npx -y @respira/wordpress-mcp-server

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

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

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

npx add-mcp "npx -y @respira/wordpress-mcp-server"

3. Añade tu sitio

Ejecuta el asistente:

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

O escribe ~/.respira/config.json tú mismo:

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

Reinicia tu herramienta de IA y comienza a editar.

¿Alcanzando un límite de herramientas del cliente?

Algunos clientes MCP limitan el número de herramientas activas, a menudo a 100. Respira anuncia mucho más que eso, así que añade enabledTools a tu configuración y solo aparecerán esas en el listado:

{
  "sites": [{ "...": "..." }],
  "preferences": {
    "enabledTools": [
      "respira_read_page",
      "respira_update_page",
      "respira_list_pages",
      "respira_find_element",
      "respira_update_element",
      "respira_build_page",
      "respira_get_site_context",
      "respira_get_builder_info"
    ]
  }
}

Las herramientas de gestión del sitio (respira_list_sites, respira_switch_site, respira_get_active_site) siempre están incluidas. Las herramientas no listadas aún funcionan si se llaman directamente. El filtro solo controla lo que se anuncia.

Además, el servidor filtra la lista de herramientas según lo que tu sitio realmente ejecuta. Un sitio Divi sin WooCommerce no ve las herramientas de comercio. La detección falla de forma abierta: si no puede determinarlo, obtienes la lista completa.

18 constructores de páginas compatibles

level es la profundidad de escritura de Respira, no la calidad del constructor.

Los sitios con constructores mixtos se manejan por página, no por sitio.

Qué cubren las herramientas

La referencia completa vive en la documentación. Las familias:

Todas las herramientas usan nombres respira_*. Los alias heredados wordpress_* están obsoletos y se eliminarán.

Qué significan los números

Los recuentos actuales están en el catálogo de herramientas en vivo, contados desde el código en cada versión: herramientas MCP para todo el producto y para cada plan, las herramientas del complemento de WooCommerce y las Capacidades de WordPress. Describen el catálogo en un sitio completamente habilitado, no lo que tu cliente listará.

Un tools/list en vivo devuelve menos que el total del catálogo, y eso es un comportamiento correcto en lugar de una característica faltante. El servidor filtra el catálogo por contexto según el sitio, por lo que las herramientas de Bricks nunca llegan a un sitio de Elementor y las herramientas de comercio permanecen ocultas sin WooCommerce. Un sitio con tema de bloques sin constructor de páginas ve aún menos herramientas del núcleo.

El registro de Capacidades no se filtra por contexto, por lo que en el mismo sitio el total de capacidades supera legítimamente el total de herramientas. Los dos no son directamente comparables.

Habilidades incluidas

El paquete incluye las habilidades de Claude Code de Respira, que son las recetas que hacen que las herramientas funcionen juntas: migraciones de constructores de páginas (Divi a Bricks, Elementor a Gutenberg, WPBakery a Bricks y otras), conversión de Figma a constructor, auditorías de sitio, pases de SEO y AEO, y flujos de trabajo de WooCommerce.

npx @respira/wordpress-mcp-server install-skills

Explora el catálogo en respira.press/skills.

Seguridad

Escribir en un sitio de producción en vivo es todo el problema. Las barreras:

1. Instantánea antes de cada mutación. Restaura con respira_restore_snapshot, compara con respira_diff_snapshots.
2. Duplicar antes de editar. El original permanece intacto mientras el agente trabaja en una copia.
3. Gobernanza por herramienta. Los administradores habilitan o deshabilitan herramientas individuales desde wp-admin. La gobernanza se aplica por igual a la ruta REST, la ruta de la API de Capacidades y WebMCP.
4. Modo de solo lectura. Apunta un agente a un sitio y déjalo mirar sin permitirle escribir.
5. Registro de actividad. Cada llamada se registra y es legible desde wp-admin y desde respira_list_activity.

Ecosistema de IA de WordPress

Respira funciona con la pila oficial de IA de WordPress, no alrededor de ella.

Inhale es el plugin complementario gratuito que registra un pequeño conjunto de Capacidades sin ninguna cuenta de Respira, si quieres probar la ruta de Capacidades antes que cualquier otra cosa.

Opciones de instalación

npx

npx -y @respira/wordpress-mcp-server

Instalación cero, buena para probarla. La desventaja es que la caché de npx puede corromperse tras una instalación interrumpida, un disco externo desconectado o una cuarentena del antivirus, y los errores resultantes de ENOENT son confusos. Consulta Solución de problemas.

Instalación global (la más estable)

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

Evita por completo la caché de npx. Es la mejor opción para el uso diario.

Opciones de línea de comandos

Variables de entorno

export WORDPRESS_URL="https://yoursite.com"
export WORDPRESS_API_KEY="respira_your_key"

RESPIRA_CONFIG_FILE y RESPIRA_CONFIG_B64 son las alternativas para múltiples sitios.

Plugin de Grok Build

Este repositorio es también la fuente del plugin de Respira para Grok Build. El plugin es pequeño a propósito. Incluye dos archivos y nada más:

• .grok-plugin/plugin.json, el manifiesto.
• .mcp.json, una definición de servidor MCP: npx -y @respira/wordpress-mcp-server, el mismo paquete que describe este README.

No tiene habilidades, comandos, agentes, hooks ni scripts de instalación.

Antes del primer uso. Instala el plugin Respira for WordPress en el sitio y luego ejecuta npx @respira/wordpress-mcp-server --setup una vez. Eso escribe la lista de sitios en ~/.respira/config.json, que el servidor lee cuando Grok Build lo inicia. Si no hay ningún sitio en ese archivo, el servidor inicia con una herramienta, respira_redeem_token, que toma un código de configuración de respira.press/dashboard/mcp y escribe la lista de sitios por ti.

Endpoints de red a los que llama el servidor.

Credenciales. Una clave de sitio de Respira por sitio, guardada en ~/.respira/config.json en tu máquina (o WORDPRESS_URL y WORDPRESS_API_KEY para un solo sitio). La clave solo va al sitio al que pertenece, en un encabezado de solicitud. El plugin de WordPress la verifica; el servidor no lee claves SSH, archivos .env ni otros tokens.

Sin el plugin. Grok Build también puede acceder a un sitio directamente, un comando por sitio: consulta respira.press/integrations/grok.

Verificación de salud

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

Comprueba la versión de Node, el archivo de configuración, la conectividad del sitio, la versión del plugin, la compatibilidad de la API y las actualizaciones disponibles, e informa aprobado o fallido por verificación con algo que puedas aplicar. Añade --json para canalizaciones de CI.

Solución de problemas

{ "command": "C:\\Program Files\\nodejs\\npx.cmd", "args": ["-y", "@respira/wordpress-mcp-server"] }

{
  "sites": [
    {
      "id": "my-site",
      "url": "https://yoursite.com",
      "apiKey": "respira_your-api-key",
      "default": true,
      "forceRestRoute": true
    }
  ]
}

# 1. Switch to a global install, most stable
npm install -g @respira/wordpress-mcp-server
# then use "command": "respira-wordpress-mcp" with no npx wrapper

# 2. Or clear the npx cache and let it rebuild
npx clear-npx-cache
npx -y @respira/wordpress-mcp-server

# 3. Or clear the whole npm cache
npm cache clean --force

Seguridad

La validación de la clave de API ocurre en el lado del servidor, en el plugin de WordPress. El servidor MCP transmite las credenciales y no las almacena ni las valida.

Reporta vulnerabilidades a security@respira.press. Política completa en SECURITY.md.

Enlaces

• Sitio web
• Documentación
• Descargar el plugin
• Configuración de MCP
• Catálogo de habilidades
• Capacidades
• Complemento de WooCommerce
• Complemento de escáner de accesibilidad
• Soporte

Dónde encontrar Respira

Licencia

MIT © Respira

El catálogo completo de herramientas, contado desde el código: respira.press/tools. La capa de infraestructura de IA para WordPress.
respira.press