AppInitDev
CÓDIGO FUENTE PÚBLICO

web/mcp/tutoriales/problemas/index.html

Archivo real del paquete para implementar la función. Descárgalo del ZIP para editarlo; no contiene claves privadas.

<!doctype html><html lang="es-MX"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>18 · Solución de problemas frecuentes | AppInitDev MCP</title><meta name="description" content="Diagnosticar 404, 403, 405, errores de índice o incompatibilidad de protocolo."><link rel="canonical" href="https://appinitdev.com/mcp/tutoriales/problemas/"><link rel="stylesheet" href="/ia/plataforma.css"><link rel="stylesheet" href="/mcp/tutoriales/guia-avanzada.css"><script defer src="/mcp/tutoriales/guia-avanzada.js"></script></head><body><header class="top"><a class="brand" href="/">A · AppInitDev</a><nav><a href="/mcp/">Servidor MCP</a><a href="/mcp/tutoriales/">Tutoriales</a><a href="/ia/calidad/">Calidad</a><a href="/ia/">Centro IA</a></nav></header><main class="wrap"><div class="crumbs"><a href="/mcp/">MCP</a> / <a href="/mcp/tutoriales/">Tutoriales</a> / 18 · Solución de problemas frecuentes</div><section class="hero"><span class="eyebrow">PROCEDIMIENTO 18 DE 18</span><h1>18 · Solución de problemas frecuentes</h1><p>Diagnosticar 404, 403, 405, errores de índice o incompatibilidad de protocolo.</p></section><section class="section"><h2>Instrucciones paso a paso</h2><ol><li><strong>404 en JSON:</strong> comprueba que <code>datos/</code> esté directamente dentro de <code>public_html/</code>, no anidada en otra carpeta.</li><li><strong>403 en Hostinger:</strong> revisa permisos y reglas de <code>.htaccess</code> o WAF sin desactivar protecciones generales.</li><li><strong>405 al abrir /mcp:</strong> es normal por GET; usa un cliente POST JSON-RPC o el script de pruebas.</li><li><strong>El Worker da /health ok, pero herramientas fallan:</strong> valida los catálogos JSON y la cobertura del índice.</li><li><strong>Versiones MCP incompatibles:</strong> utiliza el cliente y cabeceras correctas; revisa <code>server/discover</code>.</li><li><strong>Datos incompletos:</strong> usa el proyecto completo con HTML o el rastreador controlado; un sitemap no contiene el texto de cada artículo.</li><li><strong>Error en registro:</strong> comprueba la prueba pública de dominio y el comando <code>--private-key-file</code>.</li></ol><p>Conserva el reporte generado localmente y no publiques claves, logs de tráfico privados ni datos de usuarios al solicitar ayuda.</p><h2>Cómo confirmar que funciona</h2><p>Revisa el resultado del procedimiento antes de avanzar. Si un comando falla, corrige el error y no publiques hasta validar la etapa correspondiente.</p><div class="pager"><a href="/mcp/tutoriales/mantenimiento/">← 17 · Actualizar, verificar y volver atrás</a><a href="/mcp/tutoriales/">Volver al índice →</a></div></section><section class="section course" id="implementacion-detallada"><h2>Implementación detallada · Problemas frecuentes y diagnóstico</h2><h2>Árbol de diagnóstico</h2>
<table>
<thead>
<tr>
<th>Síntoma</th>
<th>Comprobación</th>
<th>Acción</th>
</tr>
</thead>
<tbody>
<tr>
<td>404 en <code>/mcp/tutoriales/</code></td>
<td>¿Existe <code>public_html/mcp/tutoriales/index.html</code>?</td>
<td>Subir carpeta <code>mcp/</code> generada</td>
</tr>
<tr>
<td>404 en <code>/datos/apps.json</code></td>
<td>¿Se subió <code>datos/</code>?</td>
<td>Regenerar y subir JSON</td>
</tr>
<tr>
<td>405 en <code>/mcp</code></td>
<td>¿Abriste el endpoint con GET?</td>
<td>Usar cliente MCP con POST</td>
</tr>
<tr>
<td><code>/health</code> OK, tools fallan</td>
<td>¿JSON accesible?</td>
<td>Verificar Hostinger y formato de datos</td>
</tr>
<tr>
<td>403 en <code>/.well-known/</code></td>
<td>¿WAF o regla de dotfiles?</td>
<td>Permitir esa URL exacta</td>
</tr>
<tr>
<td><code>--private-key-file</code> no reconocido</td>
<td>CLI actual no lo documenta</td>
<td>Usar <code>--private-key=$clave</code></td>
</tr>
<tr>
<td>Registro 404</td>
<td>¿Publicación confirmada?</td>
<td>Ejecutar <code>publish</code>, comprobar detalles</td>
</tr>
<tr>
<td>Índice sin textos</td>
<td>¿Tienes HTML locales?</td>
<td>Rastrear solo páginas públicas autorizadas</td>
</tr>
</tbody>
</table>
<h2>Comandos de diagnóstico</h2>
<pre><code class="language-powershell">python AppInitDev_IA_MCP/VALIDAR_PROYECTO.py
python AppInitDev_IA_MCP/scripts/PROBAR_PUBLICACION.py
python AppInitDev_IA_MCP/registro/COMPROBAR_REGISTRO.py
</code></pre>
<p>También puedes abrir la <a href="/mcp/diagnostico/">página de diagnóstico</a> 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.</p>
<h2>Ver el código implementado, archivo por archivo</h2><p>Estos enlaces muestran el <strong>código fuente completo</strong> de los componentes utilizados en el procedimiento; no son pseudocódigo.</p><div class="code-list"><div class="code-file"><a href="/mcp/codigo/scripts-probar-publicacion-py/">scripts/PROBAR_PUBLICACION.py</a><small>Ver y copiar el archivo completo usado en esta etapa</small></div><div class="code-file"><a href="/mcp/codigo/registro-comprobar-registro-py/">registro/COMPROBAR_REGISTRO.py</a><small>Ver y copiar el archivo completo usado en esta etapa</small></div></div><h2>Lista de comprobación de esta etapa</h2><label class="task"><input type="checkbox" data-task="manual"><span>Seguí el procedimiento y comprendí las rutas y archivos implicados.</span></label><label class="task"><input type="checkbox" data-task="codigo"><span>Revisé el código fuente real y ejecuté las pruebas correspondientes.</span></label><label class="task"><input type="checkbox" data-task="seguridad"><span>Confirmé que no voy a publicar credenciales, respaldos o reportes privados.</span></label><p class="info-cta"><strong>Siguiente:</strong> <a href="/mcp/diagnostico/">diagnóstico de publicación</a> · <a href="/mcp/registro/">publicación en el MCP Registry</a>.</p></section></main><footer class="footer">AppInitDev · Guía MCP en español · <a href="/mcp/">Conectar el servidor</a></footer></body></html>