Skip to main content

Using the Ardoq MCP Server Technology Preview

Connect a client to the Ardoq MCP server

A
Written by Alf Husem
Updated over a week ago

This article introduces the Ardoq MCP server and how it enables AI clients to retrieve real-time, structured data from Ardoq. It explains how the protocol works, what features Ardoq supports, and how to connect to Claude for Desktop, with connection guides to other clients coming soon.


What Is MCP?

The Model Context Protocol (MCP) is an open protocol that standardizes how external tools and data sources can be exposed to large language models (LLMs). MCP acts as a universal adapter between models and tools, allowing AI clients to discover and use tools dynamically, with minimal manual integration.

For example, with MCP, an AI assistant can connect to a system like Ardoq and automatically access up-to-date information, such as lists of projects, reports, or applications. It can then use that context to answer questions, generate summaries, or assist with decision-making. This removes the need for manual copy-pasting or hardcoded API calls, making it easier to bring real-time business data into AI-powered workflows.


Tools and Features

The Ardoq MCP server provides AI assistants with secure, real-time access to your Ardoq data through a growing set of tools. For example, an assistant can list your available reports, run and summarize them, and generate charts or visualizations, all using natural language.

Below are a few examples of how an AI assistant connected to the Ardoq MCP server can interact with your data through natural language.


Example 1: Explore Available Reports
The assistant uses the get_reports tool to retrieve a complete list of reports from the Ardoq workspace.


Example 2: Generate a Detailed Report Summary
In this example, the assistant runs a selected report and returns a summary with key insights like cost, progress, and timelines.


Example 3: Generate a Visual Summary from Multiple BCM Reports
The assistant combines data from multiple business capability reports to generate a visual dashboard showing various metrics.

Ardoq’s MCP tools make it easy to access and work with your data and insights through natural language, without using the Ardoq UI. While current tools are read-only, upcoming support for write operations, human-in-the-loop workflows, and new features such as get_metamodel and populate_viewpoint will enable even more powerful use cases. To suggest additional tools, visit the Ardoq Product Portal via the feedback link in the app.


FAQ

Q: Which functionality is available via MCP?

A: Functionality will be added over time. The current functionality includes:

  • Reports: Get report definition, List reports, Execute Report

  • Current User: get the current user information

  • Ardoq Tip: get a tip on using ardoq

Q: How are permissions enforced?

A: The MCP server provides access to a subset of API functionality. The permission model is enforced by the API access. For example, the User (or Service User) of the API token will only be able to access reports for which they have permission to view in the tool.

Q: Do we need access to the Ardoq API to use MCP?

A: Yes. MCP is a gateway to API functionality. Access to the API is a prerequisite for use.

Q: What is the URL for the MCP server?

A: https://<your-host>.ardoq.com/mcp/ - Note the trailing '/'


API Token Guidelines

To authenticate with the Ardoq MCP server, you must provide an API token in the Authorization header. This token should be generated from a service account, not tied to a personal user.

Follow these steps to create a secure and maintainable token for your integration:


  1. In Ardoq, go to:
    Preferences → Access Control → Service accounts

  2. Click Create new

  3. Fill in the required fields:

    • Service account name – e.g., Claude MCP Access

    • Token description – e.g., Used by Claude Desktop to access MCP server

    • Service account role – Choose a role with the minimum permissions needed (e.g., read-only access to relevant workspaces)

  4. Click Create service account

  5. Copy and save the generated token securely. This token will be used in the MCP configuration.

You will not be able to view the token again after closing the dialog. Store it securely.


2. Manage Existing Service Accounts

To update or remove a token:

  • Click the three-dot menu next to the service account name

  • Select Regenerate token or Delete

Regenerating a token will break any existing integration using the old token.


3. Follow These Security Best Practices

  • Use service accounts exclusively for MCP integrations

  • Restrict access to only what’s needed for your use case

  • Keep the token secret – never hardcode it or commit it to version control. Use environment variables in your config

Using service accounts ensures better security, easier management, and avoids disruptions when team members leave your organization.


Connect an AI Assistant to the Ardoq MCP Server

There are multiple MCP clients that can connect to the Ardoq MCP server and use your own AI provider. Each platform has its own setup process, and we provide dedicated guides to help you get started with some of those. Choose your client below to view the installation and configuration instructions.

  • Requires a Claude Pro account to unlock full potential.

  • Requires a Microsoft 365 Copilot or Copilot Studio license to use.

  • Requires access to GitHub Copilot.

  • Free open-source. Requires an AI assistant API key (such as Gemini).

  • Free open-source. Requires an AI assistant API key (such as Gemini).


More guides will be added as additional platforms adopt MCP support. If there's a specific AI assistant platform you would like to see support for, you can suggest it by visiting the Ardoq Product Portal via the feedback link in the app.


Known Issues


Change Log

  • 2025-06-26

    • SSE protocol deprecated.

    • New endpoint for MCP required. See FAQ

  • 2025-05-09

    • Initial tech preview


Did this answer your question?