Skip to main content

Set up Databricks with Atlan MCP

Connect docs via MCP

Connect Databricks to the Atlan MCP server to access governed metadata, such as glossary definitions, lineage, ownership, certification status, and data quality, in your Databricks AI experiences.

Databricks acts as an MCP client: once you install the Atlan MCP connection from Databricks Marketplace and sign in to Atlan, its tools become available to your Databricks AI experiences automatically, with no code changes required. Databricks uses OAuth client authentication to connect to Atlan MCP.

Prerequisites​

Before you begin, make sure you have:

  • An Atlan tenant with Remote MCP enabled.
  • Your Atlan domain name. This is the part before .atlan.com.
  • An Atlan OAuth client ID and client secret. Generate these in Atlan from Settings (Admin) → API access → OAuth by selecting Generate new → Generate OAuth Client. For more information, see OAuth clients.
  • Permission in Databricks to add Marketplace connections.

Set up Atlan MCP​

Install the Atlan MCP connection from Databricks Marketplace and provide your Atlan OAuth client credentials.

  1. In Databricks, open Marketplace.

  2. Search for MCP, then select Atlan.

  3. Select Install to open the installation wizard, then enter a Connection name and your Atlan OAuth client ID and client secret.

  4. At the bottom of the form, select Install to confirm.

Sign in to Atlan​

After you add the connection, sign in to Atlan from the connection details page.

  1. In Databricks, go to Catalog → Connect → Connections.

  2. Select the Atlan MCP connection you created.

  3. Select Login.

  4. Enter your Atlan domain name, then select Sign in. Enter only the name before .atlan.com. For example, if your tenant URL is your-tenant.atlan.com, enter your-tenant.

  5. Complete the Atlan sign-in flow.

  6. On the confirmation page, select Open in MCP Client to return to Databricks.

You can now use your governed Atlan context in Databricks AI experiences.

View your MCP server​

Review the Atlan MCP server alongside your other MCP servers from the Databricks AI Gateway.

  1. In Databricks, go to AI Gateway → MCPs.

  2. Select the Atlan MCP server to view its details.

For more information, see View your MCP server in the Databricks documentation.

Test your MCP server​

Confirm the connection works by adding Atlan as a tool in the Databricks AI Playground.

  1. In Databricks, go to AI/ML → Playground.

  2. Select Tools → Add tool → UC connection, then select your Atlan connection.

  3. Prompt the agent to use Atlan—for example, ask it to find an asset or trace its lineage—and confirm it returns governed Atlan metadata.

For more information, see Test MCP servers within Databricks in the Databricks documentation.

Need help?​

If you have any issues configuring the integration, contact Atlan Support for assistance.

See also​