Le serveur MCP permet aux assistants IA externes d’interagir de manière structurée avec votre base de connaissances Document360. Ces interactions ne contournent pas votre modèle de gouvernance, elles fonctionnent dans votre version existante, votre langage et votre configuration de visibilité. Voici des scénarios pratiques qui montrent comment différents rôles peuvent utiliser MCP dans leurs flux de travail quotidiens de documentation.
Rédacteurs techniques
Problème : La recherche, la rédaction et l’affinage de la documentation demandent un changement de contexte et un effort manuel
Les rédacteurs techniques passent souvent d’un article à l’autre, d’une version et d’une catégorie à l’autre pour recueillir du contexte avant d’écrire ou de mettre à jour le contenu. Ils doivent également garantir la cohérence du ton, de la terminologie et de la structure, surtout lorsqu’un Guide de Style est configuré. Passer de l’éditeur, de la recherche, des versions précédentes et des articles de référence ralentit la rédaction et la relecture.
Comment le MCP aide
Avec un assistant IA connecté à Document360 via MCP, les rédacteurs peuvent :
Demandez à l’assistant de récupérer les articles pertinents avant de rédiger du nouveau contenu
Brainstorming d’idées fondées sur la documentation existante
Affiner ou réécrire le contenu directement dans le système de documentation
Mettre à jour les articles sans copier manuellement le contenu entre les outils
Au lieu de rédiger isolément et de coller du contenu par la suite, les rédacteurs peuvent travailler avec le contexte tiré de leur propre base de connaissances. Lorsque des mises à jour sont effectuées, le flux de travail existant et le comportement de versionnement restent inchangés. Toute révision ou état de revue forké continue de suivre les processus de documentation normaux.
Conséquences
Les rédacteurs techniques réduisent la recherche répétitive, maintiennent une meilleure cohérence entre les articles et rédigent le contenu plus rapidement, tout en restant dans le même modèle de gouvernance documentaire.
Développeurs
Problème : Les développeurs ont besoin d’une documentation spécifique à chaque version lors de la création de fonctionnalités
Les développeurs alternent fréquemment entre les IDE et les environnements de codage assistés par IA tels que Cursor ou d’autres outils compatibles avec l’IA. Lorsqu’ils consultent la documentation, ils ont besoin d’informations précises et adaptées à la version sans avoir à naviguer manuellement dans la base de connaissances.
Comment le MCP aide
En connectant Document360 via MCP à leur assistant IA au sein de l’IDE :
Les développeurs peuvent récupérer le contenu complet de l’article au lieu de fragments partiels
Recherchez par défaut dans toutes les versions du projet, ou spécifiez une version
Accéder à la documentation dans une langue sélectionnée
Générer des brouillons de documentation pour de nouveaux terminaux ou intégrations
Cela permet la recherche de documentation et la création de contenu directement dans le flux de travail de développement.
Conséquences
Les développeurs passent moins de temps à changer de contexte et plus de temps à construire avec une documentation qui reflète la bonne version et structure.
Chefs de produit et consultants
Problème : La validation de la documentation entre les versions est manuelle et fragmentée
Les chefs de produit doivent souvent comparer les descriptions de fonctionnalités entre les versions, préparer des notes de version ou valider que la documentation reflète les derniers changements produits. Vérifier manuellement plusieurs versions et catégories peut être lent et incohérent.
Comment le MCP aide
Grâce aux assistants IA compatibles MCP, les équipes produit peuvent :
Récupérer la documentation par version spécifique du projet
Comparez la description des fonctionnalités entre les versions
Identifier les failles avant le lancement
Générer des résumés structurés pour l’alignement interne ou l’intégration
Parce que l’interaction est structurée, le contenu est récupéré dans son contexte plutôt que sous forme de sortie web déconnectée.
Conséquences
La documentation devient plus facile à valider avant la sortie, réduisant ainsi le décalage entre les mises à jour du produit et les informations publiées.
Ingénieurs de support
Problème : Les tickets de support mettent en lumière des lacunes de connaissances
Lorsqu’un ticket de support arrive, les ingénieurs doivent rapidement déterminer si la documentation pertinente existe déjà. La recherche manuelle peut prendre du temps, surtout sur plusieurs versions et langues. Dans certains cas, la documentation peut ne pas exister du tout.
Comment le MCP aide
Avec MCP connecté à un assistant IA :
Les ingénieurs support peuvent coller le contexte du ticket et demander à l’assistant de récupérer les articles pertinents
Récupérer le contenu par nom d’article ou identifiant
Recherche à travers les versions et les langues
Partagez directement les URL des articles avec les clients
Si aucun article pertinent n’est trouvé, cela signifie qu’il existe un vide de connaissances dans la base de connaissances. Les ingénieurs peuvent alors :
Rédigez un nouvel article basé sur le contexte du ticket
Mettre à jour un article existant pour améliorer la clarté
Pousser les modifications structurées dans Document360
Toutes les opérations d’écriture continuent de respecter les flux de travail et les autorisations existants.
Conséquences
Les équipes de support résolvent les tickets plus rapidement tout en améliorant continuellement la qualité de la documentation.
Meilleures pratiques
Suivez ces bonnes pratiques lors de l’utilisation du MCP avec des assistants IA :
Utilisez MCP pour récupérer la documentation de la source de vérité au lieu de copier manuellement le contenu
Vérifiez les réponses générées par l’IA avant de publier ou de partager
Spécifiez la version du projet ou le langage lorsque la précision est requise
Utilisez des consignes claires et spécifiques lorsque vous demandez du contenu ou des mises à jour
Assurez-vous que les rôles et permissions des utilisateurs sont correctement configurés
Limitations et considérations
Les assistants IA ne peuvent accéder qu’au contenu autorisé par la configuration de votre projet
Le contenu restreint ou non publié reste soumis à des règles de visibilité
Les sorties générées par l’IA peuvent nécessiter une validation avant utilisation
Le processus de configuration peut varier selon l’assistant IA
Le support MCP peut varier selon l’assistant IA ou l’outil développeur utilisé (comme les assistants basés sur IDE ou les clients expérimentaux). Certains outils peuvent avoir un support limité ou en évolution des capacités MCP.
Dépannage
Si vous rencontrez des problèmes avec l’utilisation du MCP :
Confirmez que MCP est activé dans Document360
Vérifiez que l’URL du serveur MCP est correcte
Assurez-vous que l’authentification OAuth est réalisée avec succès
Vérifiez si votre assistant IA prend en charge MCP ou des connecteurs personnalisés
Si le problème persiste, consultez la documentation de votre assistant IA ou contactez le support.