Context7: Documentación siempre actualizada para LLMs y asistentes de código

¿Qué es Context7?

Context7 es un servidor MCP (Model Context Protocol) desarrollado por Upstash que proporciona documentación actualizada de más de 1000 librerías directamente a tus asistentes de código IA como Claude, Cursor, VSCode y Windsurf. Elimina el problema de código obsoleto y APIs deprecadas que ya no existen, inyectando documentación version-específica y actualizada proveniente directamente de la fuente oficial.

Cómo funciona:

1. Detecta automáticamente la librería mencionada en tu prompt
2. Descarga fragmentos de documentación y ejemplos de código reales desde la fuente oficial
3. Procesa, limpia y jerarquiza la información por relevancia
4. Entrega esa documentación directamente dentro del contexto del modelo

Resultado: Código que compila en el primer intento, sin APIs deprecadas ni ejemplos obsoletos.

¿Buscas alternativas? Lee nuestra comparativa Context7 vs DeepWiki para entender cuándo usar cada uno.

¿Solo quieres la configuración? Salta a cómo instalar Context7, que tiene el bloque exacto de Claude Code, Cursor, VS Code, opencode y Claude Desktop.

¿Qué es MCP (Model Context Protocol)?

Context7 funciona sobre el Model Context Protocol (MCP), un estándar abierto introducido por Anthropic en noviembre de 2024 para estandarizar cómo los sistemas de IA se integran con herramientas y fuentes de datos externas.

MCP es descrito como el "puerto USB-C para aplicaciones de IA": así como USB-C estandarizó las conexiones físicas, MCP estandariza las conexiones entre LLMs y servicios externos.

Adopción y estado actual (2026)

• Diciembre 2025: Anthropic donó MCP a la Agentic AI Foundation (AAIF), un fondo bajo la Linux Foundation
• Co-fundadores: Anthropic, Block (anteriormente Square) y OpenAI
• Adoptado por: OpenAI, Google DeepMind, y otras empresas importantes
• Ecosistema Claude: Más de 75 conectores MCP disponibles (directorio oficial)

Novedad 2026: MCP Apps

En enero de 2026, Anthropic expandió MCP para permitir que aplicaciones presenten interfaces dentro de Claude, mostrando gráficos, formularios y dashboards directamente en la ventana de chat.

Context7 es, de hecho, uno de los mejores servidores MCP para developers. Y si quieres construir el tuyo, escribí una guía de cómo crear un servidor MCP en TypeScript. Todo el protocolo ordenado de menos a más está en la guía de MCP.

Beneficios principales

• Siempre actualizado: Evita el uso de ejemplos obsoletos o APIs inexistentes
• Conciso y relevante: Filtra el contenido útil, sin saturaciones
• Gratis para uso personal/educativo: Desarrollado como proyecto de Upstash
• Compatible con múltiples editores: Cursor, Windsurf, VS Code, Claude, Copilot
• Más de 1000 librerías soportadas: JavaScript, TypeScript, Python, Go, Rust y más

Librerías soportadas

Context7 soporta las librerías más populares en múltiples lenguajes:

• Frontend: React, Vue, Next.js, Nuxt, Svelte, Angular, Solid
• Backend: Laravel, Django, Rails, Express, FastAPI, Nest.js
• Databases: Prisma, Mongoose, Eloquent, TypeORM, Drizzle
• Build Tools: Vite, Webpack, Turbopack, esbuild, Rollup
• Styling: Tailwind CSS, Shadcn UI, Radix UI, MUI
• Testing: Vitest, Jest, Playwright, Cypress
• Y más de 1000 librerías adicionales

Ver la lista completa de librerías soportadas en el repositorio oficial.

Cómo instalar Context7

Hay dos caminos: el instalador oficial, que configura tu agente por ti, y la configuración manual, donde cada cliente usa una forma de archivo distinta. Esa segunda parte es donde se atasca casi todo el mundo, así que abajo está el bloque exacto de cada uno.

Los bloques manuales apuntan al servidor remoto https://mcp.context7.com/mcp y pasan la API key en la cabecera Authorization, que es la forma que recomienda hoy la documentación oficial de clientes. Los ejemplos con npx -y @upstash/context7-mcp que verás en tutoriales viejos siguen funcionando, pero son el modo local y ya no son el camino por defecto.

