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

Cuando un agente te proponga un método que no conoces, pregúntale de dónde lo ha sacado. El ejemplo puede sonar convincente y pertenecer a otra versión del paquete, o no existir en la API. Para comprobarlo necesitas la documentación de la biblioteca que usa de verdad tu proyecto.

Context7 busca documentación de bibliotecas y le pasa al agente los fragmentos que vienen al caso. Se conecta tanto a Cursor como a Claude Code. Aporta fuentes para trabajar con una API; el código que salga de ahí hay que probarlo igualmente en tu aplicación.

• Presentación

Esta guía explica la configuración en clientes locales y propone una consulta de control con la que distinguir una búsqueda real de una respuesta de memoria. Hemos contrastado las instrucciones con la documentación oficial. No hemos accedido a tu cuenta ni probado tu instalación.

Cuándo resulta útil

Empieza por una tarea que dependa de una biblioteca: configurar rutas, manejar un formulario, lanzar una consulta con un ORM o subir un archivo con un SDK. Ahí necesitas saber qué métodos existen, qué argumentos aceptan y qué comportamiento describe la documentación.

Para corregir una errata o tocar tu propia lógica de negocio, buscar en bibliotecas externas seguramente no aporte nada. Averigua primero qué información falta.

No pidas «conectar toda la documentación». Plantea la pregunta concreta que la fuente debe responder.

Cómo busca documentación

La conexión MCP tiene dos herramientas principales: `resolve-library-id` encuentra el identificador de la biblioteca y `query-docs` trae el material que responde a la pregunta. Si ya conoces el identificador, puedes saltarte el primer paso.

• 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 se comprueba por separado. Si el agente eligió otra biblioteca, reescribir bien el ejemplo no lo arregla. Y que la fuente sea la adecuada tampoco demuestra que el código esté bien integrado en tu aplicación.

Antes de instalar

Necesitas Cursor o Claude Code, conexión a Internet y un Node.js que funcione, con npm/npx, para lanzar el comando de configuración. El instalador ctx7 requiere Node.js 18 o posterior; en un entorno nuevo, instala una LTS que siga teniendo soporte.

• Requisitos CLI

En la terminal:

node --version
npx --version

Si falta alguno de los dos comandos, instala Node.js en el entorno desde el que vayas a ejecutar el instalador. Compruébalo en la terminal que usas de verdad, sea macOS, Windows o WSL.

Si Context7 ya está conectado, revisa la configuración antes de reinstalar. Con dos entradas que se autentican de forma distinta no sabrás cuál está usando el agente.

Conectar Claude Code

Ejecuta:

npx ctx7 setup --claude

El instalador te lleva por el inicio de sesión con OAuth y te deja elegir el modo de conexión. Sigue sus indicaciones y termina la autorización en el navegador. Es el procedimiento que la documentación de Context7 da para Claude Code.

• Claude Code

Hay dos modos. Con MCP, el agente recibe las herramientas del servidor. Con CLI + Skills, usa los comandos de ctx7 siguiendo un skill. Para la consulta de control elige MCP: así verás las llamadas con su nombre. La configuración por CLI es global por defecto; `--project` la limita al proyecto actual.

• Modos

Después abre Claude Code y ejecuta `/mcp`. Verás los servidores disponibles y su estado.

• Gestión MCP

Si elegiste CLI + Skills, busca en el historial llamadas reales a ctx7 y no un servidor MCP. Cada modo llega a la documentación por un camino distinto.

Conectar Cursor

Cursor tiene su propio comando:

npx ctx7 setup --cursor

Autoriza la conexión y elige MCP si quieres repetir la consulta de control de esta guía.

• Guía de Cursor

Para configurarlo a mano, abre los ajustes de MCP de Cursor. El archivo global es `~/.cursor/mcp.json`; el del proyecto, `.cursor/mcp.json`. Context7 documenta esta configuración HTTP:

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

`YOUR_API_KEY` ocupa el lugar de la clave de tu cuenta. El ejemplo coincide con la configuración oficial para clientes. Si el archivo ya existe, añade context7 dentro de mcpServers y deja las demás conexiones como están.

• configuración oficial

No subas una clave personal a un repositorio compartido. Para una primera configuración manual es más cómodo el archivo personal. OAuth usa otra dirección, `https://mcp.context7.com/mcp/oauth`; no mezcles los dos métodos de autenticación.

• Autenticación

Con la instalación automática suele bastar. Pasa a la manual cuando tengas que examinar la configuración o gestionarla tú.

Comprobar el uso real

Empieza con una biblioteca que conozcas bien, porque así se nota antes una fuente equivocada. 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 de práctica; aquí no reproducimos ninguna respuesta del servicio. Si no tienes Zod, elige un paquete instalado que conozcas y haz una pregunta pequeña sobre su API.

Si el identificador lo diste tú, es normal que no aparezca `resolve-library-id`. Lo que tiene que haber es una consulta correcta a la biblioteca adecuada. Y si la herramienta devolvió un error, una respuesta segura a continuación no prueba nada.

Por qué importa la versión

Indicar la versión acota la consulta, pero aún tienes que contrastarla con el material devuelto. La CLI de Context7 ofrece identificadores con versión cuando aparecen en los resultados de búsqueda; elige entre los que realmente haya devuelto.

• Bibliotecas y versiones

Supón que el proyecto usa una versión mayor antigua y el ejemplo está escrito para la nueva. No migres todo para que encaje. Comprueba primero si la versión instalada admite la operación. Actualizar una dependencia es otra decisión, y sus efectos van más allá de esta tarea.

Un orden que funciona:

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 consigues confirmar la versión, abre directamente la documentación oficial de esa versión o su guía de migración. Que una herramienta no devuelva nada no quiere decir que la biblioteca no tenga solución.

¿Siempre hay que escribir use context7?

Escribir `use context7` de forma explícita viene bien para probar la conexión. La instalación automática también puede añadir un skill de documentación.

• Opciones de invocación

Para el trabajo diario es más útil dejar escrito cuándo debe recurrir a él:

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.

Esta regla es una propuesta nuestra. Puedes ponerla en CLAUDE.md o en las reglas de proyecto de Cursor. Dice cuándo buscar y qué hacer si la búsqueda falla, y no obliga a consultar fuentes externas por cada cambio de texto.

• CLAUDE.md

Si no funciona

Mira en qué paso se quedó la consulta. Reinstalar el cliente entero rara vez te dice dónde está la causa.

Las cuatro primeras filas son problemas de acceso; las dos últimas, de la búsqueda y de cómo se aplica el resultado. Para los detalles técnicos, consulta la guía de resolución de problemas.

• Resolución de problemas

Los Cloud Agents de Cursor usan una configuración MCP aparte. Que Context7 funcione en local no significa que esté disponible en una ejecución en la nube. Sigue la guía de Cloud Agents.

• guía Cloud Agents