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:
Your Aragorn Analytics MCP URL
Administrative access to the AI platform you want to configure
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
Login to your Aragorn account as an admin
Navigate to Manage Analytics on the side menu
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:
Review the member criteria of the Analytics Groups.
Review the group's Data Permissions.
Review its Storyboard Access.
Configure the appropriate Measures, Metrics, and Dimensions under Analytics Guardrail.
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:
Navigate to: Customize → Connectors
Find: Aragorn Analytics and select: Connect
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.
Navigate to: Workspace Settings → Permissions & Roles → Connected Data
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
Navigate to: Workspace Settings → Apps → Create
Create a new custom app.
Name:
Aragorn AnalyticsDescription:
Access governed workforce analytics from Aragorn, including approved workforce measures, metrics, and dimensions.
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
Confirm that the connector was added under: Organization settings → Connectors and that the user has connected it under:
Customize → Connectors - For Claude Team and Enterprise, organization Owners control the initial addition of custom remote MCP connectors.
ChatGPT
Confirm that the Aragorn Analytics app has been published, not left as a draft.
For Enterprise/Edu workspaces, also confirm that the user's role or group has been granted access to the app.
Microsoft Copilot
Confirm that the Aragorn MCP server has been added to the correct agent and that the agent has been saved and published.
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

