consultation-de-documentation

Consultation de documentation (Context7)

Lorsque l'utilisateur pose des questions sur des bibliothèques, frameworks ou API, récupérez la documentation à jour via le MCP Context7 (outils resolve-library-id et query-docs) plutôt que de vous appuyer sur les données d'entraînement.

Concepts clés

• Context7 : serveur MCP qui expose une documentation en direct ; utilisez-le à 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 requête.
• 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 en premier 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 repose sur un comportement précis et à jour d'une bibliothèque, d'un framework ou d'une API. Elle s'applique à tous les environnements qui disposent du MCP Context7 configuré (par ex. Claude Code, Cursor, Codex).

Fonctionnement

É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 la pertinence du classement 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 la résolution, choisissez-en un en utilisant :

• Correspondance de nom : privilégiez la correspondance exacte ou la plus proche de ce que l'utilisateur a demandé.
• Score de qualité : des scores plus élevés indiquent une meilleure qualité de documentation (100 étant le maximum).
• Réputation de la source : préférez les sources Haute ou Moyenne lorsqu'elles sont disponibles.
• Version : si l'utilisateur a spécifié une version (ex. "React 19", "Next.js 15"), privilégiez un identifiant de bibliothèque spécifique à cette 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 la 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 reste floue 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 vous basant sur les informations récupérées et à jour.
• Incluez des exemples de code pertinents issus de la documentation lorsque c'est utile.
• Citez la bibliothèque ou la version lorsque c'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. À partir des résultats, choisissez la meilleure correspondance (ex. /vercel/next.js) selon le nom et le score de qualité.
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 issu de la documentation si pertinent.

Exemple : Requête Prisma

1. Appelez resolve-library-id avec libraryName: "Prisma", query: "Comment faire 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 identifiant et la requête.
4. Renvoyez le modèle Prisma Client (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 issus de la documentation récupérée.

Bonnes pratiques

• Soyez précis : utilisez la question complète de l'utilisateur comme requête dans la mesure du possible pour une meilleure pertinence.
• Conscience des versions : lorsque les utilisateurs mentionnent des versions, utilisez les identifiants de bibliothèque spécifiques à cette version issus de l'étape de résolution si disponibles.
• Privilégiez les sources officielles : lorsqu'il existe plusieurs résultats, préférez les packages 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.