通过

将 Genie Code 连接到 MCP 服务器

通过模型上下文协议（MCP）将 Genie Code 连接到外部工具和数据源。 Genie Code 可以使用已添加到工作区且你有权使用的任何 MCP 服务器。

注释

MCP 服务器仅在 Genie Code 代理模式下受支持。

什么是 MCP？

MCP是将 AI 代理连接到工具、资源、提示和其他上下文信息的开放源代码标准。 MCP 提供了一种标准化的方法，用于向 Genie Code 公开工具、数据和工作流，而无需将上下文直接嵌入提示或说明。

MCP 是为那些重要的上下文已经存在但难以从 AI 代理（如 Genie Code）访问的情况而设计的。 MCP 提供了一种安全的方法，使 Genie Code 能够访问上下文，如下所示：

  • 文档系统：团队通常会在 Confluence 等工具中保留运行手册或操作文档。 无需将部分复制到提示中，这些内容可以通过外部 MCP 服务器被公开一次，并在相关时引用。 文档可能还作为矢量搜索索引位于 Databricks 中，Genie Code 可用于查询相关文档。
  • 工具和服务：平台团队可以维护用于设置、验证或部署的 API 或脚本。 MCP 使这些功能直接可用于 Genie Code。
  • 数据源：如果 Databricks 中已有数据，可以将 Genie Code 连接到 Genie 空间，以帮助你使用自然语言分析数据。 对于 Databricks 外部存储的数据，可以通过外部 MCP 服务器为 Genie Code 提供安全访问。
  • 自定义应用：还可以添加通过 Databricks 应用托管的自定义功能。 这样，就可以将 Genie Code 连接到专为你或组织构建的专有工具、工作流或集成，这些集成都安全地托管在 Databricks 工作区中。

在这些情况下，MCP 将手动复制粘贴替换为结构化的可重用方法，使正确的上下文仅在需要时才可用。

可以将 Genie Code 连接到工作区中有权使用的任何 MCP 服务器。 工作区管理员控制哪些服务器可用，而用户可以根据需要从这些批准的源中进行选择。

若要详细了解 Databricks 中的 MCP 服务器以及如何创建自己的服务器，请参阅 Databricks 上的模型上下文协议（MCP）。

连接到第三方数据源

重要

此功能在 Beta 版中。 若要使用第三方数据源连接器，工作区管理员必须为代理预览启用 第三方连接器 。 请参阅 Manage Azure Databricks 预览版。

Genie Code 为常见的企业数据源（包括 Google Drive 和 SharePoint）提供内置连接器。

连接到这些数据源后，Genie Code 可以在回答问题时搜索文档。 每个用户单独进行身份验证，OAuth 令牌不会在用户之间共享。

连接第三方数据源：

  1. 在工作区中，单击 “Sparkle Genie 代码”图标。 右上角的 Genie Code 打开聊天。
  2. 在提示栏中，单击新建图标的加号图标。
  3. 在要连接到的数据源旁边，单击“ 连接”。
  4. 完成登录步骤。

进行身份验证后，Genie Code 可以在回答问题时搜索文档。 元存储管理员与连接所有者可以管理或撤销用户对连接的权限。 请参阅 “共享 MCP 服务器连接”。

注释

数据源工具并不总是会自动触发。 如果未启动文档搜索，请尝试显式提示 Genie Code 使用该工具，例如“使用 Google Docs”或“使用SharePoint”。

若要连接其他数据源，请手动将其添加到 Genie Code。 请参阅 手动将 MCP 服务器添加到 Genie Code。

Google Drive 限制

  • 最大文件大小为 10 MB。
  • 仅支持本机 Google 工作区文件（Docs、Sheets、Slides）。 不支持 PDF、图像和其他二进制格式。
  • 连接或令牌过期错误可能会出现在代理输出中。 重新验证身份以解决问题。

SharePoint限制

  • 最大文件大小为 10 MB。
  • 支持的文件类型包括 Office 文档（.docx、.xlsx、.pptx），以及基于文本的常用格式，例如 .txt、 .csv、 .json、 .md和其他格式。 不支持 PDF、图像和其他二进制格式。

手动将 MCP 服务器添加到 Genie Code

若要将 Genie Code 连接到 MCP 服务器，请在 Genie Code 设置中添加它：

  1. 打开 Genie Code 设置。 在“Genie 代码”面板中，单击“ 齿轮”图标。 设置。
  2. 在 MCP 服务器下，单击“ 新建”图标。 添加服务器。
  3. 选择要添加的 MCP 服务器。 可以选择 Databricks 托管 MCP 服务器或外部 MCP 服务器：
    • Unity 目录函数：选择函数的架构。 这允许 Genie Code 使用函数来运行预定义的 SQL 查询。
    • 矢量搜索：选择索引的架构。 这允许 Genie Code 查询矢量搜索索引以查找相关文档。
    • Genie 空间：请选择 Genie 空间。 Genie MCP 调用 Genie 作为工具，使你能够查询 Genie 空间，以使用自然语言分析数据。
    • 外部 MCP 服务器：选择要用作外部 MCP 服务器的 Unity 目录连接。 必须先登录到连接，然后才能使用它。
    • 自定义 MCP 服务器：选择要用作自定义 MCP 服务器的 Databricks 应用 。 这样，就可以使用任何自定义定义的工具。 以下要求适用：
      • 您的应用程序必须部署在您尝试连接的同一工作区中。
      • 必须在 https://<server-url>/mcp 访问 MCP 服务器。
      • 你的应用必须是无状态的。 例如，设置 mcp_app = mcp_server.http_app(stateless_http=True)。
      • 如果遇到 CORS 错误，可能需要将工作区 URL 添加到应用的允许源列表。 例如，设置 app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"])。
  4. 单击“ 保存”。

添加后，MCP 服务器立即可供 Genie Code 使用。 可以在代理模式下开始使用它们，而无需更改提示或说明。 当需要时，Genie Code 会自动利用这些服务器。

目前，MCP 访问仅限于所有服务器上的 20 个工具。 可以在 Genie Code 设置中选择启用或禁用的工具和服务器。

  • Last updated on