I. Introduction▲
Le serveur MCP de ONLYOFFICE DocSpace permet d’intégrer des modèles linguistiques (LLM) dans des workflows documentaires grâce au Model Context Protocol (MCP). Il sert d’intermédiaire entre les LLM et votre instance DocSpace, en facilitant la gestion de fichiers, d’utilisateurs, de salles et l’automatisation des tâches.
Ce guide présente :
- les bases du serveur MCP,
- son installation,
- sa configuration via variables d’environnement,
- les outils disponibles,
- les options avancées,
- et les notions de sécurité et de licence.
II. À propos du serveur MCP DocSpace▲
Le serveur MCP de ONLYOFFICE DocSpace est un outil de gestion de l’interaction entre les modèles linguistiques et les systèmes externes, spécialement conçu pour les flux de gestion de documents au sein de l’écosystème ONLYOFFICE.
Il comble le fossé en normalisant la communication par le biais de MCP, ce qui rend les tâches complexes telles que la manipulation des fichiers, la gestion des utilisateurs et les mises à jour de l’espace de travail intuitives et fiables. En mettant en œuvre des outils qui améliorent la collaboration, l’automatisation et l’intégration, il devient un élément indispensable de toute installation assistée par l’IA.
Au-delà de la rationalisation de cette interaction, le serveur MCP garantit une grande flexibilité des intégrations, permettant aux entreprises d’adapter les solutions à leurs besoins tout en exploitant le plein potentiel des fonctionnalités de ONLYOFFICE DocSpace.
III. Avantages du serveur MCP DocSpace▲
- Flux de documents rationalisés. Automatisez les tâches telles que le téléchargement de fichiers, la création de dossiers ou l’organisation de documents.
- Collaboration réalisée. Améliorez la collaboration au sein de l’équipe grâce à des outils robustes qui intègrent les LLM dans vos espaces de partage de documents.
- Communication unifiée. Créez des processus cohérents en intégrant vos outils pilotés par l’IA directement dans les flux de documents, sans redondance.
- Sécurité et conformité. Exploitez les fonctions d’authentification et les clés API pour garantir des interactions sécurisées à chaque étape du processus.
IV. Installation▲
L’installation repose sur le fichier de configuration JSON utilisé par le client MCP de votre choix (ex. Claude Desktop).
2.
3.
4.
5.
6.
7.
8.
9.
{
"mcpServers": {
"onlyoffice-docspace": {
"env": {
"DOCSPACE_BASE_URL": "https://your-instance.onlyoffice.com",
"DOCSPACE_API_KEY": "your-api-key"
}, "command": "npx",
"args": ["--yes", "@onlyoffice/docspace-mcp"]
} } }
V. Configuration▲
Le serveur MCP de ONLYOFFICE DocSpace s’appuie uniquement sur les variables d’environnement pour sa configuration. Elles dictent la façon dont il interagit avec votre instance et assurent la flexibilité pour différents cas d’utilisation. Voici quelques-unes des variables de configuration clés :
DOCSPACE_BASE_URL
L’URL de base où réside votre instance DocSpace. Cette information est essentielle pour toutes les demandes d’API.
DOCSPACE_API_KEY
La clé API unique nécessaire pour une communication sécurisée avec DocSpace.
DOCSPACE_AUTH_TOKEN
Jeton d’authentification pour l’API DocSpace.
DOCSPACE_TRANSPORT
Le protocole de transport à utiliser pour la communication avec le serveur MCP DocSpace.
Les variables permettent d’adapter le serveur aux besoins de votre organisation. Par exemple, si vous souhaitez rationaliser les intégrations LLM, vous pouvez explicitement configurer des jetons pour éviter les authentifications manuelles répétées.
VI. Comment utiliser le serveur MCP DocSpace▲
Le serveur MCP de ONLYOFFICE DocSpace met en œuvre le concept d’outils du protocole Model Context Protocol. Ils offrent un ensemble prédéfini de commandes que vous pouvez utiliser pour effectuer des actions spécifiques sur vos documents et espaces.
En outre, il existe des ensembles d’outils, qui regroupent des outils connexes. Ils comprennent des fichiers, des dossiers, des personnes et des salles. Par défaut, tous les ensembles d’outils et leurs outils sont disponibles sur le serveur. Cependant, vous pouvez personnaliser cette configuration à l’aide des options suivantes : DOCSPACE_TOOLSETS, DOCSPACE_ENABLED_TOOLS et DOCSPACE_DISABLED_TOOLS. Découvrir comment configurer
Voici un aperçu des outils :
create_folder : Créez rapidement des dossiers pour structurer votre espace.
get_file_info : Retrouvez des métadonnées et des informations spécifiques sur un fichier.
upload_file : Téléchargez de nouveaux documents dans DocSpace en toute transparence.
create_room : Mettez en place des salles de collaboration adaptées à des projets spécifiques.
set_room_security : Contrôlez l’accès des utilisateurs pour une sécurité accrue.
archive_room : Archivez les salles qui ne sont plus utilisées.
20 outils sont disponibles au total, couvrant la gestion des fichiers, utilisateurs, salles, recherches, etc.
Par exemple, imaginez que votre équipe doive archiver les dossiers de projets terminés après la fin d’un projet. L’outil archive_room vous permet d’automatiser ce processus pour un espace donné. De même, vous pouvez télécharger par lots de nouveaux documents de projet pour votre prochaine campagne en une seule commande à l’aide de upload_file.
VII. Meta Tools (outils dynamiques)▲
Si vous activez DOCSPACE_DYNAMIC, le serveur regroupe tous les outils en Meta Tools.
Cela permet à un LLM de :
- découvrir les outils à la volée,
- interagir dynamiquement sans tout charger en même temps,
- simplifier les intégrations complexes.
VIII. Sécurité et licences▲
Le serveur MCP est distribué sous licence Apache-2.0, garantissant :
- transparence,
- modification libre,
- redistribution autorisée.
Les communications avec DocSpace sont sécurisées par clé API et jetons d’authentification.
Remarque
Ce serveur MCP de ONLYOFFICE DocSpace est actuellement en phase de prévisualisation. Bien qu’il soit fonctionnel, il peut comporter des fonctionnalités incomplètes, des bogues potentiels ou subir des modifications importantes. Utilisez-le avec prudence dans les environnements de production, car les mises à jour peuvent avoir un impact sur la compatibilité.
IX. Conclusion▲
Le serveur MCP de ONLYOFFICE DocSpace offre une intégration puissante entre les LLM et les workflows documentaires. Il permet d’automatiser les processus, d’améliorer la collaboration et d’exploiter pleinement les fonctionnalités DocSpace grâce à une passerelle unifiée basée sur MCP.
Il constitue une base solide pour toute équipe souhaitant construire des workflows intelligents intégrant IA et cloud.