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

  1. El asistente llama a tools/list si no lo ha hecho ya.
  2. Elige una herramienta de lectura.
  3. Llama a tools/call con argumentos.
  4. Tu sitio lo ejecuta y devuelve JSON.
  5. 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, oauth o api_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.