Skip to main content

How to Use Analytics MCP

G
Written by Gladys Adjei

Connect Aragorn Analytics to Claude, ChatGPT, or Microsoft Copilot

Aragorn's Analytics MCP allows your organization to securely access governed workforce analytics from supported AI assistants such as Claude, ChatGPT, and Microsoft Copilot.
​

Once connected, your team can ask questions about your workforce data using natural language while Aragorn controls which analytics are available through your organization's configured Analytics Guardrails.
​

For example, users may be able to ask:

  • "What is our current headcount by department?"

  • "What is our average salary by gender?"

  • "Show me turnover by location."

  • "How has headcount changed over the last 12 months?"

  • "Compare voluntary turnover across departments."

The analytics available to a user depend on the access configured for their Aragorn Analytics Group.


Before You Begin

You will need:

  1. Your Aragorn Analytics MCP URL

  2. Administrative access to the AI platform you want to configure

  3. At least one Aragorn Analytics Group with the appropriate Analytics Guardrails configured

Your Aragorn administrator can obtain the MCP URL from the applicable Analytics Group in Aragorn.

Finding your MCP URL in Aragorn

  1. Login to your Aragorn account as an admin

  2. Navigate to Manage Analytics on the side menu

  3. Locate MCP URL on the page and click the Copy URL button

The MCP URL connects the AI assistant to the analytics available through that Aragorn configuration.


Understanding Analytics Guardrails

Before connecting Aragorn to an AI assistant, we recommend reviewing the Analytics Guardrail for the applicable group.
​

Analytics Guardrails determine which Measures, Metrics, and Dimensions members of the group can use when exploring analytics through Aragorn's Analytics MCP. This allows your organization to control the analytics exposed through connected AI assistants.
​

For example, an organization may allow an HR Business Partner group to access:

  • Active Headcount

  • Turnover Rate

  • Average Tenure

  • Department

  • Location

  • Job Level

while keeping compensation-related calculations unavailable to that group.

Your existing Aragorn governance remains the source of truth for what analytics the MCP makes available.
​

Before deployment

We recommend that you:

  1. Review the member criteria of the Analytics Groups.

  2. Review the group's Data Permissions.

  3. Review its Storyboard Access.

  4. Configure the appropriate Measures, Metrics, and Dimensions under Analytics Guardrail.

  5. Copy the MCP URL and provide the URL to the administrator responsible for Claude, ChatGPT, or Microsoft Copilot.

Security recommendation: Do not configure Full Access unless everyone in that group must have access to all applicable current and future analytics. Aragorn displays an elevated-access warning when Full Access is selected.


Option 1: Connect Aragorn Analytics to Claude

Who should complete this setup?

For Claude Team or Enterprise, an organization Owner or Primary Owner should configure the connector.


After the connector is added to the organization, users can connect to and use the connector according to the organization's Claude configuration and permissions.
​

Step 1 — Open Claude organization settings

Sign in to your organization's Claude account and navigate to: Organization settings → Connectors
​

Step 2 — Add a custom connector

Select Add. Then hover over Custom, and select: Web. Claude will ask for the remote MCP server information.
​

Step 3 — Enter the Aragorn MCP URL

Enter the MCP URL copied from Aragorn. Use a recognizable name if Claude asks you to name the connector.


​Recommended name:

Aragorn Analytics


​Recommended description, if requested:

Access governed workforce analytics from Aragorn, including approved workforce measures, metrics, and dimensions.

Step 4 — Complete the connection

Select Add and follow any authentication or authorization prompts presented by Claude and Aragorn.


Once completed, Aragorn Analytics should appear as an available connector in your Claude organization. Claude's current remote MCP implementation connects to the MCP server from Anthropic's cloud infrastructure rather than directly from an employee's computer.
​

Step 5 — Have users connect Aragorn

Once the organization owner has added the connector, users can:

  1. Navigate to: Customize → Connectors

  2. Find: Aragorn Analytics and select: Connect

  3. Complete any authentication prompts that appear.

