Context7 pour Cursor et Claude Code : installation et vérification

Quand un agent propose une méthode que vous ne connaissez pas, demandez-lui d'où elle vient. L'exemple a beau être plausible, il peut viser une autre version du paquet, voire ne correspondre à aucune API existante. Pour trancher, il faut la documentation de la bibliothèque que votre projet utilise réellement.

Context7 recherche la documentation des bibliothèques et en transmet les extraits utiles à l'agent. Il se connecte à Cursor comme à Claude Code. Il fournit des sources pour travailler avec une API ; le code qui en sort reste à vérifier dans votre application.

• Présentation

Vous trouverez ci-dessous la configuration pour les clients locaux, puis une demande témoin qui permet de distinguer une vraie recherche documentaire d'une réponse donnée de mémoire. Nous avons confronté ces instructions à la documentation officielle. Nous n'avons ni accédé à votre compte ni testé votre installation.

Quand l'utiliser

Partez d'une tâche qui dépend d'une bibliothèque : configuration d'un routeur, gestion d'un formulaire, requête via un ORM, envoi de fichier par un SDK. Dans ces cas, il faut savoir quelles méthodes existent, ce qu'elles acceptent et quel comportement la documentation annonce.

Pour une faute de frappe ou une règle métier interne, la recherche externe n'apportera sans doute rien. Commencez par repérer l'information qui manque.

Ne demandez pas de « connecter toute la documentation ». Posez la question précise à laquelle la source doit répondre.

Fonctionnement de la recherche

La connexion MCP repose sur deux outils : `resolve-library-id` trouve l'identifiant de la bibliothèque, `query-docs` récupère les passages qui répondent à la question. Si vous connaissez déjà l'identifiant, la première étape est superflue.

• Intégration

Tâche et version du paquet
        ↓
Choisir la bibliothèque
        ↓
Chercher dans la documentation
        ↓
Comparer au code du projet
        ↓
Modifier et vérifier

Chaque étape se contrôle séparément. Si l'agent s'est trompé de bibliothèque, recopier proprement l'exemple n'y changera rien. Et une source juste ne garantit pas que le code soit bien intégré à votre application.

Préparer l'installation

Il vous faut Cursor ou Claude Code, un accès à Internet et un Node.js fonctionnel avec npm/npx pour lancer la commande d'installation. L'installateur ctx7 exige Node.js 18 ou une version ultérieure ; pour un nouvel environnement, prenez une LTS encore maintenue.

• Prérequis CLI

Dans le terminal :

node --version
npx --version

Si l'une des commandes est introuvable, installez Node.js dans l'environnement où vous lancerez l'installateur. Vérifiez le terminal dont vous vous servez vraiment : macOS, Windows ou WSL.

Si Context7 est déjà connecté, regardez la configuration existante avant de réinstaller. Avec deux entrées authentifiées différemment, vous ne saurez plus par laquelle passe l'agent.

Connecter Claude Code

Dans le terminal :

npx ctx7 setup --claude

L'installateur vous guide dans la connexion OAuth et vous propose un mode. Suivez ses indications, puis terminez l'autorisation dans le navigateur. C'est le parcours que la documentation de Context7 indique pour Claude Code.

• Claude Code

Deux modes existent. En MCP, l'agent dispose des outils du serveur. En CLI + Skills, il passe par les commandes ctx7, guidé par un skill. Choisissez MCP pour la demande témoin ci-dessous : les appels d'outils apparaîtront sous leur nom. L'installation CLI est globale par défaut ; `--project` la limite au projet en cours.

• Modes

Ouvrez ensuite Claude Code et lancez `/mcp` : la commande affiche les serveurs disponibles et leur état.

• Gestion MCP

Si vous avez choisi CLI + Skills, cherchez dans l'historique de vrais appels à ctx7 plutôt qu'un serveur MCP. Les deux modes n'empruntent pas le même chemin vers la documentation.

Connecter Cursor

Cursor a sa propre commande :

npx ctx7 setup --cursor

Autorisez la connexion et choisissez MCP si vous voulez reproduire la demande témoin de ce guide.

• Guide Cursor

