Connecter le serveur MCP ONLYOFFICE Apps à OpenAI à l'aide d'en-têtes personnalisés

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é, pour rationaliser les flux de travail pilotés par l'intelligence artificielle, la gestion des documents et des tâches et pour 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 moderne Streamable et à l'adresse https://mcp.onlyoffice.com/sse pour les clients qui prennent en charge uniquement le transport SSE hérité. Nous vous recommandons d'utiliser le transport HTTP Streamable à chaque fois que possible.

Ces instructions montrent comment connecter un client MCP à un serveur MCP distant en utilisant des en-têtes personnalisés, à condition qu'un tel client vous permette de transmettre des en-têtes personnalisés. N'utilisez cette méthode d'authentification que si vous ne pouvez pas utiliser OAuth pour une raison quelconque, car cette méthode est moins sécurisée.

Pour connecter le serveur MCP ONLYOFFICE Apps à la plateforme OpenAI :

1. Générez votre propre clé API. La méthode d'authentification par en-têtes personnalisés est moins sécurisée comparée à OAuth, par conséquent il n'est pas conseillé d'utiliser les clés API du propriétaire ou du gestionnaire de salle. Pour générer une clé API, accédez à votre espace de travail ONLYOFFICE 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.

   

2. Accédez à votre compte OpenAI et lancez une conversation dans Chat.

3. Recherchez l'option Tools (Outils) et cliquez sur le bouton Add (Ajouter).

   

4. Dans la fenêtre qui s'ouvre, cliquez sur Server (Serveur) dans le coin supérieur droit.

   

5. Renseignez les paramètres requis du serveur MCP :

   

   • URL :

     https://mcp.onlyoffice.com/mcp

   • Label (Étiquette) – renseignez le nom pour distinguer le serveur MCP.

   • Description – donnez une courte description du serveur MCP afin d'améliorer l'identification du serveur. C'est un paramètre facultatif.

   • Authentification – définissez la méthode d'authentification et les paramètres. Choisissez En-têtes personnalisés dans la liste déroulante et utilisez votre clé API et l'URL de base de votre espace de travail ONLYOFFICE Apps pour vous connecter. Renseignez les champs qui s'ouvrent comme suit :

     X-Mcp-Base-Url: https://your-instance.onlyoffice.com/
     X-Mcp-Api-Key: sk-a499e...

     X-Mcp-Base-Url – l'adresse web de votre espace de travail ONLYOFFICE Apps pour que le serveur MCP se connecte à la bonne instance.

     X-Mcp-Api-Key – la clé API qui a été générée comme décrit à l'étape 1 ci-dessus pour autoriser l'accès du serveur MCP à ONLYOFFICE Apps.

     

6. Cliquez sur Connect (Connecter) et attendez que la connexion s'établisse.

7. Une fois le serveur MCP connecté, la liste des outils du serveur MCP s'affiche. Choisissez les outils nécessaires ou choisissez tous, et cliquez sur le bouton Add (Ajouter) en bas de la liste.

   

8. Utilisez le chat OpenAI avec les outils du serveur MCP ONLYOFFICE Apps connectés. Saisissez votre requête, cliquez sur Approve (Valider) pour confirmer la liste des outils utilisés pour répondre à votre requête.