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.
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.
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, sensible à la casse, 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 |
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 |
Limites de taux
Les requêtes MCP sont soumises à des limites de débit basées sur votre plan Document360. Les 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, recherche, récupération, création et mise à jour des appels sont tous tirés d’un même pool. Selon votre forfait, la limite de débit est de 60 ou 100 requêtes par minute.
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.