ONLYOFFICE DocSpace MCP Server

官方

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

分类: 团队协作第 25 / 55
Stars: ★ 32 热门
传输方式: stdio（本地进程） · SSE · Streamable HTTP
运行环境: Docker · Node.js · 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 16 天前

55FMRS · C

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

最强项 · 文档质量 14/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

9/20

维护活跃度

11/20

文档质量

14/20

安装易用性

13/20

查看各项评分依据

可靠性 8/20: README 显示该服务器支持 stdio/SSE/Streamable HTTP 三种传输、四类认证方式，并链接到工具文档，说明其声明的能力面较完整且结构清晰。但所有判断仅来自 README 与本任务提供的元数据，未提供服务器清单、源码目录内容、CI 工作流或已提交测试，因此无法核实 MCP 初始化与 tool-list 握手、工具的真实行为与声明是否一致、错误处理与依赖可控性。按静态校准规则，在缺少可验证执行证据（真实 CI + 覆盖关键路径的测试）时可靠性不得超过 12；实际缺少任何测试与错误处理证据，故保守给 8 分。
安全与权限 9/20: README 提示本地示例通过环境变量注入 DOCSPACE_API_KEY，未在示例中硬编码真实密钥（属占位符），OAuth 2.0 与请求级认证头说明其具备凭据隔离思路；未发现恶意行为、隐蔽外传或未确认的危险默认操作线索，不触发红线。但仓库未提供权限范围、最小权限、删除/归档等破坏性操作是否需要确认、令牌存储与日志脱敏等细节，安全边界证据不完整，故扣分至 9。
维护活跃度 11/20: MIT 许可明确，仓库未归档，标注 0 个开放 issue，说明维护状态活跃、有明确的所有权（ONLYOFFICE 官方组织）；README 引用多年份的发布路径（Docker Hub、Docker MCP、npm、MCP bundle），具备分发与更新渠道。但缺少发布的版本号、提交频率、issue 响应时效、依赖更新策略与安全响应通道等证据，无法判断是否持续维护，故按中间偏上保守给 11。
文档质量 14/20: 文档层次较好：README 提供概览、功能、用例、远程与本地接入、环境变量说明，并链接至 docs 目录下的工具、全局配置、请求级配置、各客户端与分发文档，还给出工具与安装示例链接。不足在于所链接的文档内容不在本次提供材料中，无法核实工具参数、限制与故障排查细节；README 对错误处理与平台差异披露有限，故扣分至 14。
安装易用性 13/20: 安装路径清晰：给出主流客户端 JSON 配置模板（Docker 方式，含 mcpServers 结构与环境变量占位），并说明远程实例可直接连接，降低本地部署复杂度，另有 Docker/npm/MCP bundle 多种分发。但完整步骤依赖 Docker 或 Node 运行时、需自行生成 API key，且未提供可直接复制的多客户端示例与验证步骤；按静态校准，无执行证据时安装上限为 15，故保守给 13。

静态评测 · 未实际运行收录于 2026-09-10

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件访问网络修改第三方账户数据

适合谁

使用 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 托管，使用前应查阅其法律条款与隐私政策。
凭据以明文环境变量形式保存在客户端配置文件中，存在被本地读取的风险。

安装接入

准备工作

运行环境：Docker · Node.js · 远程托管（无需本地环境）

DOCSPACE_BASE_URL 必填你的 ONLYOFFICE DocSpace 实例 URL（例如 https://portal.onlyoffice.com）。

DOCSPACE_API_KEY 必填密钥在 DocSpace 设置 -> Developer Tools -> API keys 中生成的个人 API key。

找到客户端的 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 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "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"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add onlyoffice-docspace -e DOCSPACE_BASE_URL=https://your-instance.onlyoffice.com -e DOCSPACE_API_KEY=your-api-key -- docker run --interactive --rm --env DOCSPACE_BASE_URL --env DOCSPACE_API_KEY onlyoffice/docspace-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

按配置重启客户端后，在工具列表中应出现 DocSpace 工具；可让 AI "列出所有房间"，若返回实例中的房间数据即证明连接成功。

常见排障

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

试试这样问

连接成功后，可以直接对 AI 助手这样说：

创建一个新项目房间并邀请 Anna，赋予编辑权限。
把这个文件上传到 "My documents"。
列出所有房间及其访问级别。
列出门户里的所有人员。

使用场景

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

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

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

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

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

支持客户端

Claude Desktop

Cursor

Windsurf

依据项目文档列出，未经本站实测。

详细介绍

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），可免部署直接连接。