Solución de problemas de acceso de Claude Code o Codex a WordPress

Diagnostica el acceso de Claude Code o Codex a WordPress de fuera hacia dentro: confirma que el cliente carga la configuración prevista, que se puede alcanzar el servidor MCP o la herramienta REST, que la credencial de WordPress autentica, que la identidad tiene la capacidad requerida y que la tarea solicita una herramienta disponible con entradas válidas.

No cambies clientes, conectores, credenciales y permisos al mismo tiempo. Cambia una capa, vuelve a ejecutar una prueba conocida y conserva el límite de rechazo esperado.

En una frase: aísla cliente, conector, autenticación, autorización y diseño de tarea en vez de tratar toda la pila como una única conexión.

Lo que esta guía te ayuda a conseguir

Esta guía proporciona un método de diagnóstico común para dos grandes clientes de agentes de programación y conserva referencias de configuración específicas de cada cliente. Está diseñada para reducir la ambigüedad de soporte y producir evidencia adecuada para futuras afirmaciones de compatibilidad.

Un flujo de trabajo de IA útil no se define solo por la calidad de la respuesta. También se define por los datos que el asistente puede alcanzar, las acciones que puede realizar, la evidencia que puedes inspeccionar después y la facilidad con que puede retirarse el acceso.

Por qué importa

Una conexión puede fallar antes de contactar con WordPress, después de la autenticación o solo para una acción. A menudo los usuarios responden reinstalando todo o concediendo acceso más amplio, destruyendo la evidencia que identificaría el problema real.

Un método capa por capa hace reproducible el fallo y revela si el problema pertenece al cliente, al conector, al sitio, al modo de producto o al prompt.

Salida esperada

Una ejecución satisfactoria debe producir:

• Un registro de diagnóstico capa por capa.
• Una prueba de lectura conocida como correcta.
• Una clasificación de fallo de cliente, conector, credencial, capacidad o tarea.
• Una corrección mínima y una prueba de regresión.
• Evidencia ligada a versiones para soporte o documentación.

Capa 1: configuración de cliente

En Claude Code, inspecciona servidores MCP y ámbito configurados. En Codex, inspecciona la capa activa de config.toml y los servidores MCP disponibles. Confirma que el proyecto es de confianza cuando se requiera y que existen variables de entorno sin imprimir sus valores.

Capa 2: conector o servidor

Confirma que el proceso se inicia o que se puede alcanzar el endpoint HTTP. Inspecciona el descubrimiento de herramientas independientemente de ejecutar la tarea. Verifica versión de paquete, transporte, tiempo de inicio e instrucciones de servidor. Una herramienta ausente es diferente de una herramienta que devuelve 403.

Capa 3: autenticación de WordPress

Usa una solicitud mínima no relacionada con IA cuando sea posible para comprobar la credencial y la ruta HTTPS. Comprueba si proxies, cortafuegos o plugins de seguridad eliminan autenticación. No pegues la credencial en registros de soporte.

Capa 4: autorización y cobertura de WordPress

Identifica la identidad autenticada, el modo de producto, la capacidad de WordPress y la acción solicitada. Comprueba la cobertura actual del producto y el esquema de herramienta del conector. Una guía o un prompt no puede hacer disponible una acción que no existe.

Capa 5: tarea y entrada

Confirma que el prompt llama a una herramienta disponible con ID de registros, estados, campos y límites válidos. Reduce la tarea a una lectura de cinco registros. Cuando funcione, añade complejidad un elemento cada vez.

Un flujo de trabajo seguro

1. Registra cada componente y versión de la pila.
2. Confirma que el cliente carga la configuración MCP o de herramienta esperada.
3. Confirma que el conector se inicia y enumera herramientas.
4. Prueba la autenticación de WordPress independientemente.
5. Prueba una acción conocida de Solo lectura.
6. Compara la acción fallida con la capacidad prevista de la identidad.
7. Aplica una corrección mínima.
8. Repite la lectura conocida, la acción objetivo y la regresión de rechazo.

Plantilla de prompt

Antes de copiar este prompt, sustituye cada valor entre corchetes. No pegues credenciales, datos de clientes ni información privada en la instrucción.

Ayuda a diagnosticar paso a paso esta conexión WordPress de Claude Code o Codex.

