ONLYOFFICE DocSpace MCP Server

ONLYOFFICE Apps MCP Server

Model Context Protocol（MCP）是一种标准化协议，用于管理大语言模型（LLM）与外部系统之间的上下文。本仓库提供 ONLYOFFICE Apps 的 MCP 服务。

ONLYOFFICE Apps MCP Server 可将 AI 工具直接连接到 ONLYOFFICE Apps。借助它，AI Agent、助手和聊天机器人可以通过自然语言交互管理房间、协作处理文件、管理权限并自动化文档工作流。

功能

• 精细控制工具 - 可访问按逻辑工具集组织的工具，并支持精细的启用／禁用控制和元工具。
• 多种传输协议 - 支持 stdio、SSE 和 Streamable HTTP 传输方式。
• 多种身份验证方式 - 支持 API 密钥、个人访问令牌、基本身份验证，以及支持动态客户端注册的 OAuth 2.0。请参阅示例。
• 请求级配置 - 在会话初始化期间，使用自定义 HTTP 标头配置身份验证和工具选择。
• 多种分发格式 - 提供 Docker 镜像、Docker MCP Server、MCP bundle 和 Node.js 应用程序。

使用场景

• 房间管理：创建、更新和归档房间。配置房间类型、管理成员资格并控制访问级别。
• 文件夹和文件操作：创建文件夹、上传文档、批量复制或移动项目、重命名或删除内容，并查看文件或文件夹详情。
• 协作和权限：邀请或移除用户、调整安全设置，并查看房间和共享空间的当前访问权限。
• 内容访问：获取“我的文档”或“房间”文件夹、查看文件夹内容、以文本形式下载文件，并监控正在进行的文件操作。
• 人员目录：列出工作区中的所有人员，以简化邀请和访问管理。

将客户端连接到 ONLYOFFICE Apps MCP Server

你可以使用任何 MCP 客户端连接到 ONLYOFFICE Apps MCP 服务。我们介绍了一些常用客户端，例如 Claude Desktop、Cursor、Devin Desktop 等，你可以在此处了解详情。

远程 ONLYOFFICE Apps MCP Server

远程 ONLYOFFICE Apps MCP Server 由 ONLYOFFICE 托管，可让你最快地开始在 AI Agent 中使用 ONLYOFFICE Apps 工具。你无需在设备上部署或配置任何内容，即可立即连接。

支持现代 Streamable HTTP 传输方式的客户端可通过 https://mcp.onlyoffice.com/mcp 访问公共实例；仅支持旧版 SSE 传输方式的客户端可通过 https://mcp.onlyoffice.com/sse 访问。建议尽可能使用 Streamable HTTP 传输方式。

请在此处查看连接客户端到远程 ONLYOFFICE Apps MCP Server 的所有选项。

本地 ONLYOFFICE Apps MCP Server

如果你的 MCP 主机不支持远程 MCP 服务，可以改为运行 ONLYOFFICE Apps MCP Server 的本地版本。

大多数实现了 MCP 协议的客户端都有通用的 JSON 格式配置文件，你可以在其中添加 ONLYOFFICE Apps MCP Local Server。

注意：以下通用示例适用于 Docker 镜像，因此你的系统必须安装 Docker。

步骤 1. 找到配置文件

找到客户端的 .json 配置文件。

步骤 2. 添加 ONLYOFFICE Apps MCP 服务条目

将以下代码块插入 .json 配置文件的 mcpServers 部分：

{
  "mcpServers": {
    "onlyoffice-apps": {
      "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"
      }
    }
  }
}

步骤 3. 设置环境变量

• DOCSPACE_BASE_URL - ONLYOFFICE Apps 实例的 URL（例如 https://your-instance.onlyoffice.com）。
• DOCSPACE_API_KEY - 在 ONLYOFFICE Apps 的 开发者工具 → API 密钥中生成的个人 API 密钥（从左侧边栏底部的横幅打开开发者工具）。

所有可用参数均列于此处。

步骤 4. 重启客户端

关闭并重新打开客户端。在大多数情况下，ONLYOFFICE Apps MCP 服务会自动启动，你就可以发出如下自然语言命令：

• 创建一个新项目空间，并邀请 Anna，授予其编辑权限。
• 将此文件上传到“我的文档”。

工具

ONLYOFFICE Apps MCP 服务实现了 [MCP 规范]中描述的工具概念。

所有 ONLYOFFICE Apps MCP 服务工具的介绍见此处。

文档

文档位于 docs 目录中。

示例

以下[示例]展示了如何使用 ONLYOFFICE Apps MCP 服务。

隐私政策

相关政策见[法律条款]和[隐私政策]。

许可证

ONLYOFFICE Apps MCP 服务依据 MIT 许可证分发，许可证内容见 LICENSE 文件。