Celonis MCP Server (Preview)

The Celonis MCP Server provides a growing set of ready-to-use tools that agents can use to search for relevant information, get real-time process context, trigger actions in external systems, and write back decisions to Celonis. Delivered securely via the MCP protocol, this toolkit makes it easy to build sophisticated agents that leverage Process Intelligence.

This connector is available in the following products and regions:

Celonis MCP Server Connector

The Celonis MCP Server provides a growing set of ready-to-use tools that agents can use to search for relevant information, get real-time process context, trigger actions in external systems, and write back decisions to Celonis. Delivered securely via the MCP protocol, this toolkit makes it easy to build sophisticated agents that leverage Process Intelligence.

Prerequisites

You will need the following to proceed:

• A Microsoft Power Apps or Power Automate plan with custom connector feature
• A Celonis account with access to MCP Server Asset
• The Power Platform CLI tools

Celonis MCP Server Asset Configuration

Step 1: Create and Configure Your MCP Server in Celonis

Before setting up authentication, you need to create and publish an MCP Server asset in Celonis:

1. Log in to your Celonis account with access to MCP Server Asset

2. Navigate to Studio and select your desired package

3. Create an MCP Server Asset

   • Create a new asset with the type "MCP Server"

4. Configure the MCP Server

   • Add the desired tools to your MCP Server

5. Publish the Asset

   • Once configured, publish the asset
   • After publishing, a link for the published asset will appear at the top of the asset
   • This link is your MCP Server URL (format: https://[team].[realm].celonis.cloud/studio-copilot/api/v1/mcp-servers/mcp/[mcp-server-id])
   • Save this URL for later use when creating your Celonis MCP Server connection

Step 2: Set Up OAuth 2.0 Authentication

1. Create an OAuth Client in Celonis
   • In Celonis platform, go to Admin & Settings
   • Under the Applications tab, click to add a new application
   • Select application type: OAuth Client
   • Give it a descriptive name
   • Set Grant Type to: Authorization Code
   • Set Redirect URI to: https://global.consent.azure-apim.net/redirect/celonis-20mcp-20server-5f61a292eb24590c19-5fdf63166fa0464df5
   • Important: For Authentication Methods, select Client Secret and enable both:
     • Client secret basic
     • Client secret post
     • Enable refresh token
   • Under the MCP scope group, enable the scope: mcp-asset.tools:execute
   • Save and note down your Client ID and Client Secret

Step 3: Grant Permissions to Your MCP Server Asset

After creating your OAuth Client:

1. Go back to your MCP Server asset in Studio
2. Navigate to the Permissions section of the asset
3. Grant permissions to your newly created OAuth Client:
   • Search for the name of the OAuth Client
   • Grant the 'use' permission to the asset

This step is crucial to allow your connector to access the MCP Server.

Deploy the Connector

Run the following commands and follow the prompts:

paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --secret "placeholder-not-used"

Additional Resources

• Celonis Website
• Celonis Privacy Policy
• Celopeers Community Support

Creating a connection

The connector supports the following authentication types:

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Throttling Limits

Actions

Celonis MCP Server