Context7: Usa Skills y Subagentes, no solo MCP

Muchos desarrolladores conectan Context7 a través de MCP para consultar documentación actualizada de librerías. Funciona: obtienes docs al día directamente dentro de tu sesión de programación. Pero tiene un costo: cada documento que jalas cae directo en tu ventana de contexto principal. Consulta unas cuantas librerías y tu contexto se llena rápido. En sesiones largas de programación, eso se traduce en rendimiento degradado y detalles de la sesión que el modelo simplemente olvida.

Estuve pensando en cómo resolver esto en Claude Code usando Skills y subagentes, y la diferencia en la práctica es significativa.

La limitación de las conexiones MCP directas

Cuando llamas a Context7 directamente por MCP, todo el contenido del documento entra a tu contexto principal. Para una consulta rápida y puntual, está bien. Pero en una sesión de trabajo real, rara vez buscas una sola cosa.

Revisas la documentación de un hook de React. Después una utilidad de Tailwind. Luego una API de Astro. Cada respuesta se apila sobre la anterior. Tu ventana de contexto se llena, y el modelo empieza a perder de vista la conversación anterior: tu código real, tus requisitos, las decisiones de arquitectura que tomaste tres intercambios atrás.

Como enfatizó el equipo de Manus en sus notas de arquitectura, un solo contexto masivo no es la solución. La idea clave es que no todo necesita vivir en la misma ventana de contexto.

Skills y Subagentes: Consultas en contexto aislado

El plugin de Context7 ofrece dos mecanismos que mantienen las consultas de documentación fuera de tu contexto principal.

• Skill: Cuando haces una pregunta sobre una librería o API, Context7 se invoca automáticamente. Obtiene la documentación más reciente y responde sin que tengas que usar ningún prompt especial. La consulta ocurre tras bambalinas.
• Agente docs-researcher: Esta es la pieza arquitectónica central. Las consultas de documentación corren en un contexto aislado: un subagente separado que maneja la búsqueda, extrae lo relevante y devuelve solo la respuesta. Tu contexto principal nunca ve la documentación en bruto.

Cuando quieres consultar documentación de forma explícita, puedes usar el comando:

/context7:docs <librería> [consulta]

Esto te da control directo sin dejar de mantener el trabajo pesado fuera de tu ventana de contexto principal.

Instalación

Instala el plugin de Context7 en Claude Code con:

/plugin marketplace add upstash/context7
/plugin install context7-plugin@context7-marketplace

La diferencia de diseño

Usando el mismo backend de Context7, los dos enfoques producen resultados muy distintos en la práctica.

MCP directo: Cada consulta de documentación se suma a tu contexto principal. Con tres consultas, ya consumiste una porción considerable de tu ventana de contexto. A media sesión, el modelo trabaja con un recuerdo degradado del estado real de tu proyecto.

Skill + Subagente: Las consultas de documentación ocurren en contextos aislados. Solo la respuesta extraída — la firma específica de la función, la opción de configuración, el ejemplo de uso — regresa a tu contexto principal. La documentación en bruto nunca lo toca.

Este patrón resuelve dos problemas a la vez. Aborda el problema del corte de conocimiento al jalar documentación en tiempo real, y lo hace sin desestabilizar las sesiones largas de programación. Obtienes información actualizada sin pagar el costo de contexto.

El principio más amplio aplica más allá de Context7: cada vez que estés jalando contenido externo voluminoso a una sesión de IA, pregúntate si necesita vivir en el contexto principal o si puede procesarse de forma aislada y resumirse de vuelta. Esa única decisión arquitectónica — aislar y resumir — es lo que separa una sesión que se mantiene precisa durante horas de una que empieza a olvidar lo que estás construyendo.