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, votre langage et votre configuration de visibilité existants. Voici des scénarios pratiques qui montrent comment différents rôles peuvent utiliser le 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 le 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 révision.
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
Utilisez le Guide de style configuré comme guide lors de l’édition ou de la révision du contenu
Au lieu de rédiger en isolement et de coller du contenu plus tard, 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 bifurquée ou état de révision continue de suivre les processus de documentation normaux.
Conséquences
Les rédacteurs 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 des 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 conscientes de 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 différentes 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 entre 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é, ce vide devient immédiatement visible. 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.
Utilise MCP avec ton assistant IA
Après avoir connecté MCP, vous pouvez interagir avec votre base de connaissances via votre assistant IA.
Recherche dans la documentation
Vous pouvez demander à l’assistant IA de rechercher du contenu dans votre base de connaissances.
Exemples :
Recherchez une fonctionnalité dans une version spécifique
Trouvez des articles liés à un sujet
Récupérer la documentation dans un langage spécifique
Consulter les articles
Vous pouvez demander des articles spécifiques par nom ou sujet.
L’assistant IA récupère le contenu structuré en fonction de la configuration de votre projet, y compris la version et le langage.
Créer et mettre à jour du contenu
Si les opérations d’écriture sont autorisées, l’assistant IA peut :
Créer de nouveaux articles dans une catégorie spécifiée
Mettre à jour les articles existants
Maintenir la structure et la mise en forme HTML
Toutes les opérations d’écriture suivent le comportement existant de versionnement et de publication.
Accédez aux métadonnées structurées
Vous pouvez demander un contexte supplémentaire, tels que :
Versions disponibles des projets
Langues prises en charge
Structure des catégories
Cela permet de garantir que les interactions correspondent à celles de votre organisation de 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 de développement 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.