跳到主要内容

将 ONLYOFFICE Apps MCP 服务器连接到 Mistral

简介​

ONLYOFFICE Apps MCP 服务器是一款用于管理与语言模型交互的工具,旨在提高效率,简化由 AI 驱动的工作流程以及文档和任务管理,并充分发挥 ONLYOFFICE Apps 的潜力。

ONLYOFFICE Apps MCP 服务器可以连接到支持连接远程计算机上运行的 MCP 服务器的客户端。

公共实例位于 https://mcp.onlyoffice.com/mcp,适用于支持现代 Streamable HTTP 传输的客户端;位于 https://mcp.onlyoffice.com/sse,适用于仅支持旧版 SSE 传输的客户端。我们建议尽可能使用 Streamable HTTP 传输。

可以使用以下两种身份验证方法将 ONLYOFFICE Apps MCP 服务器连接到 Mistral:OAuth 和 API 令牌身份验证。后者适用于允许在自定义标头和查询参数中传递配置的客户端。我们建议尽可能使用 OAuth 身份验证。

要将 ONLYOFFICE Apps MCP 服务器连接器添加到 Mistral:

  1. 访问您的 Mistral Chat 账户。

  2. 转到左侧面板中的 Intelligence → Connectors,然后单击 Add connector 按钮。

    Mistral 连接器

  3. 选择右上角的 Custom MCP Connector,然后配置 MCP 服务器参数:

    自定义连接器

OAuth 身份验证​

  1. 输入连接器名称。

    自定义连接器

  2. Connector Server - 粘贴 ONLYOFFICE MCP 服务器的 URL:

    https://mcp.onlyoffice.com/mcp
  3. Description – 为 MCP 服务器提供简短描述,以便更好地识别服务器。这是一个可选参数。

  4. Authorization Method - 选择 OAuth2.1 作为 Apps MCP 服务器的授权方法,然后单击 Connect。

  5. 完成 OAuth 身份验证过程:

    • 填写您的 Apps 凭据。

      自定义连接器

    • 允许 MCP 远程服务器访问您的 Apps 账户。

      自定义连接器

API 令牌身份验证​

由于安全性较低,请仅在因某种原因无法使用 OAuth 时使用此身份验证方法。此方法允许您使用默认标头中的 API 密钥和查询参数中的基本 URL 连接 MCP 服务器。

  1. 生成您自己的 Apps API 密钥。不建议使用所有者或房间管理员的 API 密钥。要生成 API 密钥,请转到您的 Apps。单击左侧面板中的开发者工具选项卡。选择顶部的 API 密钥选项卡,然后单击创建新的密钥按钮。复制生成的密钥。

    生成 API 密钥

  2. 输入连接器名称。

  3. Connector Server - 将您的 Apps 实例的基本 URL 添加到 ONLYOFFICE Apps MCP 服务器 URL 中,并按以下结构通过查询参数传递:

    https://mcp.onlyoffice.com/mcp?base_url=https://your-instance.onlyoffice.com
  4. Description – 为 MCP 服务器提供简短描述,以便更好地识别服务器。这是一个可选参数。

  5. Authorization Method - 选择 API Token Authentication 作为 Apps MCP 服务器的授权方法。

    Default header - 将您的 Apps API 密钥作为 Bearer 令牌添加到 Authorization 标头中。这是一个必填参数,因为此标头用于授权对 Apps 的请求。

    Authorization: Bearer sk-a499e...
  6. 单击 Create,将 Apps MCP 服务器添加到 Mistral 连接器。

使用 ONLYOFFICE MCP 服务器​

  • 身份验证成功后,Apps 连接器将显示在可用连接器中。

    Apps 已连接

  • 单击它可显示连接器概览和功能。Overview 选项卡显示您在设置时提供的连接器描述,并可通过单击省略号删除连接器。

    自定义连接器

  • 在 Functions 选项卡中,您可以滚动浏览可用工具并启用所需的工具。

    自定义连接器

  • 打开聊天并输入您的提示。在连接器列表中,确保已选中 Apps(或您为其指定的名称)。

  • 单击 Continue 以确认用于响应您的提示的工具列表。

    批准工具