Eulerian MCP Integration Guide for Claude Desktop

Eulerian MCP Integration Guide for Claude Desktop

EULERIAN MCP
Integration Guide with Claude Desktop
For users without advanced technical knowledge
One-click extension or manual install · Claude Desktop

1. What the Eulerian MCP is

The Eulerian MCP (Model Context Protocol) is a connector that lets Claude read your Eulerian Marketing Platform data directly. Instead of opening dashboards, exporting CSV files or writing SQL queries, you simply ask Claude in plain language.
A simple analogyThink of the MCP as an «interpreter» between Claude and Eulerian. Claude speaks natural language, Eulerian speaks APIs; the MCP translates between the two automatically.

What you can do with it:

  • Check last week's paid-search campaign performance with a single sentence.
  • Find out which media channels drove the most conversions this month.
  • Analyse the customer journey of your highest-converting segment.
  • Get analytics insights without exporting data manually.

2. Before you begin

Make sure you have these four things before continuing with the installation:
Title
Title
1
An active Eulerian account (Webmaster type)
You need webmaster access to your Eulerian Marketing Platform instance. If you don't have it, contact your platform administrator.
Title
Title
2
Your Eulerian API token
A secret key that Eulerian provides. Keep it somewhere safe; you'll need it in Step 3 (or when configuring the extension).
Title
Title
3
Python 3.10 or later
Download it from  python.org/downloads . During installation on Windows, tick «Add Python to PATH». Required for BOTH methods: the manual method (Section 3) uses it directly, and the .dxt extension (Section 4) also runs on your system's Python.
Title
Title
4
Claude Desktop installed
Download it from  claude.ai/download . This guide uses Claude Desktop as the main client.

3. Manual installation (terminal + configuration file)

