Aller au contenu principal

Connecter le serveur MCP ONLYOFFICE Apps à Claude Desktop

Introduction​

Le serveur MCP ONLYOFFICE Apps est un outil pour gérer l'interaction avec les modèles de langage conçu pour améliorer l'efficacité, rationaliser les flux de travail pilotés par l'IA, la gestion des documents et des tâches et exploiter pleinement le potentiel d'ONLYOFFICE Apps.

Le serveur MCP ONLYOFFICE Apps peut être connecté aux clients qui prennent en charge la connexion aux serveurs MCP fonctionnant sur une machine distante.

L'instance publique est disponible à l'adresse https://mcp.onlyoffice.com/mcp pour les clients qui prennent en charge le transport HTTP Streamable moderne et à https://mcp.onlyoffice.com/sse pour les clients qui prennent en charge uniquement le transport SSE hérité. Nous recommandons d'utiliser le transport HTTP Streamable dans la mesure du possible.

Le serveur MCP ONLYOFFICE Apps peut être connecté à Claude Desktop de trois façons différentes :

  1. Connector (Connecteur) – la méthode de connexion recommandée, qui convient à la plupart des utilisateurs ;
  2. Extension – permet de se connecter au serveur MCP fonctionnant en local à l'aide d'un pack MCP ;
  3. Local MCP (Serveurs MCP locaux) – convient aux configurations avancées et aux développeurs qui souhaitent utiliser Docker et les fichiers de configuration.

Tout d'abord, téléchargez et installez Claude Desktop pour votre système d'exploitation. Claude Desktop est disponible pour macOS et Windows. Si Claude Desktop est déjà installé, vérifiez la version que vous utilisez. Cliquez sur le menu Claude Desktop et sélectionnez Check for Updates (Vérifier les mises à jour).

Connecteur​

  1. Ouvrez Claude Desktop.

  2. Accédez au menu et sélectionnez Settings (Paramètres).

  3. Sur la page Settings (Paramètres), passez à Connectors (Connecteurs) et cliquez sur Add (Ajouter) -> Add custom connector (Ajouter un connecteur personnalisé).

    Claude Connector

  4. Saisissez le nom du connecteur (par exemple, « ONLYOFFICE Apps MCP »).

  5. Saisissez l'URL de connexion :

    https://mcp.onlyoffice.com/mcp

  6. Cliquez sur Add (Ajouter).

    Claude Connector

  7. Cliquez sur Connect (Connecter) à côté du connecteur que vous venez d'ajouter.

  8. Terminez le processus d'authentification OAuth.

Extension​

Claude Desktop Extensions est une autre façon de se connecter au serveur MCP fonctionnant en local.

Le serveur MCP nécessite Node.js. Assurez-vous d'utiliser Node.js version 18 ou ultérieure, puis téléchargez le fichier mcpb depuis GitHub Releases. Si Node.js n'est pas installé, accédez à nodejs.org pour le télécharger.

  1. Ouvrez Claude Desktop.

  2. Accédez au menu et sélectionnez Settings (Paramètres).

  3. Sur la page Settings (Paramètres), passez à Extensions et cliquez sur Advanced settings (Paramètres avancés).

    Extension Claude

  4. Cliquez sur Install extension (Installer l'extension).

    Extension Claude

  5. Sélectionnez le fichier du pack MCP que vous avez téléchargé.

    Extension Claude

Serveurs MCP locaux​

Claude Local MCP servers (Serveurs MCP locaux Claude) est la troisième façon de se connecter au serveur MCP fonctionnant localement.

Assurez-vous que Docker est installé et fonctionne sur votre système.

Générez une clé API Apps. Cliquez sur l'onglet Outils de développement dans le panneau de gauche, que vous pouvez ouvrir depuis la bannière située en bas de la barre latérale gauche. Choisissez l'onglet Clés API en haut et cliquez sur le bouton Créer une nouvelle clé secrète. Copiez la clé générée.

  1. Ouvrez Claude Desktop.

  2. Accédez au menu et sélectionnez Settings (Paramètres).

  3. Sur la page Settings (Paramètres), naviguez vers l'onglet Developer (Développeur) dans la barre latérale gauche.

  4. Cliquez sur le bouton Edit config (Modifier la config).

    Serveurs MCP locaux Claude

  5. Ouvrez le fichier de configuration dans un éditeur de texte. Le chemin du fichier :

    • Sur macOS :

      ~/Library/Application Support/Claude/claude_desktop_config.json

    • Sur Windows :

      %APPDATA%\Claude\claude_desktop_config.json

  6. Ajoutez la structure JSON suivante :

    {
      "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"
          }
        }
      }
    }
    • DOCSPACE_BASE_URL – l'URL de votre instance ONLYOFFICE Apps
    • DOCSPACE_API_KEY – votre clé API personnelle qui a été générée conformément aux instructions ci-dessus
    • command: "docker" – la commande utilisée pour lancer le serveur MCP via Docker
    • onlyoffice/docspace-mcp – l'image Docker du serveur MCP

  7. Enregistrez le fichier, ensuite quittez complètement Claude Desktop et relancez-le.

Utiliser le serveur MCP ONLYOFFICE Apps​

  • Après une authentification réussie, ouvrez le chat et donnez votre instruction, cliquez sur Always allow (Toujours autoriser) ou Allow once (Autoriser une fois) pour confirmer la liste des outils utilisés pour répondre à votre instruction.

    Approuver les outils