ONLYOFFICE 协作空间 MCP 服务器：开发者快速入门指南

ONLYOFFICE 协作空间 MCP 服务器通过模型上下文协议（MCP）集成大型语言模型（LLM）与外部系统，简化 AI 工作流程。它提升效率、优化文档管理，并支持团队无缝引入 AI 能力。阅读本文，获取安装与使用的快速指南。

简介

ONLYOFFICE 协作空间 MCP 服务器是一款专为文档管理流程打造的工具，用于高效连接语言模型与外部系统，深度适配 ONLYOFFICE 生态。

它基于 MCP 标准实现统一通信，简化了文件处理、用户管理与工作区更新等复杂操作，使其更加直观可靠。通过支持协作增强、流程自动化与系统集成，MCP 服务器已成为 AI 辅助办公环境中的关键组件。

此外，它还提供高度灵活的集成方式，帮助企业根据实际需求定制解决方案，充分释放 ONLYOFFICE 协作空间的功能潜力。

协作空间 MCP 服务器的优势

• 简化文档工作流程：自动执行文件上传、文件夹创建或文档整理等任务。
• 实现协作：使用将 LLM 集成到文档共享空间的强大工具，增强团队协作。
• 统一沟通：通过将 AI 驱动的工具直接桥接到文档工作流程中，创建一致的流程，避免冗余。
• 安全与合规：利用身份验证功能和 API 密钥，确保流程每一步的安全交互。

安装

设置 ONLYOFFICE 协作空间 MCP 服务器非常简单，只需在客户端使用的 JSON 文件中进行配置即可。以下是添加服务器的示例：

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

如需更详细的安装步骤，请查看 Claude Desktop 等配置提供的示例，以便您更好地调整工作流程。

从源代码构建也是一个选项，需要 Node.js 和 pnpm。请参阅说明

配置

ONLYOFFICE 协作空间 MCP 服务器通过环境变量进行配置，这些变量定义了服务器与实例的交互方式，确保适应不同使用场景的灵活性。以下是一些关键的配置参数：

• DOCSPACE_BASE_URL

协作空间实例所在的基本 URL。这对于所有 API 请求都至关重要。

• DOCSPACE_API_KEY

与协作空间进行安全通信所需的唯一 API 密钥。

• DOCSPACE_AUTH_TOKEN

协作空间 API 的身份验证令牌。

• DOCSPACE_TRANSPORT

用于与协作空间 MCP 服务器通信的传输协议。

查看所有变量

这些变量提供了灵活的功能，可帮助您根据组织的需求微调服务器。例如，针对简化 LLM 集成的需求，可以通过明确配置令牌来避免重复的手动身份验证，从而提高效率。

如何使用协作空间 MCP 服务器

ONLYOFFICE 协作空间 MCP 服务器实现了模型上下文协议（MCP）中的工具概念，提供一系列预定义命令，可用于对文档和工作空间执行特定操作。

此外，还有工具集——一系列相关工具。它们包括文件、文件夹、成员和房间。默认情况下，所有工具集及其工具在服务器中均可用。但是，您可以使用以下配置选项进行自定义：DOCSPACE_TOOLSETS、DOCSPACE_ENABLED_TOOLS 和 DOCSPACE_DISABLED_TOOLS。了解如何配置

以下是可用工具的简要介绍：

• create_folder：快速创建文件夹来构建您的空间。
• get_file_info：检索文件的特定元数据和信息。
• upload_file：无缝上传新文档到协作空间。
• create_room：设置针对特定项目的协作室。
• set_room_security：控制用户访问权限以增强安全性。
• archive_room：归档不再使用的房间。

该服务器提供了20多种工具，支持从用户管理到文件处理和数据检索等多种功能，适用于广泛的使用场景。

例如，若您的团队需要在项目完成后归档相关文件夹，可以使用 archive_room 工具自动完成特定空间的归档。同样，利用 upload_file 命令，您可以轻松实现为下一个项目批量上传文档的操作。

元工具

直接连接所有可用工具有时可能颇具挑战性。通过使用 DOCSPACE_DYNAMIC 配置选项，您可以将所有可用工具分组到元工具中。它们使 AI 模型能够与其他工具动态交互，而无需同时加载它们。了解更多

许可

ONLYOFFICE 协作空间 MCP 服务器采用 Apache-2.0 许可证分发，该许可证保证了透明度和灵活性。无论您是想修改服务器以更好地满足您的需求，还是在组织内部分发服务器，该许可证都允许您在开源框架内自由地进行修改。

使用 ONLYOFFICE 协作空间 MCP 服务器构建更智能的工作流程

将 LLM 无缝集成到文档管理流程中，不仅能提升团队效率与协作能力，还能确保安全性与合规性，为自动化文件归档、共享空间设置和资源上传等任务带来无限可能。借助 ONLYOFFICE 协作空间 MCP 服务器，企业可以充分释放人工智能与云技术的潜力。

通过部署 ONLYOFFICE 协作空间 MCP 服务器，组织能够构建更加智能化的工作环境，让人类与 AI 协同共创、高效运作。

如果您希望借助 AI 和先进工具提升文档管理水平，实现无缝协作，那么集成该服务器将是您提升生产力与工作效率的明智之选。依托其强大的功能与对模型上下文协议（MCP）的支持，这项投入将为您的团队带来切实价值。

立即开始

请注意：此 ONLYOFFICE 协作空间 MCP 服务器目前处于预览状态。虽然它可以正常运行，但可能包含不完整的功能、潜在的错误或进行过重大更改。请谨慎在生产环境中使用，因为更新可能会影响兼容性。

从哪里获取

ONLYOFFICE 协作空间 MCP 目前可通过多个专用中心获取。您可以从这些中心开始：

• mcp | Docker Hub
• MCPHub.com

常见问题解答

问：什么是 ONLYOFFICE 协作空间 MCP 服务器？

ONLYOFFICE 协作空间 MCP 服务器是一款旨在管理大型语言模型 (LLM) 与外部系统之间交互的工具，专门用于 ONLYOFFICE 生态系统内的文档管理工作流。它简化了文件处理、用户管理和工作区更新等任务。

问：它适合哪些用户？

开发人员、DevOps 以及将 AI 集成到文档工作流的团队。如果您在协作空间中管理文件、房间或用户，并希望实现 AI 驱动的自动化，那么这款服务器非常适合您。

问：我可以从源代码构建服务器吗？

是的，可以从源代码构建。它需要 Node.js 和 pnpm。

问：如何配置？

完全通过环境变量。这使得部署在开发、测试和生产环境中保持简单和一致。

问：我可以限制 AI 的操作吗？

是的。可以限制工具集和工具，以便只允许执行已批准的操作。

问：协作空间 MCP 服务器是否已准备好投入生产？

目前处于预览阶段。它可以正常运行，但可能存在功能不完整或重大更改。请进行全面测试，并在生产环境中谨慎使用。

问：我在哪里可以找到协作空间 MCP 服务器？

该服务器可在 GitHub 上找到，也可以通过 Docker Hub 和 MCPHub.com 等专业目录找到。

问：该服务器使用什么许可证？

ONLYOFFICE 协作空间 MCP 服务器采用 Apache-2.0 许可证分发，为修改和分发提供了透明度和灵活性。