ONLYOFFICE DocSpace MCP 服务器

Model Context Protocol (MCP) 是一种用于管理大型语言模型 (LLM) 与外部系统之间上下文的标准化协议。本仓库为 ONLYOFFICE DocSpace 提供了一个 MCP 服务器。

DocSpace MCP 服务器将 AI 工具直接连接到 ONLYOFFICE DocSpace。这使得 AI 智能体、助手和聊天机器人能够通过自然语言交互来管理房间、协作处理文件、处理权限并自动化文档工作流。

功能特性

• 具有细粒度控制的工具 - 可访问 tools，这些工具被组织成逻辑工具集，支持精细的启用/禁用功能以及元工具。

• 多种传输协议 - 支持 stdio、SSE 和 Streamable HTTP transports。

• 不同的身份验证方法 - 支持 API 密钥、个人访问令牌、基本身份验证以及具有动态客户端注册的 OAuth 2.0。请参阅 examples。

• 请求级配置 - 在会话初始化期间使用 custom HTTP headers 配置身份验证和工具选择。

• 多种分发格式 - 可作为 Docker image、Docker MCP Server、MCP bundle 和 Node.js application 使用。

Related MCP server: LibreOffice MCP Tools

使用场景

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

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

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

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

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

将客户端连接到 DocSpace MCP 服务器

您可以使用任何 MCP 客户端连接到 DocSpace MCP 服务器。我们已经涵盖了一些流行的客户端，例如 Claude Desktop、Cursor、Windsurf 等，您可以在 这里 阅读相关内容。

远程 DocSpace MCP 服务器

远程 DocSpace MCP 服务器由 ONLYOFFICE 托管，是在 AI 智能体中使用 DocSpace 工具的最快方式。您可以立即连接到它，而无需在您的机器上进行部署或配置。

对于支持现代 Streamable HTTP 传输的客户端，公共实例位于 https://mcp.onlyoffice.com/mcp；对于仅支持旧版 SSE 传输的客户端，公共实例位于 https://mcp.onlyoffice.com/sse。尽可能优先使用 Streamable HTTP 传输。

查看将客户端连接到远程 DocSpace MCP 服务器的所有选项 这里。

本地 DocSpace MCP 服务器

如果您的 MCP 主机不支持远程 MCP 服务器，您可以运行 本地版本 的 DocSpace MCP 服务器。

大多数实现 MCP 协议的客户端都有一个 JSON 格式的通用配置文件，您可以在其中添加 ONLYOFFICE DocSpace MCP 本地服务器。

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

第 1 步：找到您的配置文件

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

第 2 步：添加 DocSpace MCP 服务器条目

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

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

第 3 步：设置环境变量

• DOCSPACE_BASE_URL - 您的 DocSpace 实例的 URL（例如 https://portal.onlyoffice.com）。

• DOCSPACE_API_KEY - 您在 DocSpace 设置 -> 开发人员工具 -> API 密钥中生成的个人 API 密钥。

所有可用参数列在 这里。

第 4 步：重启客户端

关闭并重新打开您的客户端。在大多数情况下，DocSpace MCP 服务器将自动启动，您将能够发出如下自然语言命令：

• 创建一个新的项目房间并邀请 Anna，赋予她编辑权限。

• 将此文件上传到“我的文档”。

工具

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

所有 DocSpace MCP 服务器工具都在 这里 有所描述。

文档

文档可在 docs 目录中获取。

示例

以下 examples 展示了如何使用 ONLYOFFICE DocSpace MCP 服务器。

隐私政策

政策可在 Legal Terms 和 Privacy Policy 中获取。

许可证

DocSpace MCP 服务器根据 LICENSE 文件中的 MIT 许可证分发。