Context7: Usa Skills y subagentes, no solo MCP

Muchos desarrolladores conectan Context7 a través de MCP para consultar documentación actualizada de bibliotecas. Funciona: obtienes documentación al día directamente dentro de tu sesión de programación. Pero tiene un coste: cada documento que solicitas aterriza directamente en tu ventana de contexto principal. Consulta unas cuantas bibliotecas y el contexto se llena enseguida. En sesiones de programación largas, esto se traduce en un rendimiento degradado y en detalles que el modelo olvida a mitad de sesión.

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

La limitación de las conexiones MCP directas

Cuando llamáis a Context7 directamente a través de MCP, el contenido completo del documento se vuelca en vuestro contexto principal. Para una consulta puntual, no pasa nada. Pero en una sesión de trabajo real, rara vez buscáis una sola cosa.

Consultáis la documentación de un hook de React. Luego una utilidad de Tailwind. Después una API de Astro. Cada respuesta se apila sobre la anterior. La ventana de contexto se llena y el modelo empieza a perder el hilo de la conversación anterior: vuestro código, vuestros requisitos, las decisiones de arquitectura que tomasteis tres intercambios atrás.

Como el equipo de Manus subrayó en sus notas de arquitectura, un único 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 vuestro contexto principal.

• Skill: Cuando hacéis una pregunta sobre una biblioteca o API, Context7 se invoca automáticamente. Recupera la documentación más reciente y responde sin que tengáis que usar ningún prompt especial. La consulta se produce entre bastidores.
• Agente docs-researcher: Esta es la pieza arquitectónica central. Las consultas de documentación se ejecutan en un contexto aislado - un subagente independiente que gestiona la búsqueda, extrae lo relevante y devuelve únicamente la respuesta. Vuestro contexto principal nunca ve la documentación en bruto.

Cuando queréis consultar documentación de forma explícita, podéis usar el comando:

/context7:docs <biblioteca> [consulta]

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

Instalación

Instalad el plugin de Context7 en Claude Code con:

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

La diferencia de diseño

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

MCP directo: Cada consulta de documentación se añade a vuestro contexto principal. Con tres consultas, ya habéis consumido una parte significativa de la ventana de contexto. A mitad de sesión, el modelo trabaja con una capacidad de recuerdo mermada sobre el estado real de vuestro proyecto.

Skill + Subagente: Las consultas de documentación se ejecutan en contextos aislados. Solo la respuesta extraída - la firma de función concreta, la opción de configuración, el ejemplo de uso - vuelve a vuestro 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 del modelo al tirar de documentación en tiempo real, y lo hace sin desestabilizar las sesiones de programación largas. Obtenéis información actualizada sin pagar el coste en contexto.

El principio general se aplica más allá de Context7: cada vez que vayáis a incorporar contenido externo voluminoso a una sesión de IA, plantearos si realmente necesita vivir en el contexto principal o si puede procesarse de forma aislada y devolver un resumen. Esa única decisión arquitectónica - aislar y resumir - es lo que separa una sesión que se mantiene afinada durante horas de otra que empieza a olvidar qué estáis construyendo.