Skip to content
Last updated

Hex integration

Hex is a collaborative data workspace for building, sharing, and iterating on analyses, notebooks, and data apps.

It can be connected to Agen.co two ways, matching the Official / In-house filter in the connector picker:

  • Official — Agen.co connects through Hex's own hosted MCP server, so your AI agents use the same project-search and Hex Notebook Agent Thread tools Hex exposes to MCP clients like Claude, Cursor, and ChatGPT.
  • In-house — Agen.co wraps the Hex API directly through its own integration layer, using a workspace API token.

Pick Official if the built-in MCP tools cover what your agents need. Fall back to In-house if you need broader API coverage, such as managing projects, users, groups, collections, and data connections directly.


Connect via the official MCP server

Prerequisites

  • A Hex workspace on a Team or Enterprise plan
  • Explorer role or higher in the workspace
  1. In the Agen.co portal, go to Connectors → My connectors and click Add connector.
  2. In the search bar, type Hex and select it from the results.
  3. In the Instance Slug field, enter a slug for this connector instance — it prefixes each imported tool as slug__tool, so a second instance of the same connector needs a slug of its own. Use lowercase kebab-case. You can change it later from the connector's settings.
  4. In Hex domain, select the region your workspace runs on: app (US — app.hex.tech), eu (EU — eu.hex.tech), or hc (HIPAA — hc.hex.tech).
  5. Click Connect.
  6. You're redirected to Hex to sign in and approve access. No API token needs to be entered manually.
  7. Return to Agen.co and click Add below the list of tools that were added.

Once connected, Hex appears under My connectors with tools spanning:

AreaWhat it covers
Project searchFinding projects in the workspace by query
Notebook Agent ThreadsStarting new Threads, retrieving Thread messages and results, and adding follow-up questions to existing Threads

Data connections marked as sensitive in Hex are excluded from MCP access regardless of the tools a policy grants.

Enabling the Hex connector isn't enough on its own. Tool calls remain denied until you create a policy that grants access to the specific tools you want to expose.

Connect via the Hex API

Hex is a collaborative data workspace for building, sharing, and iterating on analyses, notebooks, and data apps. The Frontegg integration connects to the Hex API using an API token to manage projects, runs, users, groups, collections, and data connections.

Prerequisites

  • A Hex workspace with Admin access (required to create workspace tokens)

Generate an API token

Step 1: Open your workspace settings

In your Hex workspace, click Settings in the left sidebar.

Hex workspace sidebar with Settings highlighted

Step 2: Navigate to API keys

In the Settings panel, select the API keys tab, then click New token under the Workspace tokens section.

Hex API keys settings with New token button highlighted

Step 3: Configure the token

In the New workspace token dialog:

  1. Enter a Description, for example Frontegg Integration.
  2. Set Expiration to No Expiry.
  3. Select the required API scopes:
ScopeAccess required
Sync semantic projectsEnabled
ProjectsRead + Write + Run + Read queried tables
UsersRead + Write
GroupsRead + Write
CollectionsRead + Write
Data connectionsRead + Write
CellsRead + Write
GuidesRead + Write
  1. Click Generate token.

New workspace token dialog with scopes selected and Generate token highlighted

Step 4: Copy the token

Copy the generated token immediately — it is shown only once and cannot be retrieved later.

Generated workspace token with Copy token button highlighted

Configure the Frontegg portal

Once you have your API token, enter it in the Frontegg portal:

  1. Open the Frontegg portal and navigate to [ENVIRONMENT] → Integrations → Hex.
  2. Enter the API Key you copied in the previous step.
  3. Click Save.

Keep your token secure

Never share or commit your API token to version control. If a token is compromised, revoke it from Settings → API keys and generate a new one.

Additional resources