Connecting an AI Agent
Last updated: November 9, 2026
| Tier | Deployment |
|
|
|
Note:
This page covers connecting an AI client. For what the MCP Server is and how it is governed, see Sisense MCP Server.
You connect an MCP-compatible AI client to Sisense by adding the Sisense MCP endpoint and signing in once with your Sisense credentials. There is nothing to install. Claude, ChatGPT, and Cursor are validated. Validation covers connecting and running the tools; whether a client can display rendered charts and dashboards depends on MCP Apps support in that client, described under Interactive Charts and Dashboards in Claude and ChatGPT below. Claude and ChatGPT users can also connect from each client's connector directory, without entering an endpoint. See Add It to Your MCP Client below.
Note for Administrators:
On Managed Cloud, the MCP Server is enabled by default under System Configuration > MCP. On self-hosted deployments, an administrator must first enable it at install or upgrade. See Enabling the MCP Server on Self-Hosted Deployments. To stop AI clients from connecting to a given environment, turn the Enabled toggle off. Each Sisense environment is controlled independently.
1. Get the Endpoint URL
Managed Cloud
The hosted MCP Server runs at a single Sisense address. There are two ways to tell it which deployment to work against, and both are supported.
If you want to use one deployment, with one target URL, use option 1 (this will eliminate the need to enter your target URL upon each sign in); if you want to be prompted to choose your deployment's target URL before signing in (e.g., the first time you sign in, or if you have more than one deployment to sign in to), use option 2.
Option 1: Name your deployment in the URL. Add a target query parameter set to your Sisense URL:
https://mcp.sisense.com/mcp?target=<your-deployment-url>
The client then connects straight to your deployment with no further prompting. This is the form administrators usually distribute when rolling the connector out to a team, because it settles both the endpoint and the deployment up front and nobody has to know or type their instance URL.
Option 2: Use the base endpoint and choose your deployment on screen. Add the endpoint without a target:
https://mcp.sisense.com/mcp
The first time you connect, Sisense presents a form where you enter your deployment URL before signing in. This suits individual users, and anyone who connects to more than one deployment.
Your Sisense administrator can confirm the exact endpoint and your deployment URL.
Self-Hosted
On self-hosted deployments, the endpoint is exposed by your own instance and serves that instance directly, so no target parameter is needed:
https://<your-deployment>/mcp
For example, https://company.sisense.com/mcp.
The endpoint is available only after your administrator has enabled the MCP Server. See Enabling the MCP Server on Self-Hosted Deployments. Your administrator provides the exact endpoint.
2. Add It to Your MCP Client
Add the endpoint as a remote (HTTP) MCP server. There are no credentials to enter. Authentication happens in the browser on first use.
Important:
Administrator prerequisite. Before users connect Claude, an administrator must add Claude's content domain to Admin > Security Settings > CORS Allowed Origins:
https://*.claudemcpcontent.com
Without this entry, the connector still connects and runs queries, but dashboards and charts do not load, and users get text-only answers. See Interactive Charts and Dashboards in Claude and ChatGPT below.
Connect from the Claude Connector Directory
Sisense is listed in Claude's connector directory. This is the quickest way to connect on Managed Cloud.
-
In Claude, open Customize > Connectors, and click + next to Connectors.
-
Find Sisense and click Connect.
-
Enter your Sisense deployment URL. The directory listing uses the base endpoint (
https://mcp.sisense.com/mcp, with notarget), so Sisense first shows a screen where you enter your deployment URL. See Option 2 under Managed Cloud above. -
Sign in with your Sisense credentials and approve access.
Add a Custom Connector
Add Sisense as a custom connector instead in these cases:
-
Self-hosted deployments. The directory listing connects to the Sisense-hosted endpoint. Use your own instance's endpoint (
https://<your-deployment>/mcp). -
Administrators who want to set the deployment up front. Use the endpoint with the
targetparameter (Option 1 above), so users connect straight to your deployment without the deployment URL screen.
Note:
Team and Enterprise plans: Members cannot add a custom connector themselves. An Owner first adds it for the organization:
-
Open Organization settings > Connectors.
-
Select Add, hover over Custom, and select Web.
-
Paste your endpoint URL.
-
Click Add.
Members then open Customize > Connectors, find the Sisense connector (marked Custom), click Connect, and sign in.
On individual plans:
-
Open Customize > Connectors > + Add > Add custom connector.
-
Give it a name (for example,
Sisense) and paste your endpoint URL. -
Save. Claude prompts you to sign in the first time you use it.
Important:
Administrator prerequisite. Before users connect ChatGPT, an administrator must add ChatGPT's content domain to Admin > Security Settings > CORS Allowed Origins:
https://*.web-sandbox.oaiusercontent.com
Without this entry, the connector still connects and runs queries, but charts and dashboards do not render, and users get text-only answers. See Interactive Charts and Dashboards in Claude and ChatGPT below.
Connect from the ChatGPT Directory
Sisense is listed in ChatGPT's directory. This is the quickest way to connect on Managed Cloud.
-
Open the Sisense listing in ChatGPT, or find Sisense in ChatGPT's directory.
-
Click Connect.
-
Sign in with your Sisense credentials and approve access. If Sisense asks for your deployment URL, enter it first.
Add a Custom Connector
On self-hosted deployments, add Sisense as a custom connector with your own instance's endpoint (https://<your-deployment>/mcp). The directory listing connects to the Sisense-hosted endpoint.
-
Open Settings > Connectors.
-
Add a custom connector, name it (for example,
Sisense), and paste your endpoint URL. -
Save, then sign in to Sisense when ChatGPT prompts you.
Custom connector availability depends on your ChatGPT plan.
Add the server to your MCP configuration. On Managed Cloud:
{
"mcpServers": {
"sisense": {
"url": "https://mcp.sisense.com/mcp?target=<your-deployment-url>"
}
}
}
On self-hosted deployments:
{
"mcpServers": {
"sisense": {
"url": "https://<your-deployment>/mcp"
}
}
}
Reload the MCP servers. Cursor opens a browser sign-in the first time the server is used.
Any client that supports remote MCP servers over HTTP with OAuth can connect. Add the endpoint as a remote/HTTP server (not a local command). The client discovers Sisense's OAuth configuration automatically and registers itself. No manual client ID or secret is required.
3. Sign In and Approve Access
The first time the agent uses the server, your browser opens a Sisense sign-in page. Sign in with your existing Sisense credentials, including SSO, and approve access. Sisense issues the agent a short-lived credential scoped to you, and you are ready to go.
On self-hosted deployments running Sisense 2026.4.1 or later, the approval (consent) page shows your organization's logo, name, and colors instead of the Sisense branding. See Branding the Consent Page.
The connection stays signed in for 3 days from sign-in. Within that period, your client renews access automatically, so you do not need to do anything. Using the connection does not extend this period. After 3 days, sign in to Sisense again. See Troubleshooting below.
Note:
Each user connects individually. Every person who wants to use the MCP Server completes this sign-in with their own account. There is no shared login, and each user sees only the data their permissions allow.
4. Verify the Connection
Confirm the agent is connected before you rely on it:
-
Check that the Sisense tools appear in your client's tool or connector list.
-
Ask the agent to list your data sources, for example, "List my Sisense data sources."
-
You should see the data models your account can access.
If the tools do not appear or the request fails, see Troubleshooting below.
Switching Deployment or Instance
Each connection is scoped to one deployment and one user.
-
To point an agent at a different Sisense deployment on Managed Cloud, change the
targetin the endpoint URL. On self-hosted, use the other deployment's own/mcpURL. The client prompts you to sign in again for that deployment. -
Signing in as a different user, or connecting to a different instance, also starts a new sign-in. Credentials are never shared between users or deployments.
Interactive Charts and Dashboards in Claude and ChatGPT
Claude and ChatGPT can render charts and dashboards as live, interactive visualizations inside the conversation. For this to work, your administrator must add each client's content domain to the allowed origins in Admin > Security Settings > CORS Allowed Origins. Add the entry for every client your users connect:
-
Claude:
https://*.claudemcpcontent.com -
ChatGPT:
https://*.web-sandbox.oaiusercontent.com
Use the subdomain wildcard form. Each client loads charts and dashboards from a subdomain (for example, Claude uses https://abc123.claudemcpcontent.com), so the browser origin is a subdomain, not the bare domain. Listing the bare domain on its own does not match, and charts and dashboards stay blocked.
Note:
Rendered Charts and Dashboards Depend on MCP Apps, Not on MCP Compatibility Alone.
Sisense renders charts and dashboards through MCP Apps, an extension for interactive content inside the conversation that not every MCP client implements. A client can be fully MCP compatible, connect successfully, and run every tool, and still have no way to display a rendered chart or dashboard. Claude and ChatGPT are validated for interactive charts and dashboards. In other clients, expect the narrative insights instead, and treat chart and dashboard rendering as unverified until you have tried it in that client.
Without these entries, queries and other tools still work, but dashboards and charts do not load, and users get text-only answers. Clients that do not support interactive content receive only the narrative insights, not a rendered chart or dashboard.
Troubleshooting
Reload or restart the MCP client, and confirm it supports remote MCP servers over HTTP. Check that the endpoint is entered as a remote/HTTP server, not a local command.
Ask your administrator to check the following:
-
The
sisenseMcpsetting is in the Sisense Helm override values (for example,installer/extra_values/helm/sisense.yml), not inconfig.yamlorcluster_config.yaml. It must be nested underglobal:, withenabled: true, and the installer or upgrade must be run afterward. See Enabling the MCP Server on Self-Hosted Deployments. -
The
oauth-gatewayandmcp-servicepods are running. -
The Enabled toggle is on under System Configuration > MCP.
-
If multitenancy is enabled on the deployment and the endpoint returns the Sisense "Page not Found" page, this is a known limitation that is fixed in Sisense 2026.4.1.
Connections stay signed in for 3 days from sign-in, and using the connection does not extend this. After 3 days, you must sign in to Sisense again. Depending on the client, it either prompts you to sign in, or tool calls fail until you reconnect Sisense in the client's connector settings. Sign in again, then retry the request.
If the problem persists after you sign in, confirm you are signing in to the correct Sisense instance.
Data source names are case-sensitive. Ask the agent to list your data sources and use the exact name.
Check whether your client supports MCP Apps. Clients without it receive the narrative insights rather than a rendered chart or dashboard, and nothing is wrong with the connection or the query. In Claude or ChatGPT, if the chart or dashboard area stays blank, or you get text only, see the CORS entries under Interactive Charts and Dashboards in Claude and ChatGPT above.
Your administrator must allow the client's content domain in Sisense CORS settings. See Interactive Charts and Dashboards in Claude and ChatGPT above. Other tools still work without it, but answers are text only.
Charts and dashboards shown in a conversation stay viewable for about 24 hours. Ask the agent to rebuild it to bring it back.
Be more specific: name the chart type, the fields, and any sorting or filter. Simplify the request, then build it back up.
buildQuery, the chart tools, or the dashboard tools fail, but discovery still works.
The AI-powered tools need Cloud-Linked Features and a configured LLM provider. Ask your administrator to confirm Cloud-Linked Features is enabled under Admin > Sisense Intelligence > Feature Management, and that an LLM provider is set up: either the LLM managed by Sisense, which draws on your Sisense credit package, or your own provider under Provider Configuration. If you use the Sisense-managed LLM, also check that your Sisense credit package has not run out and that credits are allocated to your tenant and user group under Admin > Sisense Intelligence > Credits & Allocations. The discovery tools (getDataSources and getDataSourceFields) do not need this and keep working.