Conectar un cliente MCP
Toda la configuración, en orden. La mayor parte la realiza el cliente; las partes que te necesitan están marcadas.
Antes de empezar
- POM AI MCP habilitado en Settings → POM AI → AI Tools.
- Enlaces permanentes bonitos configurados.
- El sitio en HTTPS.
- Diagnósticos correctos. Consulta Comprobar el estado del servidor.
Integración de WordPress incluida
Instala el paquete completo del plugin POM AI. En WordPress 6.9 o posterior, POM AI usa automáticamente la API de Abilities del núcleo y su adaptador MCP oficial incluido. No necesitas otro plugin, Composer, una instalación local de WordPress ni un selector de transporte. WordPress 6.8 conserva el transporte estándar de POM; el enrutamiento de cuentas y la delegación multisitio requieren 6.9+.
Abre Settings → POM AI → MCP server, deja Enable OAuth habilitado y guarda. Las conexiones con clave de API en WordPress 6.9+ requieren además un Service user ID existente con la capacidad read de WordPress. OAuth usa a la persona que autoriza la conexión y no necesita un usuario de servicio ni una clave de API MCP generada.
Después de actualizar desde el transporte estándar, reconecta tu cliente una vez para que inicialice una sesión y vuelva a descubrir las herramientas. La URL MCP y las credenciales OAuth conservan su identidad. La configuración de transporte retirada se ignora, incluidos los valores guardados deshabilitados. El panel de configuración informa del transporte activo y de los problemas de dependencias. Consulta el contrato de transporte para los detalles de sesiones y protocolo.
1. Obtén la URL del servidor
Desde Settings → POM AI → MCP server, copia la URL MCP:
https://example.com/wp-json/pom-ai-mcp/v1/mcpCópiala en lugar de escribirla — también sirve como identificador del recurso OAuth y se compara de forma exacta. Consulta Encontrar la URL del servidor MCP.
2. Añade el servidor al cliente
En el formulario de servidor MCP personalizado del cliente:
| Campo | Valor |
|---|---|
| Nombre | Algo que identifique el sitio |
| Transporte | HTTP con transmisión |
| URL | La URL MCP |
| Token de portador | Déjalo vacío para OAuth |
| Cabeceras | Déjalas vacías para OAuth |
Para el modo de clave de API, en su lugar, configura una cabecera X-POM-AI-MCP-API-Key con tu clave, idealmente desde una variable de entorno. Nunca configures a la vez un token de portador y una clave de API — una petición que lleve ambos se rechaza.
3. Deja que descubra y se registre
En la primera conexión, el cliente recibe un 401 que apunta a los metadatos del recurso protegido, los sigue hasta los metadatos del servidor de autorización y se registra por sí mismo. Ninguna acción por tu parte.
Si el flujo nunca arranca, probablemente las URL de descubrimiento devuelven 404 porque los enlaces permanentes no están configurados.
4. Aprueba la autorización — tu paso
El cliente abre la página de autorización. Si no has iniciado sesión, WordPress te pide que lo hagas primero.
Inicia sesión como el usuario cuyas capacidades debe tener el asistente. Esta es la decisión más importante de toda la configuración. La aprobación de un administrador da alcance de administrador; un usuario limitado dedicado da un alcance limitado.
Lee los ámbitos en la pantalla de consentimiento y, a continuación, aprueba. Consulta El punto de conexión de autorización y Ámbitos OAuth.
5. Confirma la conexión
El cliente debería mostrar ahora las herramientas. Comprueba dos cosas:
- En el cliente: la lista de herramientas está poblada. Su tamaño refleja los productos y el transporte activos. El descubrimiento no es permiso para ejecutar todas las operaciones listadas.
- En WordPress: el registro reciente del panel de configuración MCP muestra la autorización y la llamada de descubrimiento MCP, con el usuario que actúa.
Si el cliente no muestra herramientas, comprueba sus errores de conexión, el transporte seleccionado y las dependencias requeridas antes de reconectar.
6. Lee antes de escribir
Pide al asistente algo inofensivo — cuántas entradas publicadas hay, o los detalles de una página por su ID. Consulta Haz tu primera petición de lectura.
Solo entonces plantéate habilitar una puerta de escritura. Las cuatro están desactivadas por defecto y ese es el estado inicial correcto. Consulta Habilitar las escrituras.
Multisitio
Para una conexión del sitio principal que gestione páginas de la red, sigue Gestionar páginas multisitio. Los subsitios delegados solo necesitan POM AI activo; no configures una licencia local, una clave MCP ni una conexión OAuth para la delegación.
Para un subsitio con su propia conexión directa, activa POM AI allí, guarda su propia licencia autorizada por dominio en Settings → POM AI → License, habilita POM AI MCP y sigue los pasos anteriores usando la URL mostrada de ese subsitio. Autoriza con el usuario de WordPress previsto para ese subsitio. Su conexión nunca hereda la concesión de red del sitio principal. Una instalación independiente sigue estos mismos pasos con su propia licencia y URL.
Una cuenta POM AI Unlimited elegible puede, en su lugar, proporcionar una conexión de cuenta para sitios web inscritos explícitamente, incluidas instalaciones independientes y subsitios multisitio. En My Account → POM AI Management → AI site connections, conecta cada sitio web y aprueba su consentimiento OAuth de WordPress. Cada destino requiere el modo de adaptador nativo, OAuth y un dominio de licencia ya autorizado. Configura la Account MCP URL mostrada una vez en el agente usando OAuth. Pídele que liste los sitios y seleccione el dominio previsto antes de leer o escribir.
El descubrimiento y la lectura de cuenta requieren mcp:read más account:sites:read. La ejecución requiere además mcp:write, account:sites:execute, una conexión de sitio con escritura habilitada y las capacidades/puertas de escritura propias del destino. Esta concesión de cuenta también cubre los sitios web que inscribas más adelante; nunca concede la administración del sitio web de la cuenta. Que un dominio aparezca en tu licencia por sí solo no lo conecta.
Comprueba la línea Blog ID del panel de configuración para confirmar qué sitio estás configurando.
Sitios multilingües
Configura la URL canónica que se muestra en la pantalla de configuración. Cuando POM Translate antepone un código de idioma a las URL, el servidor también acepta rutas OAuth y de descubrimiento localizadas, de modo que una redirección a través de una URL traducida no rompe el flujo.
Cuando no se conecta
| Síntoma | Comprobar |
|---|---|
| El cliente no puede alcanzar el servidor | La URL, HTTPS y que el punto de conexión de estado devuelva JSON |
| El flujo OAuth nunca arranca | Enlaces permanentes bonitos |
| La autorización termina, las llamadas siguen devolviendo 401 | Si la cabecera Authorization sobrevive — los diagnósticos informan de esto |
invalid_resource |
La URL configurada frente a la pantalla de configuración, carácter por carácter |
invalid_client después de haber funcionado antes |
Alguien usó Reset OAuth; reconecta |
| Limitación de velocidad durante la configuración | Las peticiones de registro y de token permiten 5 por minuto; espera |
| La lista de herramientas está vacía | Las dependencias del transporte, los errores de conexión y si los productos están activos |
| HTML en lugar de JSON | Un plugin de seguridad, un WAF o una caché interceptando las rutas |
Ejecuta los diagnósticos antes de investigar el cliente; responden a la mayoría de estas preguntas directamente.
Desconexión
- Reset OAuth revoca todos los clientes y tokens del sitio a la vez.
- Revoke API key detiene el acceso por clave de API.
- Deshabilitar la herramienta POM AI MCP elimina el servidor por completo.
Reset OAuth sigue siendo todo o nada. Un cliente de protocolo puede revocar su concesión individual usando el punto de conexión de revocación anunciado. Para un sitio web inscrito en una cuenta, Disconnect en AI site connections elimina ese sitio web de la cuenta y solicita la revocación de su concesión de sitio mientras las demás conexiones de sitios web siguen disponibles. Si el sitio no puede confirmar la revocación, la cuenta lo informa explícitamente. Una operación ya enviada puede terminar igualmente.