Skip to content
Agent Tools (MCP) Asset
/
/
Configure the Claude Desk...
Last updated

Configure the Claude Desktop / MCP Setup

Save this file by opening your Claude Desktop config file at:

  • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
  • PC: %APPDATA%\Claude\claude_desktop_config.json

Replace the placeholder values with your actual Celonis credentials.

{
  "mcpServers": {
    "celonis": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://YOUR-TEAM.YOUR-REALM.celonis.cloud/studio-copilot/api/v1/mcp-servers/mcp/YOUR-MCP-SERVER-ID",
        "--header",
        "Authorization:${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "Bearer YOUR-ACCESS-TOKEN-HERE"
      }
    }
  }
}

Placeholders to replace

PlaceholderWhat to put here
YOUR-TEAMYour Celonis team subdomain.
YOUR-REALMYour Celonis realm (e.g., us-1, eu-1).
YOUR-MCP-SERVER-IDThe ID of your published MCP Asset in Celonis Studio.
YOUR-ACCESS-TOKEN-HEREThe bearer token generated by the refresh script see Auto-Refresh Script for Celonis Access Token)

Notes

  • The -y flag auto-accepts the npx install prompt so the connection doesn't hang on first run.
  • The AUTH_TOKEN is stored as an environment variable and referenced in the header. Never hardcode the token directly in the args string.
  • After editing the file, you must fully quit and reopen Claude Desktop for the changes to take effect.
  • The access token expires every 15 minutes — use the auto-refresh script to keep it current automatically.

Claude Desktop Setup Guide

Auto-Refresh Script for Celonis Access Token