MCP / Tutoriales / 18 · Solución de problemas frecuentes
18 · Solución de problemas frecuentes
Diagnosticar 404, 403, 405, errores de índice o incompatibilidad de protocolo.
Instrucciones paso a paso
- 404 en JSON: comprueba que
datos/esté directamente dentro depublic_html/, no anidada en otra carpeta. - 403 en Hostinger: revisa permisos y reglas de
.htaccesso WAF sin desactivar protecciones generales. - 405 al abrir /mcp: es normal por GET; usa un cliente POST JSON-RPC o el script de pruebas.
- El Worker da /health ok, pero herramientas fallan: valida los catálogos JSON y la cobertura del índice.
- Versiones MCP incompatibles: utiliza el cliente y cabeceras correctas; revisa
server/discover. - Datos incompletos: usa el proyecto completo con HTML o el rastreador controlado; un sitemap no contiene el texto de cada artículo.
- 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.