El camino corto: npx ctx7 setup

La CLI oficial resuelve la autenticación por OAuth, genera tu API key e instala lo necesario en el agente que detecte. Requiere Node.js 18 o superior.

# Detecta tus clientes y configura los que encuentre
npx ctx7 setup
 
# O apunta a uno concreto
npx ctx7 setup --claude
npx ctx7 setup --cursor
npx ctx7 setup --opencode

Context7 funciona en dos modos y el instalador te deja elegir: CLI + Skills, que instala un skill para que el agente use los comandos ctx7, o MCP nativo, que registra el servidor. Para deshacerlo, npx ctx7 remove.

Skill o MCP: cuál elegir

La diferencia práctica es cuándo se carga. El MCP registra el servidor y sus dos herramientas quedan en el contexto del agente desde el arranque, en toda sesión. El skill solo se activa cuando el agente detecta una pregunta de librería, así que no ocupa contexto el resto del tiempo, a cambio de depender de que ese disparo ocurra.

Si trabajas con sesiones largas y te importa el gasto de tokens, el skill. Si quieres que la documentación esté disponible siempre y de forma predecible, el MCP. Los bloques de abajo son para el modo MCP, que es el que hay que configurar a mano.

La API key de Context7

No es obligatoria para empezar, pero es gratuita y sube los límites de uso, así que conviene generarla desde context7.com/dashboard. En los bloques remotos va en la cabecera Authorization: Bearer; en los locales, como argumento --api-key.

Claude Code con Context7

Para configurar Context7 en Claude Code no hace falta editar JSON a mano. Se registra con un comando, y --scope user lo deja disponible en todos tus proyectos en vez de solo en el actual:

claude mcp add --scope user \
  --header "Authorization: Bearer TU_API_KEY" \
  --transport http context7 https://mcp.context7.com/mcp

Queda guardado en ~/.claude.json y lo compruebas con claude mcp list.

Cursor con Context7

En ~/.cursor/mcp.json para todos los proyectos, o en .cursor/mcp.json dentro de uno:

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "Authorization": "Bearer TU_API_KEY"
      }
    }
  }
}

VS Code con Context7

Para Context7 en VS Code hay un detalle que rompe la configuración: usa la clave servers, no mcpServers, y el tipo de transporte va explícito. Es lo que más falla al copiar la configuración de Cursor:

{
  "servers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "Authorization": "Bearer TU_API_KEY"
      }
    }
  }
}

opencode con Context7

Context7 en opencode se configura en opencode.json (u opencode.jsonc). El bloque se llama mcp, el tipo es remote y hay que activarlo con enabled:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "context7": {
      "type": "remote",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "Authorization": "Bearer TU_API_KEY"
      },
      "enabled": true
    }
  }
}

Si prefieres correrlo en local, el mismo bloque pasa a "type": "local" y el comando va como array, no como string con los argumentos en un campo aparte. Ese detalle es el que rompe la configuración cuando se copia desde Cursor o Claude Desktop, porque ahí van separados:

{
  "mcp": {
    "context7": {
      "type": "local",
      "command": ["npx", "-y", "@upstash/context7-mcp", "--api-key", "TU_API_KEY"],
      "enabled": true
    }
  }
}

Claude Desktop con Context7

La configuración vive en:

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

Y va dentro de mcpServers, en modo local:

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

Cómo usar Context7

Instalarlo no basta: el agente tiene que decidir llamarlo. Hay dos formas y conviene conocer las dos.

Desde el prompt. Añadir use context7 al final es la forma explícita, y la que uso cuando el resultado tiene que salir bien a la primera:

Configura el middleware de autenticación en Laravel 13. use context7

Si ya sabes exactamente qué librería quieres, pasa su identificador y Context7 se salta el paso de búsqueda, que es justo donde pierde precisión:

Implementa autenticación básica. use library /supabase/supabase for API and docs.

También puedes pedir una versión concreta mencionándola en el prompt, y Context7 hace el match.

Desde la CLI, sin pasar por el agente. Sirve para comprobar qué devuelve el índice antes de culpar al modelo de un resultado raro:

ctx7 library next "app router"
 
