Skip to main content

Connecting MCP servers

ONLYOFFICE Desktop Editors version 9.2 and later supports connecting MCP (Model Context Protocol) servers to extend AI capabilities with custom tools and integrations. MCP allows AI agents to interact with various services and data sources through standardized protocols.

AI Agent capabilities​

The AI agent in Desktop Editors provides several powerful features:

  1. Chat interface - Natural language interaction with documents and data
  2. Web search - Integrated web search capabilities for real-time information
  3. MCP servers - Connect custom or community MCP servers for extended functionality
  4. Built-in tools - Desktop Editors includes native tools for document operations (generation, forms, presentations)

Viewing available tools​

To see all available tools (both built-in and MCP):

Method 1: Console command

Open the browser console in Desktop Editors and execute:

JSON.parse(AscDesktopEditor.getToolFunctions());

This returns an object with descriptions of all available functions.

Method 2: Source code

View the built-in tool definitions in the Desktop SDK repository.

Each folder (except internal) contains a JSON file with function descriptions.

Prerequisites​

Before connecting MCP servers, ensure you have:

  • ONLYOFFICE Desktop Editors version 9.2 or higher
  • A configured AI provider (OpenAI, Anthropic Claude, or other supported LLM)
  • Required dependencies for the MCP server (e.g., Docker, Node.js, or Python)

Important: The MCP Servers tab only appears after establishing an AI connection in Desktop Editors.

Configuration steps​

Follow these steps to connect an MCP server to Desktop Editors:

Step 1: Access MCP configuration​

  1. Open ONLYOFFICE Desktop Editors
  2. Navigate to the start window
  3. Go to AI agent → MCP Servers section
  4. Click Edit configuration to open the JSON editor

Step 2: Add server configuration​

Enter your MCP server configuration in JSON format. The configuration structure depends on how the server is launched:

{
  "mcpServers": {
    "server-name": {
      "command": "docker",
      "args": [
        "run",
        "--interactive",
        "--rm",
        "--env", "VARIABLE_NAME",
        "--env", "API_KEY",
        "docker-image-name"
      ],
      "env": {
        "VARIABLE_NAME": "value",
        "API_KEY": "your-api-key"
      }
    }
  }
}
note

Docker must be installed and running.

Configuration parameters​

ParameterTypeDescription
mcpServersobjectRoot object containing all MCP server configurations.
server-nameobjectUnique identifier for the MCP server. Replace with your server's name (e.g., "onlyoffice-docspace").
commandstringCommand to launch the MCP server (e.g., "docker", "node", "python").
argsarrayArray of command-line arguments passed to the command.
envobjectEnvironment variables required by the MCP server (e.g., API keys, URLs).

Practical examples​

ONLYOFFICE DocSpace MCP​

Connect to DocSpace for document management operations:

{
  "mcpServers": {
    "onlyoffice-docspace": {
      "env": {
        "DOCSPACE_BASE_URL": "https://your-docspace-instance.onlyoffice.com",
        "DOCSPACE_API_KEY": "your-api-key-here"
      },
      "command": "npx",
      "args": [
        "--yes",
        "@onlyoffice/docspace-mcp"
      ]
    }
  }
}

Local custom MCP server​

Run a custom Node.js MCP server from your local machine:

{
  "mcpServers": {
    "mcp_local": {
      "command": "node",
      "args": [
        "D:/MCP_EXAMPLE/index.js"
      ]
    }
  }
}
tip

To create your own custom MCP server:

  1. Install Node.js on your system
  2. Create a new directory for your MCP server
  3. Run npm install to install dependencies
  4. Implement your custom tools following the MCP protocol
  5. Reference the path to your server's entry point in the configuration

Multiple MCP servers​

Configure multiple servers simultaneously:

{
  "mcpServers": {
    "mcp_local": {
      "command": "node",
      "args": [
        "D:/MCP_EXAMPLE/index.js"
      ]
    },
    "onlyoffice-docspace": {
      "env": {
        "DOCSPACE_BASE_URL": "https://your-docspace-instance.onlyoffice.com",
        "DOCSPACE_API_KEY": "your-api-key-here"
      },
      "command": "npx",
      "args": [
        "--yes",
        "@onlyoffice/docspace-mcp"
      ]
    }
  }
}
note

When configuring multiple servers, separate each server configuration with a comma.

Step 3: Save and enable tools​

  1. After entering the configuration, click Save
  2. The server will appear in your MCP servers list
  3. Enable or disable individual tools provided by the server
  4. You can also manage all tools at once using the toggle controls

Step 4: Use the MCP server​

Once connected and enabled:

  1. Open the AI agent panel in Desktop Editors
  2. Type natural language commands that correspond to the server's capabilities
  3. The AI agent will automatically utilize the available MCP tools
  4. Results are displayed directly in the chat interface
  5. You can copy conversations or save them as .docx files

Available MCP servers​

Desktop Editors supports various MCP servers that extend AI capabilities:

  • ONLYOFFICE DocSpace - Connect to DocSpace for document management
  • Community MCP servers - Any MCP-compatible server following the protocol specification

Troubleshooting​

Common issues and solutions:

  • MCP Servers tab not visible: Ensure you have configured an AI provider connection first
  • Server fails to start: Check that all required dependencies are installed and running
  • Authentication errors: Verify that API keys and credentials in the env section are correct
  • Tools not appearing: Restart Desktop Editors after saving the configuration

Notes​

  • MCP server support is currently in preview and may undergo changes in future versions
  • Server configurations are stored locally on your machine
  • Each server runs in its own process and communicates via the Model Context Protocol
  • Multiple MCP servers can be configured simultaneously