Connecting ONLYOFFICE DocSpace MCP Server to Claude Web
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 Claude: Oauth and URL Encoding Path and Query Parameters. The latter is used with MCP clients that do not allow you to pass custom headers. We recommend using OAuth authentication whenever possible.
To connect ONLYOFFICE DocSpace MCP Server to Claude:
- Access your Claude account and go to Settings.
- On the Settings page, go to Connectors and click the Add custom connector button.
OAuth Authentication
- Enter the connector name.
- Remote MCP server URL - enter the ONLYOFFICE MCP Server URL:
https://mcp.onlyoffice.com/mcp - Click the Add button to complete the authentication.
- Click the Connect button next to the newly added connector.
- Fill in your DocSpace login and password.
- Review the MCP server installation scope levels (local/project/user) for managing server accessibility and sharing, choose the right one, and click Allow.
- Wait for the redirect back to Claude.
URL Encoding Path and Query Parameters
- Enter the connector name.
- Remote MCP server URL - connect using URL-encoded credentials, ONLYOFFICE MCP server URL, and base URL in query parameters. You need to use URL-encoding for both your Docspace login and password to pass your credentials via the query parameters following the structure below:
https://your-url-encoded-login:your-encoded-password@mcp.onlyoffice.com/mcp?base_url=https://your-instance.onlyoffice.com/ - Click the Add button.
Using the ONLYOFFICE MCP Server
- After a successful authentication, the connector will be added to the list of the available connectors.
- Open the chat and give your prompt, click Always allow or Allow once to confirm the list of tools used to respond to your prompt.
