ONLYOFFICE 协作空间的 MCP 服务器组件将它从一款仅提供用户界面的协作工具转变为一款 AI 驱动的自动化解决方案。最近的更新使得在远程计算机上运行协作空间 MCP 服务器变得轻而易举，并允许多个应用程序、机器人或 AI 智能体安全与其进行连接。这种方法将自动化流程集中化，并且让跨团队和工具的集成更简单。
下面将为您介绍什么是远程协作空间 MCP 服务器、为什么要远程运行它、如何快速将其连接、安全最佳实践和实际用例。
关于 ONLYOFFICE 协作空间
ONLYOFFICE 协作空间是一款以 "房间"为核心概念的在线文档协作平台。通过为每个文档、项目或工作流程创建独立的房间，用户可以清晰、安全地组织协作内容 。
在该平台中，您可以灵活配置每个房间的设置，包括精细化的用户权限管理，从而与客户、业务合作伙伴或第三方进行高效的在线协作，共同编辑文档、表格、幻灯片、PDF 及表单 。
若需将 ONLYOFFICE 协作空间集成至自有的商业软件或服务器环境中，可以选择开发者版本，还支持自定义品牌选项、连接外部服务和存储等。
什么 是 在 远程 机器 上 运行 的 MCP 服务器？
远程协作空间 MCP 服务器指的是运行在可通过 HTTP 访问的服务器上的协作空间 MCP 服务器。它提供了一组 MCP 工具（文件操作、房间管理、文档生成等），客户端（AI 智能体、自动化脚本或应用程序）可以通过 HTTP 调用这些工具。
为什么要远程运行 MCP 服务器？
与本地 MCP 服务器相比，远程 MCP 服务器具有以下几个优势：
- **集中维护：**它可以降低运营成本，提高安全性和一致性，并加快更新和故障排除速度。
- 可预测的工作流程： 借助远程部署的 MCP 服务器，工具的可用性得到集中管理。服务器所有者决定哪些工具对外开放，从而确保连接到服务器的每个人都能获得可预测的体验。
- 每个团队都使用一致的自动化流程：市场部、人力资源部、产品部、开发部、管理部------每个人都使用同一套工具。
- **终端用户友好：**无需手动配置，意味着更快的上手速度和更少的配置错误。
如何 实现 远程连接
连接到远程协作空间 MCP 服务器非常简单。您可以在任何可通过 HTTP 访问的机器上运行 MCP 服务器，例如云实例、虚拟机或容器。然后将其连接到您的协作空间。
之后，您只需使用 OAuth 或 API 密钥将 MCP 服务器的 URL 共享给您的团队或需要访问的工具，MCP 服务器就会代表他们处理与协作空间的所有通信。
然后，他们无需任何本地安装或复杂配置，即可执行任务、上传文件、创建房间、生成文档或运行自动化工作流程。所有操作都通过一个集中、安全的服务进行，这个简洁的连接点使您的集成简单、可扩展且易于管理。
架构和支持的传输方式
远程 MCP 服务器通过一种或多种传输方式公开模型上下文协议，以便 AI 客户端可以发现和调用工具：
- **Streamable HTTP：**推荐用于流式响应的现代传输方式。
- **服务器发送事件 (SSE)：**支持依赖 SSE 的旧版客户端。
同时支持这两种传输方式可以提高连接的灵活性，因为它可以在不放弃对旧式客户端的支持的情况下，将覆盖范围扩展到更广泛的客户端。
如何连接公共远程 MCP 服务器
公共实例可通过以下网址访问：https://mcp.onlyoffice.com/mcp（适用于支持现代 Streamable HTTP 传输的客户端）和 https://mcp.onlyoffice.com/sse（适用于仅支持传统 SSE 传输的客户端）。建议尽可能使用 Streamable HTTP 传输。
公共实例支持使用 OAuth、API 密钥、个人访问令牌 (PAT)、用户名/密码对或原始"Authorization"标头进行身份认证。建议尽可能使用 OAuth 身份认证。
默认情况下，公共实例提供对所有可用工具的访问权限。工具选择可以通过查询参数或自定义标头进行定制。但是，如果支持，建议使用 MCP 客户端界面进行工具配置。
为了便于理解，以下是一些简单的示例，展示了客户端如何连接到公共远程 MCP 服务器。这些示例反映了当前支持的身份认证方法。
使用公共应用 的 OAuth 认证：无需自定义凭据，即可使用公共 OAuth 应用程序进行连接：https://mcp.onlyoffice.com/mcp
使用自定义应用 的 OAuth 认证：请使用您自己的 OAuth 客户端 ID 和客户端密钥进行连接：https://mcp.onlyoffice.com/mcp（需要客户端 ID 和密钥）
使用 请求 头 的 API 密钥 **认证：**使用 API 密钥和自定义请求头中提供的基础 URL 进行连接：
- X-Mcp-Base-Url: https://your-instance.onlyoffice.com/
- X-Mcp-Api-Key: sk-a499e...
使用 授权请求头 的 API 密钥 认证 **：**在授权请求头中使用 API 密钥，并在查询参数中使用基础 URL 进行连接：
- https://mcp.onlyoffice.com/mcp?base_url=https://your-instance.onlyoffice.com
- Authorization: Bearer sk-a499e...
**URL 中包含用户名和密码认证：**使用 URL 编码的凭证和查询参数中的基础 URL 进行连接：
这为使用公共 MCP 服务器实例认证您的工具或工作流程提供了灵活、安全的选项。
立即 在 ONLYOFFICE 协作空间中实现工作流程自动化
远程运行 ONLYOFFICE 协作空间 MCP 服务器，即可将协作空间带入可编程协作的世界。凭借 OAuth 安全性、灵活的托管方式以及与工具和代理的便捷连接，MCP 可成为一个可靠的自动化层，服务于您的整个团队。
无论是小型团队还是大型企业，MCP 服务器都能帮助简化工作流程、自动化重复性任务并优化协作空间的使用体验。立即使用 ONLYOFFICE 协作空间体验高效协作吧！
相关链接
GitHub 上的 ONLYOFFICE 协作空间 MCP 服务器