如何将 ONLYOFFICE 协作空间 MCP 服务器连接到桌面编辑器

ONLYOFFICE 桌面编辑器现已支持 MCP（模型上下文协议）服务器，使 AI 智能体不仅可以与本地工具协同工作，还可以与扩展其功能的外部服务配合使用。通过连接 ONLYOFFICE 协作空间 MCP 服务器，您可以让编辑器直接在桌面环境中与文件交互并使用高级 AI 驱动的操作。

本指南将介绍如何将 ONLYOFFICE MCP 服务器连接到桌面编辑器。

关于 ONLYOFFICE 桌面编辑器

ONLYOFFICE 桌面编辑器是一款功能强大、安全可靠且免费开源的全平台办公套件。它能提供文本文档、电子表格、演示文稿以及PDF的查看与编辑功能，支持在Windows、Linux和macOS 系统上运行。与在线版本相比，桌面编辑器允许用户在没有网络连接的情况下工作，并提供更多的定制选项和本地化控制。

ONLYOFFICE 桌面编辑器中的 MCP 服务器是什么？

MCP 服务器允许 AI 智能体访问其本地环境之外的工具。这些工具可以用于生成文件、读取内容、操作文档或执行由服务器定义的自定义功能。

ONLYOFFICE 桌面编辑器内置了一些 MCP 工具，您还可以通过简单的 JSON 配置来添加与其他服务器的连接。

如何连接 ONLYOFFICE 协作空间 MCP 服务器？

协作空间 MCP 服务器使您能够通过 AI 智能体与您的 ONLYOFFICE 协作空间实例进行交互。

开始之前，请确保您已满足以下前提条件：

已安装 ONLYOFFICE 桌面编辑器（版本 9.2 或更高）
拥有协作空间的访问权限
持有一个有效的协作空间 API 密钥
已配置好一个 AI 服务提供商（例如 OpenAI、Anthropic Claude 或其他受支持的 LLM）------请注意，MCP 服务器选项卡仅在桌面编辑器中设置了 AI 连接后才会出现。

步骤 1. 打开 MCP 服务器配置

在 ONLYOFFICE 桌面编辑器的启动窗口中，转到 AI 智能体 → MCP 服务器板块。

在 MCP 服务器板块，点击编辑配置。随后将会弹出一个 JSON 编辑器。

步骤 2. 添加您的 MCP 服务器配置

在编辑配置对话框中，输入从 MCP 服务器提供商处获取的 JSON 配置，然后点击保存。以下是一个 Docker 配置示例：

复制代码

{

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

}

}

}

}

请将 DOCSPACE_BASE_URL 和 DOCSPACE_API_KEY 替换为您自己协作空间实例对应的值。

保存配置后，ONLYOFFICE MCP 服务器将出现在列表中，其提供的工具即可供您的 AI 智能体使用。

步骤 3. 启用或禁用 MCP 工具

添加 MCP 服务器后，其提供的工具将出现在可用工具列表中。

您可以在此处单独启用或禁用每一个工具，也可以一次性管理所有工具。更改会立即生效，方便您根据需求精细调整 AI 智能体的配置。

在桌面编辑器中使用协作空间 MCP 服务器

成功连接服务器后：

在桌面编辑器中打开 AI 智能体面板。
使用自然语言指令输入您的任务，智能体将自动调用协作空间 MCP 服务器提供的相应工具来处理。

智能体生成的结果将直接显示在聊天窗口中。在此窗口中，您可以：

查看使用了哪些 MCP 工具
查看 AI 生成的回复
将整个对话复制到剪贴板
将结果保存为计算机上的 .docx 文件

**重要提示：**此 ONLYOFFICE 协作空间 MCP 服务器目前处于预览状态。虽然当前版本功能完整，但可能包含尚在开发中的功能、潜在问题，且未来更新可能引入不兼容的重大更改。请谨慎在生产环境中使用，并留意后续更新可能带来的影响。