Maintenant que vous avez connecté le serveur MCP Document360 à vos assistants IA, voyons comment ces assistants peuvent utiliser les outils MCP pour rechercher, récupérer, créer, mettre à jour, gérer des flux de travail et publier du contenu dans votre base de connaissances. Ils peuvent également maintenir des termes de glossaire, gérer les rappels de revue d’articles, accomplir vos tâches assignées et envoyer des retours d’articles.
Ces outils fonctionnent ensemble via des invites, permettant des tâches de documentation en plusieurs étapes avec une seule instruction. Par exemple, un assistant IA peut rechercher des articles existants, récupérer des détails de catégorie, créer de nouvelles documentations, mettre à jour le contenu existant, faire passer le contenu à travers les étapes de workflow et le publier sur votre site de base de connaissances, le tout en fonction de la structure de votre projet et des permissions. Comprendre le fonctionnement de ces outils vous aide à créer des prompts plus efficaces et à construire des flux de travail de documentation plus efficaces.
Lorsque Document360 lance de nouveaux outils MCP, votre assistant IA ne les détecte pas automatiquement. Rafraîchissez la liste des outils dans votre assistant IA, ou déconnectez et reconnectez le connecteur Document360 pour commencer à les utiliser.
Les outils MCP fonctionnent uniquement avec le contenu de votre espace de travail de la base de connaissances. Ils ne recherchent, ne récupèrent, ne créent pas ou ne mettent à jour pas de contenu dans un espace de travail de documentation API (références API générées à partir d’une spécification OpenAPI ou Postman). Pour travailler avec le contenu de documentation API, utilisez plutôt le portail Document360 ou l’API client standard.
Outils MCP
Outils de recherche et de récupération
| Outil | Ce que ça fait | Utilisez cela pour |
|---|---|---|
document360-mcp-search |
Effectue une recherche sémantique sur votre projet de base de connaissances. Correspond par signification, pas par formulation exacte. Recherche par défaut dans toutes les versions du projet, ou une version spécifique si nécessaire. | Découvrez des articles connexes, explorez un sujet ou trouvez de la documentation lorsque vous ne connaissez pas la phrase exacte utilisée |
document360-mcp-find-text |
Trouve un mot ou une expression exacte n’importe où dans votre documentation et renvoie chaque article et catégorie de page qui le contient, avec leurs URL publiques. | Trouvez chaque document contenant un terme exact, des ressources de contenu ou un extrait de code avant une mise à jour massive |
document360-mcp-list-documents |
Liste les articles et les catégories de pages en utilisant des filtres tels que version, langue, catégorie, statut, tags, étiquettes ou date de mise à jour. | Constituez une liste de revues pour une publication, auditez une catégorie, ou trouvez tout ce qui est mis à jour depuis une date donnée |
document360-mcp-get-article |
Récupère le contenu complet de tout article en utilisant son ID ou URL. Fonctionne dans plusieurs langues et vous permet d’accéder à la fois aux versions publiées et brouillon. | Lisez les articles existants, relisez le contenu brouillon, récupérez les articles avant de les mettre à jour |
document360-mcp-get-categories |
Récupère la structure complète des catégories pour une version de projet sélectionnée, incluant les catégories enfants et les articles associés. | Parcourez la hiérarchie de la base de connaissances, trouvez les identifiants de catégorie, comprenez la structure de la documentation |
document360-mcp-get-category |
Récupère tout ce qui concerne une catégorie spécifique, son contenu, ses sous-catégories et les articles associés en utilisant l’identifiant de catégorie. | Inspecter en profondeur une catégorie, lire le contenu de la page de catégorie, valider la catégorie avant les mises à jour |
document360-mcp-get-project-versions |
Liste toutes les versions disponibles de votre projet avec leurs identifiants afin que vous puissiez exécuter des opérations spécifiques à chaque version avec précision. | Sélectionnez la bonne version, créez des invites sensibles à la version, récupérez les identifiants de version valides |
document360-mcp-get-workflow-statuses |
Liste les statuts du flux de travail configurés pour le projet, ainsi que leurs identifiants et indicateurs. | Découvrez les statuts de flux de travail disponibles, récupérez les identifiants d’état avant de faire passer le contenu par les étapes de révision |
document360-mcp-get-workflow-assignees |
Liste les utilisateurs et groupes pouvant être assignés au flux de travail d’un document spécifique. | Trouvez des identifiants de cessionnaire valides avant d’assigner une étape de workflow, identifiez qui peut examiner un document |
document360-mcp-list-glossary-terms |
Liste les termes du glossaire dans votre projet, y compris la définition de chaque terme et ses variantes linguistiques. Vous pouvez filtrer par termes globaux ou au niveau de la langue, langue ou texte de recherche. | Vérifiez si un terme est déjà défini, consultez les définitions du glossaire, trouvez un terme avant de l’insérer dans un article |
document360-mcp-list-review-reminders |
Liste les articles et les catégories de pages dans un espace de travail contenant un rappel de critique, avec la date d’évaluation la plus ancienne en premier. Vous pouvez filtrer par état (obsolète ou programmé), plage de dates d’évaluation et langue. | Trouvez le contenu qui nécessite une révision immédiate, planifiez les prochaines critiques, vérifiez quels articles doivent être remis avant une sortie |
document360-mcp-get-my-tasks |
Liste les tâches qui vous sont assignées dans un espace de travail, y compris les attributions de workflow, les retours des lecteurs et les rappels de révision. C’est la même liste que vous voyez sur la page Tâches du portail. | Voyez ce qui est en retard ou à rendre cette semaine, triez votre travail, trouvez l’identifiant de la tâche avant d’agir |
Quel outil de recherche devriez-vous utiliser ? Cela dépend de ce que vous recherchez :
- Si vous connaissez le sujet mais pas les mots exacts, utilisez
document360-mcp-search. Par exemple, « que dit notre documentation concernant la réinitialisation d’un mot de passe ? » - Si vous connaissez le mot ou l’expression exacte que vous souhaitez trouver, utilisez
document360-mcp-find-text. Par exemple, pour trouver chaque article contenant{{old_api_key}}. - Si vous n’avez pas de terme de recherche et que vous souhaitez simplement une liste de documents, utilisez
document360-mcp-list-documents. Par exemple, chaque article d’une catégorie qui a été mis à jour le mois dernier.
Outils d’écriture
| Outil | Ce que ça fait | Utilisez cela pour |
|---|---|---|
document360-mcp-create-article |
Crée un nouvel article dans une catégorie spécifiée et une version du projet en supportant un contenu structuré. | Créer une nouvelle documentation dans la bonne catégorie, rédiger des articles d’aide manquants, générer des premiers brouillons à partir des prompts |
document360-mcp-update-article |
Met à jour un article existant tout en préservant sa structure et sa mise en forme. Conçu pour des mises à jour partielles afin que vous puissiez réviser une section sans toucher au reste de l’article. | Mettre à jour la documentation obsolète, réviser les articles pendant les mises à jour produit, réécrire certaines sections sans affecter le reste |
document360-mcp-create-category |
Crée une nouvelle catégorie au sein d’une version de projet sélectionnée. Prend en place les structures imbriquées afin que vous puissiez créer des sous-catégories au fur et à mesure que votre contenu grandit. | Ajouter de nouvelles sections de documentation, créer des sous-catégories pour de nouvelles fonctionnalités, organiser le contenu en nouvelles structures |
document360-mcp-update-category |
Met à jour les propriétés des catégories telles que nom, position, hiérarchie ou visibilité. | Renommer les catégories, réorganiser la hiérarchie, améliorer la structure |
document360-mcp-update-category-content |
Met à jour le contenu des pages de catégories tout en préservant la structure existante. | Mettre à jour le contenu des catégories de page ou d’index, réviser l’aperçu des catégories ou les sections introductives, actualiser les directives au niveau de la catégorie sans affecter le reste de la structure |
document360-mcp-set-workflow-status |
Définit le statut du flux de travail d’un article ou d’une catégorie de page, avec une date d’échéance optionnelle, un commentaire et des destinataires. | Faire passer le contenu à travers les étapes de révision, assigner des relecteurs, fixer des dates limites pour les tâches de workflow |
document360-mcp-publish-article |
Publie un article en promouvant son dernier brouillon en version live. | Faites publier un brouillon d’article sur le site de la base de connaissances après l’avoir créé ou mis à jour |
document360-mcp-unpublish-article |
Désédite un article et le retire du site de la base de connaissances en ligne. Le contenu est préservé et peut être republié. | Mettez un article obsolète ou incorrect hors ligne sans le supprimer |
document360-mcp-publish-category |
Publie le dernier brouillon de contenu d’une catégorie Page en version live. | Créez une catégorie Page en ligne après avoir mis à jour son contenu |
document360-mcp-unpublish-category |
Désédite une catégorie de page et la retire du site de la base de connaissances en ligne. Le contenu est préservé et peut être republié. | Supprimez une catégorie de page du site de la base de connaissances en ligne sans la supprimer |
document360-mcp-create-glossary-term |
Ajoute un nouveau terme à votre glossaire, soit comme terme global partagé entre toutes les langues, soit comme terme au niveau de la langue pour une langue. | Définir de nouveaux termes produits, ajouter des entrées de glossaire manquantes, construire un glossaire à partir de la documentation existante |
document360-mcp-update-glossary-term |
Met à jour le nom, le terme ou la définition d’un terme du glossaire existant. Seuls les champs que vous modifiez sont mis à jour. Pour les termes au niveau de la langue, vous pouvez mettre à jour une langue ou en ajouter une nouvelle. | Réviser des définitions obsolètes, ajouter une définition dans une autre langue, corriger la formulation d’un terme |
document360-mcp-set-article-review-reminder |
Programmer un rappel de revue sur un article, le signaler pour révision immédiate, ou effacer le rappel. | Planifiez la prochaine revue après la mise à jour d’un article, signalez un article comme nécessitant une révision, supprimez un rappel qui n’est plus nécessaire |
document360-mcp-snooze-task |
Il fait remettre une de vos tâches en veille jusqu’à une date précise, ou ramène une tâche en attente. | Repoussez une tâche que vous ne pouvez pas encore accomplir, ramène une tâche endormie plus tôt |
document360-mcp-mark-task-done |
Marque une de vos tâches de workflow comme terminée, de la même manière que sur la page Tâches : Marquez comme terminée. | Confirmez que vous avez terminé votre revue d’un article |
document360-mcp-update-feedback-status |
Met à jour le statut, l’assigné ou la note interne des retours des lecteurs qui vous sont attribués. Vous pouvez également informer le lecteur du changement. | Fermez un retour après avoir corrigé un article, donnez un retour à un coéquipier, ajoutez une note interne |
document360-mcp-send-article-feedback |
Envoie un retour sur un article publié à votre équipe de documentation, par exemple lorsque le contenu est peu clair, obsolète, manque d’informations, hors sujet ou comporte un lien défaillant. Le retour apparaît dans le gestionnaire de retours. | Signalez un problème trouvé dans un article en utilisant votre assistant IA |
- Les outils de glossaire ne sont disponibles que lorsque la fonctionnalité Glossaire est incluse dans le plan de votre projet.
document360-mcp-update-feedback-statusest disponible uniquement lorsque le gestionnaire de rétroaction est inclus dans le plan de votre projet. - Les termes du glossaire ne peuvent pas être supprimés via MCP, et vous ne pouvez pas déclencher la traduction du glossaire à partir de MCP. Pour les termes au niveau de la langue, ajoutez chaque langue séparément à l’aide
document360-mcp-update-glossary-termde . - Renommer un terme de glossaire ne met pas à jour les articles qui l’utilisent déjà.
document360-mcp-mark-task-donene modifie pas le statut du flux de travail. Pour déplacer l’article au statut suivant, utilisezdocument360-mcp-set-workflow-status.
Comptes lecteurs et critiques : Les outils MCP suivent le rôle et l’accès au contenu du compte connecté, de sorte que votre assistant IA ne peut effectuer que les actions que vous êtes autorisé à effectuer dans le portail.
- Les comptes lecteurs peuvent utiliser
document360-mcp-send-article-feedback, mais aucun autre outil d’écriture. Les lecteurs ne peuvent pas non plus utiliserdocument360-mcp-list-glossary-terms,document360-mcp-list-review-reminders, oudocument360-mcp-get-my-tasks. - Les comptes de critique ne peuvent pas utiliser
document360-mcp-create-glossary-term,document360-mcp-update-glossary-term,document360-mcp-set-article-review-reminder, oudocument360-mcp-update-feedback-status.
Limites de taux
Les requêtes MCP sont soumises à des limites de débit basées sur votre plan Document360. Des limites sont appliquées par utilisateur, par projet, sur tous les appels d’outils MCP dans une fenêtre fixe d’une minute. Les opérations de lecture et d’écriture partagent la même limite, donc recherche, récupération, création et mise à jour des appels tirent tous dans un même pool. La limite de taux dépend de votre plan : les projets business plan sont limités à 60 requêtes par minute par utilisateur et les projets Enterprise plan sont limités à 100 requêtes par minute par utilisateur.
Ces limites garantissent une performance fiable et une utilisation équitable dans les flux de travail de documentation. Si vous dépassez la limite de vitesse, les requêtes suivantes peuvent être limitées jusqu’au début de la prochaine fenêtre d’une minute.
Cela peut arriver lorsque :
- Exécution fréquente des invites automatisées
- Effectuer des recherches répétées en succession rapide
- Exécution simultanée de plusieurs opérations de création ou de mise à jour
Si votre flux de travail nécessite une limite plus élevée, contactez votre Customer Success Manager ou votre support@document360.com. Des limites plus élevées peuvent être configurées en fonction de vos besoins, et peuvent entraîner un coût supplémentaire.
Meilleures pratiques pour gérer les limites de demandes MCP
Pour éviter le throttling :
- Étalez les requêtes fréquentes ou automatisées
- Divisez les grands flux de travail en séquences d’invites plus petites
- Réutiliser le contexte de la catégorie ou de l’article récupéré lorsque possible
- Évitez les recherches parallèles répétées sur plusieurs versions
Cela permet de maintenir une expérience MCP plus fluide et réduit le risque d’interruptions du flux de travail.