Skip to main content

How to set up Insightful MCP server

Learn how to connect AI tools like Claude or ChatGPT to Insightful using MCP in order to analyze your workforce data

Written by Petar Jelaca

AI assistants are most useful when they can work with your actual data. Connect Insightful to a tool like Claude and you can ask about your workforce data in plain language - and if it's connected to your other tools too (Jira, SAP, your HRIS), it can combine them: in Claude Cowork, for example, one conversation can pull a team's utilization and check it against their open Salesforce deals.

The connection works through MCP (Model Context Protocol), an open standard that lets AI tools securely request data from other apps. You don't need to understand how it works - setup comes down to pasting a URL and signing in. Below you'll find the endpoint you'll need, followed by instructions for Claude, ChatGPT, and other MCP-compatible tools.

Before you begin

You'll need:

  • An Insightful account - during setup you'll sign in with your own Insightful credentials and approve the connection. The AI tool can only access data your account can access.

  • An AI tool that supports MCP - Claude, ChatGPT, or any client that can connect to remote MCP servers.

Find your endpoint

The endpoint is the URL your AI tool will use to reach Insightful. Use the one that matches the region your organization's Insightful data is hosted in - it's the same region as the app URL you normally use to log in.

Region

Endpoint

United States (default)

European Union

Saudi Arabia

Copy the URL for your region - you'll paste it in the steps below.

Connect your AI tool

Setting up Claude

  1. Open Settings → Connectors.

  2. Select Add custom connector.

  3. Paste your regional endpoint URL and confirm.

  4. You'll be prompted to sign in and authorize access to your Insightful organization. Approve the request.

  5. That's it. Once connected, the Insightful tools (utilization, app usage, productivity labels, employees, teams, etc.) become available to Claude in that workspace.

Setting up ChatGPT

  1. Click your profile icon Settings Apps & Connectors (it may show as Connectors) Advanced Settings, and toggle Developer mode on.

  2. Back in Apps & Connectors, select Create connector (or New connector).

  3. Fill in: Name (e.g. “Insightful”), Description (optional), and URL - your regional endpoint from the table above.

  4. Set Authentication to OAuth and save. Complete the sign-in and authorization flow when prompted.

  5. In each conversation where you want to use it, click the + in the message box > More Developer mode, then toggle the Insightful connector on for that chat.

Setting up other MCP clients

Most MCP-compatible tools (Cursor, Windsurf, Cline, Claude Code, Codex, and others) accept mcpServers JSON. Add Insightful to your tool's MCP config file, making sure the url points to your regional endpoint:

{
"mcpServers": {
"insightful": {
"url": "https://app.insightful.io/mcp"
}
}
}

The location of the config file differs from tool to tool, so consult your tool's documentation. Any client that supports remote (HTTP) MCP servers with OAuth should work - on first use you'll be asked to sign in to Insightful and approve access, just like in the steps above.

The example above uses the United States endpoint. If your organization is hosted in the European Union or Saudi Arabia region, replace the URL with the matching endpoint from the table.

You're all set

Once connected, simply ask your AI assistant a question about your workforce data - it will pull the answer from live Insightful data.

Did this answer your question?