Pila:
- Cliente/versión: [Claude Code o Codex]
- Ámbito de configuración: [local/proyecto/usuario]
- Conector/servidor MCP/versión: [valor]
- Transporte: [stdio/http/rest]
- WordPress/versión: [valor]
- Artefacto/versión de WP Agent Control: [valor]
- Identidad/modo: [valor]
- Herramientas disponibles observadas: [lista]
- Tarea fallida: [tarea]
- Error saneado: [error]

Instrucciones:
1. Clasifica la capa del fallo.
2. No solicites valores secretos.
3. Propón una sola prueba diagnóstica mínima.
4. Propón una sola corrección mínima después de la prueba.
5. Conserva el límite de permisos previsto.
6. Termina con una matriz de regresión: lectura conocida, acción objetivo, acción prohibida, revocación.

Por qué el prompt tiene esta estructura

El prompt produce una conversación de soporte disciplinada. Requiere versiones de componentes y herramientas observadas, excluye secretos e impide cambios simultáneos en toda la pila.

Límite de acceso recomendado

Usa una identidad de Solo lectura. El asistente puede inspeccionar los datos de WordPress incluidos en el alcance, pero cualquier intento de crear, editar, eliminar o publicar contenido debe rechazarse.

Este flujo de trabajo puede influir en decisiones editoriales o crear cambios no publicados. Mantén el alcance limitado y revisa cada cambio propuesto.

El nivel de acceso es una recomendación inicial, no una autorización universal. Las capacidades exactas de WordPress disponibles para una identidad deben proceder de la versión instalada del producto y de su cobertura publicada, no solo de este artículo.

Lo que debe quedar fuera de la tarea

• Ningún valor secreto ni encabezado de autorización sin procesar.
• Ningún cambio de varias capas en un mismo paso de diagnóstico.
• Ninguna afirmación de compatibilidad sin el artefacto y las versiones probados.
• Ninguna elevación de privilegios que rompa la regresión de rechazo.

Cómo encaja WP Agent Control

Este es un flujo general de WordPress, no una promesa de que Agent Control pueda editar todos los objetos o integraciones tratados. En la ruta guiada, empiece por las páginas públicas. Las operaciones de plugins, temas, usuarios, ajustes, archivos, eliminación, WooCommerce, ACF y constructores no son tareas guiadas nativas. Utilice herramientas y permisos evaluados por separado cuando sea necesario.

Obtén información estructurada del sitio e inspecciona páginas publicadas seleccionadas después de conectar. Esta lectura pública no requiere una tarea temporal. También puedes navegar por páginas públicas sin el plugin; Agent Control añade acceso estructurado y continuidad hacia operaciones autorizadas en WordPress.

Conectar tu IA: docs first profile · Ver funciones y compatibilidad: coverage

Lista de verificación

• ☐ Se registran cada componente y versión de la pila.
• ☐ El cliente ve el servidor y las herramientas esperados.
• ☐ La autenticación se prueba de forma independiente.
• ☐ La autorización coincide con el modo seleccionado.
• ☐ Solo se aplica una corrección a la vez.
• ☐ Las regresiones de lectura, objetivo, rechazo y revocación pasan.

Modos de fallo habituales

• Reinstalar la pila: se destruye la evidencia necesaria para aislar el fallo.
• Cambiar de cliente inmediatamente: un problema de servidor o WordPress sigue el flujo y no se resuelve.
• Suponer que el nombre de herramienta significa capacidad: existe la herramienta, pero puede fallar autenticación, permiso o implementación.
• Probar solo la acción objetivo: faltan controles conocidos como correctos y conocidos como denegados.

Nota avanzada

La compatibilidad debe representarse como una matriz probada por versión de cliente, versión de conector, versión de WordPress, artefacto de plugin, modo de identidad y tarea. Una respuesta de soporte puede resolverse entonces contra la celda probada más cercana e indicar claramente cuándo la combinación actual no está verificada.

Guías relacionadas

• Cómo conectar Claude Code a WordPress
• Cómo conectar Codex a WordPress
• Errores de conexión de WordPress AI: por qué 401 y 403 pueden ser útiles
• Cómo revocar el acceso de un asistente de IA a WordPress

Continuar

Siguiente paso: no eludas un rechazo cambiando inmediatamente a una cuenta de administrador. Identifica la capa fallida, corrige solo esa capa y repite la prueba más pequeña posible.