Ejecuta tu primera solicitud MCP de solo lectura
Una solicitud de lectura demuestra toda la cadena — descubrimiento, autenticación, ámbitos, capacidades y la propia herramienta — sin cambiar nada. Haz esto antes de activar cualquier puerta de escritura.
Pide algo pequeño
Con el cliente conectado, pídele al asistente un dato sobre el sitio:
¿Cuántas entradas publicadas hay?
Muéstrame el título y el estado de la página 412.
Enumera las categorías de productos.
El asistente elige una herramienta, la llama e informa del resultado. Lo que estás comprobando es que puede hacerlo, no que la respuesta sea interesante.
Empieza con un recuento o con un único elemento por ID. Una solicitud que devuelve cientos de registros hace más difícil distinguir una conexión que funciona de una confusa.
Qué debería ocurrir
- El asistente llama a
tools/listsi no lo ha hecho ya. - Elige una herramienta de lectura.
- Llama a
tools/callcon argumentos. - Tu sitio lo ejecuta y devuelve JSON.
- El asistente lo resume.
Los resultados llegan como texto que contiene JSON con formato legible, de modo que un asistente que informa de un muro de JSON se está comportando con normalidad.
Confírmalo desde el lado de WordPress
No te fíes solo de la palabra del asistente. Abre Settings → POM AI → MCP server y mira Recent MCP logs. Deberías ver:
- una entrada
tools_list; - una entrada
tool_…con el nombre de la herramienta que se ejecutó; - el estado
success; - el tipo de autenticación,
oauthoapi_key; - el usuario que actuó.
Comprueba que el usuario que actuó es el que pretendías. Este es el momento de detectar una autorización aprobada con la cuenta equivocada, mientras no hay nada en juego.
Seleccionar la acción abre la entrada completa con los argumentos y el resultado, redactados y truncados.
Leer la lista de herramientas
Pregunta al asistente qué herramientas tiene. La lista te dice mucho:
- Muchas menos de las esperadas — los ámbitos del token son limitados, o faltan productos.
- Sin herramientas de WooCommerce — WooCommerce no está activo en este sitio.
- Sin herramientas de POM Theme — el tema POM no es el tema activo.
- Una herramienta listada es rechazada — comprueba el usuario que actuó, los ámbitos de OAuth cuando corresponda, la puerta de escritura y los argumentos aceptados.
La lista refleja lo que está registrado en el servidor. Que una herramienta listada vaya a ejecutarse realmente sigue dependiendo de los ámbitos, las capacidades y las puertas.
Primeras preguntas útiles
| Objetivo | Pregunta |
|---|---|
| Demostrar la conexión | ¿Cuántas entradas publicadas hay? |
| Comprobar la identidad que actúa | ¿Qué puedes ver de la página N? |
| Comprobar la detección de productos | ¿Qué herramientas de WooCommerce tienes? |
| Comprobar la capa de autoría | ¿Qué shortcodes están disponibles en este sitio? |
| Comprobar la visibilidad de la caché | ¿Cuál es el estado actual de la caché? |
La pregunta sobre autoría merece hacerse pronto si tienes intención de construir páginas más adelante — ejercita las herramientas que hacen válidos los diseños generados.
Cuando falla
| Síntoma | Causa |
|---|---|
| 401 en cada llamada | Token caducado, o la cabecera Authorization se está eliminando |
pom_ai_mcp_scope_denied |
El token carece de un ámbito que la herramienta necesita, a menudo el compañero de lectura de un ámbito de escritura |
pom_ai_mcp_forbidden |
El usuario de WordPress que actúa carece de la capacidad |
pom_ai_mcp_unknown_tool |
La herramienta no existe aquí; probablemente falta su producto |
pom_ai_mcp_missing_argument |
El cliente omitió un argumento obligatorio |
| Limitado por velocidad | 60 solicitudes por minuto por cliente de forma predeterminada |
| Nada en el registro | La solicitud nunca llegó a WordPress |
Esa última fila es el diagnóstico importante: un registro vacío significa que el problema está aguas arriba — red, proxy, WAF o una cabecera eliminada — no en el servidor.
Antes de continuar
Confirma las cuatro cosas:
- [ ] Una herramienta de lectura devolvió una respuesta correcta que verificaste de forma independiente.
- [ ] El registro muestra la llamada con el usuario que esperabas que actuara.
- [ ] La lista de herramientas coincide con los productos instalados.
- [ ] No se modificó nada.
Después lee Enabling writes antes de your first write request.