Claude Bridge – Plugin para WordPress

Claude Bridge es un plugin de WordPress que expone una API REST segura que permite a Claude (a través de un servidor MCP local) leer y modificar los archivos del tema y gestionar los plugins, las opciones, la biblioteca de medios y la base de datos de tu sitio. Cada escritura va precedida de una copia de seguridad automática y de una validación de la sintaxis PHP.

Versión 1.0.0 · WordPress 5.6 o superior · PHP 7.4 o superior · Licencia GPL-2.0+ · Synaptic CRM Dev Team

Funcionalidades

Claude Bridge agrupa sus funciones en siete herramientas, que puedes activar o desactivar una a una:

• Tema: listar, leer, crear y modificar los archivos del tema activo, incluso mediante cambios puntuales (inserción, sustitución o eliminación por línea o por ancla).
• Plugins: listar, buscar, instalar, activar, desactivar y actualizar las extensiones.
• Código de los plugins: leer y modificar el código fuente de las extensiones instaladas (Claude Bridge está protegido).
• Opciones: leer, buscar y modificar las opciones de WordPress.
• Base de datos: listar las tablas y ejecutar consultas de solo lectura. La escritura SQL requiere además la constante CLAUDE_BRIDGE_ALLOW_SQL_WRITE en wp-config.php.
• Biblioteca de medios: subir imágenes (logotipos, ilustraciones…), con texto alternativo y vinculación a una entrada.
• Copias de seguridad: listar y restaurar las copias creadas automáticamente antes de cada cambio.

Los archivos grandes se envían en varios fragmentos, con un control de integridad SHA-256.

Seguridad

• Acceso reservado a las cuentas de administrador, autenticadas con una contraseña de aplicación de WordPress dedicada (nunca la contraseña habitual).
• HTTPS obligatorio: se muestra un aviso en la administración si el sitio no usa SSL.
• Solo tres herramientas están activas por defecto (Tema, Plugins, Opciones). Una herramienta desactivada devuelve un error 403 en todas sus rutas, incluso con credenciales válidas.
• Copia de seguridad automática antes de cada cambio y verificación de la sintaxis PHP antes de la escritura.
• Las operaciones SQL más peligrosas (DROP DATABASE, GRANT, CREATE USER, eliminación de las tablas principales de WordPress…) siempre están prohibidas.

Instalación

Opción A: desde el archivo ZIP (la más sencilla)

1. Descarga el archivo ZIP con el botón de arriba (ya contiene la carpeta claude-bridge, no lo descomprimas).
2. Inicia sesión en la administración de WordPress: https://tu-sitio.tld/wp-admin.
3. En el menú de la izquierda, haz clic en Plugins y luego en Añadir nuevo plugin.
4. En la parte superior de la página, haz clic en Subir plugin.
5. Haz clic en Seleccionar archivo, elige el archivo ZIP descargado y haz clic en Instalar ahora.
6. Una vez terminada la instalación, haz clic en Activar plugin.

Opción B: por transferencia de archivos (FTP, SFTP o gestor de archivos)

1. Descomprime el archivo y copia la carpeta claude-bridge tal cual en wp-content/plugins/claude-bridge/.
2. En la administración de WordPress, abre Plugins y luego Plugins instalados.
3. Busca Claude Bridge en la lista y haz clic en Activar debajo de su nombre.

Configuración: elegir las herramientas autorizadas

Abre Ajustes y luego Claude Bridge. Cada herramienta tiene su propia casilla:

• Tema: activada por defecto
• Plugins: activada por defecto
• Código de los plugins: desactivada por defecto (arriesgado)
• Opciones: activada por defecto
• Base de datos: desactivada por defecto (acceso SQL directo)
• Biblioteca de medios: desactivada por defecto
• Copias de seguridad: desactivada por defecto

Marca solo las herramientas que necesites y haz clic en Guardar. Puedes volver a esta página en cualquier momento.

Crear una contraseña de aplicación

Claude Bridge no funciona con la contraseña habitual de la cuenta. Hay que crear una contraseña de aplicación dedicada, con una cuenta de administrador, en un sitio con HTTPS.

1. En la administración, haz clic en tu nombre arriba a la derecha (o en Usuarios y luego Perfil).
2. Desplázate hasta la sección Contraseñas de aplicación, al final de la página.
3. Escribe un nombre para identificarla, por ejemplo Claude Bridge.
4. Haz clic en Añadir nueva contraseña de aplicación.
5. WordPress muestra la contraseña una sola vez (4 grupos de 4 caracteres). Cópiala inmediatamente en un gestor de contraseñas.

Datos que debes indicar al servidor MCP local (o a la herramienta que llama a la API):

• URL del sitio: https://tu-sitio.tld
• Nombre de usuario: tu identificador de acceso a WordPress
• Contraseña: la contraseña de aplicación generada (no tu contraseña habitual)

Probar la conexión (opcional)

curl -u "tu_usuario:xxxx xxxx xxxx xxxx" 
     https://tu-sitio.tld/wp-json/claude-bridge/v1/info

Si todo es correcto, el comando devuelve un JSON con la versión del plugin, la versión de WordPress y el tema activo.

Para revocar el acceso más adelante, vuelve a tu página de perfil, sección Contraseñas de aplicación, y haz clic en Revocar junto a la contraseña «Claude Bridge».