将 Genie Code 连接到 MCP 服务器

Genie Code 通过模型上下文协议（MCP）服务器以及适用于 Google Drive、SharePoint、GitHub、Glean、Atlassian 和 Slack 的原生连接器，连接到外部工具、文档和数据。 将本机连接器用于常见的 SaaS 源，或者从工作区中添加自己的外部或自定义 MCP 服务器。 选择要在 Genie Code 设置中启用的工具。

什么是 MCP？

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

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

  • 文档系统：团队通常会在 Confluence 等工具中保留运行手册或操作文档。 无需将内容段落复制到提示符中，只需通过外部 MCP 服务器将内容公开一次，在需要时即可引用。 您的文档也可能已以 AI Search 索引的形式存在于 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服务器以及如何创建自己的服务器，请参见 MCP和代理工具。

使用原生连接器连接第三方数据源

重要

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

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

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

连接第三方数据源：

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

进行身份验证后，Genie Code 可以在回答问题时搜索文档。 元存储管理员和连接所有者可以管理或撤销用户对该连接的权限。 请参阅 步骤 4。授予对队友的访问权限。

注释

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

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

Google Drive 限制

  • 授权 Google Drive 时，可能会看到“未验证的应用”屏幕。 单击“ 高级 ”并继续授权过程。
  • 最大文件大小为 10 MB。
  • 仅支持本机 Google 工作区文件（Docs、Sheets、Slides）。 不支持 PDF、图像和其他二进制格式。
  • 连接或令牌过期错误可能会出现在代理输出中。 重新验证身份以解决问题。

注释

从 Google Workspace API 接收的原始或派生用户数据的使用和传输将遵循 Google API 服务用户数据策略，包括有限使用要求。

SharePoint限制

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

GitHub限制

  • 默认情况下，Databricks GitHub MCP 连接器只能访问公共存储库。 若要授予连接器对专用企业存储库的读取访问权限，GitHub组织管理员必须完成其他设置。 请参阅 “启用专用存储库访问”。
  • GitHub企业服务器（GitHub自承载版本）不受支持。

Glean 的限制

  • 元存储管理员必须先配置 Glean 租户 ID，非管理员用户才能使用该连接。 首次连接到 Glean 时，管理员可以输入租户 ID。
  • 为了连接到特定的 Glean MCP 服务器，元存储管理员可以在设置连接时选择性地设置 MCP 服务器路径（例如 /mcp/eng）。 保持该字段空启以便使用默认路径（/mcp/default）。 非管理员用户无法指定或更改 Glean MCP 服务器路径。

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

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

  1. 打开 Genie Code 设置。 在“Genie 代码”窗格中，单击“ 齿轮”图标。 设置。
  2. 在 MCP 服务器下，单击“ 新建”图标。 添加服务器。
  3. 选择要添加的 MCP 服务器。 可以选择 Databricks 托管 MCP 服务器或外部 MCP 服务器：
    • Unity 目录函数：选择函数的架构。 这允许 Genie Code 使用函数来运行预定义的 SQL 查询。
    • AI 搜索：选择索引的架构。 这允许 Genie Code 查询 AI 搜索索引以查找相关文档。
    • 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 会在相关情况下自动利用这些服务器。

可以在 Genie Code 设置中选择启用或禁用的工具和服务器。

局限性

  • Last updated on