CAPÍTULO 1
Núcleo de integración
Cuatro módulos para diseñar, recuperar, migrar e integrar.
Convierte recorridos y sitios existentes en integraciones WebMCP coherentes, recuperables y listas para evolucionar.
Capítulos Integrator
Módulos disponibles
Temas publicados
Laboratorio
PROGRESO COMPARTIDO
El mismo identificador de la Formación 1 registra elementos leídos, dudas y notas. En GitHub Pages, el origen es compartido; JSON mantiene el fallback portátil.
La parte superior navega por capítulos. Dentro de cada capítulo, los módulos siguen la numeración capítulo.módulo.
CAPÍTULO 1
Cuatro módulos para diseñar, recuperar, migrar e integrar.
CAPÍTULO 2
Inventario multipágina, priorización de portafolio y rollout por lotes.
CAPÍTULO 3
Design systems, CMS, comercio electrónico y aplicaciones compuestas.
CAPÍTULO 4
Calidad, documentación, handoff y proyecto aplicado.
LABORATORIO TRANSVERSAL
Pega un catálogo auditable en JSON y recibe un diagnóstico del contrato, la claridad, el schema, el ciclo de vida, el riesgo y un ejemplo de salida. El laboratorio no registra ni ejecuta herramientas.
Convierte recorridos humanos en herramientas pequeñas, distintas y fáciles de elegir.
Una tool nace de un objetivo real del usuario, no de cada botón o función que ya existe en el código.
Mapear el inicio, la decisión, el efecto y la evidencia evita que la integración copie la interfaz sin comprender la intención.
objetivo observable · estado inicial · efecto esperado · evidencia final
Las herramientas pequeñas llevan a cabo una intención completa y no compiten por la misma llamada.
Cuando dos descripciones parecen responder a la misma solicitud, la LLM tiene que adivinar y la tasa de selección correcta disminuye.
sin superposición · verbo preciso · límite claro · salida propia
La entrada debe pedir solo los datos necesarios y representar las alternativas cerradas con enums cuando sea posible.
Los schemas enfocados reducen los argumentos inventados, pero la validación real sigue siendo obligatoria en execute y en el backend.
campos mínimos · enum útil · descripción concreta · validación real
El agente puede conocer el nombre que menciona el usuario antes de conocer el identificador interno del sistema.
Separar la búsqueda, la resolución y la acción evita exigir IDs opacos demasiado pronto o aceptar nombres ambiguos demasiado tarde.
el nombre permite descubrir · el ID identifica · resolución explícita · ambigüedad resuelta
El catálogo debe reflejar la ruta, la selección, la autenticación y la etapa actual del recorrido.
Menos herramientas disponibles significan menos contexto y menos llamadas imposibles.
catálogo contextual · registro dinámico · sesión visible · cleanup
Los nombres genéricos y superpuestos deben convertirse en una secuencia que revele la intención y el efecto.
La entrega demuestra que el catálogo orienta al agente y también explica el flujo a producto, seguridad y QA.
inventario · refactorización · prueba de elección · documentación
Modela dependencias, stale state, idempotencia, timeout, cancelación y recuperación.
Cada etapa declara qué ya ocurrió, qué acciones están disponibles y qué transición es válida.
Sin un modelo de estado, el agente puede confirmar antes de iniciar o repetir un efecto ya completado.
estado explícito · transición válida · precondición · efecto
Los errores recuperables indican una próxima acción; los errores definitivos cierran el intento con un motivo verificable.
La clasificación evita ciclos a ciegas y permite que el agente explique alternativas reales al usuario.
código estable · mensaje accionable · siguiente acción · cierre honesto
El estado usado para decidir puede cambiar antes de la ejecución, especialmente en vacantes, precios y permisos.
Volver a validar en el momento del efecto impide que una tool use una fotografía antigua como autorización vigente.
revalidación · versión del estado · conflicto · nueva lectura
Una clave de idempotencia permite repetir una solicitud sin duplicar una suscripción, un cobro o un envío.
Los agentes, las redes y los usuarios pueden repetir llamadas; la operación debe distinguir entre un reintento y un nuevo efecto.
idempotency key · retry seguro · resultado anterior · efecto único
AbortSignal y el timeout terminan el trabajo que dejó de ser relevante o superó la ventana operativa.
Cancelar de verdad preserva los recursos y evita que la interfaz muestre un éxito después de que la persona desistió.
AbortSignal · timeout · limpieza visual · resultado cancelado
La integración debe demostrar el camino feliz, el orden inválido, el reintento, la cancelación y el cambio concurrente.
Una matriz de fallos convierte la resiliencia en un comportamiento verificable, no en una intención de arquitectura.
escenarios · evidencia · reproducción · regresión
Audita los recorridos, reutiliza la lógica existente e introduce WebMCP como mejora progresiva.
Mapea formularios, handlers, servicios, endpoints y estados antes de proponer tools.
La auditoría revela dónde ya existe la regla y dónde la interfaz contiene lógica que debe separarse.
formularios · funciones JS · APIs · estado
No todas las funcionalidades merecen migrarse primero; combina frecuencia, valor, estabilidad y reversibilidad.
El recorte correcto permite aprender pronto sin empezar con una acción crítica o poco comprendida.
valor · frecuencia · riesgo · estabilidad
La misma función de dominio debe servir tanto para el clic humano como para la ejecución de WebMCP.
Compartir la lógica evita divergencias entre el flujo visual y el camino del agente.
servicio común · UI adaptadora · herramienta adaptadora · regla única
La tool traduce los argumentos, llama al servicio existente, actualiza la UI y devuelve una respuesta estructurada.
Los wrappers pequeños son más fáciles de revisar y no recrean la aplicación dentro del registro WebMCP.
traducción · servicio existente · UI sincronizada · retorno
El recorrido humano sigue funcionando cuando WebMCP no existe o está desactivado.
Una tecnología experimental se incorpora como capacidad adicional, con observación y rollback.
detección de funciones · fallback · rollout · rollback
El dossier conecta el inventario, el catálogo, los riesgos, la implementación, las pruebas y el plan de publicación.
La migración se vuelve revisable por producto, desarrollo, seguridad y operaciones.
mapa · riesgo · prueba funcional · rollout
Integra WebMCP en SPA, React, Angular y Next.js con registro y cleanup predecibles.
Una implementación sin framework explicita el registro, las dependencias y el cleanup.
La referencia reduce la magia y ayuda a diagnosticar problemas ocultos por hooks o inyección de dependencias.
función pura · registro explícito · AbortController · baseline
El efecto registra tools para el estado actual y la limpieza aborta los registros anteriores.
Strict Mode, los rerenders y los cambios de dependencias no pueden duplicar nombres en el catálogo.
useEffect · dependencias · cleanup · Strict Mode
Un servicio recibe dependencias, registra las tools y expone cleanup al componente o a la ruta.
La inyección de dependencias mantiene las reglas comprobables y separadas del ciclo visual.
servicio · DI · OnDestroy · capacidad de prueba
document.modelContext solo existe en el cliente y después de que el documento está activo.
Separar el componente cliente, la carga y la API del servidor evita el acceso a Document durante SSR.
use client · hydration · SSR · API route
Las SPAs deben retirar las herramientas de la ruta anterior y registrar solo las capacidades de la nueva pantalla.
Un catálogo obsoleto es stale UI: el agente ve una acción que la persona ya no puede ejecutar.
router · unmount · catálogo actual · transición
Los distintos frameworks deben cumplir el mismo contrato observable de registro, ejecución, UI y cleanup.
Una matriz común separa las diferencias de ergonomía de las diferencias reales de comportamiento.
mismo contrato · mismas pruebas · cleanup comprobado · compatibilidad
CONTINUIDAD DEL INTEGRATOR
Después de los fundamentos, la misma formación continúa en los capítulos 2, 3 y 4. Cada capítulo tendrá módulos propios; el alumno mantiene el papel de Integrator mientras amplía la escala y la gobernanza.