I. Introduction▲
ONLYOFFICE Desktop Editors prend en charge le protocole MCP (Model Context Protocol), permettant aux agents IA d’interagir avec des outils externes et des services distants. Cette fonctionnalité ouvre la voie à des scénarios avancés d’automatisation et d’intégration, notamment avec ONLYOFFICE DocSpace.
Ce guide explique pas à pas comment connecter le serveur MCP ONLYOFFICE DocSpace aux éditeurs de bureau afin de permettre aux agents IA d’accéder aux fichiers, espaces et opérations DocSpace directement depuis l’environnement desktop.
II. Qu’est-ce qu’un serveur MCP dans ONLYOFFICE Desktop Editors▲
Le Model Context Protocol (MCP) permet aux agents IA d’utiliser des outils qui ne sont pas limités à l’environnement local. Un serveur MCP expose un ensemble d’outils que l’agent peut appeler pour effectuer différentes actions : création et modification de fichiers, lecture de contenu, organisation de données ou interaction avec des services externes.
Dans ONLYOFFICE Desktop Editors, un agent IA peut utiliser :
- des outils locaux intégrés ;
- des outils fournis par des serveurs MCP externes, configurés via un fichier JSON.
Le serveur MCP ONLYOFFICE DocSpace permet à l’agent IA d’interagir directement avec une instance DocSpace : gérer des fichiers, accéder aux salles et effectuer des actions automatisées basées sur l’IA.
III. Prérequis▲
Avant de commencer, assurez-vous de disposer des éléments suivants :
- ONLYOFFICE Desktop Editors version 9.2 ou supérieure ;
- Un accès à une instance ONLYOFFICE DocSpace ;
- Une clé API valide pour DocSpace ;
- Un fournisseur d’IA configuré dans Desktop Editors (OpenAI, Anthropic, Ollama, TogetherAI ou OpenRouter).
L’onglet Serveurs MCP n’est disponible qu’après la configuration d’un fournisseur d’IA.
III-A. Étape 1 : ouvrir la configuration des serveurs MCP▲
Lancez ONLYOFFICE Desktop Editors et, dans la fenêtre de démarrage, accédez à :
Agent IA → Serveurs MCP
|
|
Dans cette section, cliquez sur Modifier la configuration. Un éditeur JSON s’ouvre et permet de définir un ou plusieurs serveurs MCP.
III-B. Étape 2 : ajouter la configuration du serveur MCP DocSpace▲
Dans l’éditeur JSON, ajoutez la configuration du serveur MCP ONLYOFFICE DocSpace.
|
|
Exemple de configuration utilisant Docker :
2.
3.
4.
5.
6.
7.
8.
9.
{
"mcpServers": {
"onlyoffice-docspace": {
"command": "docker",
"args": ["run", "--interactive", "--rm", "--env", "DOCSPACE_BASE_URL", "--env", "DOCSPACE_API_KEY", "onlyoffice/docspace-mcp"],
"env": {
"DOCSPACE_BASE_URL": "https://your-instance.onlyoffice.com",
"DOCSPACE_API_KEY": "your-api-key"
} } } }
Remplacez :
- DOCSPACE_BASE_URL par l’URL de votre instance DocSpace
- DOCSPACE_API_KEY par votre clé API DocSpace
Si vous utilisez Docker, celui-ci doit être installé et opérationnel sur votre système afin que le serveur MCP puisse démarrer correctement.
Une fois la configuration enregistrée, le serveur MCP ONLYOFFICE DocSpace apparaît dans la liste des serveurs disponibles.
|
|
III-C. Étape 3. Activer ou désactiver les outils MCP▲
Après avoir ajouté un serveur MCP, ses outils apparaissent dans la liste Outils disponibles.
Vous pouvez également activer ou désactiver chaque outil individuellement, activer tous les outils à la fois ou désactiver tous les outils à la fois. Les modifications sont appliquées instantanément, ce qui facilite le réglage précis de votre configuration IA.
IV. Utiliser le serveur MCP DocSpace dans Desktop Editors▲
Une fois la connexion établie, ouvrez le panneau de l’agent IA dans ONLYOFFICE Desktop Editors et saisissez vos instructions en langage naturel.
L’agent IA peut alors :
- utiliser automatiquement les outils MCP fournis par DocSpace ;
- interagir avec les fichiers et espaces DocSpace ;
- générer des résultats directement dans la fenêtre de discussion.
Dans l’interface de l’agent, vous pouvez :
- voir quels outils MCP ont été utilisés ;
- consulter les réponses générées par l’IA ;
- copier l’historique de la conversation ;
- enregistrer le résultat sous forme de fichier .docx sur votre machine.
|
|
V. Remarque importante▲
Le serveur MCP ONLYOFFICE DocSpace est actuellement en phase de prévisualisation. Bien qu’il soit fonctionnel, certaines fonctionnalités peuvent être incomplètes et des changements de compatibilité sont possibles. Il est recommandé de l’utiliser avec prudence dans des environnements de production.