For Team and Enterprise organizations, adding the connector at the organization level makes the connector available; users may still need to establish their individual connection depending on the authentication configuration.
​

Step 6 — Enable Aragorn in a Claude conversation

Start a new conversation in Claude by selecting the + button near the chat input and open Connectors. Make sure Aragorn Analytics is enabled.
​


Option 2: Connect Aragorn Analytics to ChatGPT

Requirements

Custom MCP apps are currently supported through ChatGPT's app and developer-mode capabilities. For organizational deployments, your ChatGPT Workspace Admin or Owner should perform the initial setup and review the app before making it available to users. OpenAI currently provides full MCP support for ChatGPT Business and Enterprise/Edu workspaces. Enterprise and Edu administrators can additionally use role-based access controls to determine who can access a custom app.

Step 1 — Enable custom MCP apps

As a ChatGPT Workspace Admin or Owner, open your workspace settings.

  1. Navigate to: Workspace Settings → Permissions & Roles → Connected Data

  2. Enable the setting for: Developer mode / Create custom MCP connectors

Depending on your ChatGPT plan and workspace configuration, developer access can also be controlled through workspace roles.
​

Step 2 — Create the Aragorn app

  1. Navigate to: Workspace Settings → Apps → Create
    ​

  2. Create a new custom app.

    1. Name: Aragorn Analytics

    2. Description: Access governed workforce analytics from Aragorn, including approved workforce measures, metrics, and dimensions.
      ​

  3. Paste the URL copied directly from the applicable Aragorn Analytics Group.

Step 3 — Configure authentication

Select the authentication option required by your Aragorn connection and follow the authentication flow presented by ChatGPT. If authorization is requested, complete the Aragorn sign-in/authorization process before continuing.
​

Step 4 — Scan the available tools

Select: Scan Tools

ChatGPT will connect to the Aragorn MCP server and discover the capabilities exposed by the server. Wait for the scan to complete and then review the tools that ChatGPT discovers before proceeding. OpenAI specifically recommends reviewing the MCP server and its permissions before deploying a custom app to your workspace.
​

Step 5 — Create and test the app

Select: Create

The Aragorn Analytics app will initially be available as a draft. Open a new ChatGPT conversation and select Aragorn Analytics from the available Apps/Tools. Next, test the connection with a few analytics prompts and verify that the results align with the access you configured in the corresponding Aragorn Analytics Guardrail.
​

Step 6 — Publish Aragorn Analytics to your workspace

Once testing is complete, return to: Workspace Settings → Apps → Drafts and locate Aragorn Analytics. Then, select Publish.


Review the permissions and available actions before publishing. For Enterprise/Edu environments, administrators can also configure which workspace groups can access the app and which actions are available before publishing. Once published, Aragorn Analytics will appear as a custom app available to authorized members of the workspace.
​


Option 3: Connect Aragorn Analytics to Microsoft Copilot

Microsoft supports MCP servers through Microsoft Copilot Studio. This allows an administrator or Copilot agent builder to add Aragorn Analytics as a tool available to a Copilot agent.


​Important: Microsoft has multiple Copilot products and administration experiences. The instructions below apply to connecting an MCP server through Microsoft Copilot Studio.
​

Requirements

Before starting, make sure you have:

  • Access to Microsoft Copilot Studio

  • Permission to create or modify the applicable Copilot agent

  • Your Aragorn Analytics MCP URL

Step 1 — Open your Copilot agent

Sign in to Microsoft Copilot Studio and open the agent that should have access to Aragorn Analytics.
​

Step 2 — Open Tools

Navigate to the agent's: Tools and select: Add a tool. Afterwards, select: New tool → Model Context Protocol
​

Step 3 — Configure the Aragorn MCP server

Server name: Aragorn Analytics

Server description: Access governed workforce analytics from Aragorn, including approved workforce measures, metrics, and dimensions.

Server URL:[YOUR ARAGORN MCP URL]
​
​

Step 4 — Configure authentication

Select the OAuth 2.0 authentication method for your Aragorn connection and complete the requested configuration before continuing
​

