Manual completo · Birlo Bridge 1.2.6

Birlo Bridge · Manual completo

Instalación, conexión MCP, OAuth, permisos, aprobaciones, auditoría, Bridge, Pro, Commerce, Agency, Cloud, Autonomy, licencias, actualizaciones y resolución de problemas.

1. Requisitos

• WordPress 6.4 o superior.
• PHP 8.0 o superior.
• HTTPS recomendado para el flujo OAuth y el uso remoto.
• Permisos de administrador para configurar conexiones y aprobar operaciones sensibles.
• WooCommerce activo únicamente si vas a utilizar Birlo Bridge Commerce.

2. Instalación de Birlo Bridge

1. Instala y activa Birlo Bridge.
2. Abre Herramientas → Birlo Bridge.
3. Comprueba el endpoint MCP y la información OAuth mostrada por el plugin.
4. Conecta tu cliente compatible con MCP al endpoint del sitio.
5. Autoriza la conexión desde WordPress.
6. Revisa los scopes solicitados antes de aceptar.

Endpoint MCP estándar: /wp-json/birlo-bridge/v1/mcp.

3. OAuth y conexiones

Birlo Bridge utiliza OAuth con PKCE S256. Los access tokens son de corta duración y los refresh tokens rotan. Las conexiones autorizadas pueden revisarse y revocarse desde la administración de Birlo Bridge.

• Autoriza únicamente clientes MCP que reconozcas.
• Revoca conexiones que ya no utilices.
• Si cambias permisos o el perfil de capacidades, puede ser necesario reconectar el cliente para renovar scopes.

4. Scopes, aprobaciones y auditoría

Las herramientas no equivalen a acceso completo al servidor. Cada capacidad se expone como una herramienta concreta y declara permisos de lectura o escritura. Las acciones sensibles pueden quedar pendientes hasta que un administrador las apruebe dentro de WordPress.

• Lectura: consulta de contenido, estado o configuración permitida.
• Escritura: cambios sobre contenido o configuración dentro del alcance de la herramienta.
• Aprobación secundaria: confirmación adicional para operaciones sensibles.
• Auditoría: registro de las operaciones realizadas a través del puente.

5. Birlo Bridge

Birlo Bridge es la base gratuita y autohospedada. Incluye herramientas para:

• Páginas y entradas.
• Medios.
• Menús y ubicaciones de menú.
• Patrones de bloques.
• Plantillas y partes de plantilla.
• Widgets de bloques y barras laterales.
• Theme mods / valores del Personalizador.
• Identidad del sitio y ajustes generales seguros.
• Revisiones.
• Auditoría y estado de aprobaciones.

Birlo Bridge no incluye administración avanzada de plugins/archivos, WooCommerce ni monitorización multisitio. Esas funciones pertenecen a los add-ons.

6. Birlo Bridge Pro

Pro amplía Birlo Bridge con administración avanzada y herramientas de desarrollo controladas.

• Gestión avanzada de plugins.
• Acceso controlado a archivos dentro de plugins y temas.
• REST avanzada.
• Backups y rollback.
• Integraciones avanzadas, incluidas capacidades para Fluent Forms y GenerateBlocks cuando están presentes.

Planes: Individual, 1 sitio, 99 €/año. Business, 5 sitios, 249 €/año.

Ver Birlo Bridge Pro

7. Birlo Bridge Commerce

Commerce añade herramientas específicas para WooCommerce y requiere WooCommerce activo.

• Productos simples y variables.
• Precios y stock.
• Categorías y variaciones.
• Consulta y gestión de pedidos.
• Notas y cambios de estado.
• Operaciones comerciales protegidas mediante scopes, auditoría y aprobaciones.

Planes: Individual, 1 sitio, 129 €/año. Business, 5 sitios, 299 €/año.

Ver Birlo Bridge Commerce

8. Birlo Bridge Agency

Agency está orientado a agencias y equipos que administran varias instalaciones WordPress desde un sitio controlador.

