Connecting ONLYOFFICE DocSpace MCP Server to Mistral

Introduction

The ONLYOFFICE DocSpace MCP Server is a tool for managing the interaction with language models tailored to enhance efficiency, to streamline the AI-driven workflows, document and task management and to bring out the full potential of the ONLYOFFICE DocSpace.

The ONLYOFFICE DocSpace MCP Server may be connected to clients that support connection to the MCP servers running on a remote machine.

The public instance is available at https://mcp.onlyoffice.com/mcp for clients that support modern Streamable HTTP transport and at https://mcp.onlyoffice.com/sse for clients that support only the legacy SSE transport. We recommend that you use the Streamable HTTP transport whenever possible.

The following two authentication methods can be used to connect the ONLYOFFICE DocSpace MCP Server to Mistral: OAth and API Token Authentication. The latter is used with clients that allow you to pass the configuration in custom headers and quiery prameters. We recommend using OAuth authentication whenever possible.

Oath Authentication

1. Type in the connector name.
   
2. Connector Server - paste the ONLYOFFIVE MCP Server URL:

   https://mcp.onlyoffice.com/mcp

3. Description – give a short desription for the MCP Server to improve the server identificaton. It’s an optional parameter.
4. Authorization Method - choose the Oath2.1 as a method of authorization for the DocSpace MCP Server and click Connect.
5. Complete the OAuth authentication process
   • Fill in your DocSpace credentials.
     
   • Allow the MCP Remote Server to access your DocSpace account.
     

API Token Authentication

Use this authentication method if only you cannot use OAuth for some reason since it's less secure. This method allows you to connect the MCP server using the API key in default header and the base URL in query parameter.

1. Generate your own DocSpace api key. It's not advisable to use the Owner's or the Room Manager's API keys. To generate an API key, go to your DocSpace. Click the Developer Tools tab in the left panel. Choose the API keys tab on top and click the Create new secret key button. Copy the generated key.
   
2. Type in the connector name.
3. Connector Server - add the base URL of your DocSpace instance to the ONLYOFFICE DocSpace MCP Server URL, and pass it via query parameters following the structure below:

   https://mcp.onlyoffice.com/mcp?base_url=https://your-instance.onlyoffice.com
           

4. Description – give a short desription for the MCP Server to improve the server identificaton. It’s an optional parameter.
5. Authorization Method - choose the API Token Authentification as a method of authorization for the DocSpace MCP Server.
   Default header - add your DocSpace API key to the Authorization header as a Bearer token. It's a mandatory parameter since this header is used to authorize requests to DocSpace.

   Authorization: Bearer sk-a499e...
           

6. Click Create to add the DocSpace MCP Server to Mistral connectors.

Using the ONLYOFFICE MCP Server

• After a successful authentication, DocSpace connector appears among the available connectors.
  
• Click it to to display the connector overview and functions. The Overview tab gives the description of the connector you provided upon the setup, and the possibility to delete the connector clicking the ellipsis.
  
• The Functions tab allows you to scroll through the available tools, and to enable the necessary ones.
  
• Open the chat and give your prompt. In the Connectors list, make sure DocSpace (or the name you assigned to it) is selected.
• Click Continue to confirm the list of tools used to respond to your prompt.