Un cliente MCP no puede conectarse

Prueba el endpoint del sitio antes de depurar herramientas individuales.

Comprobación del endpoint

Usa la URL MCP que se muestra en Settings → POM AI → MCP server. Su ruta termina en:

/wp-json/pom-ai-mcp/v1/mcp

Una solicitud autenticada o de disponibilidad GET debería llegar a POM AI. Confirma:

• que el ajuste del servidor MCP está habilitado;
• que la URL pertenece al subsitio multisitio previsto;
• que las solicitudes REST de WordPress funcionan;
• que HTTPS y el certificado son aceptados por el cliente;
• que ningún cortafuegos ni plugin de seguridad bloquea la ruta;
• que el cliente envía una versión de protocolo compatible.

Descubrimiento y 404 de OAuth

El endpoint MCP puede responder mientras las URL de descubrimiento u OAuth devuelven 404. Comprueba el campo de estado permalinks_enabled y configura Settings → Permalinks. Es posible que las reglas de reescritura del alojamiento también necesiten atención.

Clientes con origen de navegador

Si el cliente se ejecuta desde un origen de navegador, ese origen exacto debe estar en la lista de orígenes permitidos de MCP configurada. No añadas * para solucionar una comprobación previa fallida.

Una vez que initialize tenga éxito, actualiza tools/list, resources/list y prompts/list. Un error de herramienta posterior es un problema de autorización o de esquema, no un fallo de conexión.

Guías relacionadas: transporte MCP, límite del enlace permanente y fallo de autenticación.