{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img"]},"type":"markdown"},"seo":{"title":"Connecting Celonis Agent Tools (MCP Server) to Databricks","description":"API documentation for Celonis APIs.","siteUrl":"https://developer.celonis.com","keywords":"celonis developer portal, celonis apis, celonis api reference docs","lang":"en-US","llmstxt":{"hide":false,"description":"Celonis API documentation","sections":[{"title":"API Docs","description":"Available Celonis API Docs","includeFiles":["**/*.md"]},{"title":"API Specs","description":"All Celonis API specifications","includeFiles":["**/openapi.yaml"]}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"connecting-celonis-agent-tools-mcp-server-to-databricks","__idx":0},"children":["Connecting Celonis Agent Tools (MCP Server) to Databricks"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The MCP Server allows Celonis to securely interact with Databricks, enabling agents to retrieve context from the Celonis Context Model."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication-support","__idx":1},"children":["Authentication support"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For production environments and Celonis-based integrations, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth 2.0 is required"]}," due to Celonis ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.celonis.com/en/upcoming-changes.html"},"children":["decommissioning of legacy API and application keys"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication-recommendations","__idx":2},"children":["Authentication recommendations"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth User-2-Machine (U2M) - Per User:"]}," Best for individual developers (e.g., Claude Code, Cursor). Provides per-user audit trails and automatic token refresh via PKCE."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth User-2-Machine (U2M) - Shared:"]}," Best for teams where individual accountability is secondary to simplicity. Retains the browser-based flow. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Recommended use for a Celonis Setup"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth M2M (Machine-to-Machine):"]}," Best for automated pipelines and shared background agents. Fully automated with no interactive login."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PAT / Bearer Token:"]}," Use only for quick, local testing. These are static secrets and are not supported for Custom MCP servers; their use is being deprecated by Celonis."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Dynamic Client Registration:"]}," Automatically discover and register OAuth credentials using the RFC 7591 protocol. Each user authenticates individually."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"configuration-steps","__idx":3},"children":["Configuration steps"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"celonis-platform-setup","__idx":4},"children":["Celonis Platform setup"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Configure OAuth 2.0 in the Celonis Platform by going to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Admin & Settings > Applications"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+Add new Application"]}," button and select \"OAuth Client\" from the dropdown."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Enter a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]}," and then select \"Authorization Code\" as the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Grant Type"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select \"Client Secrets\" as the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication Method"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Set the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Redirect URI"]}," to: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://dbc-0c325915-8414.cloud.databricks.com/login/oauth/http.html"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Grant the necessary scope: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcp-asset.tools:execute"]}," and Celonis assets (i.e. specific Studio Package)."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ensure the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Refresh Token"]}," option is enabled."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mcp-db-new-oauth.0b1002189a029dbeefe8a3b3a0bc79b691f0b5c287267ddc6c49746b05346113.a8ea4255.png","alt":"mcp-db-new-oauth.png","framed":false,"withLightbox":true,"width":"","height":""},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Define Scopes"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Save your Credentials (Client ID/Secret)."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To assign permissions, click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]}," icon and select \"Permissions\"."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mcp-db-permissions.96d10168f30d1174308a680724d53d73536d65ad9151af0c59674a282e35d65e.a8ea4255.png","alt":"mcp-db-permissions.png","framed":false,"withLightbox":true,"width":"","height":""},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the checkboxes to grant permissions to the OAuth key in this specific Studio Package."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mcp-db-grant-all.29377f7300d2f3e324ea156a92dd056a3b248e13653603c022b1221f39a50924.a8ea4255.png","alt":"mcp-db-grant-all.png","framed":false,"withLightbox":true,"width":"","height":""},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"databricks-unity-catalog-configuration","__idx":5},"children":["Databricks Unity Catalog configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Unity Catalog serves as the unified governance layer within Databricks. By creating a Connection object in Unity Catalog, you centralize the management of credentials for external MCP servers. Databricks Workspace must be in a Model Serving-supported region and the user must have ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CREATE CONNECTION"]}," privilege."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This ensures that when Databricks Agents or Genies access Celonis, they do so through governed, reusable connections, removing the need for manual configuration per asset."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To create a connection in the Unity Catalog UI, go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Catalog > Create a connection"]},"."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mcp-db-create-connection.2e354e6ef8f2aacdf4515da1323f9d9a46e8f185ce8dcaed3754c8568ab7b241.a8ea4255.png","alt":"mcp-db-create-connection.png","framed":false,"withLightbox":true,"width":"","height":""},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select \"HTTP\" as the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connection type"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["From the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Auth type"]}," dropdown, select the authentication method (e.g., OAuth User-To-Machine Shared) matching your Celonis setup."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mcp-db-connection-auth-type.449d27d4906b477836fd3915537bec5c02fb51dd4eb48e009e241fc6e4655275.a8ea4255.png","alt":"mcp-db-connection-auth-type.png","framed":false,"withLightbox":true,"width":"","height":""},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To configure the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication Endpoint"]}," (example for Setup with OAuth User-to-Machine Shared):"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Celonis base URL"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://[team].[realm].cloud"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Secret"]}," from the OAuth2.0 previously set up."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth Scope"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcp-asset.tools:execute"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authorization endpoint"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://[team].[realm].cloud/oauth2/authorize"]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mcp-db-new-connection-auth.f4677e88f10aeae6325b0dbd28a085f03a147c0fdc0b950f93e0540dae3acd2b.a8ea4255.png","alt":"mcp-db-new-connection-auth.png","framed":false,"withLightbox":true,"width":"","height":""},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Token Endpoint:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://[team].[realm].cloud/oauth2/token"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set ONLY the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Base path"]}," from the MCP asset: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/studio-copilot/api/v1/mcp-servers/mcp/[your-specific-url]"]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mcp-db-asset-demo.e46b4d62c08cd0774200e7cce2c34889103ea2a69b3cf6e792c590ef84d1831a.a8ea4255.png","alt":"mcp-db-asset-demo.png","framed":false,"withLightbox":true,"width":"","height":""},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Is MCP Connection"]}," checkbox.",{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mcp-db-connection-details.48b262b59dd49d0acdf3a8ce33a37ac32959a93f9f1ca811ec68a122d8cb4f80.a8ea4255.png","alt":"mcp-db-connection-details.png","framed":false,"withLightbox":true,"width":"","height":""},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create Connection"]},"."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once configured, the Celonis MCP Server is accessible via Unity Catalog and available to Databricks Agents and Genie."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mcp-db-catalog.a4b7ce24c9e76b0f3514d7459ad2dc031af3abf8f41e382303043a94c1799503.a8ea4255.png","alt":"mcp-db-catalog.png","framed":false,"withLightbox":true,"width":"","height":""},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"troubleshooting-and-additional-resources","__idx":6},"children":["Troubleshooting and additional resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connection Issues:"]}," If your connection drops frequently, verify that \"Refresh Token\" is enabled in your OAuth settings."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Official Documentation:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.databricks.com/aws/en/generative-ai/mcp/connect-external-services"},"children":["Connect External Services"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.databricks.com/aws/en/dev-tools/auth/oauth-u2m"},"children":["OAuth ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["U2M"]}," Authentication"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.databricks.com/aws/en/dev-tools/auth/oauth-m2m"},"children":["OAuth ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["M2M"]}," Authentication"]}]}]}]}]}]},"headings":[{"value":"Connecting Celonis Agent Tools (MCP Server) to Databricks","id":"connecting-celonis-agent-tools-mcp-server-to-databricks","depth":1},{"value":"Authentication support","id":"authentication-support","depth":2},{"value":"Authentication recommendations","id":"authentication-recommendations","depth":2},{"value":"Configuration steps","id":"configuration-steps","depth":2},{"value":"Celonis Platform setup","id":"celonis-platform-setup","depth":3},{"value":"Databricks Unity Catalog configuration","id":"databricks-unity-catalog-configuration","depth":3},{"value":"Troubleshooting and additional resources","id":"troubleshooting-and-additional-resources","depth":2}],"frontmatter":{"seo":{"title":"Connecting Celonis Agent Tools (MCP Server) to Databricks"}},"lastModified":"2026-09-28T20:51:30.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/mcp-server-asset/integrations/mcp-server-to-databricks","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}