Conecta tus sitios web a un único agente de IA
Usa una conexión MCP de una sola cuenta para trabajar en varios sitios web con Claude Code, Codex u otro agente compatible. Cada sitio web conserva su propio usuario de WordPress, sus permisos y sus ajustes. Los sitios web pueden ejecutarse en servidores separados o ser sitios individuales dentro de una red multisitio de WordPress.
Esta guía está dirigida a un propietario de una cuenta POM AI Unlimited que pueda obtener autorización de WordPress en cada sitio web. MCP es la conexión mediante la cual tu agente descubre y utiliza las herramientas del sitio web. La skill de autoría proporciona instrucciones; instalarla no concede acceso.
Antes de empezar
- Ten una licencia activa de POM AI Unlimited en esta cuenta, con cada dominio de destino ya autorizado para esa licencia. Conectar un sitio web no activa un nuevo dominio de licencia. Siguen aplicándose las restricciones existentes de la licencia.
- En cada destino, activa POM AI MCP en Settings → POM AI → AI Tools y, a continuación, activa Enable OAuth en MCP server. Mantén POM AI actualizado en cada destino. La conexión de la cuenta requiere su política de seguridad de autoría actual y te pedirá actualizar un destino más antiguo antes de conectarse o de ejecutar operaciones. Usa WordPress 6.9 o superior; el paquete completo de POM AI incluye el MCP Adapter oficial y lo selecciona automáticamente. No se requiere ningún plugin adaptador independiente ni ajuste de transporte. Tras actualizar un destino desde el transporte estándar, vuelve a conectarlo para iniciar una sesión nativa.
- Usa URLs HTTPS públicas con certificados válidos y enlaces permanentes bonitos. Copia la URL exacta del sitio web, incluido su subdirectorio. Las redirecciones, los puertos HTTPS personalizados y las direcciones de red privadas no son compatibles con los sitios web de destino.
- Elige el usuario de WordPress cuyo acceso debe usar el agente. Activa únicamente los grupos de escritura del destino necesarios para el trabajo.
1. Comprueba y conecta un sitio web
- Inicia sesión en tu cuenta POM. Abre My Account → POM AI Management → AI site connections.
- En Connect a website, selecciona la POM AI Unlimited license e introduce la Site URL. Expande Prepare WordPress para ver la lista de comprobación de configuración.
- Selecciona Check website. Una comprobación correcta confirma la licencia, la configuración MCP del sitio web y el descubrimiento de OAuth. No registra un agente ni autoriza el acceso al sitio web. Los valores de tu formulario siguen disponibles después de la comprobación.
- Deja sin marcar la casilla de operaciones para un acceso de Read only. Selecciona Allow site operations, including writes permitted by the WordPress user and the site's enabled write groups cuando se pretenda ejecutar acciones.
- Selecciona Connect a website. Inicia sesión en la pantalla de WordPress del destino como el usuario previsto, revisa los ámbitos solicitados y selecciona Authorize. Deny no concede ningún acceso.
- De vuelta en la página de la cuenta, busca el sitio web en Your websites. Confirma Connected y el acceso previsto; a continuación, selecciona Check connection.
- Repite el proceso para cada sitio web. El sitio principal de una red no autoriza automáticamente a sus subsitios; conecta explícitamente cada subsitio previsto.
Last check muestra Verified o Needs attention, la fecha de la comprobación y el resultado observado. Se trata de una instantánea, no de una supervisión continua. Cada operación solicitada en el sitio vuelve a comprobar la licencia y el acceso actuales al sitio web. Una conexión puede seguir apareciendo como Connected mientras su última comprobación informa de un problema que requiere atención.
Las comprobaciones de configuración y de conexión comparten un límite de 30 comprobaciones por hora y cuenta. Iniciar la autorización de un sitio web tiene un límite independiente de diez intentos por hora. Cargar la página de la cuenta no ejecuta comprobaciones en todos los sitios web.
2. Conecta el agente una sola vez
Copia la Account MCP URL con Copy URL. Añádela como un servidor MCP HTTP remoto usando OAuth. No pegues una clave de licencia de producto en un campo de token Bearer.
Para las versiones actuales de Claude Code, sustituye ACCOUNT_MCP_URL a continuación por la URL copiada:
claude mcp add --transport http --scope user pom-account 'ACCOUNT_MCP_URL'
claude mcp login pom-account
En versiones más antiguas de Claude Code, abre /mcp y autentica pom-account. Consulta la guía oficial de MCP de Claude Code.
Para Codex:
codex mcp add pom-account --url 'ACCOUNT_MCP_URL'
codex mcp login pom-account
Es posible que el comando add ya inicie la autorización. Completa el inicio de sesión cuando el cliente siga necesitando autenticación. Consulta la guía oficial de MCP de Codex.
Inicia sesión con esta cuenta POM cuando se abra el navegador. La pantalla de consentimiento muestra los ámbitos solicitados por el cliente:
| Acceso | Ámbitos requeridos |
|---|---|
| Descubrimiento y lectura | mcp:read, account:sites:read |
| Ejecución | También mcp:write, account:sites:execute |
Configura ámbitos más restringidos en el cliente antes de autorizar si no se desea la ejecución. Por ejemplo, Codex acepta codex mcp login pom-account --scopes mcp:read,account:sites:read. Claude Code admite un ajuste oauth.scopes separado por espacios en su configuración MCP HTTP. La pantalla de consentimiento muestra la solicitud resultante; no edita la selección de ámbitos del cliente.
Resultado esperado: una conexión de agente enumera los sitios web que has inscrito explícitamente. El consentimiento de la cuenta también cubre los sitios web inscritos más adelante. No concede acceso a los sitios web de otro cliente ni a la administración del sitio web de la propia cuenta. Los permisos del destino siguen aplicándose.
3. Instala la skill y verifica una primera tarea
- En Install the authoring skill, selecciona Download POM site skill.
- Extrae la carpeta completa y sigue su
INSTALL.md. Para la instalación en proyecto, usa.claude/skills/en Claude Code o.agents/skills/en Codex. Conserva los archivos de referencia complementarios. - Empieza con: "Usa POM Site Authoring para enumerar mis sitios web conectados. Selecciona el dominio que yo nombre, inspecciona sus herramientas disponibles y lee una página existente. No cambies nada todavía".
- Confirma que el agente selecciona el sitio web previsto. Para un flujo de trabajo de escritura autorizada, pídele que cree un borrador, lo vuelva a leer y lo inspeccione en WordPress antes de publicarlo.
WordPress no necesita ejecutarse en el ordenador del agente. La verificación visual requiere el propio acceso del navegador del agente. La skill también está disponible desde el Settings → POM AI → MCP server → Download POM site skill de un destino.
Operaciones admitidas y seguridad
Una conexión expone las herramientas de autoría de sitios web admitidas por el destino, sujetas al usuario de WordPress autorizado, a los ámbitos de OAuth y a los grupos de escritura activados. No puede gestionar cuentas de usuario, cambiar contraseñas ni roles, instalar software, ejecutar código arbitrario, ni crear o modificar JavaScript o PHP. El HTML sigue las reglas KSES de WordPress del destino, incluso para los administradores. Los volcados genéricos de opciones de plugins y los metadatos internos protegidos no están disponibles.
Los agentes pueden asignar scripts que ya existen en el catálogo de POM Theme a páginas, entradas y contenido personalizado compatible editables, así como a plantillas de archivo, individuales y de feed. Seleccionar un script existente no concede acceso para crear o editar su código fuente. Las asignaciones de scripts a contenido necesitan los grupos de escritura tanto de contenido como de POM Theme.
Actualiza POM AI en cada destino cuando una conexión solicite una actualización y, a continuación, ejecuta Check connection. Instalar la skill por sí sola no cambia las operaciones admitidas de un sitio web.
Revoca un agente o vuelve a conectar un sitio web
En Authorized agents, selecciona Revoke agent access junto al cliente previsto. Esto revoca el acceso a la cuenta y las credenciales de actualización de ese agente, junto con sus códigos de autorización pendientes para tu usuario. Los demás agentes y sitios web conectados siguen disponibles. Una operación ya enviada puede terminar. Para volver, el agente necesita una nueva autorización OAuth. Los nombres de los clientes son proporcionados por los clientes; usa el sufijo de identificador mostrado para distinguir nombres que coincidan.
En Your websites, Disconnect elimina la conexión seleccionada y solicita la revocación de su concesión de WordPress en el destino. Los demás sitios web siguen disponibles. Si la revocación remota no puede confirmarse, el aviso lo explica; Reset OAuth en ese destino revoca todos sus clientes y tokens OAuth.
Para cambiar el usuario de un sitio web o el acceso concedido:
- Selecciona Disconnect and reconnect. La concesión anterior se elimina inmediatamente.
- Revisa la URL, la licencia y la casilla de operaciones ya rellenadas.
- Selecciona Connect a website y completa un nuevo consentimiento en el destino.
- Confirma Connected, ejecuta Check connection y, a continuación, pide al agente que vuelva a enumerar los sitios web y seleccione la nueva conexión.
Una fila desconectada ofrece Connect again. El contenido existente del sitio web permanece. Una nueva conexión tiene una identidad de cliente nueva y no asume la propiedad de los journals creados bajo la anterior. Conserva cualquier información de journal necesaria para la revisión manual antes de volver a conectar.
Cuando el acceso necesita atención
| Situación | Siguiente paso |
|---|---|
| No aparece ninguna licencia apta | Comprueba la propiedad, el estado y el plan en Licenses & Downloads. |
| La MCP de la cuenta no está disponible | Espera a la disponibilidad del servicio de la cuenta; el acceso existente a sitios web y agentes todavía puede revocarse cuando sus servicios de gestión estén disponibles. |
| Un dominio con licencia no aparece en el agente | Completa Connect a website y su consentimiento de WordPress independiente. |
| Awaiting authorization, Authorization expired o Authorization incomplete | Usa Disconnect and reconnect, inicia sesión y completa un nuevo consentimiento. |
| Se requiere una actualización de POM AI | Actualiza POM AI en ese destino y repite la comprobación. |
| Se requiere la configuración del sitio web | Sigue Prepare WordPress y, a continuación, selecciona Check website de nuevo. |
| Needs attention después de una comprobación | Sigue el mensaje mostrado, corrige el problema del sitio web o de la licencia y ejecuta Check connection de nuevo. |
| El sitio ya está conectado, se ha movido o se ha clonado | Verifica el original previsto y desconecta su conexión antigua antes de conectar explícitamente el destino previsto. |
| Se rechaza una escritura | Comprueba los ámbitos de la cuenta, el acceso de la conexión, las capacidades del usuario del destino y los grupos de escritura del destino. |
| Se ha revocado un agente | Vuelve a autorizar ese agente mediante OAuth. Reinstalar la skill no restaura el acceso. |
| Se pierde una respuesta o es demasiado grande | Inspecciona el journal o el contenido del destino antes de repetir una operación; usa planes y cargas útiles más pequeños. |
Una llamada se dirige a un solo sitio web. No existe ninguna transacción multisitio ni deshacer automático. La cuenta acepta hasta 1 MiB de argumentos enrutados y respuestas de 2 MiB; también se aplican los límites del destino y los límites de frecuencia. Trabaja en pasos pequeños cuyos resultados puedas inspeccionar.
Relacionado: Autoriza un dominio para POM AI, Tu suscripción a POM AI.