Solución de problemas

El agente no detecta el servidor MCP

Revisa:

Que la configuración del cliente MCP se aplicó sin errores.
Que reiniciaste o recargaste el cliente después de añadir el servidor.
Que usuario y contraseña de aplicación son correctos.
Que la ruta MCP aparece en Connect.
Que el sitio WordPress responde normalmente.

Connect muestra error crítico

Comprueba que estás usando la última versión del ZIP.
Revisa el correo de error crítico de WordPress.
Activa depuración si estás en staging.
Desactiva temporalmente el plugin si el panel de administración queda bloqueado.
Anota el mensaje exacto antes de volver a probar.

Una conversión no se ve bien

Haz una revisión controlada:

Abre el borrador, no la pagina publicada.
Revisa formularios, sliders, popups y widgets de terceros.
Pide al agente un reporte de diferencias.
Corrige manualmente detalles visuales antes de publicar.

La validacion final no puede ejecutarse

Si el staging responde publicamente pero las capacidades MCP no funcionan:

Comprueba que la URL abre en navegador, por ejemplo https://kodavio.es.
Comprueba que el REST index responde: https://kodavio.es/index.php?rest_route=/.
Si wp-abilities o mcp/kodavio devuelven 401, revisa usuario y Application Password.
Confirma que el cliente MCP usa la URL y credenciales correctas del staging.
Si /wp/v2/users/me devuelve rest_not_logged_in incluso con Basic Auth, revisa si Apache/Plesk esta pasando la cabecera Authorization a PHP/WordPress.
No cierres una validacion real multi-proyecto usando solo fixtures automatizadas.

Hay demasiadas herramientas en Tools

Usa la gestión por grupos. Activa solo el grupo necesario y despliega detalles avanzados solo si quieres afinar una herramienta concreta.

No aparecen herramientas de Elementor o Gutenberg

El modo compacto de MCP prioriza las herramientas principales y de lectura. Ejecuta primero kodavio/capability-map o usa mcp-adapter-discover-abilities para ver el mapa completo. Si una capacidad está desactivada en Tools, no se expondrá por MCP.

El sistema de diseño importa tokens raros

Pide una limpieza antes de escribir design.md. Algunas fuentes pueden generar claves genéricas o temporales. El resultado final debe conservar solo tokens útiles y nombrados con sentido.

Una escritura PHP queda bloqueada

Las capacidades de edición de PHP están desactivadas por defecto. Activa el grupo correspondiente en Tools, empieza con dry_run=true, revisa el lint y usa confirm_destructive=true solo cuando aceptes el riesgo.

Si el lint de PHP no está disponible en el servidor, Kodavio debe avisarlo en la respuesta y en wp-get-config-summary.

No veo auditoría

Las operaciones de administración se registran en Kodavio > Tools > Audit log y también pueden leerse con kodavio/wp-get-change-log. Si no hay entradas, ejecuta una lectura operativa o un dry_run y vuelve a revisar.