Prerequisites
- Account Admin permissions in Sidecar
- A connected Databricks integration with a workspace host, OAuth client ID, and client secret
- The service principal assigned to the workspace with Databricks SQL access
- Permission to use the managed SQL MCP and an eligible SQL warehouse
- Unity Catalog
USE CATALOG,USE SCHEMA, andSELECTgrants on the data agents should read
Configure network access
Sidecar’s provisioning and health checks connect from44.236.246.98/32.
Agent Console connects directly from Anthropic, whose outbound IPv4 range is
currently 160.79.104.0/21. Allow both in any Databricks workspace IP access list
that applies to the service principal.
Confirm Anthropic’s current outbound
addresses
before configuring access. A SQL warehouse connection test from Sidecar does
not establish runtime MCP access from Anthropic.
Confirm the managed connection
- In Integrations → Databricks → Connection, save the integration’s OAuth credentials.
- Open the MCP tab. Sidecar normally creates the managed SQL MCP within two minutes.
- Review the status and discovered tools. If Setup is taking longer than expected appears, click Check again.
- Open Integrations → MCP Servers and confirm the Databricks row.
- Confirm the agent grant and job selection.
The managed MCP selects its SQL warehouse automatically. That warehouse can
differ from the HTTP Path used by the warehouse integration. Check the
warehouse used by the MCP when investigating permission errors.
Verify Agent Console access
Start a new manual run after confirming the grant and job selection. Ask the agent to use the Databricks MCP server for these read operations:Additional custom endpoints
For another Databricks MCP capability, use the exact endpoint and permissions from the provider’s documentation. You can register it as a custom server only if it accepts the custom connector’s static bearer authentication and Streamable HTTP transport. The custom connector does not perform OAuth refresh. If the endpoint requires OAuth, use a supported native connector or a compatible gateway. Follow the provider’s authentication requirements rather than assuming a PAT works for every Databricks-hosted MCP endpoint.Troubleshooting
The managed server does not appear
The managed server does not appear
Save the OAuth Databricks integration and allow up to two minutes for setup.
Click Check again on the MCP tab if setup is taking longer than expected.
Contact support if the row remains missing; include the integration name and
setup timestamp, without credentials.
The server shows Auth error
The server shows Auth error
Read the status detail. Check service-principal assignment, OAuth credential
validity, managed SQL MCP permissions, and SQL warehouse access. Update
credentials on the Connection tab and select Check now after correcting
permissions.
Connected in Sidecar, but the agent cannot query
Connected in Sidecar, but the agent cannot query
Confirm the grant and job selection, then start a new run. Check workspace
access rules for Anthropic’s outbound addresses, the warehouse selected by
MCP, and Unity Catalog permissions on the exact table.