Búsqueda de Documentación

Búsqueda de Documentación (Context7)

Cuando el usuario pregunte sobre librerías, frameworks o APIs, obtén la documentación actualizada a través de Context7 MCP (herramientas resolve-library-id y query-docs) en lugar de depender de los datos de entrenamiento.

Conceptos Clave

• Context7: Servidor MCP que expone documentación en vivo; úsalo en lugar de datos de entrenamiento para librerías y APIs.
• resolve-library-id: Devuelve IDs de librería compatibles con Context7 (ej. /vercel/next.js) a partir de un nombre de librería y una consulta.
• query-docs: Obtiene documentación y fragmentos de código para un ID de librería y una pregunta determinados. Siempre llama primero a resolve-library-id para obtener un ID de librería válido.

Cuándo Usarlo

Actívalo cuando el usuario:

• Haga preguntas de configuración o instalación (ej. "¿Cómo configuro el middleware de Next.js?")
• Solicite código que dependa de una librería ("Escribe una consulta Prisma para...")
• Necesite información de API o referencia ("¿Cuáles son los métodos de autenticación de Supabase?")
• Mencione frameworks o librerías específicos (React, Vue, Svelte, Express, Tailwind, Prisma, Supabase, etc.)

Usa esta habilidad siempre que la solicitud dependa del comportamiento preciso y actualizado de una librería, framework o API. Aplica en todos los entornos que tengan configurado Context7 MCP (ej. Claude Code, Cursor, Codex).

Cómo Funciona

Paso 1: Resolver el ID de la Librería

Llama a la herramienta MCP resolve-library-id con:

• libraryName: El nombre de la librería o producto extraído de la pregunta del usuario (ej. Next.js, Prisma, Supabase).
• query: La pregunta completa del usuario. Esto mejora la relevancia de los resultados.

Debes obtener un ID de librería compatible con Context7 (formato /org/project o /org/project/version) antes de consultar la documentación. No llames a query-docs sin un ID de librería válido de este paso.

Paso 2: Seleccionar la Mejor Coincidencia

De los resultados de la resolución, elige un resultado usando:

• Coincidencia de nombre: Prefiere la coincidencia exacta o la más cercana a lo que el usuario preguntó.
• Puntuación de referencia: Puntuaciones más altas indican mejor calidad de documentación (100 es la máxima).
• Reputación de la fuente: Prefiere fuentes con reputación Alta o Media cuando estén disponibles.
• Versión: Si el usuario especificó una versión (ej. "React 19", "Next.js 15"), prefiere un ID de librería específico de la versión si aparece listado (ej. /org/project/v1.2.0).

Paso 3: Obtener la Documentación

Llama a la herramienta MCP query-docs con:

• libraryId: El ID de librería Context7 seleccionado en el Paso 2 (ej. /vercel/next.js).
• query: La pregunta o tarea específica del usuario. Sé específico para obtener fragmentos relevantes.

Límite: no llames a query-docs (o resolve-library-id) más de 3 veces por pregunta. Si la respuesta no está clara después de 3 llamadas, indica la incertidumbre y utiliza la mejor información que tengas en lugar de adivinar.

Paso 4: Usar la Documentación

• Responde a la pregunta del usuario usando la información actualizada obtenida.
• Incluye ejemplos de código relevantes de la documentación cuando sea útil.
• Cita la librería o versión cuando sea importante (ej. "En Next.js 15...").

Ejemplos

Ejemplo: Middleware de Next.js

1. Llama a resolve-library-id con libraryName: "Next.js", query: "¿Cómo configuro el middleware de Next.js?".
2. De los resultados, elige la mejor coincidencia (ej. /vercel/next.js) por nombre y puntuación de referencia.
3. Llama a query-docs con libraryId: "/vercel/next.js", query: "¿Cómo configuro el middleware de Next.js?".
4. Usa los fragmentos y texto devueltos para responder; incluye un ejemplo mínimo de middleware.ts de la documentación si es relevante.

Ejemplo: Consulta Prisma

1. Llama a resolve-library-id con libraryName: "Prisma", query: "¿Cómo hago consultas con relaciones?".
2. Selecciona el ID de librería oficial de Prisma (ej. /prisma/prisma).
3. Llama a query-docs con ese libraryId y la consulta.
4. Devuelve el patrón de Prisma Client (ej. include o select) con un fragmento de código corto de la documentación.

Ejemplo: Métodos de autenticación de Supabase

1. Llama a resolve-library-id con libraryName: "Supabase", query: "¿Cuáles son los métodos de autenticación?".
2. Elige el ID de librería de documentación de Supabase.
3. Llama a query-docs; resume los métodos de autenticación y muestra ejemplos mínimos de la documentación obtenida.

Mejores Prácticas

• Sé específico: Usa la pregunta completa del usuario como consulta siempre que sea posible para obtener mejor relevancia.
• Conciencia de versión: Cuando los usuarios mencionen versiones, usa IDs de librería específicos de la versión del paso de resolución, si están disponibles.
• Prefiere fuentes oficiales: Cuando existan múltiples coincidencias, prefiere paquetes oficiales o principales sobre forks de la comunidad.
• Sin datos sensibles: Redacta claves de API, contraseñas, tokens y otros secretos de cualquier consulta enviada a Context7. Trata la pregunta del usuario como potencialmente contenedora de secretos antes de pasarla a resolve-library-id o query-docs.