入门指南：远程运行 ONLYOFFICE 协作空间 MCP 服务器
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 进行连接：
- https://henry.milton%40onlyoffice.com:password@mcp.onlyoffice.com/mcp?base_url=https://your-instance.onlyoffice.com/
这为使用公共 MCP 服务器实例认证您的工具或工作流程提供了灵活、安全的选项。
立即在 ONLYOFFICE 协作空间中实现工作流程自动化
远程运行 ONLYOFFICE 协作空间 MCP 服务器，即可将协作空间带入可编程协作的世界。凭借 OAuth 安全性、灵活的托管方式以及与工具和代理的便捷连接，MCP 可成为一个可靠的自动化层，服务于您的整个团队。
无论是小型团队还是大型企业，MCP 服务器都能帮助简化工作流程、自动化重复性任务并优化协作空间的使用体验。立即使用 ONLYOFFICE 协作空间体验高效协作吧！
相关链接
GitHub 上的 ONLYOFFICE 协作空间 MCP 服务器
如何将 ONLYOFFICE 协作空间 MCP 服务器连接到桌面编辑器
ONLYOFFICE 协作空间 MCP 服务器：开发者快速入门指南
