Comprobar el estado del servidor MCP
Hay dos formas de confirmar que el servidor está en buen estado: el botón de diagnóstico del panel de ajustes y el endpoint de estado público. Usa la primera durante la configuración y la segunda cuando un cliente se comporte de forma incorrecta.
El panel de ajustes de MCP
Settings → POM AI → MCP server muestra tres tarjetas.
Endpoints — la URL de MCP, la URL de metadatos del recurso protegido y la URL de metadatos del servidor de autorización. Consulta Encontrar la URL del servidor MCP.
Credentials — si hay una clave de API activa y sus cuatro últimos caracteres. Botones para Generate / rotate API key, Revoke API key y Reset OAuth.
Si los enlaces permanentes bonitos no están configurados, aparece un error encima de estas tarjetas explicando que los endpoints de descubrimiento y OAuth enumerados más abajo devuelven actualmente un 404. Corrige eso antes que cualquier otra cosa: las URL de los endpoints se imprimen de igual modo, así que, si no, el fallo pasa desapercibido.
Status — una lista breve:
| Línea | Significado |
|---|---|
| OAuth | Si la autenticación OAuth está activada |
| API key auth | Si la autenticación por clave de API está activada |
| POM Theme | Si se detectó el tema POM |
| WooCommerce | Si se detectó WooCommerce |
| Blog ID | De qué sitio de una red multisitio se trata |
La última línea merece leerse en un multisitio. Configurar el subsitio equivocado es un error frecuente y que desconcierta.
Ejecutar diagnósticos
El botón Run diagnostics hace que el sitio llame a sus propios endpoints e informe de lo que ha recibido. Responde a las preguntas que importan cuando algo va mal:
- Permalinks enabled — si es false, explica por qué las URL de
.well-knowny de OAuth devuelven un 404. - Authorization header seen y API key header seen — si esas cabeceras sobrevivieron al trayecto hasta WordPress. Una cabecera
Authorizationeliminada es la causa clásica de que OAuth falle en silencio. - CloudFront detected, con las rutas que deben omitir la caché y las cabeceras que deben reenviarse.
- Self-tests para los metadatos del recurso protegido, los metadatos del servidor de autorización y el endpoint de estado; cada uno informa del estado HTTP, del tipo de contenido, de si el cuerpo se analizó como JSON y de si apareció HTML donde debería haber JSON.
Esa última comprobación es la útil: HTML en la respuesta significa que algo por delante —un plugin de seguridad, un desafío de WAF, una página de mantenimiento— interceptó la solicitud.
Registros recientes de MCP
Debajo de las tarjetas, el panel enumera los diez eventos MCP más recientes con la hora, la acción, el estado, el tipo de autenticación y el usuario que actuó. Al seleccionar una acción se abre la entrada completa.
Aquí es donde ves lo que hizo realmente un cliente conectado: autenticaciones, llamadas a herramientas, denegaciones y límites de frecuencia. Los valores sensibles se ocultan antes de escribir nada, y los valores largos se truncan.
Las entradas del registro se purgan automáticamente según Log retention days, que por defecto es 30.
El endpoint de estado
https://example.com/wp-json/pom-ai-mcp/v1/statusPúblico, sin autenticación y seguro de abrir en un navegador. Informa de si el servidor está activo, del endpoint de MCP, de qué métodos de autenticación están activados, de si existe una clave de API, de qué productos se detectaron, de la versión de POM AI, de qué compuertas de escritura están abiertas y de las versiones de protocolo admitidas.
Detalle completo en El endpoint de estado.
Una rutina rápida de comprobación
- Abre el endpoint de estado en un navegador. Si hay JSON, el servidor responde.
- Comprueba
capabilities: ¿las compuertas de escritura abiertas coinciden con lo que querías? - Comprueba los productos detectados.
- Ejecuta los diagnósticos desde el panel de ajustes.
- Confirma que las autocomprobaciones están bien y que no apareció HTML.
- Revisa los registros recientes en busca de denegaciones que no puedas explicar.
Interpretar un problema
| Síntoma | Qué mirar |
|---|---|
| El endpoint de estado devuelve HTML o un 404 | La herramienta MCP está desactivada, o la API REST está bloqueada |
Las URL de .well-known devuelven 404 pero el estado funciona |
Los enlaces permanentes bonitos no están configurados |
| El cliente se autentica y luego se deniega cada llamada | Los ámbitos del token, o las capacidades del usuario que actúa |
| Las escrituras siempre se rechazan | La compuerta de escritura está cerrada; comprueba capabilities en el estado |
| OAuth nunca se completa | Cabecera Authorization eliminada, o una discrepancia en la URL del recurso |
La autocomprobación muestra html_unexpected |
Un plugin, un WAF o una capa de caché está interceptando |
| Falta un grupo de herramientas | Su producto no está activo en este sitio |
Después de cambiar ajustes
Vuelve a ejecutar los diagnósticos después de activar la herramienta MCP, cambiar los ajustes de autenticación, abrir una compuerta de escritura o cambiar los enlaces permanentes. Las URL de los endpoints y las reglas de reescritura se establecen cuando la herramienta se inicializa, y los diagnósticos son la confirmación más rápida de que el estado actual es lo que crees que es.