Genie Code 通过模型上下文协议(MCP)服务器以及 Databricks 提供的、用于 Google Drive、Gmail、Google 日历、Microsoft 365、Atlassian、Glean、Slack 和 GitHub 的 MCP 连接器连接到外部工具、文档和数据。 使用这些连接器连接常见的第三方源,或者从工作区添加您自己的外部或自定义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服务器以及如何创建自己的服务器,请参见MCPs。
第三方源使用Databricks提供的MCP连接器
Genie Code 提供了 Databricks 提供的 MCP 连接器,适用于常见的第三方来源:
- Google 云端硬盘:搜索并创建 Google 文档、表格和幻灯片;编辑它创建的文档。
- Gmail:搜索、阅读和起草邮件。
- 谷歌日历:搜索并创建日历事件。
- Microsoft 365:搜索 SharePoint、Teams、Outlook 和日历;草拟 Outlook 邮件。
- Atlassian:搜索并更新Jira和Confluence。
- Glean (测试版):使用 Glean 搜索您组织内所有连接的应用。
- Slack:搜索Slack消息和频道,发送消息。
- GitHub:搜索并更新仓库、问题和拉取请求。
连接这些数据源使Genie Code能够搜索您的文档,并在互联工具中回答问题时采取相应操作。 每个用户单独进行身份验证,OAuth 令牌不会在用户之间共享。
这些连接使用Databricks提供的MCP连接器,因此无需托管服务器,也无需注册OAuth应用。 Azure Databricks 通过 Unity Catalog 和 Unity Gateway 管理所有连接。 网关会根据你在 Unity Catalog 中的权限对每次工具调用进行授权,应用内置策略和审批要求,并在系统表中记录使用日志和审计日志。 参见 外部MCP服务器。
连接第三方数据源:
- 在您的工作区中,点击右上角的
Genie Code 以打开聊天窗口。
- 在提示栏中,单击
的加号图标。
- 在要连接到的数据源旁边,单击“ 连接”。
- 完成登录步骤。
进行身份验证后,Genie Code 可以在回答问题时搜索文档。 元存储管理员和连接所有者可以管理或撤销用户对该连接的权限。 参见授予和撤销连接权限。
注释
数据源工具并不总是会自动触发。 如果未启动文档搜索,请尝试显式提示 Genie Code 使用该工具,例如“使用 Google Docs”或“使用SharePoint”。
若要连接其他数据源,请手动将其添加到 Genie Code。 请参阅 手动将 MCP 服务器添加到 Genie Code。
定时任务与认证
- Genie Code 不会在连接认证过期时提醒你。 你可能只有在工具调用失败或打开连接列表时才知道。 重新验证身份以解决问题。
- 更改连接权限需要每个用户重新认证。 使用连接的计划任务会失败,直到用户重新认证。
Google Drive 限制
- 授权 Google Drive 时,可能会看到“未验证的应用”屏幕。 单击“ 高级 ”并继续授权过程。
- 文件大小上限为 25 MB。
- 仅支持本机 Google 工作区文件(Docs、Sheets、Slides)。 不支持 PDF、图像和其他二进制格式。
- Genie Code 可以创建 Google 文档、表格和幻灯片,并通过连接器编辑它创建的 Google 文档。 它不能编辑连接器外创建的文档,也不能编辑现有的表格或幻灯片。
- 阅读一份非常大的文档可能会很慢。
注释
从 Google Workspace API 接收的原始或派生用户数据的使用和传输将遵循 Google API 服务用户数据策略,包括有限使用要求。
Gmail 限制
- Genie Code 可以搜索、阅读和起草邮件,但不能发送邮件或编辑现有邮件。
- Genie Code 不能将 Drive 文件添加为原生 Gmail 附件。 作为变通方法,可以在邮件正文中附上文件链接。
Microsoft 365 限制
- 包括SharePoint、Teams、Outlook和日历。
- Genie Code可以起草Outlook邮件,但不能发送。
- SharePoint 文件的最大文件大小为 25 MB。
- SharePoint支持的文件类型包括Office文档(.docx、.xlsx、.pptx),以及常见的基于文本的格式,如
.txt、.csv.json.md以及其他。 不支持 PDF、图像和其他二进制格式。
Glean(Beta)的限制
- Glean仅限搜索。 它无法通过直接链接读取文档。
- 元存储管理员必须先配置 Glean 租户 ID,非管理员用户才能使用该连接。 首次连接到 Glean 时,管理员可以输入租户 ID。
- 为了连接到特定的 Glean MCP 服务器,元存储管理员可以在设置连接时选择性地设置 MCP 服务器路径(例如
/mcp/eng)。 保持该字段空启以便使用默认路径(/mcp/default)。 非管理员用户无法指定或更改 Glean MCP 服务器路径。
Slack 限制
- Genie Code 发送后无法编辑或删除消息。
GitHub限制
- 写入权限限制在文件内容、问题和拉取请求。
- 默认情况下,Databricks GitHub MCP 连接器只能访问公共存储库。 若要授予连接器对专用企业存储库的读取访问权限,GitHub组织管理员必须完成其他设置。 参见启用 GitHub 写权限和私有仓库访问。
- GitHub企业服务器(GitHub自承载版本)不受支持。
手动将 MCP 服务器添加到 Genie Code
若要将 Genie Code 连接到 MCP 服务器,请在 Genie Code 设置中添加它:
- 打开 Genie Code 设置。 在“Genie 代码”窗格中,单击“
设置。
- 在 MCP 服务器下,单击“
添加服务器。
- 选择要添加的 MCP 服务器。 可以选择 Databricks 托管 MCP 服务器或外部 MCP 服务器:
-
UC MCP服务:选择服务, 选择UC MCP服务。 为在 Unity Catalog 中注册的外部服务器使用 MCP 服务。 参见 外部MCP服务器。
- 对于针对每个用户的 OAuth,使用前请 先登录 服务。
- 有关创建自定义GITHUB MCP 服务器的帮助,请参阅 Search GitHub code with Genie Code。
- Unity 目录函数:选择函数的架构。 这允许 Genie Code 使用函数来运行预定义的 SQL 查询。
- AI 搜索:选择索引的架构。 这允许 Genie Code 查询 AI 搜索索引以查找相关文档。
- Genie 代理:选择 Genie 代理。 Genie MCP 调用 Genie 作为工具,使你能够查询 Genie 代理以使用自然语言分析数据。
-
自定义 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= ["*"])。
-
UC MCP服务:选择服务, 选择UC MCP服务。 为在 Unity Catalog 中注册的外部服务器使用 MCP 服务。 参见 外部MCP服务器。
- 单击“ 保存”。
添加后,MCP 服务器立即可供 Genie Code 使用。 无需更改提示或说明即可开始使用它们。 Genie Code 会在相关情况下自动利用这些服务器。
可以在 Genie Code 设置中选择启用或禁用的工具和服务器。
有关连接应用的合规指导,请参见 外部服务提供商要求。
局限性
- 外部 MCP 服务器仅在支持模型服务的区域可用。 请参阅 模型服务功能可用性。