This is the classic method, using commands. If you prefer an install with no commands and no Python, go straight to Section 4 (one-click extension); you only need one of the two methods.
Step 1 Install the Eulerian package
Open a terminal (Windows: search for «cmd» or «PowerShell»; Mac: search for «Terminal») and run this command:
pip install eulerian-marketing-platform
What does this do?It downloads and installs the Eulerian MCP connector on your computer. It's like installing any app, but from the terminal. When it finishes you'll see: Successfully installed eulerian-marketing-platform.
Step 2 Locate the Claude Desktop configuration file
Claude Desktop has a configuration file where we tell it to use Eulerian. Depending on your operating system:
System
File path
Windows
%APPDATA%\Claude\claude_desktop_config.json
macOS
~/Library/Application Support/Claude/claude_desktop_config.json
Linux
~/.config/Claude/claude_desktop_config.json
Shortcut from Claude DesktopOpen Claude Desktop > Claude menu > Settings > Developer > Edit Config. The file opens directly.
Step 3 Add the Eulerian configuration
Open claude_desktop_config.json with any text editor (Notepad, TextEdit, VS Code…) and replace its content with the following, replacing the UPPERCASE PLACEHOLDER values (endpoint and token) with your own:
{"mcpServers": {"eulerian-marketing-platform": {"command": "python","args": ["-m", "eulerian_marketing_platform.server"],"env": {"EMP_API_ENDPOINT": " https://YOUR-INSTANCE.api.eulerian.com/mcp ","EMP_API_TOKEN": "YOUR_SECRET_TOKEN_HERE"}}}}
Important — replace the valuesReplace  YOUR-INSTANCE.api.eulerian.com  with your real Eulerian server URL, and YOUR_SECRET_TOKEN_HERE with your API token. Never share this file with anyone.
Save the file with Ctrl+S (or Cmd+S on Mac).
Step 4 Restart Claude Desktop and check the connection
Close Claude Desktop completely (don't just minimise the window) and open it again.
Sign of successLook for a hammer icon in the bottom-right corner of the chat. Clicking it shows the available Eulerian tools. Alternatively, just ask Claude whether it is connected to the Eulerian MCP.
To confirm everything works, type in Claude:
Which Eulerian Marketing Platform tools do you have access to?
Claude should reply listing the tools available on your platform. The integration is complete.

4. Alternative: one-click install with the extension (.dxt)

In addition to the manual method in Section 3, Eulerian offers a one-click extension for Claude Desktop. It's the simplest route: no terminal, no `pip` commands and no editing JSON files. Recommended for non-technical users.
Which one should I choose?The .dxt extension is the fastest and simplest way. The manual method (Section 3) is still valid and useful if your organisation restricts installing extensions or if you prefer to control the configuration by hand. Both methods give the same result; use only one of the two.
You need the same as before — your Eulerian endpoint and token (items 1 and 2 in Section 2) — Claude Desktop installed, and Python 3.10 or later (the extension uses it to run; see the note below).
What about Python?The extension saves you the terminal, the pip install command and editing JSON, but it does need Python 3.10+ installed on the machine: Claude Desktop ships with its own Node.js runtime but does not bundle Python, so the extension runs on your system's Python. If you don't have it, install it first (item 3 in Section 2; on Windows tick «Add Python to PATH»). The connector code itself is inside the .dxt, so you do not need to run pip install.
Step 1 Get the extension file
Download the file eulerian-marketing-platform-0.2.9.dxt (provided by Eulerian; it's also available in the GitHub repository listed under Resources). Save it somewhere easy to find, for example your Downloads folder.
About the versionThe file name includes the version number (here 0.2.9). If Eulerian publishes a newer version, update by installing the new .dxt file the same way.
Step 2 Open Extensions in Claude Desktop
In Claude Desktop, go to the Claude > Settings menu and open the Extensions section. You'll see the «Installed on your computer» area and, below it, a zone that reads «Drag .MCPB or .DXT files here to install».
Step 3 Install the extension
Drag the eulerian-marketing-platform-0.2.9.dxt file from its folder onto that install zone (or use Advanced settings to select it). Once installed, it appears in the list as «Eulerian Marketing Platform» with a CUSTOM label and a Configure button.
The installed extension appears as «Eulerian Marketing Platform» (CUSTOM), with a «Configure» button and the drop zone for .DXT / .MCPB files. (Screenshot shows the Spanish UI.)
Step 4 Configure the endpoint and token
Click Configure (or click the extension) to open its settings. Turn on the «Enabled» toggle and fill in the fields:
  • API Endpoint (required): your Eulerian MCP server URL, e.g.  https://your-instance.api.eulerian.com/mcp .
  • API Token (required): your Eulerian authentication token.
  • Request Timeout (seconds): maximum wait time for responses. Leave 300 or increase it for long-running queries.
Click Save.
The extension's configuration screen: API Endpoint, API Token (hidden) and Request Timeout. Click «Save» when done. (Screenshot shows the Spanish UI.)
Step 5 Check the connection
The extension should show as «Enabled». Open a chat and click the hammer icon (bottom-right) to see the Eulerian tools, or ask Claude directly:
Which Eulerian Marketing Platform tools do you have access to?
If Claude lists the available tools, the integration is complete.
DoneYou've connected Eulerian to Claude with no terminal, no commands and no editing JSON. The result is the same as the manual method in Section 3.
Updating or removing the extensionTo change the endpoint or token, return to Settings > Extensions > eulerian-marketing-platform and click Configure. To remove it, use Uninstall. The token is shown hidden; treat it like a password.

5. How to use it — Example questions

Once connected (by either method), you can ask Claude in plain language. Some examples:
  • How did our paid-search campaigns perform last week?
  • Which media channels contributed most to conversions this month?
  • Show me the customer journey for our highest-converting segment.
  • How many unique sessions did we have in the last 7 days compared with the previous month?
  • Which Eulerian tools do you have available?
Tip for better resultsBe specific in your questions. Instead of «how are the campaigns doing?», try «what is the CPA of our display campaigns last month?». The more concrete, the more precise Claude's answer will be.

6. Security and best practices

Check with your IT department

Before using real business data, confirm with IT which AI platforms are approved by your organisation. Prefer enterprise services such as Claude Teams/Enterprise.

Verify important figures

AIs can make mistakes when phrasing queries. Cross-check critical insights against the Eulerian interface directly. In Claude, you can click any figure to see which properties and metrics were actually queried.

Protect your API token

Your token is like a password. Don't share it, don't upload it to repositories such as GitHub, and don't include it in emails.

Be careful with multiple MCPs

Avoid using several MCPs at once unless you trust all of them. An insecure MCP can expose data from the other active connectors.

7. Common issue: the configuration file doesn't exist

This is a common issue on fresh Claude Desktop installs (manual method)When you go to Settings > Developer > Edit Config, Claude Desktop may show an error saying the path doesn't exist. This happens because the folder and file aren't created automatically until it's opened for the first time from that menu, or simply because your install didn't generate them. (If you use the .dxt extension in Section 4, this issue doesn't apply.)

How to fix it: create the folder and file manually

Follow these steps depending on your operating system:

On Windows

  • Open File Explorer and, in the address bar, type exactly: %APPDATA%\Claude
  • If the Claude folder doesn't exist, create it: right-click > New folder > name it exactly Claude.
  • Inside that folder, create a new text file: right-click > New > Text Document.
  • Rename the file to claude_desktop_config.json (remove the .txt extension if it appears).
  • Open that file with Notepad and paste exactly the content from Step 3 of Section 3.
  • Save with Ctrl+S and restart Claude Desktop.
Tip for showing extensions on WindowsIf you can't see the .txt extension when renaming the file, go to File Explorer > View menu > tick «File name extensions». Then you can rename it correctly to .json.

On macOS

Open Terminal (search for «Terminal» in Spotlight with Cmd+Space) and run these two commands, one at a time, to create the folder and the empty file:
mkdir -p ~/Library/Application\ Support/Claudetouch ~/Library/Application\ Support/Claude/claude_desktop_config.json
Open the file with any text editor (TextEdit, VS Code…), add the content from Step 3, save and restart Claude Desktop.

On Linux

Open a terminal and run:
mkdir -p ~/.config/Claudetouch ~/.config/Claude/claude_desktop_config.json
Edit the file with nano or any editor: nano ~/.config/Claude/claude_desktop_config.json. Paste the content from Step 3, save with Ctrl+O, confirm with Enter and exit with Ctrl+X. Restart Claude Desktop.
Final checkOnce the file is created and Claude Desktop restarted, go back to Settings > Developer > Edit Config. This time it should open without errors and show you the JSON content you added.

8. Other common issues

Issue
Solution
The server doesn't appear in Claude Desktop
Close Claude Desktop completely (make sure it's not still in the system tray) and reopen it. Check that the JSON file has no formatting errors, or that the .dxt extension is «Enabled».
Error: EMP_API_ENDPOINT variable required
The server URL isn't set correctly. Replace the example text with your real Eulerian URL (or fill it in the extension's configuration).
Error: EMP_API_TOKEN variable required
Your API token isn't set. Replace YOUR_SECRET_TOKEN_HERE with the real token provided by Eulerian (or enter it in the extension).
«python» is not recognised as a command
Affects BOTH methods: the .dxt extension and the manual method both run on your system's Python. Install Python 3.10+ and, on Windows, tick «Add Python to PATH»; close and reopen the terminal and check that «python» works. Also try python3. If Python isn't installed, the extension won't start either.
The data doesn't look right
Click the figure in Claude to see which metrics were queried. Rephrase your question, being more specific about the period or the metric you want.

9. Additional resources

  • GitHub repository:  github.com/EulerianTechnologies/eulerian-marketing-platform-mcp 
  • PyPI package:  pypi.org/project/eulerian-marketing-platform/ 
  • Official documentation:  eulerian.slite.page/p/NhupKnGmQtUv_E/MCP-Server 
  • Download Python:  python.org/downloads 
  • Download Claude Desktop:  claude.ai/download 
Simplified guide based on the official Eulerian Technologies documentation.