Guía

Conecta Claude Code y Cursor a WordPress

Claude Code y Cursor se conectan a AlphaBridge con un token. El plugin lo crea y muestra un comando listo para Claude Code y una configuración para Cursor.

Antes de empezar

Lo que necesitas.

  • Un sitio WordPress con AlphaBridge. WordPress 6.5 y PHP 8.0 o superior. Para empezar basta con el plugin gratuito.
  • Una cuenta de administrador. Creas la conexión en Ajustes → AlphaBridge MCP.
  • Claude Code o Cursor. Claude Code se conecta directamente al endpoint. Cursor ejecuta la configuración lista para usar, que necesita Node.js 18 o superior.
Paso a paso

En 6 pasos.

Instala AlphaBridge

Añade el plugin desde el escritorio de WordPress, como cualquier plugin, y actívalo.

Elige tu cliente

Abre Ajustes → AlphaBridge MCP. En «Conecta tu asistente de IA», elige «Cursor», u «Otro» para Claude Code.

Crea la conexión

Haz clic en «Crear conexión». En «Nombre, usuario, acceso, caducidad (opcional)» puedes ponerle nombre, limitar su acceso y fijar una caducidad. Si no cambias nada, recibe acceso completo en tu nombre y no caduca.

Copia enseguida el comando o la configuración

El plugin muestra ahora el token Bearer, el «Comando para Claude Code» y la «Configuración para Cursor». Las versiones anteriores muestran una sola configuración para ambos. Copia ahora lo que necesite tu cliente. El token solo se muestra completo una vez.

Añádelo a tu cliente

Claude Code: en la carpeta de tu proyecto, ejecuta el «Comando para Claude Code» del plugin. Ya contiene tu endpoint y tu token. Si el plugin aún no muestra ese comando, ejecuta el comando claude mcp add de abajo con tu endpoint y tu token. Cursor: pega la configuración en ~/.cursor/mcp.json para todos los proyectos, guarda y recarga los servidores. Si el archivo ya incluye servidores, añade solo la entrada alphabridge dentro de mcpServers.

Compruébalo y pregunta

En Claude Code, /mcp muestra el estado del servidor. Después haz una primera pregunta, por ejemplo qué páginas siguen siendo borradores. Los cambios esperan hasta que un administrador activa el acceso de escritura.

Configuración

Un comando para Claude Code, una configuración para Cursor

El plugin muestra ambos, con tu endpoint y tu token ya incluidos.

Para Claude Code, el plugin muestra este comando con tu endpoint y tu token. Si tu plugin aún no lo muestra, pon tú mismo la URL del endpoint y el token Bearer.

claude mcp add --transport http alphabridge https://your-site.tld/wp-json/alphabridge/v1/mcp --header "Authorization: Bearer YOUR-TOKEN"

Así, Claude Code se comunica directamente con tu endpoint por HTTP, sin Node.js.

Para Cursor, el plugin muestra una configuración lista para usar. Tiene este aspecto.

{
  "mcpServers": {
    "alphabridge": {
      "command": "npx",
      "args": ["mcp-remote", "https://your-site.tld/wp-json/alphabridge/v1/mcp", "--header", "Authorization:${AUTH}"],
      "env": { "AUTH": "Bearer YOUR-TOKEN" }
    }
  }
}

En Cursor, npx inicia el programa auxiliar mcp-remote. Este envía cada petición a tu endpoint, con tu token en la cabecera Authorization.

Deja Authorization:${AUTH} tal cual. El token va en la línea env, después de la palabra Bearer.

Para un segundo sitio, crea también allí una conexión. Añádela con otro nombre, por ejemplo alphabridge-shop.

Token

Guarda bien el token

  • El token solo se muestra completo una vez. El sitio solo guarda un hash.
  • ¿Lo has perdido? Rota la conexión en «Tus conexiones». El token anterior deja de funcionar al instante.
  • Elige el nivel de acceso «solo lectura» o «solo contenido» cuando un cliente no deba poder hacerlo todo.
  • Fija una caducidad en días para los accesos que deban terminar.
  • Claude Code guarda un servidor añadido con claude mcp add en ~/.claude.json, para este proyecto y solo para ti.
  • Cada petición se ejecuta con los permisos del usuario de WordPress en cuyo nombre actúa la conexión.
  • El acceso de escritura vale para todas las conexiones del sitio, también para esta. A partir de ahí, los cambios se aplican de inmediato y pueden ser destructivos. Activarlo es responsabilidad del propietario.
Peticiones

Qué pedir en Claude Code o Cursor

Las herramientas gratuitas cubren el contenido. Pro y Agency añaden código y despliegue.

  • Enumera las páginas de mi sitio con su estado y su último cambio.
  • Lee el esquema de la página de inicio y enumera sus encabezados y botones.
  • ¿Qué plugins y temas tienen actualizaciones pendientes?
  • Crea un borrador de entrada a partir de las notas de notes.md.
  • Muéstrame el style.css del tema activo.
  • Despliega la carpeta build en el sitio por SFTP.

Las tres primeras solo leen. La cuarta necesita acceso de escritura. La quinta necesita Pro y acceso de escritura. La última necesita Agency, Site Deploy configurado y acceso de escritura.

Otros clientes

Otros clientes MCP y scripts

Cualquier cliente MCP que hable Streamable HTTP y pueda enviar una cabecera puede usar el endpoint directamente. Envía el token en cada petición como Authorization: Bearer ….

Si un cliente elimina la cabecera Authorization, envía el token como X-Api-Key.

Claude en la web, en Desktop y en iOS se conecta sin token. En su lugar, apruebas en tu sitio, como muestra la página del conector.

FAQ

Preguntas y respuestas.

¿Claude Code y Cursor necesitan un token?

Sí. El plugin les crea uno en su página de ajustes, junto con el comando para Claude Code y la configuración para Cursor. Claude en la web y ChatGPT, en cambio, se aprueban en tu sitio.

¿Qué nivel de acceso debo elegir?

Con «solo lectura», el cliente ve lo que la cuenta puede ver y no cambia nada. Con «solo contenido», también cambia entradas, páginas, medios, términos y comentarios. El nivel «completo» añade ajustes y administración. Elijas lo que elijas, el interruptor de acceso de escritura del sitio decide si se escribe algo.

He perdido el token. ¿Y ahora?

Rota la conexión en «Tus conexiones», en la página de ajustes de AlphaBridge MCP. Recibes un token nuevo con un comando y una configuración nuevos. El token anterior deja de funcionar al instante.

Claude Code sigue mostrando la lista antigua de herramientas. ¿Qué hago?

Los clientes pueden conservar la lista de herramientas que cargaron. En Claude Code, ejecuta /mcp y vuelve a conectar el servidor.

¿Necesito Pro para Claude Code?

No. El plugin gratuito le da a Claude Code 40 herramientas. Pro lleva 135 herramientas a un sitio, archivos de temas y plugins incluidos. Agency lleva las 143 herramientas y Site Deploy por SFTP a hasta 10 sitios.

Pro en tu sitio WordPress. Con vuelta atrás.

Pro lleva 135 herramientas a tu sitio y una vuelta atrás para páginas y archivos. La prueba no pide tarjeta.