Pour une configuration manuelle, ouvrez les réglages MCP de Cursor. Le fichier global est `~/.cursor/mcp.json`, celui du projet `.cursor/mcp.json`. Context7 documente la configuration HTTP suivante :

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

`YOUR_API_KEY` tient la place de la clé de votre compte. L'exemple reprend la configuration officielle des clients. Si le fichier existe déjà, ajoutez context7 dans mcpServers sans toucher aux autres connexions.

• configuration officielle des clients

Ne versez pas de clé personnelle dans un dépôt partagé. Pour une première configuration manuelle, le fichier personnel est plus simple. OAuth passe par une autre adresse, `https://mcp.context7.com/mcp/oauth` ; ne mélangez pas les deux méthodes d'authentification.

• Authentification

La configuration automatique suffit le plus souvent. Passez au manuel quand vous devez examiner la configuration ou la gérer vous-même.

Vérifier l'utilisation réelle

Commencez par une bibliothèque que vous connaissez bien : une mauvaise source s'y repère plus vite. Dans un projet qui utilise Zod, demandez :

Trouve la version installée de Zod. Utilise Context7 pour déterminer comment elle valide un email et retourne un résultat sans exception. Sélectionne la bibliothèque, puis cherche la documentation. Montre identifiant, sources et exemple court. Si la version ne peut pas être confirmée, indique-le. Ne modifie aucun fichier.

Il s'agit d'une demande d'exercice ; nous ne reproduisons pas ici de réponse du service. Si Zod n'est pas installé, prenez un paquet de votre projet que vous connaissez et posez une petite question sur son API.

Si vous avez fourni l'identifiant vous-même, l'absence de `resolve-library-id` est normale. Ce qui compte, c'est une requête réussie sur la bonne bibliothèque. Et si l'outil a renvoyé une erreur, l'assurance de la réponse qui suit ne prouve rien.

Pourquoi vérifier la version

Indiquer la version resserre la demande, mais il faut encore la rapprocher des documents renvoyés. La CLI de Context7 propose des identifiants versionnés lorsqu'ils figurent dans les résultats de recherche ; choisissez dans la liste réellement renvoyée.

• Bibliothèques et versions

Supposons que votre projet tourne sur une ancienne version majeure et que l'exemple vise la nouvelle. Ne migrez pas tout pour coller à l'exemple. Cherchez d'abord si la version installée prend en charge l'opération. Mettre à jour une dépendance est une décision à part, dont les effets dépassent la tâche en cours.

Un ordre qui fonctionne :

1. Identifier la version dans le projet.
2. Trouver l'opération documentée.
3. Vérifier la compatibilité de l'exemple.
4. Modifier de façon limitée et contrôler le résultat.

Si la version reste impossible à confirmer, ouvrez directement la documentation officielle de cette version ou son guide de migration. Qu'un outil ne renvoie rien ne veut pas dire que la bibliothèque n'a pas de solution.

Faut-il toujours écrire use context7 ?

Écrire `use context7` en toutes lettres est pratique pour tester la connexion. L'installation automatique peut aussi ajouter un skill de documentation.

• Options d'appel

Pour le travail courant, mieux vaut préciser quand l'agent doit y recourir :

Si la solution dépend d'une API externe, identifie d'abord la version
installée et cherche la documentation adaptée avec Context7.
Si la source est indisponible ou sa version non confirmée, signale-le
et consulte directement la documentation officielle.

Cette règle est une proposition de notre part. Placez-la dans CLAUDE.md ou dans les règles de projet de Cursor. Elle fixe un déclencheur et une solution de repli, sans imposer de recherche externe à chaque retouche de texte.

• CLAUDE.md

En cas de panne

Regardez à quelle étape la demande s'est arrêtée. Réinstaller tout le client vous apprend rarement d'où vient la panne.

Les quatre premières lignes concernent l'accès, les deux dernières la recherche et l'usage de son résultat. Pour le détail technique, reportez-vous à la page de dépannage.

• dépannage

Les Cloud Agents de Cursor utilisent leur propre configuration MCP. Que Context7 fonctionne en local ne dit donc rien de son accès dans le cloud. Suivez le guide Cloud Agents.

• guide Cloud Agents