This article explains how to configure Cherry, a free open-source AI assistant platform, to connect with your Ardoq MCP server. When Cherry 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 Cherry platform.
Install Cherry
Download the app from the official site: https://www.cherry-ai.com/download
Click the Download button that matches your operating system.
Follow the installation instructions.
If the page is in Chinese and your browser does not automatically translate it, you can follow these steps:
Click the Kebab-menu icon
Click Translate...
Click the Kebab-menu icon in the pop-up and select Page Not in
Select Chinese (Simplified)
Configure Cherry to Use the Ardoq MCP Server
This section explains how to connect Cherry with the Ardoq MCP server and an AI Assistant of choice. You will need an API Key for your AI Assistant provider, for example Google Gemini, as well your Ardoq API key. You can get this from your Service Account in Ardoq.
1. Set Provider
Open Cherry
Click the Gear-icon in the bottom left corner
Select your provider of choice from the list, for example Gemini
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 Cherry, as mentioned above
Press Check and then Ok in the pop-up to verify that the API Key is correct.
Make sure your provider is switched on by clicking on the toggle (it should be green)
2. Connect to the Ardoq MCP server
Open the assistant window by clicking the Chat-icon in the top left corner
Click the Terminal-icon located under the chat bar to configure MCP Servers
Click Add Server... in the pop-up, and then + Add Server in the MCP Server Window
Choose a fitting name, for example Ardoq MCP
Under Type, select Server-Sent Events (sse)
Under URL, input the following URL:
https://<your-host>.ardoq.com/mcp/sse
Replace
<your-host>with your Ardoq Org hostname
Under Headers, input the following text string:
Authorization=Bearer <your-token>
Replace
<your-token>with your Ardoq API Key (long string of letters and numbers)Make sure there are no extra spaces at the end of the string, and only a single space between 'Bearer' and your API key
Click Save
3. Test the Integration
You have now created a tool allowing Cherry to connect to the Ardoq MCP server.
Navigate back to the assistant window
Make sure you have the right provider selected in the bar on the top of the window. DeepSeek might be selected by default.
Make sure the Terminal-icon is green and that your Ardoq MCP server is selected when clicking the Terminal-icon
Try prompting the chat with:
"Please show me the reports I have in Ardoq"
If configured correctly, Cherry 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>"
Cherry will then search for that report in your Ardoq org and fetch all the available information.
You're All Set!
Cherry is now successfully integrated with the Ardoq MCP server. From here, you can start exploring your Ardoq data through natural conversation.