Step 5 — Create the connection

Select Create and complete any required connection or sign-in flow. After, select Add and configure. The Aragorn MCP server will be added as a tool for your Copilot agent.
​

Step 6 — Review the Aragorn tools

Open the newly added Aragorn Analytics tool and review these tools before publishing your agent


Security and Access

Connecting an AI assistant to Aragorn does not mean that every analytic in Aragorn would automatically be available to every user.


Aragorn's Analytics Guardrails are designed to control which analytics a group can use through the Analytics MCP.
​

Administrators should carefully review:

  • Group membership

  • Data Permissions

  • Storyboard Access

  • Measures

  • Metrics

  • Dimensions

  • Full Access settings

before distributing an MCP connection.
​

Use least-privilege access

We recommend granting each group only the analytics its members need rather than providing broad access and relying on users not to request sensitive information


Important: The AI Assistant Does Not Define Your HR Metrics

One of the primary benefits of using Aragorn Analytics through MCP is that the AI assistant can work with analytics that have already been defined and governed in Aragorn.
​

For example, your organization may have an approved definition for:

Voluntary Turnover Rate or Active Headcount
​

The AI assistant can use the analytics exposed by Aragorn rather than requiring users to repeatedly describe how those calculations should be performed. This helps provide a more consistent analytics experience across Aragorn and the AI tools your organization already uses.


Troubleshooting

The AI assistant cannot connect to the MCP URL

First confirm that:

  • The complete MCP URL was copied from Aragorn.

  • No characters were removed from the URL.

  • No spaces were added before or after the URL.

If the problem continues, contact your Aragorn representative.


The connector was added, but users cannot see it

Check the administration settings for your AI platform.
​

Claude

  1. Confirm that the connector was added under: Organization settings → Connectors and that the user has connected it under:
    ​

  2. Customize → Connectors - For Claude Team and Enterprise, organization Owners control the initial addition of custom remote MCP connectors.
    ​

ChatGPT

  1. Confirm that the Aragorn Analytics app has been published, not left as a draft.
    ​

  2. For Enterprise/Edu workspaces, also confirm that the user's role or group has been granted access to the app.
    ​

Microsoft Copilot

  1. Confirm that the Aragorn MCP server has been added to the correct agent and that the agent has been saved and published.
    ​

  2. Also review any Power Platform data policies that could prevent the agent from using the connector. Microsoft applies Power Platform connector data policies to MCP connections in Copilot Studio.


Aragorn connects successfully, but a specific analytic is unavailable

This may be expected because the user's Aragorn Analytics Group might not have access to the requested Measure, Metric, or Dimension.


An Aragorn administrator should review: Analytics → Groups → [Group] → Analytics Guardrail and verify the appropriate access.


Do not broaden access unless the group should legitimately be able to use that analytic.


The assistant can access some analytics but not others

This usually means the connection itself is working.


Review the applicable group's Analytics Guardrail and confirm that the requested Measure, Metric, and Dimension are available to that group.
​


Platform Setup Summary

Platform

Administrator

Where to configure

Claude Team / Enterprise

Owner or Primary Owner

Organization settings → Connectors

ChatGPT Business

Workspace Admin or Owner

Workspace Settings → Apps

ChatGPT Enterprise / Edu

Workspace Admin or Owner

Workspace Settings → Apps, with optional RBAC

Microsoft Copilot Studio

Copilot administrator / agent builder

Agent → Tools → Add a tool → Model Context Protocol


Need Help?

If you have questions about:

  • Your Aragorn Analytics MCP URL

  • Analytics Guardrails

  • Group configuration

  • Measures, Metrics, or Dimensions

  • Connecting Aragorn to your organization's AI environment

  • Troubleshooting an Aragorn MCP connection

contact your Aragorn representative or submit a Help Ticket for assistance. When contacting support about an MCP connection issue, please include:

  • The AI platform you are connecting: Claude, ChatGPT, or Microsoft Copilot

  • The step where the issue occurs

  • The error message displayed

  • A screenshot of the error, when possible

Did this answer your question?