Context7 para Cursor y Claude Code: configuración y comprobación

Cuando un agente propone un método desconocido, pregunta de dónde lo obtuvo. Un ejemplo convincente puede pertenecer a otra versión o no corresponder a la API. Necesitas documentación de la biblioteca que realmente utiliza el proyecto.

Context7 busca documentación de bibliotecas y entrega fragmentos pertinentes al agente. Se conecta a Cursor y Claude Code. Aporta fuentes para trabajar con API; el código resultante sigue necesitando pruebas. Presentación.

• Presentación

Esta guía configura clientes locales y propone una consulta de control para distinguir una búsqueda real de una respuesta de memoria. Las instrucciones se contrastaron con fuentes oficiales; no se accedió a tu cuenta ni se probó en ella.

Cuándo resulta útil

Elige una tarea dependiente de una biblioteca: configurar rutas, manejar formularios, consultar mediante un ORM o subir archivos con un SDK. Interesan métodos, argumentos y comportamiento documentado.

Para una errata o lógica de negocio propia, buscar bibliotecas puede no aportar nada. Identifica primero qué información falta.

No pidas «conectar toda la documentación». Formula una pregunta concreta.

Cómo busca documentación

La conexión MCP utiliza `resolve-library-id` para encontrar el identificador y `query-docs` para obtener material sobre la pregunta. Si ya conoces el identificador, puedes omitir la primera búsqueda. Integración.

• Integración

Tarea y versión del paquete
        ↓
Elegir la biblioteca
        ↓
Buscar en la documentación
        ↓
Contrastar con el código
        ↓
Modificar y verificar

Cada paso puede comprobarse por separado. Reescribir bien un ejemplo no corrige haber elegido otra biblioteca. Una fuente adecuada tampoco demuestra una integración correcta.

Antes de instalar

Necesitas Cursor o Claude Code, Internet y Node.js con npm/npx. El instalador ctx7 requiere Node.js 18 o posterior; para un entorno nuevo, usa una LTS con soporte. Requisitos CLI.

• Requisitos CLI

En la terminal:

node --version
npx --version

Si falta un comando, configura Node.js en el entorno desde el que instalarás: macOS, Windows o WSL.

Si ya existe una conexión, revisa su configuración antes de reinstalar. Dos entradas con autenticación distinta dificultan saber cuál utiliza el agente.

Conectar Claude Code

Ejecuta:

npx ctx7 setup --claude

El instalador guía la autenticación OAuth y ofrece modos de conexión. Sigue las indicaciones y completa el acceso en el navegador. Es el procedimiento documentado para Claude Code.

• Claude Code

MCP expone herramientas del servidor; CLI + Skills utiliza comandos ctx7 siguiendo un skill. Para la consulta de control, elige MCP y observa las llamadas por nombre. La configuración CLI es global por defecto; `--project` la limita al proyecto actual. Modos.

• Modos

Después abre Claude Code y `/mcp` para ver servidores y estados. Gestión MCP.

• Gestión MCP

Si elegiste CLI + Skills, comprueba llamadas reales a ctx7, no la presencia de un servidor MCP. Son vías diferentes.

Conectar Cursor

Usa el comando específico:

npx ctx7 setup --cursor

Autoriza la conexión y elige MCP para reproducir el ejemplo. Guía de Cursor.

• Guía de Cursor

Para configurar manualmente, abre los ajustes MCP. El archivo global es `~/.cursor/mcp.json`; el del proyecto, `.cursor/mcp.json`. Ejemplo HTTP oficial:

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

`YOUR_API_KEY` es el marcador de tu clave. Consulta la configuración oficial. Añade context7 a mcpServers conservando las demás conexiones.

• configuración oficial

No guardes una clave personal en un repositorio compartido. Para empezar manualmente, usa la configuración personal. OAuth emplea `https://mcp.context7.com/mcp/oauth`; no mezcles los métodos. Autenticación.

• Autenticación

La instalación automática suele bastar. Recurre a la manual para examinar o gestionar una configuración.

Comprobar el uso real

Empieza con una biblioteca conocida. En un proyecto con Zod, pide:

Localiza la versión instalada de Zod. Usa Context7 para averiguar cómo valida email y devuelve resultados sin lanzar excepciones en esa versión. Selecciona primero la biblioteca y después consulta la documentación. Muestra identificador, fuentes y un ejemplo breve. Si no puedes confirmar la versión, indícalo. No modifiques archivos.

Es una petición didáctica, no un resultado observado. Si no hay Zod, usa un paquete conocido instalado y una pregunta pequeña sobre su API.

Si proporcionaste el identificador, es normal omitir `resolve-library-id`. Importa consultar la biblioteca correcta. Una respuesta fluida tras un error de herramienta no convierte el fallo en verificación.

Por qué importa la versión

Indicar una versión acota la tarea, pero debes contrastarla con los documentos. La CLI ofrece identificadores versionados cuando aparecen en resultados; elige entre los realmente devueltos. Bibliotecas y versiones.

• Bibliotecas y versiones

Si el proyecto usa una versión principal antigua y el ejemplo una nueva, no migres todo inmediatamente. Comprueba primero si la instalada admite la operación. Actualizar una dependencia es una decisión distinta con posibles efectos amplios.

Sigue este orden:

1. Identifica la versión en los archivos.
2. Encuentra la operación documentada.
3. Comprueba la compatibilidad del ejemplo.
4. Haz un cambio limitado y verifícalo.

Si no confirmas la versión, abre directamente su documentación oficial o guía de migración. La falta de resultados en una herramienta no implica falta de solución.

¿Siempre hay que escribir use context7?

La indicación `use context7` ayuda a probar la conexión. La instalación también puede añadir un skill de documentación. Opciones de invocación.

• Opciones de invocación

Para uso habitual, define la condición:

Si la solución depende de una API externa, identifica primero
la versión instalada y busca documentación adecuada con Context7.
Si la fuente no está disponible o la versión no se confirma,
indícalo y consulta directamente la documentación oficial.

La regla propuesta puede ir en CLAUDE.md o las reglas de Cursor. Define cuándo buscar y cómo continuar si falla, sin exigir búsquedas para cada cambio de texto.

• CLAUDE.md

Si no funciona

Revisa la fase que falló. Reinstalar todo el cliente rara vez explica la causa.

Los cuatro primeros son de acceso; los dos últimos, de búsqueda y aplicación. Consulta Troubleshooting.

• Troubleshooting

Cursor Cloud Agents utiliza su propia configuración MCP. Que funcione localmente no prueba el acceso en la nube. Sigue la guía Cloud Agents.

• guía Cloud Agents