Todo sobre Context7, en español.
Qué es, qué problema resuelve de verdad, cómo funciona por dentro y la configuración exacta para Claude Code, Cursor, VS Code y opencode. Con los comandos que uso a diario, no los del README de hace un año.
Qué es Context7
Context7 es un servidor MCP creado por Upstash que inyecta documentación oficial y actualizada de librerías dentro del contexto de tu asistente de código. Le pides algo a tu agente, y en lugar de responder con lo que recuerda de su entrenamiento, consulta la documentación real de la versión que estás usando.
El problema que resuelve es concreto y lo has vivido: le pides al modelo que use una librería, y escribe código contra una API que ya no existe. No está alucinando en el sentido estricto, está recordando bien una versión vieja. El corte de entrenamiento es fijo y las librerías no lo esperan.
Es gratis, no necesitas cuenta para empezar, y funciona con cualquier cliente que hable MCP. Si no sabes qué es MCP, esa pieza está explicada aparte en la guía del Model Context Protocol.
Lo mínimo para probarlo
- 01Ejecuta npx ctx7 setup y sigue el login
- 02Reinicia tu editor o tu CLI
- 03Añade 'use context7' al final de un prompt
Cómo funciona
Son dos herramientas MCP encadenadas. Saberlo importa porque explica por qué a veces falla: si la primera no acierta la librería, la segunda trae documentación de otra cosa.
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. Nombres ambiguos resuelven a la librería equivocada, y el agente no siempre lo nota. Si ves documentación que no cuadra, empieza a mirar por aquí.
query-docs
Con el identificador ya resuelto, trae los fragmentos de documentación 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. Antes se llamaba get-library-docs, así que los tutoriales viejos citan un nombre que ya no existe.
La configuración de cada cliente
El camino corto es el instalador oficial. Los bloques manuales están abajo porque cada cliente usa una forma de archivo distinta, y esa es la parte donde la gente se atasca.
El camino corto
Hace el login, genera la API key y deja el cliente configurado. Acepta banderas para elegir el destino.
# 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 --opencodeClaude Code
Un comando. El scope de usuario lo deja disponible en todos tus proyectos, no solo en el actual.
claude mcp add --scope user \
--header "Authorization: Bearer TU_API_KEY" \
--transport http context7 https://mcp.context7.com/mcpCursor
En ~/.cursor/mcp.json para todos los proyectos, o .cursor/mcp.json dentro de uno.
{
"mcpServers": {
"context7": {
"url": "https://mcp.context7.com/mcp",
"headers": {
"Authorization": "Bearer TU_API_KEY"
}
}
}
}VS Code
Usa la clave servers, no mcpServers, y el tipo de transporte va explícito.
{
"servers": {
"context7": {
"type": "http",
"url": "https://mcp.context7.com/mcp",
"headers": {
"Authorization": "Bearer TU_API_KEY"
}
}
}
}opencode
Su bloque se llama mcp, el tipo es remote y hay que activarlo con enabled.
{
"mcp": {
"context7": {
"type": "remote",
"url": "https://mcp.context7.com/mcp",
"headers": {
"Authorization": "Bearer TU_API_KEY"
},
"enabled": true
}
}
}La API key no es obligatoria para empezar, pero es gratuita y sube los límites de uso, así que conviene generarla desde el panel de Context7. Si prefieres correr el servidor en local en vez de apuntar al remoto, el comando es npx -y @upstash/context7-mcp --api-key TU_API_KEY.
Cómo se invoca
Instalarlo no basta: el agente tiene que decidir usarlo. Hay dos formas y conviene conocer las dos.
En el prompt
Configura el middleware de autenticación
en Laravel 13. use context7Añadir use context7 es la forma explícita. Es la que uso cuando el resultado tiene que ser correcto a la primera, porque no depende de que el agente decida bien por su cuenta.
Desde la CLI
ctx7 library next "app router"
ctx7 docs /vercel/next.js "middleware"Sin pasar por el agente. Sirve para comprobar qué devuelve el índice antes de culpar al modelo de un resultado raro.
Lecturas sobre Context7
Esta página es el mapa. Estos dos entran en detalle.
Context7: Documentación siempre actualizada para LLMs y asistentes de código
Context7 brinda documentación oficial y actualizada a asistentes de código IA, evitando errores por ejemplos obsoletos y APIs desactualizadas.
Context7 vs DeepWiki: ¿Cuál elegir para documentación actualizada?
Comparativa completa entre Context7 y DeepWiki, dos herramientas gratuitas que traen documentación actualizada a tus asistentes de IA. Diferencias y cuándo usar cada una.
Preguntas frecuentes
¿Qué es Context7?
Un servidor MCP creado por Upstash que inyecta documentación oficial y actualizada de librerías dentro del contexto de tu asistente de código. Resuelve el problema de que el modelo escriba código contra una versión de la API que ya no existe, porque su entrenamiento se quedó en una versión anterior.
¿Context7 es gratis?
Sí. La API key no es obligatoria para empezar, pero es gratuita y da límites de uso más altos, así que conviene generarla. Se saca desde el panel en context7.com/dashboard.
¿Cómo instalo Context7 en Claude Code?
Con un comando: claude mcp add --scope user --header "Authorization: Bearer TU_API_KEY" --transport http context7 https://mcp.context7.com/mcp. El scope de usuario lo deja activo en todos tus proyectos. También existe el instalador npx ctx7 setup --claude, que hace el login y la configuración por ti.
¿Funciona en VS Code y en opencode?
Sí, pero la forma del archivo cambia en cada uno. VS Code usa la clave servers con el tipo de transporte explícito, y opencode usa un bloque mcp con type remote y enabled en true. Los tres formatos están en esta página.
¿Necesito escribir 'use context7' en cada prompt?
Es la forma explícita de invocarlo y la más fiable cuando quieres asegurarte de que consulta la documentación. Muchos agentes también llaman a la herramienta por su cuenta cuando detectan que les falta contexto de una librería, así que en la práctica no siempre hace falta.
¿En qué se diferencia de DeepWiki?
Context7 sirve documentación oficial de la librería, orientada a que el agente escriba código correcto contra la versión que usas. DeepWiki genera una explicación del repositorio, orientada a entender cómo está construido un proyecto. Resuelven preguntas distintas y no se excluyen.
Context7 es un servidor MCP.
Si quieres entender qué viaja por el cable, conectar otros servidores o escribir el tuyo, la guía del protocolo lo cubre entero.