ONLYOFFICE DocSpace MCP Server

官方

将 AI 智能体直接连接到 ONLYOFFICE DocSpace，用自然语言管理房间、文件与权限。

★ 29 Stars 分类 · 团队协作热门

55FMRS · C

由 ONLYOFFICE 官方维护的 DocSpace MCP 服务器，把 AI 客户端直接接入 DocSpace，支持房间、文件、权限与人员管理，提供 stdio/SSE/Streamable HTTP 三种传输、多种认证方式以及托管远程实例，采用 MIT 许可证。适合希望用自然语言自动化文档协作流程的 DocSpace 用户，但需妥善保管凭据并谨慎对待批量破坏性操作。

可靠性

8/20

安全与权限

9/20

维护活跃度

11/20

文档质量

14/20

安装易用性

13/20

查看 FMRS 评分方法 →

ONLYOFFICE DocSpace MCP Server 是 ONLYOFFICE 官方基于 Model Context Protocol 实现的服务器，把 AI 工具直接接入 ONLYOFFICE DocSpace。它让 AI 智能体、助手和聊天机器人能够管理房间、协作处理文件、处理权限，并自动化文档工作流，全部通过自然语言交互完成。服务器支持 stdio、SSE 和 Streamable HTTP 三种传输协议，支持 API 密钥、Personal Access Token、Basic 认证以及带动态客户端注册的 OAuth 2.0，并可通过自定义 HTTP 头在会话初始化时进行请求级配置。它提供按工具集划分、可精细启用/禁用的工具与元工具，并以 Docker 镜像、Docker MCP Server、MCP bundle 和 Node.js 应用等多种形式分发。ONLYOFFICE 还托管了远程实例（https://mcp.onlyoffice.com/mcp 和 https://mcp.onlyoffice.com/sse），可免部署直接连接。

安装接入

找到客户端的 JSON 配置文件。
在 mcpServers 段中加入 onlyoffice-docspace 条目：command 为 docker，args 为 run --interactive --rm --env DOCSPACE_BASE_URL --env DOCSPACE_API_KEY onlyoffice/docspace-mcp（需已安装 Docker）。
设置环境变量：DOCSPACE_BASE_URL 为你的 DocSpace 实例 URL，DOCSPACE_API_KEY 为在 DocSpace 设置 -> 开发者工具 -> API 密钥中生成的个人 API 密钥。
重启客户端，服务器通常会自动启动，即可输入自然语言命令，例如“创建一个新的项目房间并邀请 Anna 作为编辑者”。

或者直接连接 ONLYOFFICE 托管的远程服务器：支持 Streamable HTTP 的客户端使用 https://mcp.onlyoffice.com/mcp，仅支持旧版 SSE 的客户端使用 https://mcp.onlyoffice.com/sse。

claude_desktop_config.json

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

生成并校验客户端配置

选型与风险

适合谁

使用 Claude Desktop、Cursor、Windsurf 等 MCP 客户端并希望用自然语言操作 ONLYOFFICE DocSpace 的用户。
需要在 AI 工作流中自动化房间、文档和权限管理的团队。
希望免部署、直接使用 ONLYOFFICE 托管远程 MCP 服务器的用户。
需要请求级认证与工具选择等灵活配置的集成场景。

不适合谁

未使用 ONLYOFFICE DocSpace 或不打算接入其门户的用户。
希望完全在本地离线运行、不接受任何外部服务的环境。
只想管理非 DocSpace 文档系统（如其他云盘或本地文件系统）的用户。

所需权限

需要 DocSpace 实例的访问地址（DOCSPACE_BASE_URL）。
需要 DocSpace 凭据：API 密钥、Personal Access Token、Basic 认证或 OAuth 2.0。
凭据可通过环境变量或客户端配置传入。
可通过自定义 HTTP 头在会话初始化时按请求配置认证与工具选择。

风险与副作用

API 密钥或 Token 泄露会让持有者以你的身份操作 DocSpace 内容。
AI 代理可能误删、误改文件或权限，尤其是批量操作（复制、移动、删除、归档房间）时。
远程 MCP 服务器由 ONLYOFFICE 托管，使用前应查阅其法律条款与隐私政策。
凭据以明文环境变量形式保存在客户端配置文件中，存在被本地读取的风险。

常见排障

确认 DOCSPACE_BASE_URL 指向正确的 DocSpace 实例（如 https://portal.onlyoffice.com）。
确认 DOCSPACE_API_KEY 是在 DocSpace 设置 -> 开发者工具 -> API 密钥中生成的且未过期。
确认本地版已安装并运行 Docker，且镜像 onlyoffice/docspace-mcp 可正常拉取。
使用远程服务器时，检查客户端是否支持 Streamable HTTP；仅支持 SSE 时改用 /sse 端点。
修改配置后重启客户端，确认服务器已随客户端自动启动。
工具不可用时检查是否被工具集或 meta tool 设置禁用。

使用场景

房间管理：创建、更新和归档房间，配置房间类型，管理成员资格和访问级别。

文件夹与文件操作：创建文件夹、上传文档、批量复制或移动项目、重命名或删除内容、查看文件或文件夹详情。

协作与权限：邀请或移除用户、调整安全设置、查看房间和共享空间的当前访问权限。

内容访问：获取“我的文档”或“房间”文件夹、读取文件夹内容、以文本形式下载文件、监控正在进行的文件操作。

人员目录：列出门户中的所有人员，简化邀请和访问管理。

支持客户端

Claude Desktop完整支持

Cursor完整支持

Windsurf完整支持