Set up the Sigma connector
Connect Sigma to make its content discoverable in Glean Search and let users ask questions about Sigma data through its remote Model Context Protocol (MCP) tools. Indexing uses Sigma API credentials, while MCP tools require a separate OAuth connection for each user.
What the connector indexes
The Sigma connector indexes the following content types:
- Workbooks, including descriptions, tags, pages, and named data-bearing elements such as charts, tables, pivot tables, and input tables
- Workspaces
The connector indexes Sigma metadata for discovery. It does not index underlying data rows or metric values. Controls, text, and layout elements do not provide searchable content, whether named or unnamed.
Prerequisites
Before you begin:
- Have a Sigma admin account to create the API credentials for indexing. See Set up a new Sigma connection.
- Confirm that you can add connectors and manage tool access in the Glean Admin console. See Administrator Roles and Managing tool access.
- Confirm that each user's Sigma account type includes Use Sigma MCP with OAuth and the relevant View workbooks, View data models, or View connections permissions. See Use the Sigma MCP server.
- Check that users have at least Can view access to the documents and Can use access to the connections they want to query. See Use the Sigma MCP server.
- If your Sigma organization uses an IP allowlist, allow Glean's outbound IP addresses with Scope set to API in Sigma. Contact your Glean account team to confirm the addresses. See Use the Sigma MCP server.
Set up a new Sigma connection
The unified setup has three stages in Glean: Set up indexing, Connect, and Review setup. Existing connections keep their current setup flow and aren't moved automatically. For a Sigma MCP configuration managed under Platform → Tools, see Connect remote MCP servers to Glean.
Generate indexing credentials in Sigma
- Sign in to Sigma as an admin at
https://app.sigmacomputing.com/and enter your organization's sign-in URL if prompted. - Open your profile menu and go to Administration → Developer Access.
- Click Create new to generate an API credential pair.
- Under Select scopes, select REST API.
- Enter a descriptive name, such as
Glean Integration, and select a Sigma admin as the Owner. - Click Create, then copy the Client ID and Secret from Access Credentials before closing the window.
Store the secret securely because Sigma displays it only once.
Collect your Sigma connection details
Copy the API base URL from Sigma's Developer Access section, then find your organization name in your Sigma URL. For example, in https://app.sigmacomputing.com/<your-org-name>/..., copy the <your-org-name> segment.
Set up indexing in Glean
In the Admin console, open Connectors and add a Sigma connection. Give it a name and enter the following values in Set up indexing.
| Field in Glean | What to enter |
|---|---|
| Client ID | The Sigma API client ID you created for indexing |
| Client secret | The corresponding Sigma API client secret |
| API Base URL | The API base URL from Sigma's Developer Access section |
| Organization Name | The organization name from your Sigma URL |
Click Continue to save the indexing configuration and proceed to MCP authorization.
Connect Sigma MCP tools
Glean registers the MCP client automatically, so you don't need to provide another client ID or client secret. Each user authorizes MCP access with their own Sigma account, separately from the API credentials used for indexing.
- In Sigma, open Profile → Integrations and find the Sigma MCP URL under Connect Sigma to AI tools. See Use the Sigma MCP server.
- In Glean's Connect step, select the Region that matches the host in that URL.
- Click Connect, sign in to Sigma if prompted, and approve the requested access.
- Confirm that the connection succeeds before continuing to Review setup.
Your setup connection does not authorize other users to access Sigma data.
Review setup and begin indexing
In Review setup, review the indexing and tools configuration, choose who can access the connection, and click Begin indexing.
Check the connector's status for initial indexing progress and review the deployed Sigma tools in its Tools tab. Indexed results depend on crawl progress, while live Sigma queries use the requesting user's MCP authorization.
See Use Sigma in Assistant to configure tool access and verify a user's connection.
Permissions and security
The connector respects Sigma permissions in Glean Search results.
Sigma uses grants to determine access in Glean. A grant can apply to either a user or a team.
In the current implementation:
- Workspace results use grants defined on the workspace
- Workbook results use grants defined on the workbook
- Page and element content inherits grants defined on the parent workbook
Crawling strategy
The connector uses full crawls to keep content and permissions up to date. Sigma does not support incremental crawls or webhook-based updates for this integration.
Content and permissions are synced daily after initial indexing.
Limitations
- Creating or editing Sigma content from Glean is not supported.
- Indexing makes Sigma content searchable but does not query live data. Use Sigma MCP tools for natural-language queries. See Use Sigma in Assistant.
- Live Assistant answers depend on the user's Sigma permissions and, for some queries, access to the underlying data model or connection.
- Assistant queries on Sigma elements always use Sigma's default control and filter values because of Sigma MCP limitations.
- Dataset crawling is not included in this release.
- Webhook-based freshness updates are not available.
Troubleshooting
See also
- Use Sigma in Glean for guidance on finding Sigma content and asking questions about its data.