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é existantes. 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
- Déplacer les articles mis à jour au statut de flux de travail approprié et assigner des évaluateurs sans passer au portail
- Publiez le contenu approuvé directement depuis l’assistant IA une fois la revue terminée
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 techniques réduisent la recherche répétitionne, maintiennent une meilleure cohérence entre les articles, et rédigent et publient 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é, 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
- Déplacez l’article pour qu’il soit examiné et assignez le membre d’équipe approprié avant sa publication
- Publiez l’article directement une fois qu’il a été examiné et approuvé
Toutes les opérations d’écriture, de flux de travail et de publication continuent de respecter les autorisations et règles de gouvernance existantes.
Conséquences
Les équipes de support résolvent les tickets plus rapidement tout en améliorant continuellement la qualité de la documentation — et peuvent désormais passer du contenu du brouillon à la mise en ligne sans quitter leur assistant IA.
Responsables de la documentation et responsables de contenu
Problème : Coordonner la relecture, l’approbation et la publication au sein d’une grande équipe prend beaucoup de temps
Les responsables de la documentation supervisant plusieurs rédacteurs doivent suivre quels articles sont en brouillon, lesquels attendent d’être examinés et lesquels sont prêts à être publiés. Coordonner cela au sein d’une équipe sans vue centralisée entraîne des retards, des revues manquées et des rythmes de publication incohérents.
Comment le MCP aide
Avec un assistant IA connecté à Document360 via MCP, les responsables de la documentation peuvent :
- Vérifiez quels statuts de flux de travail sont configurés et comment le pipeline d’évaluation est structuré
- Déplacez plusieurs articles vers la phase de relecture appropriée et attribuez les bons membres de l’équipe en une seule conversation
- Fixez des dates d’échéance pour les tâches de workflow afin de respecter les délais d’évaluation
- Publiez du contenu qui a passé la révision sans passer au portail
- Déséditez rapidement le contenu obsolète ou incorrect lorsqu’il faut retirer quelque chose de la ligne
Parce que toutes les opérations de flux de travail et de publication suivent le même modèle d’autorisations et de gouvernance que le portail, les managers conservent le contrôle total sur qui peut faire quoi.
Conséquences
Les responsables de la documentation passent moins de temps à poursuivre le statut des revues et à publier manuellement le contenu, et plus de temps à assurer la qualité et la cohérence de la documentation au sein de l’équipe.
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 le contenu généré par l’IA avant de le déplacer pour le réviser ou de le publier sur le site de la base de connaissances
- 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, en particulier pour les flux de travail et les opérations de publication
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.
- Si un compte d’équipe a différents rôles de portail et de contenu selon les catégories et articles, MCP applique le rôle de priorité la plus faible dans toutes les catégories et articles. Par exemple, si vous avez accès à l’éditeur dans une catégorie et l’accès à l’évaluateur dans une autre, le MCP considère les deux comme évaluateurs.
- Si un utilisateur se voit attribuer deux rôles personnalisés, l’un avec des permissions de vue pour un ensemble de catégories et un autre avec des permissions de mise à jour pour un ensemble différent de catégories, le rôle avec accès à la vue prend la priorité. Si vous souhaitez que l’utilisateur mette à jour les articles via MCP, veuillez vous assurer que seul le rôle avec les permissions de mise à jour lui soit attribué.
- Pour utiliser les outils de workflow via MCP, les rôles de portail personnalisés doivent avoir explicitement activés les permissions View workflow assignments et Update workflow assignments . Sans ceux-ci, les changements de statut du flux de travail ne peuvent pas être effectués via MCP.
- Pour les catégories de pages, il n’existe pas de permission de publication autonome dans les paramètres de rôle personnalisés. Si un rôle personnalisé dispose des permissions de Visualisation et de mise à jour pour les catégories, la publication automatique des catégories de pages via MCP est autorisée, conformément au comportement du portail.
- La publication et la désédition via MCP ne sont pas prises en charge pour les guides étape par étape.
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.