This article explains how to configure 5ire, a free open-source AI assistant platform, to connect with your Ardoq MCP server. When 5ire is connected to both your AI assistant of choice—such as Gemini—and the Ardoq MCP server, the assistant can understand and interact with your Ardoq model data through the 5ire platform.
Prerequisites
5ire uses a local proxy for MCP communication through a Node.js module and runs the Ardoq MCP server as a local Python process. The following components must be installed:
Node.js – Handles the connection to the MCP server
Python – Required to run the MCP server
uv – A fast Python package manager used by 5ire
If you don't already have these dependancies installed, follow the steps below to install each one.
1. Install Node.js (v18 or higher)
Go to the official website: https://nodejs.org
Click the LTS version download for your operating system (Windows or macOS)
Run the installer and follow the instructions
After installation, open Command Prompt (Windows) or Terminal (macOS) and check the version:
node --version
You should see something like:
v18.17.1
2. Install Python (version 3.10 or higher)
Download the latest version for your operating system
Run the installer
On Windows, make sure to check “Add Python to PATH” before clicking Install
After installation, open your terminal and run:
python --version
or
python3 --version
Expected output (example):
Python 3.10.13
3. Install uv (Python package manager)
On Windows:
Open PowerShell
Run the following command:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
On macOS:
Open Terminal
Run the following command:
curl -LsSf https://astral.sh/uv/install.sh | sh
After installing uv, check that it's installed correctly:
uv --version
You should see something like:
uv 0.1.17
Once you’ve installed Node.js, Python, and uv, you’re ready to configure 5ire to connect to the Ardoq MCP server.
Install 5ire
Download the app from the official site: https://5ire.app/
Click the Download button that matches your operating system.
Follow the installation instructions.
Configure 5ire to Use the Ardoq MCP Server
This section explains how to connect 5ire with the Ardoq MCP server and an AI Assistant of choice. You will need an API key from an AI assistant (for example Gemini), as well as your Ardoq API key which you can get from your Service Account in Ardoq.
1. Set Provider
Open 5ire
Click the Fire-icon in the top left corner and choose Providers
Select your provider of choice from the list, for example Google
Enter your API Key in the empty field
You can get your Google Gemini API Key from this website: https://aistudio.google.com/
Press the button Get API key, then Create API key
Click the search bar and select a Google Cloud project, for example Gemini API
After your API key has been generated, copy it and paste it into the API Key field in 5ire, as mentioned above
2. Connect to the Ardoq MCP server
Click the Tools-icon in the top left corner
Enter a suitable Tool Key, for example
ardoq-mcp, then enter the following the following in the Command field:
npx mcp-remote https://<your-host>.ardoq.com/mcp/sse --header "Authorization:Bearer ${ARDOQ_API_TOKEN}"Replace
<your-host>with your Ardoq Org hostname
Under Environment Variables insert ARDOQ_API_TOKEN under Name, and your Ardoq API Key under Value.
The automatically generated Config Preview should look something like this:
{
"key": "ardoq-mcp",
"command": "npx",
"args": [
"mcp-remote",
"https://<your-host>.ardoq.com/mcp/sse",
"--header",
"Authorization:Bearer",
"${ARDOQ_API_TOKEN}"
],
"env": { "ARDOQ_API_TOKEN": "<your-token>" }
}<your-token>is your Ardoq API Key (long string of letters and numbers)<your-host>is your Ardoq Org hostname
3. Click Save
3. Test the Integration
You have now created a tool allowing 5ire to connect to the Ardoq MCP server. Turn it on my clicking the toggle in the Tools window.
Click the Chat-icon on the left-hand side to open a new chat 
Make sure you have the right provider in the tab above the chat.
Try prompting the chat with:
"Please show me the reports I have in Ardoq"
If configured correctly, 5ire will fetch real-time report from the Ardoq MCP server.
Next, you can try prompting:
"Can you give me more information <insert id of report from the list of reports>"
5ire will then search for that report in your Ardoq org and fetch all the available information.
You're All Set!
5ire is now successfully integrated with the Ardoq MCP server. From here, you can start exploring your Ardoq data through natural conversation.