• Inventario de sitios y clientes.
• Entornos production, staging, development y demo.
• Monitorización periódica.
• Comprobaciones de disponibilidad y REST.
• Incidencias, cambios de estado y recuperaciones.
• Políticas globales, ventana de mantenimiento y alertas.
• Panel agregado por cliente y entorno.

La monitorización puede programarse cada 15 minutos, cada hora, dos veces al día o diariamente. Las escrituras remotas se controlan mediante la política Agency y no convierten Agency en Pro.

Planes: Agency 25, hasta 25 sitios, 599 €/año. Agency 100, hasta 100 sitios, 1.199 €/año.

Ver Birlo Bridge Agency

9. Birlo Bridge Cloud

Birlo Bridge Cloud conecta WordPress remotos mediante OAuth 2.0 + PKCE y permite operar sobre sitios enlazados sin almacenar ni exponer contraseñas del administrador. La versión actualmente activa en birlo.es es la 0.5.1.

• Enlace de sitios WordPress remotos mediante OAuth.
• Inventario de sitios enlazados sin exponer credenciales.
• Acceso controlado a páginas, plugins y WooCommerce cuando el Bridge remoto ofrece esas capacidades.
• Las aprobaciones sensibles del WordPress remoto siguen siendo obligatorias cuando corresponda.

10. Birlo Bridge Autonomy

Birlo Bridge Autonomy es un módulo opcional para controlar cuánta aprobación manual exige Birlo Bridge en operaciones repetitivas. La versión activa en birlo.es es la 0.1.0.

• Modo Seguro: conserva el comportamiento estándar de aprobaciones.
• Modo Asistido: evita aprobaciones para lecturas REST seguras y determinadas escrituras reversibles.
• Modo Autónomo: amplía la autonomía a creación y actualización de contenido, manteniendo las acciones críticas bajo aprobación.
• Herramientas críticas: escritura/eliminación de archivos, instalación o actualización de plugins, restauración de backups, borrados y otras acciones sensibles siguen requiriendo aprobación.
• Controles que permanecen activos: scopes OAuth, capacidades de WordPress y auditoría.

Autonomy no sustituye la seguridad de Birlo Bridge: modifica la política de aprobación para reducir confirmaciones repetitivas dentro de límites definidos.

11. Combinación de productos

Los add-ons se cargan sobre Birlo Bridge y pueden combinarse. El perfil MCP refleja los productos activos y con entitlement válido, por ejemplo lite+pro, lite+commerce o lite+agency+commerce+pro.

12. Licencias

Pro, Commerce y Agency utilizan licencias de producto. Una clave solo puede activar el producto al que pertenece. Si intentas utilizar una clave de otro producto, el sistema la rechazará.

• Introduce la clave en la pantalla del add-on correspondiente.
• Pulsa Activar licencia.
• Comprueba estado, caducidad, activaciones y versión publicada.
• Puedes desactivar una instalación para liberar una activación.

La licencia comercial tiene una duración de 365 días. Al caducar, las capacidades del add-on quedan bloqueadas hasta renovar. El sistema contempla un periodo de gracia firmado de hasta 30 días cuando birlo.es no está disponible temporalmente.

13. Actualizaciones

Los add-ons comerciales utilizan el canal oficial de Birlo para consultar nuevas versiones. Desde la pantalla del producto puedes comprobar actualizaciones. Mantén Birlo Bridge y los add-ons en versiones compatibles.

14. Seguridad

• No expone shell arbitrario ni WP-CLI remoto.
• No da acceso a wp-config.php ni a la raíz del servidor.
• Birlo Bridge no incluye gestión de archivos.
• Pro limita la escritura a rutas permitidas dentro de plugins o temas.
• Las operaciones sensibles pueden requerir aprobación secundaria.
• Los clientes OAuth pueden revocarse.
• La auditoría permite revisar qué herramientas se ejecutaron.

15. Privacidad

Birlo Bridge se ejecuta en tu propio WordPress y no envía automáticamente el contenido del sitio a Birlo. La información se entrega únicamente cuando un cliente MCP autorizado solicita una herramienta. El cliente MCP o servicio de IA que utilices puede procesar la información que autorices; revisa sus condiciones y política de privacidad.

16. Resolución de problemas

17. Preguntas frecuentes