Pourquoi la documentation compte
- Les API et leurs paramètres actuels
- Les bonnes pratiques
- Les conventions de l’organisation
- La terminologie du domaine
Date de coupure des connaissances du modèle
- Les mises à jour récentes des bibliothèques peuvent ne pas être prises en compte
- De nouveaux frameworks ou outils peuvent être inconnus
- Les changements d’API après la date de coupure passent à la trappe
- Les bonnes pratiques ont peut-être évolué depuis l’entraînement
Quel outil utiliser ?
Modèle mental
Outil | Modèle mental |
---|---|
@Docs | Comme parcourir et lire la doc officielle |
@Web | Comme chercher des solutions sur le web |
MCP | Comme accéder à ta doc interne |
Documentation publique
Utiliser @Docs
@Docs
relie Cursor à la doc officielle des outils et frameworks populaires. Utilise-le quand t’as besoin d’infos à jour et fiables sur :
- Références d’API : Signatures de fonctions, paramètres, types de retour
- Guides de prise en main : Installation, configuration, usage de base
- Bonnes pratiques : Patterns recommandés par la source
- Débogage spécifique aux frameworks : Guides de dépannage officiels
@
@Docs Next.js How do I set up dynamic routing with catch-all routes?
∞
Agent⌘I
Auto
Utiliser @Web
@Web
parcourt le web en temps réel pour trouver des informations à jour, des articles de blog et des discussions de la communauté. Utilise-le quand tu as besoin de :
- Tutoriels récents : contenu et exemples issus de la communauté
- Comparaisons : articles qui comparent différentes approches
- Mises à jour récentes : annonces ou nouveautés toutes fraîches
- Multiples points de vue : différentes façons d’aborder un problème
@
@Web dernières optimisations de performance pour React 19
∞
Agent⌘I
Auto
Documentation interne
- API internes : Services et microservices personnalisés
- Standards de l’entreprise : Conventions de code, patterns d’architecture
- Systèmes propriétaires : Outils, bases de données, workflows personnalisés
- Connaissances métier : Logique métier, exigences de conformité
Accéder à la doc interne avec MCP
- Les modèles ne peuvent pas deviner tes conventions internes
- La doc d’API pour des services custom n’est pas publique
- La logique métier et la connaissance du domaine sont propres à ton organisation
- Les exigences de conformité et de sécurité varient selon les entreprises
Intégrations MCP courantes
Intégration | Accès | Exemples |
---|---|---|
Confluence | Espaces Confluence de l’entreprise | Doc d’architecture, spécifications d’API pour les services internes, standards et guidelines de code, doc de processus |
Google Drive | Documents et dossiers partagés | Docs de spécification, notes de réunion et décisions, docs de conception et exigences, bases de connaissances d’équipe |
Notion | Bases de données et pages d’espace de travail | Doc de projet, wikis d’équipe, bases de connaissances, exigences produit, specs techniques |
Custom | Systèmes et bases de données internes | APIs propriétaires, systèmes de doc hérités, bases de connaissances custom, outils et workflows spécialisés |
Solutions custom
- Scrappent des sites web ou portails internes
- Se connectent à des bases de données propriétaires
- Accèdent à des systèmes de doc personnalisés
- Récupèrent des contenus depuis des wikis internes ou des bases de connaissances
Si tu construis un serveur MCP custom, tu peux aussi exposer des tools pour que Cursor mette à jour la doc
Garder la doc à jour
À partir du code existant
@
Génère la documentation API pour ce routeur Express, en incluant tous les endpoints, les paramètres et les formats de réponse
∞
Agent⌘I
Auto
À partir des sessions de chat
Après avoir résolu un problème complexe :
@
Résume notre conversation sur la mise en place de l’authentification en un guide étape par étape pour le wiki de l’équipe
∞
Agent⌘I
Auto
Points à retenir
- Utiliser la documentation comme contexte rend Cursor plus précis et à jour
- Utilise
@Docs
pour la doc officielle et@Web
pour la connaissance de la communauté - MCP fait le lien entre Cursor et tes systèmes internes
- Génère de la documentation à partir du code et des conversations pour garder la connaissance à jour
- Combine des sources de doc externes et internes pour une compréhension globale