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

Lorsqu'un agent propose une méthode inconnue, demandez sa source. Un exemple plausible peut concerner une autre version ou ne pas correspondre à l'API. Il faut la documentation de la bibliothèque réellement utilisée.

Context7 recherche la documentation des bibliothèques et transmet des extraits pertinents à l'agent. Il se connecte à Cursor et Claude Code. Il apporte des sources ; le code obtenu reste à vérifier dans l'application. Présentation.

• Présentation

Voici la configuration des clients locaux et une demande témoin pour distinguer une vraie recherche d'une réponse de mémoire. Les instructions ont été confrontées aux sources officielles ; aucun accès à votre compte ni essai pratique sur celui-ci n'a été effectué.

Quand l'utiliser

Choisissez une tâche dépendant d'une bibliothèque : routeur, formulaire, requête ORM ou envoi de fichier via SDK. Il faut connaître méthodes, arguments et comportement documenté.

Pour une faute de frappe ou une règle métier interne, la recherche externe peut être inutile. Identifiez d'abord l'information manquante.

Ne demandez pas de « connecter toute la documentation ». Formulez la question à résoudre.

Fonctionnement de la recherche

En MCP, `resolve-library-id` trouve l'identifiant et `query-docs` récupère des éléments pour la question. Avec un identifiant connu, la première étape peut être omise. Intégration.

• 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 transition se contrôle séparément. Bien recopier un exemple ne corrige pas le choix d'une mauvaise bibliothèque. Une bonne source ne prouve pas une bonne intégration.

Préparer l'installation

Il faut Cursor ou Claude Code, Internet et Node.js avec npm/npx. L'installateur ctx7 exige Node.js 18 ou ultérieur ; préférez une LTS encore prise en charge pour un nouvel environnement. Prérequis CLI.

• Prérequis CLI

Dans le terminal :

node --version
npx --version

Si une commande manque, configurez Node.js dans l'environnement d'installation réellement utilisé : macOS, Windows ou WSL.

Si Context7 existe déjà, examinez la configuration avant de réinstaller. Deux connexions avec des authentifications différentes compliquent le diagnostic.

Connecter Claude Code

Dans le terminal :

npx ctx7 setup --claude

L'installateur guide la connexion OAuth et propose un mode. Suivez les indications et terminez l'autorisation dans le navigateur. C'est le parcours indiqué pour Claude Code.

• Claude Code

Deux modes existent : MCP expose des outils serveur ; CLI + Skills emploie les commandes ctx7 selon un skill. Choisissez MCP pour voir les appels nommés dans l'exemple ci-dessous. L'installation CLI est globale par défaut ; `--project` la limite au projet actuel. Modes.

• Modes

Ouvrez ensuite Claude Code et `/mcp` pour voir serveurs et états. Gestion MCP.

• Gestion MCP

Avec CLI + Skills, cherchez les appels effectifs à ctx7 plutôt qu'un serveur MCP : ce sont deux chemins différents.

Connecter Cursor

Utilisez :

npx ctx7 setup --cursor

Autorisez la connexion et choisissez MCP pour reproduire l'exemple. Guide Cursor.

• Guide Cursor

Pour la configuration manuelle, ouvrez les réglages MCP. Le fichier global est `~/.cursor/mcp.json`, celui du projet `.cursor/mcp.json`. Exemple HTTP officiel :

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

`YOUR_API_KEY` représente votre clé. Voir la configuration officielle des clients. Ajoutez context7 dans mcpServers sans remplacer les autres connexions.

• configuration officielle des clients

Ne conservez pas de clé personnelle dans un dépôt partagé. Pour commencer manuellement, préférez le fichier personnel. OAuth utilise `https://mcp.context7.com/mcp/oauth` ; ne mélangez pas les méthodes. Authentification.

• Authentification

La configuration automatique suffit généralement. Passez au manuel pour examiner ou gérer vous-même une configuration.

Vérifier l'utilisation réelle

Choisissez une bibliothèque familière. Dans un projet Zod :

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.

C'est une demande pédagogique, pas un résultat observé. Sans Zod, choisissez un paquet installé connu et une petite question d'API.

Si l'identifiant était fourni, l'absence de `resolve-library-id` est normale. L'important est la requête sur la bonne bibliothèque. Une réponse fluide après une erreur d'outil ne transforme pas l'échec en vérification.

Pourquoi vérifier la version

La version dans la question aide, mais doit correspondre aux sources. La CLI propose des identifiants versionnés lorsqu'ils figurent dans les résultats ; choisissez dans la liste réellement renvoyée. Bibliothèques et versions.

• Bibliothèques et versions

Si le projet utilise une ancienne version majeure et l'exemple une nouvelle, ne migrez pas tout immédiatement. Cherchez d'abord l'opération dans la version installée. Une mise à jour de dépendance est une décision distincte.

Procédez ainsi :

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 incertaine, consultez directement sa documentation officielle ou le guide de migration. L'absence de résultat dans un outil ne signifie pas absence de solution.

Faut-il toujours écrire use context7 ?

L'indication explicite `use context7` aide à tester. L'installation peut aussi ajouter un skill de documentation. Options d'appel.

• Options d'appel

Pour travailler régulièrement, définissez une condition :

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 proposée peut aller dans CLAUDE.md ou les règles Cursor. Elle fixe déclenchement et recours sans imposer une recherche pour chaque correction de texte.

• CLAUDE.md

En cas de panne

Examinez l'étape qui échoue. Réinstaller tout le client explique rarement la cause.

Les quatre premiers concernent l'accès, les deux derniers la recherche et son application. Voir le dépannage.

• dépannage

Cursor Cloud Agents utilise sa propre configuration MCP. Un fonctionnement local ne prouve pas l'accès dans le cloud. Suivez le guide Cloud Agents.

• guide Cloud Agents