A · AppInitDev
MCP / Tutoriales / 18 · Solución de problemas frecuentes
PROCEDIMIENTO 18 DE 18

18 · Solución de problemas frecuentes

Diagnosticar 404, 403, 405, errores de índice o incompatibilidad de protocolo.

Instrucciones paso a paso

  1. 404 en JSON: comprueba que datos/ esté directamente dentro de public_html/, no anidada en otra carpeta.
  2. 403 en Hostinger: revisa permisos y reglas de .htaccess o WAF sin desactivar protecciones generales.
  3. 405 al abrir /mcp: es normal por GET; usa un cliente POST JSON-RPC o el script de pruebas.
  4. El Worker da /health ok, pero herramientas fallan: valida los catálogos JSON y la cobertura del índice.
  5. Versiones MCP incompatibles: utiliza el cliente y cabeceras correctas; revisa server/discover.
  6. Datos incompletos: usa el proyecto completo con HTML o el rastreador controlado; un sitemap no contiene el texto de cada artículo.
  7. Error en registro: comprueba la prueba pública de dominio y el comando --private-key-file.

Conserva el reporte generado localmente y no publiques claves, logs de tráfico privados ni datos de usuarios al solicitar ayuda.

Cómo confirmar que funciona

Revisa el resultado del procedimiento antes de avanzar. Si un comando falla, corrige el error y no publiques hasta validar la etapa correspondiente.

Implementación detallada · Problemas frecuentes y diagnóstico

Árbol de diagnóstico

Síntoma Comprobación Acción
404 en /mcp/tutoriales/ ¿Existe public_html/mcp/tutoriales/index.html? Subir carpeta mcp/ generada
404 en /datos/apps.json ¿Se subió datos/? Regenerar y subir JSON
405 en /mcp ¿Abriste el endpoint con GET? Usar cliente MCP con POST
/health OK, tools fallan ¿JSON accesible? Verificar Hostinger y formato de datos
403 en /.well-known/ ¿WAF o regla de dotfiles? Permitir esa URL exacta
--private-key-file no reconocido CLI actual no lo documenta Usar --private-key=$clave
Registro 404 ¿Publicación confirmada? Ejecutar publish, comprobar detalles
Índice sin textos ¿Tienes HTML locales? Rastrear solo páginas públicas autorizadas

Comandos de diagnóstico

python AppInitDev_IA_MCP/VALIDAR_PROYECTO.py
python AppInitDev_IA_MCP/scripts/PROBAR_PUBLICACION.py
python AppInitDev_IA_MCP/registro/COMPROBAR_REGISTRO.py

También puedes abrir la página de diagnóstico para probar las rutas del sitio desde tu navegador. Una prueba en el navegador puede fallar por CORS aunque un cliente externo sí tenga acceso.

Ver el código implementado, archivo por archivo

Estos enlaces muestran el código fuente completo de los componentes utilizados en el procedimiento; no son pseudocódigo.

scripts/PROBAR_PUBLICACION.pyVer y copiar el archivo completo usado en esta etapa
registro/COMPROBAR_REGISTRO.pyVer y copiar el archivo completo usado en esta etapa

Lista de comprobación de esta etapa

Siguiente: diagnóstico de publicación · publicación en el MCP Registry.