{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Configure the Claude Desktop / MCP Setup","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":"configure-the-claude-desktop--mcp-setup","__idx":0},"children":["Configure the Claude Desktop / MCP Setup"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Save this file by opening your Claude Desktop config file at:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mac:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["~/Library/Application Support/Claude/claude_desktop_config.json"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PC:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["%APPDATA%\\Claude\\claude_desktop_config.json"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Replace the placeholder values with your actual Celonis credentials."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"mcpServers\": {\n    \"celonis\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"mcp-remote\",\n        \"https://YOUR-TEAM.YOUR-REALM.celonis.cloud/studio-copilot/api/v1/mcp-servers/mcp/YOUR-MCP-SERVER-ID\",\n        \"--header\",\n        \"Authorization:${AUTH_TOKEN}\"\n      ],\n      \"env\": {\n        \"AUTH_TOKEN\": \"Bearer YOUR-ACCESS-TOKEN-HERE\"\n      }\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"placeholders-to-replace","__idx":1},"children":["Placeholders to replace"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Placeholder"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Placeholder"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What to put here"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What to put here"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YOUR-TEAM"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your Celonis team subdomain."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YOUR-REALM"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your Celonis realm (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["us-1"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eu-1"]},")."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YOUR-MCP-SERVER-ID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ID of your published MCP Asset in Celonis Studio."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YOUR-ACCESS-TOKEN-HERE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The bearer token generated by the refresh script see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/mcp-server-asset/troubleshooting/claude-refresh-token-script"},"children":["Auto-Refresh Script for Celonis Access Token"]},")"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"notes","__idx":2},"children":["Notes"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["-y"]}," flag auto-accepts the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["npx"]}," install prompt so the connection doesn't hang on first run."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AUTH_TOKEN"]}," is stored as an environment variable and referenced in the header. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Never hardcode the token directly in the args string."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["After editing the file, you must fully quit and reopen Claude Desktop for the changes to take effect."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The access token expires every 15 minutes — use the auto-refresh script to keep it current automatically."]}]}]},"headings":[{"value":"Configure the Claude Desktop / MCP Setup","id":"configure-the-claude-desktop--mcp-setup","depth":1},{"value":"Placeholders to replace","id":"placeholders-to-replace","depth":2},{"value":"Notes","id":"notes","depth":2}],"frontmatter":{"seo":{"title":"Configure the Claude Desktop / MCP Setup"}},"lastModified":"2026-08-27T16:35:27.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/mcp-server-asset/troubleshooting/claude-desktop-config","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}