ctx7 docs /vercel/next.js "middleware"

Si instalaste con ctx7 setup ya tienes un skill que dispara Context7 solo cuando detecta una pregunta de librería. Para hacerlo a mano, añade una regla en CLAUDE.md o en los rules de Cursor:

Always use Context7 when I need library/API documentation, code generation, setup or configuration steps without me having to explicitly ask.

Fuente: README de Context7 y documentación de clientes.

Testimonios reales

• En Hacker News, un usuario comenta:

  "I've had good success with the Context7 model context protocol tool, which allows code agents, like GitHub Copilot, to look up the latest relevant version of library documentation including code snippets" (news.ycombinator.com).

• En Medium, Matteo Ferruccio Andreoni relata cómo Context7 cambió su flujo de trabajo:

  "Instead of me shoveling documentation into the model, the service automatically pulls the right snippet, filtered by library and version, and feeds it to the assistant... the code it proposes usually compiles on the first try." (medium.com).

Casos de uso

1. Uso manual: Copia y pega fragmentos desde Context7 directamente a tu editor o interfaz de Chat de Cursor, Claude, etc.
2. Integración automática vía MCP: Context7 se acopla al flujo del editor y enriquece las respuestas sin pasos manuales.
3. Con asistentes locales: Context7 funciona con editores tradicionales (Cursor, VSCode), pero también con asistentes IA locales como OpenClaw, que ejecuta tareas autónomas en tu dispositivo. Esto permite tener documentación actualizada incluso en workflows completamente self-hosted.
4. Para autores de librerías: Se puede añadir tu proyecto en context7.com o enviar un PR en GitHub para que se genere automáticamente el archivo llms.txt optimizado para LLMs.

Funcionamiento interno

Las dos herramientas MCP

Desde tu agente, Context7 son dos herramientas encadenadas. Saberlo importa porque explica por qué a veces falla:

1. resolve-library-id traduce un nombre suelto a un identificador del índice de Context7. De next a algo como /vercel/next.js. Es donde se pierde la precisión: un nombre ambiguo resuelve a la librería equivocada y el agente no siempre lo nota. Si ves documentación que no cuadra, empieza a mirar por aquí.
2. query-docs ya con el identificador resuelto, trae los fragmentos relevantes para la pregunta concreta. No vuelca el manual entero, filtra por la consulta, que es lo que evita que se te coma la ventana de contexto.

Esa segunda herramienta se llamaba get-library-docs, así que los tutoriales de hace un año citan un nombre que ya no existe. Pasarle el identificador directo en el prompt (use library /vercel/next.js) salta el primer paso y con él su margen de error.

Del lado del servidor

Context7:

• Extrae fragmentos de código y ejemplos desde la documentación oficial.
• Agrega explicaciones cortas usando LLMs.
• Vectoriza y ordena por relevancia mediante un algoritmo propio.
• Almacena en cache (en Redis) para respuesta rápida (upstash.com).

En resumen

1. ¿Qué es? Servidor MCP que inyecta documentación oficial actualizada

2. Ventajas Exactitud, relevancia, ahorro de tiempo, gratis (uso personal)

3. Compatibilidad Cursor, Windsurf, VS Code + Copilot, Claude, otros.

4. Modo de uso Manual (copiar/pegar) o automático (MCP integrado).

5. Testimonios Usuarios reportan mejor compilación en primera sugerencia.

6. Tecnología interna Parsing, enriquecimiento, vectorización, ranking, cache.

Recursos oficiales

• Repositorio GitHub: upstash/context7
• NPM Package: @upstash/context7-mcp
• Blog Upstash: Introducing Context7
• MCP Official: Model Context Protocol
• Directorio MCP: LobeHub, Smithery

Enlaces de interes

• GitHub y sitio oficial de Context7 --- explicación general y arquitectura (github.com, upstash.com, context7.com).
• Blog de Upstash (marzo 2025): introducción, beneficios, "llms.txt" (upstash.com).
• Guía de instalación y uso detallado en Apidog (julio 2025) (apidog.com).
• Artículo en Medium (junio 2025): experiencia práctica de integración (medium.com).
• Comentario en Hacker News: experiencia de usuario (news.ycombinator.com).

Preguntas frecuentes