Todo el soporte de tus apps, en un solo lugar.

Integra Yocol en esta aplicación mediante el MCP yocol. Primero usa yocol_whoami para confirmar mi sesión y permisos. Guíame en este orden y pregunta sólo los datos que falten. Si algo bloquea una etapa, explica la causa y cómo resolverla. 1. Crea o selecciona tu proyecto Usa yocol_plan_project_flow para crear o seleccionar mi proyecto de Yocol. Si ya existe, no lo dupliques. Pregúntame sólo los datos que falten, como nombre y funciones: reportes, chat o leads. Revisa qué diagnósticos quiero habilitar (consola, red, capturas y grabación), las funciones pausadas y los campos obligatorios. Después consulta yocol_get_setup_status y explícame el siguiente paso. 2. Configura ambientes y URLs Consulta yocol_get_setup_status de mi proyecto. Configura primero el ambiente dev con yocol_configure_environment. Pregúntame la URL completa de la aplicación, incluido el puerto si es local, sólo si no la conoces. Configura stage y prod únicamente cuando tenga sus URLs. Conserva los demás ambientes. Usa el servicio Yocol al que está conectado el MCP; el ambiente dev de mi app no implica cambiar de servidor Yocol. 3. Prepara la key e instala el widget Revisa funciones habilitadas, pausas y configuración obligatoria con yocol_get_setup_status. Usa yocol_prepare_integration para obtener o reutilizar la key pública y el snippet del ambiente dev. Inspecciona el framework y la integración existente e instala el widget una sola vez. No pongas secretos de servidor en el navegador. Indica qué archivo cambiaste y cualquier bloqueo pendiente. 4. Asocia al usuario autenticado Implementa identidad asíncrona de Yocol según la guía /widget/identity del sitio Yocol conectado. Consulta yocol_get_setup_status y yocol_prepare_integration. Si mi app tiene login, configura issuer y clave pública Ed25519 por ambiente con yocol_configure_identity; guarda la clave privada exclusivamente en nuestro backend. Crea POST /api/yocol/identity que valide nuestra sesión, derive el ID estable desde esa sesión y devuelva { identityToken } con Cache-Control: no-store. Firma el JWT conforme al contrato, con vigencia máxima de 5 minutos; sólo user.id es obligatorio dentro de los datos de usuario, y sub debe coincidir exactamente. Nombre, email y metadata son opcionales. Permite iniciar anónimo. Tras el login, usa la instancia existente del SDK y await yocol.identify({ getIdentityToken: async signal => ... }); pasa signal al fetch del endpoint. Al cerrar sesión o cambiar de cuenta llama await yocol.reset() y completa el logout de nuestra app incluso si reset falla; sincroniza la limpieza entre pestañas. Ante identity.expired, obtén una nueva identidad si la sesión sigue activa. No reasignes reportes anónimos anteriores. No envíes contraseñas, cookies ni tokens de sesión en metadata. Si la app no tiene autenticación, conserva el flujo anónimo. 5. Conecta GitHub y sigue tus reportes Usa yocol_plan_project_flow con intent github y consulta yocol_get_github_configuration. Si falta la conexión, guíame a Integraciones del proyecto para instalar la GitHub App; no pidas credenciales. Configura opcionalmente el Project con yocol_configure_github_project, expectedVersion y los cuatro nombres de columnas existentes. Valida el permiso Projects de organización. Envía un reporte de prueba con una sola descripción y comprueba yocol_get_github_report. Recorre nextCommentsPage para leer respuestas anteriores. Sólo los comentarios que empiezan con [yocol:public] son visibles al visitante. Comprueba Mis reportes y Ampliar sin una cuenta GitHub del visitante. No confundas un issue cerrado con un despliegue verificado. 6. Comprueba el flujo completo en dev Ejecuta yocol_test_setup para mi proyecto en dev. Distingue el resultado de configuración y handshake de las pruebas reales en navegador. Abre mi app, verifica que carga el widget y revisa errores de red, origen y CSP. Prueba las funciones habilitadas con datos de prueba y confirma que llegan a Yocol. Si hay login, prueba anónimo → usuario A → logout → usuario B, ID estable al volver a entrar, atributos opcionales ausentes y rechazo de identidades inválidas o vencidas. Confirma que no se mezclan historiales. Reporta cada prueba como aprobada, fallida o pendiente, con evidencia; no declares la integración completa sólo porque pasó el handshake. Enumera cada bloqueo y la acción necesaria para resolverlo. Antes de pasar a producción, repite la configuración de URLs, key pública e identidad para ese ambiente y verifica su integración. Los ambientes de un proyecto comparten configuración y conversaciones; usa proyectos separados si necesitas aislamiento de datos.