{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Celonis Agent Tools (MCP Server) in Claude","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":"celonis-agent-tools-mcp-server-in-claude","__idx":0},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Celonis Agent Tools (MCP Server) in Claude"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This topic walks you through integrating your Celonis MCP Server with Claude (web, CLI). This integration enables your AI agents to leverage your Celonis tools and capabilities from Claude."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Celonis provides a pre-registered OAuth client for Claude, so you do ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," need to create your own OAuth client in the Celonis Platform. Instead, you only need to deploy your Agent Tools asset, add it as a connector in Claude, and then sign in."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Prerequisites"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before you begin, ensure you have:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Completed the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.notion.so/getting-started.md"},"children":["Getting Started"]}," guide and set up your Agent Tools Asset (MCP Server) in Celonis."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP Server URL"]},", in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://[team].[realm].celonis.cloud/studio-copilot/api/v1/mcp-servers/mcp/[mcp-server-id]"]}," format."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A published Agent Tools (MCP) asset and the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["use package"]}," permission assigned to the package containing it."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A Claude account. Custom connectors are available on the Free, Pro, Max, Team and Enterprise plans. Free accounts are limited to one custom connector."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For Team and Enterprise plans: if you want the connector to be available to everyone, an Owner needs to add it once by going to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Organization settings > Connectors"]},". Individual members will still need to authorize it with their own Celonis account."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-collect-your-connection-details","__idx":2},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Step 1: Collect Your Connection Details"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You need two values:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP Server URL"]},": Copied from the Getting Started guide. It looks similar to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://[team].[realm].celonis.cloud/studio-copilot/api/v1/mcp-servers/mcp/[mcp-server-id]"]},", where ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[mcp-server-id]"]}," is the ID of your Agent Tools (MCP) Asset. Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://test.eu-1.celonis.cloud/studio-copilot/api/v1/mcp-servers/mcp/3f2b1c9e-7d4a-4f1b-9c8e-2a5d6b7c8e9f"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["claude_mcp_server_asset_oauth_1p"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There is no client secret. The Celonis client for Claude is a public OAuth client that uses PKCE, so you can leave the secret field empty."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The connection authorizes using the Authorization Code grant, so it inherits the permissions of the Celonis user who signs in. If a user needs additional permissions, go to the package you are using in Studio and follow ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.celonis.com/en/managing-packages-and-package-permissions.html"},"children":["these instructions"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-add-the-celonis-mcp-server-to-claude","__idx":3},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Step 2: Add the Celonis MCP Server to Claude"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Important"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Any references to third-party products or services do not constitute Celonis product documentation nor do they create any contractual obligations. This material is for informational purposes only and is subject to change without notice."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Celonis does not guarantee the availability, accuracy, reliability, completeness, or usefulness of any information regarding the subject of third-party services or systems."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open Claude and go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Customize > Connectors"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add custom connector"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]},", such as \"Celonis\"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Remote MCP server URL"]},", paste your MCP Server URL from ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#step-1-collect-your-connection-details"},"children":["Step 1"]},". Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continue"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/claude-add-custom-connector.0685c1319119e8a8da37efaa58937bdf58396c9ccc0e84e610e5dfb961b53801.a6bd5218.png","alt":"claude_add_custom_connector"},"children":[]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":5},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When you get the following message, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]},": \"Couldn't determine the server settings. You can still configure them manually. Click Next to configure the connector manually.\""]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/claude-add-custom-connector-error.2bf81d6482dad2cd6dc3d0dc8df523e4350e8d1f37ec91104d70b2da5be0889e.a6bd5218.png","alt":"claude_add_custom_connector_error"},"children":[]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":6},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the following window, under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication"]}," select \"Always required\" and under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth client"]}," select \"Use your own OAuth client\"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth Client ID"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["claude_mcp_server_asset_oauth_1p"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Leave the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth Client Secret"]}," field empty."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add"]},"/",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/claude-add-custom-connector-settings.52f106237d782f5acc73ac7148000949386e11e1893f5937e86bd25107280fdc.a6bd5218.png","alt":"claude_add_custom_connector_settings"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3-authorize-the-connection","__idx":4},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Step 3: Authorize the Connection"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Claude redirects you to Celonis. Sign in to your Celonis account if you are not already signed in."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Celonis shows a consent screen listing the access Claude is requesting - the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcp-asset.tools:execute"]}," scope. Review the request and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authorize"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You are returned to Claude and the connector shows as connected."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/claude-add-custom-connector-consent.635d419f1f46e75d262a8c672db6104aa57b8f9e3738a441564a0aea4c6dc21f.a6bd5218.png","alt":"claude_add_custom_connector_consent"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-4-view-available-tools","__idx":5},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Step 4: View Available Tools"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open the connector's settings in Claude. You can see all the tools published by your Agent Tools (MCP Server) Asset. You can enable or disable individual tools from this screen if you only want Claude to use a subset of those tools."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/claude-add-custom-connector-tools.2e9d5f27ce36399d559ca2ac5c4d571e27472560aef5a2adbe5942f52fe88762.a6bd5218.png","alt":"claude_add_custom_connector_tools"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-5-test-your-integration","__idx":6},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Step 5: Test your Integration"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Start a new conversation and ask Claude a question that requires your Celonis tools. Claude asks for your approval the first time it calls a tool and then shows you the tool call and its result inline."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"optional-connect-from-claude-code","__idx":7},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Optional: Connect from Claude Code"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The same Celonis client works with Claude Code, so developers can use your Celonis tools from the command line."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"claude mcp add --transport http \\\n  --client-id claude_mcp_server_asset_oauth_1p \\\n  celonis https://[team].[realm].celonis.cloud/studio-copilot/api/v1/mcp-servers/mcp/[mcp-server-id]\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Run ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/mcp"]}," inside Claude Code to start the authorization flow, then confirm the server shows as connected."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To share the configuration with a team through version control, commit a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".mcp.json"]}," file in your repository root:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"mcpServers\": {\n    \"celonis\": {\n      \"type\": \"http\",\n      \"url\": \"https://${CELONIS_TEAM}.${CELONIS_REALM}.celonis.cloud/studio-copilot/api/v1/mcp-servers/mcp/${CELONIS_MCP_SERVER_ID}\",\n      \"oauth\": {\n        \"clientId\": \"claude_mcp_server_asset_oauth_1p\"\n      }\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each developer sets ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CELONIS_TEAM"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CELONIS_REALM"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CELONIS_MCP_SERVER_ID"]}," in their own environment, so one file works across teams and assets."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"troubleshooting","__idx":8},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Troubleshooting"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you encounter issues:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check that your MCP Server URL is correct and that your Agent Tools (MCP) Asset is published."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm the Client ID is exactly ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["claude_mcp_server_asset_oauth_1p"]}," and that the client secret field is empty."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If authorization fails immediately, sign in to your Celonis team in a browser first, then retry ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect"]},". The connector requires an interactive sign-in and cannot use a Celonis API key or application key."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the tool list is empty after a successful connection, disconnect and then reconnect the connector so Claude refreshes the tool list."]}]}]},"headings":[{"value":"Celonis Agent Tools (MCP Server) in Claude","id":"celonis-agent-tools-mcp-server-in-claude","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Step 1: Collect Your Connection Details","id":"step-1-collect-your-connection-details","depth":2},{"value":"Step 2: Add the Celonis MCP Server to Claude","id":"step-2-add-the-celonis-mcp-server-to-claude","depth":2},{"value":"Step 3: Authorize the Connection","id":"step-3-authorize-the-connection","depth":2},{"value":"Step 4: View Available Tools","id":"step-4-view-available-tools","depth":2},{"value":"Step 5: Test your Integration","id":"step-5-test-your-integration","depth":2},{"value":"Optional: Connect from Claude Code","id":"optional-connect-from-claude-code","depth":2},{"value":"Troubleshooting","id":"troubleshooting","depth":2}],"frontmatter":{"seo":{"title":"Celonis Agent Tools (MCP Server) in Claude"}},"lastModified":"2026-08-26T22:24:22.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/mcp-server-asset/integrations/claude-connector-agent-tools","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}