Context7 MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Documentos frescos y anclados a versiones para más de 30000 bibliotecas JS/TS/Python/Rust/Go
Solo dos herramientas — resolve-library-id + query-docs — cero sobrecarga cognitiva
Nivel gratuito, clave API gratuita opcional para límites de tarifa más altos
Trabaja en Claude Desktop, Cursor, Windsurf, Zed, Continue, Claude Code, VS Code
Tira de los documentos para la versión que realmente estás usando, no lo que sea que esté en el corte de entrenamiento 2024 del modelo

Demo en vivo

Cómo se ve en la práctica

context7.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/context7-mcp@latest"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/context7-mcp@latest"
      ]
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/context7-mcp@latest"
      ]
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/context7-mcp@latest"
      ]
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "context7",
      "command": "npx",
      "args": [
        "-y",
        "@upstash/context7-mcp@latest"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "context7": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@upstash/context7-mcp@latest"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add context7 -- npx -y @upstash/context7-mcp@latest

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Context7

Evite que su agente alucine con funciones que no existen

👤 Cualquier persona que use un asistente de codificación de IA con una biblioteca más nueva que el punto de corte del modelo ⏱ ~5 min beginner

Cuándo usarlo: Estás trabajando con Next.js 15, Prisma 5, Drizzle, LangChain 0.3 o cualquier biblioteca que se mueva rápidamente y tu agente sigue inventando funciones que no existen.

Requisitos previos

Nodo 18+ — node -v
Context7 MCP instalado — Pegue el bloque de configuración anterior en la configuración de Claude Desktop / Cursor / Windsurf

Flujo

Nombra la biblioteca explícitamente

Usando Context7, saca los últimos documentos de prisma y muéstrame la forma correcta de hacer una transacción con escrituras de relaciones anidadas.✓ Copiado

→ El agente llama a resolve-library-id y luego a query-docs con una consulta relevante, no con un resumen al estilo de Wikipedia
Anclar a una versión si es importante

Estoy en el [email protected]. Use Context7 para obtener los documentos de transmisión del enrutador de aplicaciones para esa versión exacta.✓ Copiado

→ Citation incluye la versión; el código utiliza convenciones basadas en archivos, no getServerSideProps
Verifica tu propio código

Lea las importaciones en src/lib/db.ts, luego use Context7 para verificar que cada función que importé realmente existe en drizzle-orm 0.30.x.✓ Copiado

→ Por importación✓/✗informe con enlaces a documentos

Resultado: La salida del agente utiliza API reales y actuales, el primer intento, en lugar de las inventadas de aspecto plausible.

Errores comunes

El agente se olvida de llamar a Context7 en el segundo turno — Ponga 'usar siempre Context7 para preguntas de la biblioteca' en el indicador del sistema o en CLAUDE.md
Nombre de biblioteca ambiguo (por ejemplo, 'supabase') — Dejar que resolve-library-id devuelva coincidencias; elegir el paquete específico (supabase-js vs @supabase/ssr)

Combinar con: filesystem · github

Andamia una nueva función utilizando el patrón idiomático actual

👤 Ingenieros que inician una función en una versión desconocida o más nueva de un marco ⏱ ~15 min intermediate

Cuándo usarlo: Debe añadir la autenticación a una aplicación Next.js 15 y desea omitir las publicaciones de blog obsoletas.

Requisitos previos

Marco objetivo identificado — package.json o pyproject.toml ya lo enumera

Flujo

Preguntar por modismos actuales

Usando Context7, busque los documentos de NextAuth v5 y apoye la configuración de un proveedor de credenciales para mí. Quiero la versión beta actual, no la v4.✓ Copiado

→ El código utiliza la función auth() y la configuración compatible con Edge de v5, no v4 getServerSession
Verificar notas de migración

Tire de la sección "actualizar desde v4" de los documentos de NextAuth y enumere lo que tendría que cambiar en mi código actual.✓ Copiado

→ Lista de estilo diff de cambios de ruptura

Resultado: Código v5 en funcionamiento en la primera confirmación, no un híbrido a medio migrar.

Errores comunes

Los documentos no cubren tu caso límite — Context7 es solo para documentos; para comportamientos inéditos, vuelva a la fuente a través de GitHub MCP

Combinar con: github · filesystem

Revise un PR con citas de documentos reales, no vibraciones

👤 Revisores que desean respaldar los comentarios con pruebas ⏱ ~20 min intermediate

Cuándo usarlo: Al revisar una PR que utiliza una API de biblioteca, no está 100% seguro de que sea correcta.

Flujo

Lee el diff

Extraiga el diff de PR #482. Para cada llamada a la biblioteca, use Context7 para verificar la firma y marcar cualquier cosa que se vea mal.✓ Copiado

→ Veredicto por llamada con enlace y versión del documento
Escribir comentarios citables

Para cada llamada marcada, redacta un comentario de revisión que vincule el documento oficial a través de Context7.✓ Copiado

→ Los comentarios se leen como "según los documentos v15<link>, X debe ser Y"

Resultado: Revise los comentarios con citas, no con opiniones.

Combinar con: github

Migrar una base de código a una nueva versión principal de una biblioteca

👤 Ingenieros que realizan una actualización importante (React 18→19, Tailwind 3→4, etc.) ⏱ ~90 min advanced

Cuándo usarlo: Te estás topando con una versión principal y la guía de actualización tiene 40 páginas de "depende".

Requisitos previos

Versión de destino elegida — Elige la versión exacta; no hagas "lo último" en especialidades

Flujo

Tire de la guía de migración

Utilice Context7 para obtener el documento de migración Tailwind v3→v4. Resumir como una lista de verificación.✓ Copiado

→ Lista de verificación ordenada de cambios de rotura
Escanee el repositorio para cada problema

Para cada elemento de esa lista de verificación, use el MCP del sistema de archivos para encontrar patrones coincidentes en src/. Deme un informe por archivo.✓ Copiado

→ Lista de archivos → afectados por el patrón
Parche en pequeñas confirmaciones

Haga que cada elemento de migración sea una confirmación separada con un mensaje que haga referencia a la sección doc.✓ Copiado

→ Limpia el registro de confirmaciones, puedes revertir artículo por artículo

Resultado: Una PR de migración que realmente puedes revisar, con cada cambio vinculado a una sección de documentos.

Errores comunes

Asumir demasiados elementos en un compromiso — Un cambio de ruptura → un compromiso; hace que la bisección sea fácil si algo se rompe

Combinar con: filesystem · git · github

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

context7 + filesystem

Lea el package.json para elegir la versión exacta, luego consulte Context7 para obtener documentos coincidentes

Lea package.json, busque la siguiente versión y extraiga los documentos coincidentes de Context7 para las acciones del servidor.✓ Copiado

context7 + github

Para las PR que tocan las API de la biblioteca, anote la revisión con citas de documentos

Por cada llamada a la API en PR #482, añada un comentario de revisión citando los documentos de Context7.✓ Copiado

context7 + sequential-thinking

Planifique una migración paso a paso antes de tocar el código

Utilice el pensamiento secuencial para planificar la migración de Prisma v4→v5, extrayendo evidencia documental de Context7 en cada paso.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
resolve-library-id	libraryName: str	Primera llamada: elimine la ambigüedad del nombre de la biblioteca que le importa	1 free request
query-docs	libraryId: str, query: str, version?: str	Después de resolver-library-id — haga la pregunta real	1 free request (higher rate limit with API key)

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: El nivel gratuito es generoso; la clave API gratuita (context7.com/dashboard) aumenta los límites de tarifa
Tokens por llamada: ~200–2000 por consulta dependiendo de la longitud del documento
Monetario: Gratis
Consejo: Consultas de alcance: 'cómo usar X' es más barato que 'dame todo sobre X'; el servidor ya devuelve fragmentos enfocados

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: CONTEXT7_API_KEY env var opcional para límites de tasa más altos

Salida de datos: Las consultas van a api.context7.com; sin salida de código, solo se envían el nombre de la biblioteca y su consulta

Context7 ve lo que preguntas, no tu código. No pegue la fuente propietaria en el campo de consulta.

Resolución de problemas

Errores comunes y soluciones

Biblioteca no encontrada por resolve-library-id

Pruebe nombres alternativos (por ejemplo, 'nextjs' vs 'next.js' vs '@vercel/next'); Context7 indexa por alias comunes, pero no todas las bifurcaciones

Verificar: Check context7.com/browse for the official slug

Los documentos parecen obsoletos

Incluya una versión explícita arg; sin ella, obtendrá los últimos documentos indexados de la biblioteca que pueden retrasar las versiones por horas

Verificar: Compare the returned snippet URL to the official docs site

Límite de tasa alcanzado en el uso anónimo

Obtenga una clave API gratuita en context7.com/dashboard y configure CONTEXT7_API_KEY en el bloque env de su configuración MCP

Verificar: Re-run the same query and check it succeeds

Alternativas

Context7 vs otros

Alternativa	Cuándo usarla	Contrapartida
GitHub MCP (docs folder)	Necesitas una verdad a nivel de fuente o un comportamiento inédito	La latencia por archivo es alta; tienes que navegar por el repositorio manualmente
Ref Tools	Quieres un proveedor de documentos diferente con su propio índice	Cobertura de biblioteca diferente
Direct web fetch	El documento no está en ningún índice; tienes la URL.	Sin resolución de versión; tu haces el trabajo de URL

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills