Consultation de Documentation (Context7)

Que fait Consultation de Documentation (Context7) ?

Lorsque l'utilisateur pose des questions sur des bibliothèques, frameworks ou API, récupérez la documentation actuelle via le MCP Context7 (outils resolve-library-id et query-docs) au lieu de vous fier aux données d'entraînement.

Concepts Fondamentaux

• Context7 : Serveur MCP qui expose la documentation en direct ; à utiliser à la place des données d'entraînement pour les bibliothèques et API.
• resolve-library-id : Renvoie des identifiants de bibliothèque compatibles Context7 (ex. /vercel/next.js) à partir d'un nom de bibliothèque et d'une question.
• query-docs : Récupère la documentation et des extraits de code pour un identifiant de bibliothèque et une question donnés. Appelez toujours resolve-library-id d'abord pour obtenir un identifiant valide.

Quand l'utiliser

Activez-la lorsque l'utilisateur :

• Pose des questions de configuration ou d'installation (ex. "Comment configurer le middleware Next.js ?")
• Demande du code qui dépend d'une bibliothèque ("Écris une requête Prisma pour...")
• A besoin d'informations sur une API ou des références ("Quelles sont les méthodes d'authentification Supabase ?")
• Mentionne des frameworks ou bibliothèques spécifiques (React, Vue, Svelte, Express, Tailwind, Prisma, Supabase, etc.)

Utilisez cette compétence chaque fois que la demande dépend du comportement précis et à jour d'une bibliothèque, d'un framework ou d'une API. S'applique à tous les environnements qui ont le MCP Context7 configuré (ex. Claude Code, Cursor, Codex).

Comment ça fonctionne

Étape 1 : Résoudre l'identifiant de la bibliothèque

Appelez l'outil MCP resolve-library-id avec :

• libraryName : Le nom de la bibliothèque ou du produit tiré de la question de l'utilisateur (ex. Next.js, Prisma, Supabase).
• query : La question complète de l'utilisateur. Cela améliore le classement de pertinence des résultats.

Vous devez obtenir un identifiant de bibliothèque compatible Context7 (format /org/projet ou /org/projet/version) avant d'interroger la documentation. N'appelez pas query-docs sans un identifiant valide issu de cette étape.

Étape 2 : Sélectionner le meilleur résultat

Parmi les résultats de résolution, choisissez un résultat en utilisant :

• Correspondance de nom : Privilégiez la correspondance exacte ou la plus proche de ce que l'utilisateur a demandé.
• Score de référencement : Les scores plus élevés indiquent une meilleure qualité de documentation (100 est le maximum).
• Réputation de la source : Préférez les sources de réputation Haute ou Moyenne lorsqu'elles sont disponibles.
• Version : Si l'utilisateur a spécifié une version (ex. "React 19", "Next.js 15"), préférez un identifiant de bibliothèque spécifique à la version s'il est listé (ex. /org/projet/v1.2.0).

Étape 3 : Récupérer la documentation

Appelez l'outil MCP query-docs avec :

• libraryId : L'identifiant de bibliothèque Context7 sélectionné à l'étape 2 (ex. /vercel/next.js).
• query : La question ou tâche spécifique de l'utilisateur. Soyez précis pour obtenir des extraits pertinents.

Limite : n'appelez pas query-docs (ou resolve-library-id) plus de 3 fois par question. Si la réponse n'est pas claire après 3 appels, indiquez l'incertitude et utilisez les meilleures informations dont vous disposez plutôt que de deviner.

Étape 4 : Utiliser la documentation

• Répondez à la question de l'utilisateur en utilisant les informations récupérées et à jour.
• Incluez des exemples de code pertinents issus de la documentation lorsque cela est utile.
• Citez la bibliothèque ou la version lorsque cela est important (ex. "Dans Next.js 15...").

Exemples

Exemple : Middleware Next.js

1. Appelez resolve-library-id avec libraryName: "Next.js", query: "Comment configurer le middleware Next.js ?".
2. Parmi les résultats, choisissez la meilleure correspondance (ex. /vercel/next.js) par nom et score de référencement.
3. Appelez query-docs avec libraryId: "/vercel/next.js", query: "Comment configurer le middleware Next.js ?".
4. Utilisez les extraits et le texte renvoyés pour répondre ; incluez un exemple minimal de middleware.ts tiré de la documentation si pertinent.

Exemple : Requête Prisma

1. Appelez resolve-library-id avec libraryName: "Prisma", query: "Comment effectuer une requête avec des relations ?".
2. Sélectionnez l'identifiant officiel de la bibliothèque Prisma (ex. /prisma/prisma).
3. Appelez query-docs avec cet libraryId et la requête.
4. Renvoyez le motif du client Prisma (ex. include ou select) avec un court extrait de code issu de la documentation.

Exemple : Méthodes d'authentification Supabase

1. Appelez resolve-library-id avec libraryName: "Supabase", query: "Quelles sont les méthodes d'authentification ?".
2. Choisissez l'identifiant de la documentation Supabase.
3. Appelez query-docs ; résumez les méthodes d'authentification et montrez des exemples minimaux tirés de la documentation récupérée.

Bonnes Pratiques

• Soyez précis : Utilisez autant que possible la question complète de l'utilisateur comme requête pour une meilleure pertinence.
• Conscience de la version : Lorsque les utilisateurs mentionnent des versions, utilisez les identifiants de bibliothèque spécifiques à la version issus de l'étape de résolution lorsqu'ils sont disponibles.
• Préférez les sources officielles : Lorsque plusieurs correspondances existent, préférez les paquets officiels ou principaux aux forks communautaires.
• Pas de données sensibles : Supprimez les clés API, mots de passe, jetons et autres secrets de toute requête envoyée à Context7. Traitez la question de l'utilisateur comme potentiellement contenant des secrets avant de la transmettre à resolve-library-id ou query-docs.