/wp-json/pom-ai-mcp/v1/status: Endpoint de estado MCP

Un resumen público y sin autenticación de la configuración del servidor. Es la forma más rápida de confirmar que el servidor está activo y de ver qué encontrará un cliente.

https://example.com/wp-json/pom-ai-mcp/v1/status

Solo GET. Ábrelo en un navegador.

Qué informa

Campo Significado
active El servidor está en ejecución
mcp_endpoint La URL MCP canónica que deberían usar los clientes
oauth_enabled Si se acepta la autenticación OAuth
api_key_enabled Si se acepta la autenticación por clave de API
api_key_active Si existe actualmente una clave de API
pom_theme Si se detectó el POM theme, con la hoja de estilos activa, la plantilla y la versión
woocommerce_detected Si WooCommerce está activo
permalinks_enabled Si los enlaces permanentes bonitos están configurados
pom_ai_version La versión instalada de POM AI
capabilities Qué compuertas de escritura están abiertas, además de recursos, prompts y contexto de autoría
protocol_versions Las versiones del protocolo MCP compatibles

El campo que más importa

capabilities te indica cuáles de las cuatro compuertas de escritura están abiertas:

content_writes, option_writes, pom_theme_writes, woocommerce_writes

Las cuatro deberían mostrar false a menos que hayas abierto deliberadamente una para una tarea. Este endpoint es la auditoría más rápida de eso: más rápida que abrir la pantalla de ajustes y consultable desde fuera.

Si una compuerta que creías cerrada muestra true, ciérrala. Consulta Habilitar escrituras.

El campo que explica una conexión rota

Que permalinks_enabled muestre false significa que los endpoints de descubrimiento y OAuth devuelven 404 mientras este endpoint sigue respondiendo: la combinación que hace más difícil atribuir una conexión fallida.

Corrígelo en Settings → Permalinks eligiendo cualquier estructura distinta de la simple. El panel de ajustes de MCP también muestra una advertencia mientras esto ocurra.

Es público a propósito

No se requiere autenticación, y es deliberado: un cliente necesita saber si un servidor existe y qué versiones del protocolo admite antes de poder autenticarse.

No se expone nada sensible. Informa de si existe una clave de API, nunca de la clave; de si OAuth está habilitado, nunca de un token; de qué productos están instalados, nunca de sus datos.

Si prefieres no publicar ni siquiera eso, desactiva la herramienta POM AI MCP cuando no esté en uso: el endpoint desaparece con ella.

Usarlo para diagnosticar

Lo que ves Significa
JSON El servidor está en ejecución y la API REST es accesible
Un 404 La herramienta MCP está desactivada o la API REST está bloqueada
HTML Algo en la cadena interceptó la solicitud: un plugin de seguridad, un WAF o una página de mantenimiento
woocommerce_detected: false en una tienda Estás en el sitio equivocado o WooCommerce está inactivo
pom_theme.detected: false El POM theme no es el tema activo aquí
Falta la versión del protocolo El cliente y el servidor no coinciden en el soporte de protocolo

Vale la pena detenerse en el caso del HTML: significa que las solicitudes no llegan intactas a WordPress, lo que romperá todo el flujo MCP independientemente de las credenciales.

Almacenamiento en caché

La respuesta incluye Cache-Control: no-store. Si una CDN la almacena en caché de todos modos, verás estados de compuertas obsoletos y una detección de productos obsoleta, que es exactamente la información para la que la consultas. Excluye las rutas MCP del almacenamiento en caché. Consulta Requisitos de MCP.

En una comprobación de estado

Como es público, estable y económico, funciona como sonda de monitorización. Afirmaciones razonables:

  • la respuesta es JSON;
  • active es true;
  • las cuatro compuertas de escritura coinciden con tu configuración prevista;
  • pom_ai_version coincide con lo que desplegaste.

La afirmación sobre las compuertas es la valiosa. Detecta una compuerta dejada abierta después de una tarea, que es la desviación de configuración más probable en un sitio que usa MCP.

`/wp-json/pom-ai-mcp/v1/mcp`: Extremo de transporte MCP
Anterior
Cómo descubren los clientes las herramientas y los recursos
Siguiente