Merk
Tilgang til denne siden krever autorisasjon. Du kan prøve å logge på eller endre kataloger.
Tilgang til denne siden krever autorisasjon. Du kan prøve å endre kataloger.
Genie One can reach content outside Azure Databricks in two ways: Genie Search, which an account admin sets up for the whole account, and MCP connectors, which each user connects with their own credentials. Databricks recommends using both. See Genie Search and MCP connectors. This page covers MCP connectors.
Connect Genie One to applications such as Gmail and Slack with MCP connectors. Genie One can then look up live information, such as the current status of a Jira issue. It can also take action, such as drafting an email, posting to a Slack channel, or updating an issue. Admins control access and policies for most connectors through Unity Gateway.
Each user authenticates individually, so Genie One works within each user's own permissions. OAuth tokens are not shared between users.
Types of MCP connectors
You can connect Genie One to the following kinds of MCP servers:
- Databricks-provided connectors: Connectors that Azure Databricks hosts for common applications. There's no server to host and no OAuth app to register. See Databricks-provided connectors.
- MCP servers from Azure Databricks Marketplace: MCP servers that providers list on Azure Databricks Marketplace. See Get access to external MCP servers.
- Custom MCP services: MCP servers that your organization registers in Unity Catalog. See Connect a custom MCP service.
Databricks-provided connectors and MCP services, including servers installed from Marketplace, run through Unity Gateway. Before each tool call, the gateway checks that the user has EXECUTE on the MCP, and it records usage and audit logs in system tables. Admins can also limit which tools are available and apply service policies (Beta), for example to block sensitive data or to require approval for a tool call.
The exceptions are Glean (Beta) and legacy MCP connections, which are Unity Catalog connections that aren't registered as MCP services. They don't run through the gateway, so these controls don't apply to them. See Govern an MCP.
Databricks-provided connectors
Supported connectors include:
- Google Drive: Search and create Google Docs, Sheets, and Slides; edit Docs it created.
- Gmail: Search, read, and draft email.
- Google Calendar: Search and create calendar events.
- Microsoft 365: Search SharePoint, Teams, Outlook, and Calendar; draft Outlook email.
- Atlassian: Search and update Jira and Confluence.
- Asana: Search tasks, projects, portfolios, users, and teams, and create or update tasks when write actions are allowed.
- Glean (Beta): Search across your organization's connected apps using Glean.
- Slack: Search Slack messages and channels, and send messages.
- GitHub: Search and update repositories, issues, and pull requests.
Note
To use these connectors in a Genie Agent instead of Genie One, see Connect a Genie Agent to MCP tools and sources.
Connect an external application
On the Genie One home page, click the
plus icon at the bottom left of the search bar.
Click Connectors, then select an application.
To connect additional applications, click Browse connectors at the bottom of the list. To add a custom MCP service, see Connect a custom MCP service.
Click Sign in and complete the steps to sign in.
If your organization blocks the sign-in, see Get admin approval for connectors.
The connection is added to your conversation. Genie One can now use its tools to look up information and take action. See Share an MCP.
Note
Connector tools might not always trigger automatically. If a tool doesn't run, try explicitly prompting chat to use it, for example "use Google Drive" or "use SharePoint."
Connect a custom MCP service
You can connect Genie One to any MCP server that is registered as an MCP service in Unity Catalog:
- Register your own server: Register an external or self-hosted MCP server. See External MCP servers.
- Install from Marketplace: Install an MCP server listed on Azure Databricks Marketplace. The installation creates an MCP service in the Unity Catalog schema that you choose. See Get access to external MCP servers.
After the MCP service exists and you have access to it, add it to a chat conversation from Browse connectors. See Share an MCP. If the service uses per-user OAuth, each user must sign in before using it.
Reconnect an application
If an administrator approves new permissions for an application after you sign in to it, revoke your credentials and sign in again so that your connection gets the new permissions:
- On the Genie One home page, click the
plus icon at the bottom left of the search bar.
- Click Connectors, then click Browse connectors.
- Click the application.
- Click the
down arrow next to Connected, then click Revoke credentials.
- Click Use connector and complete the steps to sign in.
When sign-in completes, the button shows Connected again.
Write actions
Some connected MCP tools can perform write actions in the source application, not just search and read data. Whether a connection can write, and which actions it can take, depends on the tool, the OAuth scopes you consent to when you connect, and your own permissions in the source application.
OAuth scopes
When you connect an external application, its provider prompts you to consent to a set of OAuth scopes. Scopes define the maximum set of actions a connection can attempt on your behalf. Each user consents individually. What a connection can access also depends on your own permissions in the source application and on any policies that your Azure Databricks admins set in Unity Gateway.
Azure Databricks manages the OAuth credentials for these connections. For the full list of scopes each managed OAuth provider requests and the purpose of each scope, see Managed OAuth providers. The exact set of scopes requested for a connection appears on the provider's consent screen when you connect.
For compliance guidance for connected applications, see External provider requirements.
Admin controls
For connectors that run through Unity Gateway, admins control who can use each connector and which of its tools are available, and can apply service policies (Beta) to tool calls. See Govern an MCP.
Get admin approval for connectors
Two groups of administrators control whether users can sign in to a connector and what the connection can do:
- Provider administrators: Your organization's Slack, Google Workspace, Microsoft Entra ID, or GitHub administrators decide whether users can authorize the app and which permissions it gets, such as OAuth scopes or access to GitHub repositories. They are often not your Azure Databricks admins.
- Azure Databricks admins: Users with the
MANAGEprivilege on a connector's MCP decide which tools are available and who can call them. See Govern an MCP.
If a provider blocks sign-in or limits what a connector can access, share the steps for that provider with its administrator. After the administrator approves the app, sign out of the connector and sign in again to get the approved permissions. See Manage provider sign-in.
Approve the Databricks Genie app in Slack
If your Slack workspace requires app approval, the Slack sign-in screen warns that the app is likely blocked. Slack can also drop permissions that an administrator hasn't approved. For example, sign-in succeeds, but the connector can't send messages.
A Slack Workspace Owner or app manager must approve the Databricks Genie app:
- In Slack, click Admin in the sidebar.
- Select Apps and workflows to open the Slack Marketplace.
- Click Browse, then search for and select Databricks Genie.
- Review the requested permissions and click Approve. The Send messages on a user's behalf permission (
chat:write) lets users send messages through the connector.
If a user already requested the app, the Workspace Owner or app manager can approve the pending request instead. See Manage app approval for your workspace.
When Azure Databricks adds a permission to the connector, Slack asks for approval again. Until the new permission is approved, sign-in fails or Slack drops the new permission.
When you sign in again, check the actions that Databricks Genie can take on the Slack sign-in screen. The list should include sending messages. If the connector still can't send messages, ask a metastore admin or another user with MANAGE on system.ai.slack to check its tools:
- In Unity Gateway, select MCPs and open
system.ai.slack. - On Overview, click Edit tools.
- Confirm that the tools that send messages are selected, then click Save changes.
Allow the connectors in Google Workspace
If Google sign-in shows an access blocked error or says that your administrator's policy blocks the app, your Google Workspace administrator restricts which third-party apps can access Google data. The Google Drive, Gmail, and Google Calendar connectors use the same Google OAuth app, so one configuration covers all three.
A Google Workspace administrator with the Service Settings administrator privilege must configure the app:
- In the Google Admin console, go to Security > Access and data control > API controls.
- Click Manage App Access.
- For Configured apps, click Configure new app.
- Enter the client ID
645306276512-s5jbhbhff6irpdq1fpt2f21pcrf4agqs.apps.googleusercontent.com, click Search, and click the app in the search results. - For Scope, leave the top organizational unit selected to configure access for all users, or click Select org units to choose specific organizational units. Click Continue.
- For Access to Google data, select Trusted. To allow only the scopes that the connectors request, select Specific Google data instead and add the scopes listed in Managed OAuth providers. Click Continue.
- Review the settings and click Finish.
The app appears in the Configured apps list with the access level you selected. See Control which apps access Google Workspace data.
Approve Microsoft 365 permissions
The Microsoft 365 connector requests its Microsoft Graph permissions for SharePoint, OneDrive, Teams, Outlook, Calendar, and online meetings in a single consent. Users and administrators can't consent to only some of them, such as only the Outlook mail permissions. For the full list, see Microsoft 365 scopes.
Permissions that end in .All typically require administrator consent. If your organization requires administrator approval, share the app name from the consent screen with your Microsoft Entra ID administrator.
To limit what the connector can do, a metastore admin or another user with MANAGE on system.ai.microsoft_365 can remove its write tools. See Choose available tools. Removing tools controls which tools the connector can call. It doesn't change the permissions that the consent screen requests.
Enable GitHub write access and private repository access
By default, the GitHub connector (system.ai.github) can read only public repositories. To access private repositories, or to make changes such as committing files or creating issues and pull requests, the repository owner or a GitHub organization administrator must:
Install the Databricks GitHub connector app and grant it access to the required repositories.
If the organization uses an IP allowlist, add the Azure Databricks serverless outbound IPs for your workspace's cloud and region.
After the app is installed, users can work with the granted repositories through the connector, within their own GitHub permissions.
Limitations
External connections are only available in regions where Unity Gateway is supported.
See supported regions.
Scheduled tasks and authentication
- Chat doesn't warn you when a connection's authentication expires. You might only find out when a tool call fails or when you open the connections list. Re-authenticate to resolve.
- Changing a connection's permissions requires each user to re-authenticate. Scheduled tasks that use the connection fail until the user re-authenticates.
Google Drive
- When authorizing Google Drive, you might see an Unverified app screen. Click Advanced and continue the authorization process.
- Maximum file size is 25 MB.
- Only native Google Workspace files (Docs, Sheets, Slides) are supported. PDFs, images, and other binary formats are not supported.
- The connector can create Google Docs, Sheets, and Slides, and edit Google Docs it created. It can't edit Docs created outside the connector, or edit existing Sheets or Slides.
- Reading a very large document can be slow.
Note
The use and transfer of raw or derived user data received from Google Workspace APIs will adhere to the Google API services User Data Policy, including the Limited Use requirements.
Gmail
- The connector can search, read, and draft email, but it can't send email or edit existing messages.
- The connector can't add Drive files as native Gmail attachments. As a workaround, include links to the files in the email body.
Microsoft 365
- Includes SharePoint, OneDrive, Teams, Outlook, Calendar, and online meetings.
- The connector can draft Outlook email but can't send it.
- Maximum file size is 25 MB for SharePoint files.
- Supported SharePoint file types include built-in SharePoint documents, spreadsheets, and presentations, as well as common text-based formats such as
.txt,.csv,.json,.md, and others. PDFs, images, and other binary formats are not supported.
Glean (Beta)
- Glean is search-only. It can't read a document from a direct link.
- A metastore admin must first configure the Glean tenant ID before non-admin users can use the connection. The admin can enter the tenant ID when first connecting to Glean.
- To connect to a specific Glean MCP server, a metastore admin can optionally set the MCP server path (for example,
/mcp/eng) when setting up the connection. Leave this field blank to use the default path (/mcp/default). Non-admin users cannot specify or change the Glean MCP server path.
Slack
- The connector can't edit or delete a message after sending it.
GitHub
- Writes are limited to file contents, issues, and pull requests.
- By default, the Databricks GitHub MCP connector can access only public repositories. To access private repositories, or to make changes such as committing files or creating issues and pull requests, the repository owner or a GitHub organization administrator must complete additional setup. See Enable GitHub write access and private repository access.
- GitHub Enterprise Server (the self-hosted version of GitHub) is not supported.