Requisitos de MCP

Estos requisitos describen una conexión de sitio independiente. Los destinos multisitio delegados necesitan POM AI activo, pero no una licencia local ni una configuración de MCP; el sitio principal es el propietario de la conexión autorizada.

Comprueba esto antes de conectar un cliente. La mayoría de las configuraciones de MCP fallidas se deben a un prerrequisito que falta, no a un problema del cliente.

En el sitio

Los enlaces permanentes amigables importan más de lo que se espera. Con enlaces permanentes simples, /.well-known/oauth-protected-resource y /pom-ai-mcp/oauth/* no se resuelven, por lo que el descubrimiento y todo el flujo de OAuth fallan mientras que el propio endpoint de MCP sigue respondiendo. Establece primero una estructura de enlaces permanentes en Settings → Permalinks.

No tendrás que adivinarlo. Cuando los enlaces permanentes son simples, el panel de ajustes de MCP muestra un error encima de la lista de endpoints que lo indica, y el endpoint de estado informa de permalinks_enabled: false.

Productos opcionales

Los grupos de herramientas solo aparecen cuando su producto está presente:

• POM Theme activo: herramientas de ajustes del tema, modelo de contenido y plantillas.
• WooCommerce activo: herramientas de productos, variaciones, atributos y cupones.
• POM Cache activo: herramientas de estado de caché y purga.

Un producto que falta elimina sus herramientas de la lista en lugar de provocar errores. El endpoint de estado informa de cuáles se detectaron.

Infraestructura

El servidor establece Cache-Control: no-store en sus respuestas, y las rutas implicadas deben llegar a WordPress intactas.

Si una CDN, un proxy inverso o un WAF se sitúa delante del sitio, estas rutas no deben almacenarse en caché ni ser desafiadas:

/wp-json/pom-ai-mcp/v1/*
/pom-ai-mcp/oauth/*
/.well-known/oauth-protected-resource
/.well-known/oauth-authorization-server

Y estas cabeceras de solicitud deben reenviarse en lugar de eliminarse:

Authorization
X-POM-AI-MCP-API-Key
Mcp-Session-Id
MCP-Protocol-Version
Content-Type
Accept
Origin
Cookie
Host

Authorization es la que se elimina con más frecuencia, tanto por configuraciones de Apache como por plugins de seguridad. Cuando ocurre, OAuth parece fallar sin motivo: el token se envía y nunca llega.

Los diagnósticos del panel de ajustes de MCP informan de si se vieron las cabeceras Authorization y de clave de API, lo que resuelve esa cuestión rápidamente. Consulta Comprobar el estado del servidor.

En el cliente

• Un cliente compatible con MCP que admita el transporte Streamable HTTP.
• Compatibilidad con OAuth con PKCE S256, o la capacidad de enviar una cabecera personalizada para el modo de clave de API.
• Acceso de red a tu sitio.

El servidor admite las versiones del protocolo MCP 2025-06-18 y 2025-03-26, con la primera como predeterminada. A un cliente que solicite cualquier otra se le rechaza con un error explícito.

Decide antes de conectar

Qué método de autenticación. OAuth actúa como el usuario de WordPress que autoriza y admite ámbitos por cliente; las claves de API actúan como el usuario de servicio configurado y pueden escribir cuando las capacidades y los umbrales lo permiten. Consulta Elegir un método de autenticación.

Qué usuario de WordPress. Con OAuth, el asistente hereda las capacidades de quien aprueba la autorización. Aprobar como administrador concede alcance de administrador. Considera un usuario dedicado con únicamente las capacidades que el trabajo necesite.

Si se necesita alguna escritura. Los cuatro umbrales de escritura están desactivados de forma predeterminada, y el modo de solo lectura es una configuración permanente legítima.

Dónde lo estás haciendo. El trabajo estructural —modelos de contenido, plantillas, ajustes del tema, cambios masivos— debe realizarse primero en un entorno de pruebas.

Antes de la primera escritura

• Haz una copia de seguridad que realmente puedas restaurar.
• Activa únicamente el umbral de escritura que la tarea necesite.
• Confirma que el usuario que actúa es el que pretendías.

Consulta Activar las escrituras.

Verificar la preparación

1. Settings → POM AI → AI Tools muestra POM AI MCP activado.
2. La pestaña MCP server muestra las tres URL de endpoints.
3. Run diagnostics informa de que las autocomprobaciones están correctas.
4. El endpoint de estado devuelve JSON en un navegador.
5. Los productos detectados coinciden con lo que esperas.

A continuación, continúa con Encontrar la URL del servidor MCP.