Bemærk
Adgang til denne side kræver godkendelse. Du kan prøve at logge på eller ændre mapper.
Adgang til denne side kræver godkendelse. Du kan prøve at ændre mapper.
Expand Genie's and Genie Code's code search capabilities by connecting to GitHub with the native connector or a custom MCP server.
Note
MCP servers are only supported in Genie Code Agent mode.
Use the native connector (recommended)
Important
This feature is in Beta. To use third-party data source connectors, a workspace admin must enable the Third Party Connectors for Agents preview. See Manage Azure Databricks previews.
To connect Genie or Genie Code to GitHub, use the Databricks native third-party connector. See Use native connectors for third-party data sources and Add a data source to a conversation. For private repositories, admins need to enable access.
- For the connection type, select the default Databricks system connection (Recommended). You can also select a custom connection.
- To improve responses, add personal context for each repository to help GitHub search tools understand your codebase.
Enable private repository access
The default Databricks system connection for GitHub can access only public repositories. To give the connection read access to private enterprise repositories, a GitHub organization admin must complete the following steps:
Install the Databricks GitHub connector app on your GitHub organization so it has read access to your private repositories.
Allowlist the Databricks serverless outbound IPs for your workspace's cloud and region. For the list of IP addresses, see IP addresses and domains for Azure Databricks services and assets. For instructions on configuring allowed IP addresses for your GitHub organization, see Managing allowed IP addresses for your organization.
After admin setup is complete, users in your organization can access private repos using the default Databricks system connection.
Create a custom GitHub MCP server (not recommended)
Skip this section if your Databricks workspace already has a GitHub Unity Catalog connection available for you to use. If you only need access to public repositories and your own account's information, skip to step 3.
Follow the steps below to create a custom GitHub MCP server. This allows you to configure the server to your specific data and security needs.
From your GitHub account, create a GitHub app. For enterprise codebases, a GitHub organization admin must complete this step.
- Navigate to Profile > Settings > Developer settings > GitHub Apps and click New GitHub App.
- Fill in the requested fields. The Callback URL should be
https://<your-databricks-workspace-url>/login/oauth/http.html. This is how GitHub authenticates with your Databricks workspace.- Homepage URL does not impact the MCP server and may be set to any value you prefer
- Uncheck the "active" box to make Webhook URL an optional field
- Grant your GitHub app the necessary permissions to access your repository and organization.
- Click Create GitHub App.
In the newly created app, under Client secrets, click Generate a new client secret. Copy this value.
Create a new Unity Catalog connection for GitHub. You must have
CREATE CONNECTIONprivileges.- If your workspace already has one installed, you can use the existing one as long as you have
USE CONNECTIONprivileges on it. - Fill in these fields:
- Connection type:
HTTP - Auth type:
OAuth User to Machine - OAuth provider:
Manual configuration- If you only need access to public repositories and your own account's information, select
Github MCPhere and skip the rest of the steps.
- If you only need access to public repositories and your own account's information, select
- Host:
https://api.githubcopilot.com - OAuth scope: The scopes of your app. For example,
mcp:access read:user user:email repo read:org - Client secret and client ID: generated from Step 2
- Authorization endpoint:
https://github.com/login/oauth/authorize - Token endpoint:
https://github.com/login/oauth/access_token - Base path:
/mcp - Is mcp connection:
checked
- Connection type:
- Click Create connection.
- If your workspace already has one installed, you can use the existing one as long as you have
In the top right corner, click Login to login to your connection. This opens a new window prompting you to authorize the GitHub App to your Databricks account. Click connect on the GitHub account you wish to connect to.
Your GitHub MCP is now ready to use. You can select this connection when using the native connector or manually add the external MCP server to Genie Code.