Encontrar la URL del servidor MCP

Todo lo que un cliente necesita aparece en una sola pantalla. Esta página te indica dónde se encuentra y qué valor debes darle al cliente.

Dónde están las URLs

Abre Settings → POM AI → MCP server. La tarjeta Endpoints muestra tres URLs:

Cópialas desde la pantalla en lugar de componerlas a mano. Se crean a partir de la propia URL de inicio de tu sitio, por lo que ya reflejan tu dominio, el esquema y cualquier instalación en un subdirectorio.

Cuál necesita el cliente

La URL MCP. Esa es la dirección del servidor que solicita un cliente.

Un cliente que se comporta correctamente descubre las otras dos por sí mismo: llama al endpoint MCP, recibe una 401 con una cabecera WWW-Authenticate que apunta a los metadatos del recurso protegido, y sigue la cadena desde ahí. Consulta Cómo funciona el descubrimiento.

Dale al cliente únicamente la URL MCP, salvo que su formulario de configuración pida explícitamente una URL de metadatos.

La forma exacta

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

En una instalación en un subdirectorio:

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

Tres cosas importan:

• HTTPS. Los tokens y las claves de API viajan en las cabeceras.
• Sin barra final. La comprobación del recurso de OAuth compara la URL de forma exacta, ignorando únicamente una diferencia de barra final; una cadena de consulta o un fragmento la invalidan.
• El host canónico. La URL se deriva de la URL de inicio de tu sitio, por lo que utiliza la variante de example.com y www.example.com que WordPress considera canónica. Usar la otra hará que falle la comprobación del recurso.

Por qué importa la URL exacta

El endpoint MCP funciona a la vez como el identificador de recurso de OAuth. Durante la autorización y el intercambio de tokens, el cliente envía un parámetro resource y el servidor lo comprueba contra este endpoint, comparando el esquema, el host, el puerto y la ruta.

Una discrepancia —la variante de host incorrecta, un segmento de ruta añadido, una cadena de consulta— se rechaza con invalid_resource. Si un cliente falla en el paso del token con ese error, compara su URL configurada con la que aparece en esta pantalla carácter por carácter.

Los clientes que omiten por completo el parámetro resource se aceptan, porque algunos clientes MCP no lo envían; el servidor asume entonces su propio endpoint.

Multisitio

Cada sitio tiene su propio endpoint, derivado de la URL de inicio de ese sitio:

https://example.com/site-a/wp-json/pom-ai-mcp/v1/mcp
https://example.com/site-b/wp-json/pom-ai-mcp/v1/mcp

Los tokens, las claves de API, los clientes OAuth y los ajustes son todos por sitio. Un token de un sitio no funciona en otro. Abre los ajustes de MCP dentro de la administración del sitio concreto para obtener su URL.

Sitios multilingües

Cuando POM Translate antepone un código de idioma a las URLs, el servidor también acepta rutas localizadas para los endpoints de OAuth y de descubrimiento —/es/pom-ai-mcp/oauth/authorize, por ejemplo—, sin dejar de anunciar las URLs canónicas sin prefijo.

Configura el cliente con la forma canónica que se muestra en la pantalla de ajustes. La aceptación localizada existe para que una redirección a través de una URL traducida no rompa el flujo.

Comprobar que resuelve

Abre el endpoint de estado en un navegador:

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

Debería devolver JSON. Si devuelve HTML o un 404, la herramienta MCP no está habilitada o la API REST no es accesible. Consulta El endpoint de estado.

A continuación, comprueba de la misma manera las dos URLs .well-known. Si esas devuelven la página 404 de tu sitio mientras que el endpoint de estado funciona, los enlaces permanentes bonitos no están configurados: las URLs de descubrimiento son reglas de reescritura. Configura una estructura de enlaces permanentes y vuelve a comprobarlo.

Siguiente

Confirma que todo está en buen estado con Comprobar el estado del servidor y después elige un método de autenticación.