El puente (paquete npm)

@ballesdev/wp-realmcp es el programa que arranca tu cliente de IA. Habla con el cliente por stdin/stdout y manda cada mensaje a tu sitio por HTTPS con tu contraseña de aplicación. No tiene dependencias y necesita Node.js 22 o posterior.

Configuración

Todo se configura con variables de entorno. Los nombres coinciden con los de mcp-wordpress-remote de Automattic, así que para cambiar de uno a otro alcanza con cambiar el nombre del paquete.

Variable	Obligatoria	Descripción
WP_API_URL	Sí	La URL de tu sitio (https://ejemplo.com, o https://ejemplo.com/blog para un sitio en un subdirectorio) o el endpoint completo (https://ejemplo.com/wp-json/ballesdev/mcp). Una URL de sitio se convierte en ?rest_route=/ballesdev/mcp, que funciona con cualquier configuración de enlaces permanentes; se conserva su query string.
WP_API_USERNAME	Sí*	Usuario de WordPress.
WP_API_PASSWORD	Sí*	Contraseña de aplicación, con o sin espacios. En una línea de comandos, ponela entre comillas si tiene espacios.
CUSTOM_HEADERS	No	Headers HTTP extra, en JSON ({"X-Nombre":"valor"}) o como pares Nombre:Valor separados por comas.
WP_API_TIMEOUT_MS	No	Tiempo máximo por pedido, en milisegundos. Por defecto: 120000.
WP_ALLOW_INSECURE_HTTP	No	Ponela en 1 para mandar credenciales por http:// a un sitio que no es local. Sin ella, el puente se niega.
LOG_FILE	No	Archivo para un log detallado: cada método, su estado HTTP y cuánto tardó.

* Dejalas vacías solo si CUSTOM_HEADERS trae un header Authorization.

Comportamiento

• Nunca registra credenciales ni el contenido de los mensajes, y por stdout solo salen mensajes MCP.
• No sigue redirecciones: una redirección convertiría el pedido en un GET o perdería la contraseña. Usá en WP_API_URL la dirección final de tu sitio.
• localhost, las direcciones de loopback y los dominios .local, .localhost y .test cuentan como locales: ahí HTTP funciona sin WP_ALLOW_INSECURE_HTTP.
• Los errores vuelven al cliente como errores MCP que dicen qué corregir, y también van a stderr, que los clientes guardan en sus logs de MCP.
• Cuando el cliente cierra stdin, el puente espera los pedidos en curso y termina.